Interface ITrackerAppSoap

    • Method Detail

      • getTrackerList

        TrackerSoapList getTrackerList​(String sessionId,
                                       String projectId)
                                throws RemoteException
        Deprecated.
        use getTracker3List instead, which includes tracker unit and autosum foreign children support
        Returns a list of trackers for a project in the order that they are displayed in the UI.
        Parameters:
        sessionId - User session id.
        projectId - Project id.
        Returns:
        List of trackers within the project.
        Throws:
        InvalidSessionFault - when the specified session id is invalid.
        NoSuchObjectFault - when the specified object id is invalid.
        PermissionDeniedFault - when the user has insufficient privileges.
        SystemFault - when an unexpected system error occurs.
        RemoteException
        Since:
        4.1
      • getTracker2List

        Tracker2SoapList getTracker2List​(String sessionId,
                                         String projectId)
                                  throws RemoteException
        Deprecated.
        use getTracker3List instead, which includes autosum foreign children support
        Returns a list of trackers for a project in the order that they are displayed in the UI.
        Parameters:
        sessionId - User session id.
        projectId - Project id.
        Returns:
        List of trackers within the project.
        Throws:
        InvalidSessionFault - when the specified session id is invalid.
        NoSuchObjectFault - when the specified object id is invalid.
        PermissionDeniedFault - when the user has insufficient privileges.
        SystemFault - when an unexpected system error occurs.
        RemoteException
        Since:
        6.2
      • getTrackerData

        TrackerSoapDO getTrackerData​(String sessionId,
                                     String trackerId)
                              throws RemoteException
        Deprecated.
        use getTracker3Data instead, which includes tracker unit and autosum foreign children support
        Returns a data object for a given tracker
        Parameters:
        sessionId - User session id.
        trackerId - Tracker id.
        Returns:
        Detailed data on the tracker.
        Throws:
        InvalidSessionFault - when the specified session id is invalid.
        NoSuchObjectFault - when the specified object id is invalid.
        PermissionDeniedFault - when the user has insufficient privileges.
        SystemFault - when an unexpected system error occurs.
        RemoteException
        Since:
        "4.2"
      • getTracker2Data

        Tracker2SoapDO getTracker2Data​(String sessionId,
                                       String trackerId)
                                throws RemoteException
        Deprecated.
        use getTracker3Data instead, which includes autosum foreign children support
        Returns a data object for a given tracker
        Parameters:
        sessionId - User session id.
        trackerId - Tracker id.
        Returns:
        Detailed data on the tracker.
        Throws:
        InvalidSessionFault - when the specified session id is invalid.
        NoSuchObjectFault - when the specified object id is invalid.
        PermissionDeniedFault - when the user has insufficient privileges.
        SystemFault - when an unexpected system error occurs.
        RemoteException
        Since:
        "6.2"
      • setTrackerData

        void setTrackerData​(String sessionId,
                            TrackerSoapDO trackerData)
                     throws RemoteException
        Deprecated.
        use setTracker3Data instead, which includes tracker unit and autosum foreign children support
        Sets data on a specific tracker
        Parameters:
        sessionId - User session id.
        trackerData - Detailed data on the tracker to set.
        Throws:
        InvalidSessionFault - when the specified session id is invalid.
        NoSuchObjectFault - when the specified object id is invalid or field or icon could not be found.
        PermissionDeniedFault - when the user has insufficient privileges.
        SystemFault - when an unexpected system error occurs.
        IllegalArgumentFault - when invalid data is specified.
        VersionMismatchFault - when the object version mismatches the application server.
        RemoteException
        Since:
        4.2
      • createTracker

        TrackerSoapDO createTracker​(String sessionId,
                                    String projectId,
                                    String trackerName,
                                    String trackerTitle,
                                    String trackerDescription,
                                    String icon)
                             throws RemoteException
        Deprecated.
        use createTracker3 instead, which includes tracker unit and autosum foreign children support
        Creates a new tracker with an icon
        Parameters:
        sessionId - User session id.
        projectId - The id of the project under which to create the new tracker
        trackerName - The name of the new tracker
        trackerTitle - The title of the new tracker
        trackerDescription - The description of the new tracker
        icon - The tracker icon (null or something between "icon_01.png" and "icon_99.png")
        Returns:
        the tracker soap object
        Throws:
        InvalidSessionFault - when the specified session id is invalid.
        PermissionDeniedFault - when the user has insufficient privileges.
        SystemFault - when an unexpected system error occurs.
        NoSuchObjectFault - when the specified object id is invalid or icon could not be found.
        ObjectAlreadyExistsFault - if an existing tracker already exists
        RemoteException
        Since:
        4.3-HOTFIX1
      • createTracker2

        Tracker2SoapDO createTracker2​(String sessionId,
                                      String projectId,
                                      String trackerName,
                                      String trackerTitle,
                                      String trackerDescription,
                                      String icon,
                                      String trackerUnitId)
                               throws RemoteException
        Deprecated.
        use createTracker3 instead, which includes foreign children support
        Creates a new tracker with an icon
        Parameters:
        sessionId - User session id.
        projectId - The id of the project under which to create the new tracker
        trackerName - The name of the new tracker
        trackerTitle - The title of the new tracker
        trackerDescription - The description of the new tracker
        icon - The tracker icon (null or something between "icon_01.png" and "icon_99.png")
        trackerUnitId - The tracker unit
        Returns:
        the tracker soap object
        Throws:
        InvalidSessionFault - when the specified session id is invalid.
        PermissionDeniedFault - when the user has insufficient privileges.
        SystemFault - when an unexpected system error occurs.
        NoSuchObjectFault - when the specified object id is invalid or icon could not be found.
        ObjectAlreadyExistsFault - if an existing tracker already exists
        RemoteException
        Since:
        6.2
      • createTracker3

        Tracker3SoapDO createTracker3​(String sessionId,
                                      String projectId,
                                      String trackerName,
                                      String trackerTitle,
                                      String trackerDescription,
                                      String icon,
                                      String trackerUnitId,
                                      boolean autosumForeignChildren)
                               throws RemoteException
        Creates a new tracker with autosum foreign children support
        Parameters:
        sessionId - User session id.
        projectId - The id of the project under which to create the new tracker
        trackerName - The name of the new tracker
        trackerTitle - The title of the new tracker
        trackerDescription - The description of the new tracker
        icon - The tracker icon (null or something between "icon_01.png" and "icon_99.png")
        trackerUnitId - The tracker unit
        autosumForeignChildren - The flag indicating whether the autosum calculation of effort and points includes children from foreign projects
        Returns:
        the tracker soap object
        Throws:
        InvalidSessionFault - when the specified session id is invalid.
        PermissionDeniedFault - when the user has insufficient privileges.
        SystemFault - when an unexpected system error occurs.
        NoSuchObjectFault - when the specified object id is invalid or icon could not be found.
        ObjectAlreadyExistsFault - if an existing tracker already exists
        IllegalArgumentFault - if the arguments are incorrectly specified
        RemoteException
        Since:
        8.0
      • addTextField

        void addTextField​(String sessionId,
                          String trackerId,
                          String fieldName,
                          int displayColumns,
                          int displayLines,
                          boolean isRequired,
                          boolean isDisabled,
                          boolean isHiddenOnCreate,
                          String defaultValue,
                          String helpText,
                          String pattern)
                   throws RemoteException
        Adds a custom text field to a tracker.
        Parameters:
        sessionId - User session id.
        trackerId - The tracker to add the field to.
        fieldName - the name of the field
        displayColumns - the width of the display area
        displayLines - the height of the display area
        isRequired - if the field is required
        isDisabled - if the field is disabled
        isHiddenOnCreate - if the field is hidden when first created
        defaultValue - default value
        helpText - The help text for the field
        pattern - The field validation pattern
        Throws:
        NoSuchObjectFault - when the specified object id or fieldData is invalid
        InvalidSessionFault - when the specified session id is invalid.
        PermissionDeniedFault - when the user has insufficient privileges.
        VersionMismatchFault - if the object has been updated since this fieldDO was fetched
        IllegalArgumentFault - if the arguments are incorrectly specified
        InvalidOperationFault - if the operation is not allowed
        SystemFault - when an unexpected system error occurs.
        RemoteException
        Since:
        4.3-HOTFIX1
      • addSingleSelectChildField

        void addSingleSelectChildField​(String sessionId,
                                       String trackerId,
                                       String fieldName,
                                       String[] fieldValues,
                                       String parentFieldId,
                                       SoapNamedValues parentChildFieldValueMap,
                                       String helpText)
                                throws RemoteException
        Adds a custom single select field to a tracker.
        Parameters:
        sessionId - User session id.
        trackerId - The tracker to add the field to.
        fieldName - the name of the field
        fieldValues - Array of valid field values
        parentFieldId - The id of the parent field
        parentChildFieldValueMap - soapNamedValues which keeps mapping between parent field values and child values
        helpText - the help text for the field
        Throws:
        NoSuchObjectFault - when the specified object id or fieldData is invalid
        InvalidSessionFault - when the specified session id is invalid.
        PermissionDeniedFault - when the user has insufficient privileges.
        VersionMismatchFault - if the object has been updated since this fieldDO was fetched
        IllegalArgumentFault - if the arguments are incorrectly specified
        InvalidOperationFault - if the operation is not allowed
        SystemFault - when an unexpected system error occurs.
        RemoteException
        Since:
        5.4.1
      • addSingleSelectField

        void addSingleSelectField​(String sessionId,
                                  String trackerId,
                                  String fieldName,
                                  boolean isRequired,
                                  boolean isDisabled,
                                  boolean isHiddenOnCreate,
                                  String[] fieldValues,
                                  String defaultValue,
                                  String helpText)
                           throws RemoteException
        Adds a custom single select field to a tracker.
        Parameters:
        sessionId - User session id.
        trackerId - The tracker to add the field to.
        fieldName - the name of the field
        isRequired - if the field is required
        isDisabled - if the field is disabled
        isHiddenOnCreate - if the field is hidden when first created
        fieldValues - Array of valid field values
        defaultValue - default value
        helpText - the help text for the field
        Throws:
        NoSuchObjectFault - when the specified object id or fieldData is invalid
        InvalidSessionFault - when the specified session id is invalid.
        PermissionDeniedFault - when the user has insufficient privileges.
        VersionMismatchFault - if the object has been updated since this fieldDO was fetched
        IllegalArgumentFault - if the arguments are incorrectly specified
        InvalidOperationFault - if the operation is not allowed
        SystemFault - when an unexpected system error occurs.
        RemoteException
        Since:
        4.3-HOTFIX1
      • addMultiSelectField

        void addMultiSelectField​(String sessionId,
                                 String trackerId,
                                 String fieldName,
                                 int displayLines,
                                 boolean isRequired,
                                 boolean isDisabled,
                                 boolean isHiddenOnCreate,
                                 String[] fieldValues,
                                 String[] defaultValues,
                                 String helpText)
                          throws RemoteException
        Adds a custom multi select field to a tracker.
        Parameters:
        sessionId - User session id.
        trackerId - The tracker to add the field to.
        fieldName - the name of the field
        displayLines - the height of the display area
        isRequired - if the field is required
        isDisabled - if the field is disabled
        isHiddenOnCreate - if the field is hidden when first created
        fieldValues - possible values
        defaultValues - default values
        helpText - the help text for the field
        Throws:
        NoSuchObjectFault - when the specified object id or fieldData is invalid
        InvalidSessionFault - when the specified session id is invalid.
        PermissionDeniedFault - when the user has insufficient privileges.
        VersionMismatchFault - if the object has been updated since this fieldDO was fetched
        IllegalArgumentFault - if the arguments are incorrectly specified
        InvalidOperationFault - if the operation is not allowed
        SystemFault - when an unexpected system error occurs.
        RemoteException
        Since:
        4.3-HOTFIX1
      • addDateField

        void addDateField​(String sessionId,
                          String trackerId,
                          String fieldName,
                          boolean isRequired,
                          boolean isDisabled,
                          boolean isHiddenOnCreate,
                          String helpText)
                   throws RemoteException
        Adds a custom Date field to a tracker.
        Parameters:
        sessionId - User session id.
        trackerId - The tracker to add the field to.
        fieldName - the name of the field
        isRequired - if the field is required
        isDisabled - if the field is disabled
        isHiddenOnCreate - if the field is hidden when first created
        helpText - the help text of the field
        Throws:
        NoSuchObjectFault - when the specified object id or fieldData is invalid
        InvalidSessionFault - when the specified session id is invalid.
        PermissionDeniedFault - when the user has insufficient privileges.
        VersionMismatchFault - if the object has been updated since this fieldDO was fetched
        IllegalArgumentFault - if the arguments are incorrectly specified
        InvalidOperationFault - if the operation is not allowed
        SystemFault - when an unexpected system error occurs.
        RemoteException
        Since:
        4.3-SP1
      • reorderTrackerFields

        void reorderTrackerFields​(String sessionId,
                                  String trackerId,
                                  String[] layoutIds)
                           throws RemoteException
        Sets a new order of the fields and the separators within a tracker.
        Parameters:
        sessionId - User session id.
        trackerId - Id of tracker which all the fields and the separators belong to.
        layoutIds - An array of layout ids which can be obtained by getOrderedTrackerFields().
        Throws:
        InvalidSessionFault - When the specified session id is invalid.
        NoSuchObjectFault - When any of the specified object id is invalid.
        IllegalArgumentFault - If invalid argument value is passed.
        PermissionDeniedFault - When the user has insufficient privileges.
        SystemFault - When an unexpected system level error occurs.
        RemoteException
        Since:
        5.4.1
      • getArtifactList

        ArtifactSoapList getArtifactList​(String sessionId,
                                         String containerId,
                                         SoapFilter[] filters)
                                  throws RemoteException
        Deprecated.
        in fovor of getArtifactList2
        Returns a filtered list of artifacts within the specified container (project or tracker).
        Parameters:
        sessionId - User session id.
        containerId - ID of a project or a tracker.
        filters - Array of filters to apply (null to return unfiltered list).
        Returns:
        List of filtered artifacts.
        Throws:
        InvalidSessionFault - when the specified session id is invalid.
        NoSuchObjectFault - when the specified object id is invalid.
        PermissionDeniedFault - when the user has insufficient privileges.
        InvalidFilterFault - when the specified filters are invalid.
        SystemFault - when an unexpected system error occurs.
        RemoteException
        Since:
        4.1
      • getCrossTrackerArtifactList

        ArtifactDetailSoapList getCrossTrackerArtifactList​(String sessionId,
                                                           String containerId,
                                                           SoapFilter[] filters,
                                                           String[] selectedColumns)
                                                    throws RemoteException
        Deprecated.
        in favor of getCrossTrackerArtifactList2
        Returns a filtered list of artifacts within the specified container (project or tracker).
        Parameters:
        sessionId - User session id.
        containerId - ID of a project or a tracker. (should not be null)
        filters - Array of filters to apply (null to return unfiltered list).
        selectedColumns - String array of column names to be selected (null to return all columns).
        Returns:
        List of filtered artifacts.
        Throws:
        InvalidSessionFault - when the specified session id is invalid.
        NoSuchObjectFault - when the specified object id is invalid.
        PermissionDeniedFault - when the user has insufficient privileges.
        InvalidFilterFault - when the specified filters are invalid.
        SystemFault - when an unexpected system error occurs.
        RemoteException
        Since:
        5.3
      • getCrossTrackerArtifactList2

        ArtifactDetail2SoapList getCrossTrackerArtifactList2​(String sessionId,
                                                             String containerId,
                                                             SoapFilter[] filters,
                                                             String[] selectedColumns)
                                                      throws RemoteException
        Returns a filtered list of artifacts within the specified container (project or tracker).
        Parameters:
        sessionId - User session id.
        containerId - ID of a project or a tracker. (should not be null)
        filters - Array of filters to apply (null to return unfiltered list).
        selectedColumns - String array of column names to be selected (null to return all columns).
        Returns:
        List of filtered artifacts.
        Throws:
        InvalidSessionFault - when the specified session id is invalid.
        NoSuchObjectFault - when the specified object id is invalid.
        PermissionDeniedFault - when the user has insufficient privileges.
        InvalidFilterFault - when the specified filters are invalid.
        SystemFault - when an unexpected system error occurs.
        RemoteException
        Since:
        8.0
      • getArtifactDetailList

        ArtifactDetailSoapList getArtifactDetailList​(String sessionId,
                                                     String trackerId,
                                                     String[] selectedColumns,
                                                     SoapFilter[] filters,
                                                     SoapSortKey[] sortKeys,
                                                     int startIndex,
                                                     int maxRows,
                                                     boolean exceptionIfExpiredCache,
                                                     boolean forceNewQuery)
                                              throws RemoteException
        Deprecated.
        in favor of getArtifactDetailList2
        Returns a filtered and ordered list of artifacts from the specified tracker.
        Parameters:
        sessionId - User session id.
        trackerId - Tracker id.
        selectedColumns - String array of column names to be selected (null to return all columns).
        filters - Array of filters to apply (null to return unfiltered list).
        sortKeys - Array of SortKey to apply
        startIndex - The index from which to return the results.
        maxRows - The max quantity of elements to be returned (-1 will return the full list).
        exceptionIfExpiredCache - Causes the method to throw an exception if it doesn't have the result in the cache
        forceNewQuery - force the re-execution of the query, ignoring any cached copy of the search result.
        Returns:
        List of filtered artifacts.
        Throws:
        InvalidSessionFault - when the specified session id is invalid.
        NoSuchObjectFault - when the specified object id is invalid.
        PermissionDeniedFault - when the user has insufficient privileges.
        InvalidFilterFault - when the specified filters are invalid.
        SystemFault - when an unexpected system error occurs.
        RemoteException
        Since:
        4.3-HOTFIX1
      • getArtifactDetailList2

        ArtifactDetail2SoapList getArtifactDetailList2​(String sessionId,
                                                       String trackerId,
                                                       String[] selectedColumns,
                                                       SoapFilter[] filters,
                                                       SoapSortKey[] sortKeys,
                                                       int startIndex,
                                                       int maxRows,
                                                       boolean exceptionIfExpiredCache,
                                                       boolean forceNewQuery)
                                                throws RemoteException
        Returns a filtered and ordered list of artifacts from the specified tracker.
        Parameters:
        sessionId - User session id.
        trackerId - Tracker id.

        See ArtifactSoapDO for filters names constant values

        sortKeys - Array of SortKey to apply (null to return a default order list that is by ID).
        startIndex - The index from which to return the results.
        maxRows - The max quantity of elements to be returned (-1 will return the full list).
        exceptionIfExpiredCache - Causes the method to throw exception if it doesn't have the results in the cache
        forceNewQuery - force the re-execution of the query, ignoring any cached copy of the search result.
        Returns:
        List of filtered artifacts.
        Throws:
        InvalidSessionFault - when the specified session id is invalid.
        NoSuchObjectFault - when the specified object id is invalid.
        PermissionDeniedFault - when the user has insufficient privileges.
        InvalidFilterFault - when the specified filters are invalid.
        SystemFault - when an unexpected system error occurs.
        RemoteException
        Since:
        8.0
      • findArtifacts

        ArtifactSoapList findArtifacts​(String sessionId,
                                       String queryString,
                                       String projectId,
                                       boolean searchAttachments)
                                throws RemoteException
        Deprecated.
        in favor of findArtifacts2
        Finds a list of artifacts matching a search string.
        Parameters:
        sessionId - User session id.
        queryString - Query string.
        projectId - The project in which to find artifacts. (if null, search all projects)
        searchAttachments - Whether to search attachments.
        Returns:
        List of artifacts matching search criteria.
        Throws:
        InvalidSessionFault - when the specified session id is invalid.
        NoSuchObjectFault - when the specified project id is invalid.
        SearchQuerySyntaxFault - when the specified search query string is syntactically invalid.
        IllegalArgumentFault - when the specified query string is invalid.
        SystemFault - when an unexpected system level error occurs.
        RemoteException
        Since:
        4.1
      • findArtifacts2

        Artifact2SoapList findArtifacts2​(String sessionId,
                                         String queryString,
                                         String projectId,
                                         boolean searchAttachments)
                                  throws RemoteException
        Finds a list of artifacts matching a search string.
        Parameters:
        sessionId - User session id.
        queryString - Query string.
        projectId - The project in which to find artifacts. (if null, search all projects)
        searchAttachments - Whether to search attachments.
        Returns:
        List of artifacts matching search criteria.
        Throws:
        InvalidSessionFault - when the specified session id is invalid.
        NoSuchObjectFault - when the specified project id is invalid.
        SearchQuerySyntaxFault - when the specified search query string is syntactically invalid.
        IllegalArgumentFault - when the specified query string is invalid.
        SystemFault - when an unexpected system level error occurs.
        RemoteException
        Since:
        8.0
      • getArtifactData

        ArtifactSoapDO getArtifactData​(String sessionId,
                                       String artifactId)
                                throws RemoteException
        Deprecated.
        in favor of getArtifactData3
        Returns data associated with the specified artifact.
        Parameters:
        sessionId - User session id.
        artifactId - Artifact id.
        Returns:
        the data associated with the artifact at the given path
        Throws:
        InvalidSessionFault - when the specified session id is invalid.
        NoSuchObjectFault - when the specified object id is invalid.
        PermissionDeniedFault - when the user has insufficient privileges.
        SystemFault - when an unexpected system error occurs.
        RemoteException
        Since:
        4.1
      • createArtifact

        ArtifactSoapDO createArtifact​(String sessionId,
                                      String trackerId,
                                      String title,
                                      String description,
                                      String group,
                                      String category,
                                      String status,
                                      String customer,
                                      int priority,
                                      int estimatedEffort,
                                      int remainingEffort,
                                      boolean autosumming,
                                      int points,
                                      String assignedUsername,
                                      String releaseId,
                                      String planningFolderId,
                                      SoapFieldValues flexFields,
                                      String attachmentFileName,
                                      String attachmentMimeType,
                                      String attachmentFileId)
                               throws RemoteException
        Deprecated.
        in favor of createArtifact4
        Creates a new artifact.
        Parameters:
        sessionId - User session id.
        trackerId - Tracker id.
        title - Artifact title.
        description - Artifact description.
        group - Artifact group.
        category - Artifact category.
        status - Artifact status.
        customer - Customer.
        priority - Artifact priority.
        estimatedEffort - Estimated effort to close artifact.
        remainingEffort - Remaining effort to close artifact.
        autosumming - Determines whether autosumming should be enabled for the newly created artifact.
        points - The story points for this artifact.
        assignedUsername - User this artifact should be assigned to.
        releaseId - Release this artifact is assigned with.
        planningFolderId - planning folder, this artifact belongs to
        flexFields - Flex field values.
        attachmentFileName - Name of the attached file (or null)
        attachmentMimeType - Mime type of the attached file (or null)
        attachmentFileId - ID of the attached file (previously uploaded via *FileStorage service) or null
        Returns:
        Newly created artifact object.
        Throws:
        InvalidSessionFault - when the specified session id is invalid.
        NoSuchObjectFault - when the specified object id is invalid.
        PermissionDeniedFault - when the user has insufficient privileges.
        IllegalArgumentFault - when the artifact data is invalid.
        InconsistentFieldValueFault - when field hierarchy has been changed and the values are no longer valid
        SystemFault - when an unexpected system error occurs.
        RemoteException
        Since:
        4.2
      • createArtifact2

        ArtifactSoapDO createArtifact2​(String sessionId,
                                       String trackerId,
                                       String title,
                                       String description,
                                       String group,
                                       String category,
                                       String status,
                                       String customer,
                                       int priority,
                                       int estimatedEffort,
                                       int remainingEffort,
                                       boolean autosumming,
                                       int points,
                                       String assignedUsername,
                                       String releaseId,
                                       String planningFolderId,
                                       SoapFieldValues flexFields,
                                       AttachmentSoapDO[] attachments)
                                throws RemoteException
        Deprecated.
        in favor of createArtifact4
        Creates a new artifact with multiple attachments.
        Parameters:
        sessionId - User session id.
        trackerId - Tracker id.
        title - Artifact title.
        description - Artifact description.
        group - Artifact group.
        category - Artifact category.
        status - Artifact status.
        customer - Customer.
        priority - Artifact priority.
        estimatedEffort - Estimated effort to close artifact.
        remainingEffort - Remaining effort to close artifact.
        autosumming - Determines whether autosumming should be enabled for the newly created artifact.
        points - The story points for this artifact.
        assignedUsername - User this artifact should be assigned to.
        releaseId - Release this artifact is assigned with.
        planningFolderId - planning folder, this artifact belongs to
        flexFields - Flex field values.
        attachments - attached file List (or null)
        Returns:
        Newly created artifact object.
        Throws:
        InvalidSessionFault - when the specified session id is invalid.
        NoSuchObjectFault - when the specified object id is invalid.
        PermissionDeniedFault - when the user has insufficient privileges.
        IllegalArgumentFault - when the artifact data is invalid.
        InconsistentFieldValueFault - when field hierarchy has been changed and the values are no longer valid
        SystemFault - when an unexpected system error occurs.
        RemoteException
        Since:
        6.2
      • createArtifact3

        Artifact2SoapDO createArtifact3​(String sessionId,
                                        String trackerId,
                                        String title,
                                        String description,
                                        String group,
                                        String category,
                                        String status,
                                        String customer,
                                        int priority,
                                        int estimatedEffort,
                                        int remainingEffort,
                                        boolean autosumming,
                                        int points,
                                        boolean autoSummingPoints,
                                        String assignedUsername,
                                        String releaseId,
                                        String planningFolderId,
                                        String teamId,
                                        SoapFieldValues flexFields,
                                        AttachmentSoapDO[] attachments)
                                 throws RemoteException
        Deprecated.
        in favor of createArtifact4
        Creates a new artifact with multiple attachments and flag to enable the autosumming_points.
        Parameters:
        sessionId - User session id.
        trackerId - Tracker id.
        title - Artifact title.
        description - Artifact description.
        group - Artifact group.
        category - Artifact category.
        status - Artifact status.
        customer - Customer.
        priority - Artifact priority.
        estimatedEffort - Estimated effort to close artifact. This will be ignored if autosumming is set to true.
        remainingEffort - Remaining effort to close artifact. This will be ignored if autosumming is set to true.
        autosumming - Determines whether autosumming should be enabled for the newly created artifact.
        points - The story points for this artifact. This will be ignored if autoSummingPoints is set to true.
        autoSummingPoints - Determines whether autoSummingPoints should be enabled for the newly created artifact.
        assignedUsername - User this artifact should be assigned to.
        releaseId - Release this artifact is assigned with.
        planningFolderId - planning folder, this artifact belongs to
        teamId - team, this artifact belongs to
        flexFields - Flex field values.
        attachments - attached file List (or null)
        Returns:
        Newly created artifact object.
        Throws:
        InvalidSessionFault - when the specified session id is invalid.
        NoSuchObjectFault - when the specified object id is invalid.
        PermissionDeniedFault - when the user has insufficient privileges.
        IllegalArgumentFault - when the artifact data is invalid.
        InconsistentFieldValueFault - when field hierarchy has been changed and the values are no longer valid
        SystemFault - when an unexpected system error occurs.
        RemoteException
        Since:
        8.0
      • createArtifact4

        Artifact3SoapDO createArtifact4​(String sessionId,
                                        String trackerId,
                                        String title,
                                        String description,
                                        String group,
                                        String category,
                                        String status,
                                        String customer,
                                        int priority,
                                        int estimatedEffort,
                                        int remainingEffort,
                                        boolean autosumming,
                                        int points,
                                        boolean autoSummingPoints,
                                        String assignedUsername,
                                        String releaseId,
                                        String planningFolderId,
                                        String teamId,
                                        SoapFieldValues flexFields,
                                        AttachmentSoapDO[] attachments,
                                        String[] tagNames)
                                 throws RemoteException
        Creates a new artifact with multiple attachments, flag to enable the autosumming_points and tags.
        Parameters:
        sessionId - User session id.
        trackerId - Tracker id.
        title - Artifact title.
        description - Artifact description.
        group - Artifact group.
        category - Artifact category.
        status - Artifact status.
        customer - Customer.
        priority - Artifact priority.
        estimatedEffort - Estimated effort to close artifact. This will be ignored if autosumming is set to true.
        remainingEffort - Remaining effort to close artifact. This will be ignored if autosumming is set to true.
        autosumming - Determines whether autosumming should be enabled for the newly created artifact.
        points - The story points for this artifact. This will be ignored if autoSummingPoints is set to true.
        autoSummingPoints - Determines whether autoSummingPoints should be enabled for the newly created artifact.
        assignedUsername - User this artifact should be assigned to.
        releaseId - Release this artifact is assigned with.
        planningFolderId - planning folder, this artifact belongs to
        teamId - team, this artifact belongs to
        flexFields - Flex field values.
        attachments - attached file List (or null)
        tagNames - tag names
        Returns:
        Newly created artifact object.
        Throws:
        InvalidSessionFault - when the specified session id is invalid.
        NoSuchObjectFault - when the specified object id is invalid.
        PermissionDeniedFault - when the user has insufficient privileges.
        SystemFault - when an unexpected system error occurs.
        IllegalArgumentFault - when the artifact data is invalid.
        InconsistentFieldValueFault - when field hierarchy has been changed and the values are no longer valid
        RemoteException
        Since:
        17.4
      • cloneTrackerAcrossProject

        Tracker2SoapDO cloneTrackerAcrossProject​(String sessionId,
                                                 String srcTrackerId,
                                                 String destProjectId,
                                                 String destTrackerTitle,
                                                 String destTrackerDescription)
                                          throws RemoteException
        Clone Tracker across the project
        Parameters:
        sessionId - User session id.
        srcTrackerId - Tracker id.
        destProjectId - on which project you need to create a tracker
        destTrackerTitle - destination tracker title
        destTrackerDescription - destination tracker description
        Returns:
        returns cloned tracker
        Throws:
        InvalidSessionFault - when the specified session id is invalid.
        NoSuchObjectFault - when the specified object id is invalid.
        PermissionDeniedFault - when the user has insufficient privileges.
        ObjectAlreadyExistsFault - if an existing tracker already exists.
        SystemFault - when an unexpected system level error occurs.
        RemoteException
        Since:
        8.0
      • setArtifactRank

        void setArtifactRank​(String sessionId,
                             String planningFolderId,
                             String artfToRankId,
                             String artfBeforeId,
                             String artfAfterId)
                      throws RemoteException
        Sets the rank of an artifact relative to one or more other artifacts
        Parameters:
        sessionId - User session id.
        planningFolderId - the id of the planning folder in which we are doing the rank
        artfToRankId - the artifact to rank
        artfBeforeId - the artifact that should be before it
        artfAfterId - the artifact that should be after it
        Throws:
        NoSuchObjectFault - when one of the specified object id is invalid.
        IllegalArgumentFault - when the specified id is invalid.
        InvalidSessionFault - when the specified session id is invalid.
        PermissionDeniedFault - when the user has insufficient privileges.
        SystemFault - when an unexpected system level error occurs.
        InvalidRankFault - when the requested rank operation is invalid
        RemoteException
        Since:
        5.4