Skip navigation links
com.collabnet.ce.soap60.webservices.tracker

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:
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.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:
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system error occurs.
        RemoteException
        Since:
        6.2
      • getTracker3List

        Tracker3SoapList getTracker3List(String sessionId,
                                         String projectId)
                                  throws RemoteException
        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:
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system error occurs.
        RemoteException
        Since:
        8.0
      • 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:
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.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:
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system error occurs.
        RemoteException
        Since:
        "6.2"
      • getTracker3Data

        Tracker3SoapDO getTracker3Data(String sessionId,
                                       String trackerId)
                                throws RemoteException
        Returns a data object for a given tracker
        Parameters:
        sessionId - User session id.
        trackerId - Tracker id.
        Returns:
        Detailed data on the tracker.
        Throws:
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system error occurs.
        RemoteException
        Since:
        8.0
      • 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, using this method and not setTracker2Data will reset the tracker unit to the default
        Parameters:
        sessionId - User session id.
        trackerData - Detailed data on the tracker to set.
        Throws:
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id is invalid or field or icon could not be found.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system error occurs.
        com.collabnet.ce.soap60.fault.IllegalArgumentFault - when invalid data is specified.
        com.collabnet.ce.soap60.fault.VersionMismatchFault - when the object version mismatches the application server.
        RemoteException
        Since:
        4.2
      • setTracker2Data

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

        void setTracker3Data(String sessionId,
                             Tracker3SoapDO trackerData)
                      throws RemoteException
        Sets data on a specific tracker with autosum foreign children support
        Parameters:
        sessionId - User session id.
        trackerData - Detailed data on the tracker to set.
        Throws:
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id is invalid or field or icon could not be found.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system error occurs.
        com.collabnet.ce.soap60.fault.IllegalArgumentFault - when invalid data is specified.
        com.collabnet.ce.soap60.fault.VersionMismatchFault - when the object version mismatches the application server.
        RemoteException
        Since:
        8.0
      • 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:
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system error occurs.
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id is invalid or icon could not be found.
        com.collabnet.ce.soap60.fault.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:
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system error occurs.
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id is invalid or icon could not be found.
        com.collabnet.ce.soap60.fault.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:
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system error occurs.
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id is invalid or icon could not be found.
        com.collabnet.ce.soap60.fault.ObjectAlreadyExistsFault - if an existing tracker already exists
        com.collabnet.ce.soap60.fault.IllegalArgumentFault - if the arguments are incorrectly specified
        RemoteException
        Since:
        8.0
      • setField

        void setField(String sessionId,
                      String objectId,
                      TrackerFieldSoapDO fieldData)
               throws RemoteException
        Deprecated. use setField2 instead
        Sets a custom/flex-field that is associated with a specific folder (e.g. tracker). This method was introduced to be able to set properties of the help text in TeamForge 5.4.1
        Parameters:
        sessionId - User session id.
        objectId - Object (e.g. tracker) for which to set the field information.
        fieldData - the custom/flex-field to associate with a specific folder
        Throws:
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id or fieldData is invalid
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.VersionMismatchFault - if the object has been updated since this fieldDO was fetched
        com.collabnet.ce.soap60.fault.IllegalArgumentFault - if the arguments are incorrectly specified. See FaultSummary for detail for the following: - DUPLICATE_FIELD_VALUE - ILLEGAL_FIELD_VALUE - INVALID_FIELD_VALUE - INVALID_DEFAULT_VALUE - INVALID_FIELD_OPTIONS_REQUIRED_DISABLED - INVALID_FIELD_VALUE_LENGTH - REQUIRED_FIELD_MISSING - INVALID_FIELD_PATTERN
        com.collabnet.ce.soap60.fault.InvalidOperationFault - if the operation is not allowed. See FaultSummary for detail for the following: - INVALID_OPTION_DISABLE_RESERVED_FIELD - INVALID_OPTION_DISABLE_IN_USE_FIELD
        com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system error occurs.
        com.collabnet.ce.soap60.fault.DependencyViolationFault - if changing a status violates artifact dependency
        RemoteException
        Since:
        4.3-HOTFIX1
        See Also:
        FaultSummary
      • setField2

        void setField2(String sessionId,
                       String objectId,
                       TrackerField2SoapDO fieldData)
                throws RemoteException
        Sets a custom/flex-field that is associated with a specific folder (e.g. tracker). This method was introduced to be able to set properties of the tracker field and also supporting to set the field role filters for the 'assignedTo' field
        Parameters:
        sessionId - User session id.
        objectId - Object (e.g. tracker) for which to set the field information.
        fieldData - the custom/flex-field to associate with a specific folder
        Throws:
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id or fieldData is invalid
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.VersionMismatchFault - if the object has been updated since this fieldDO was fetched
        com.collabnet.ce.soap60.fault.IllegalArgumentFault - if the arguments are incorrectly specified. See FaultSummary for detail for the following: - DUPLICATE_FIELD_VALUE - ILLEGAL_FIELD_VALUE - INVALID_FIELD_VALUE - INVALID_DEFAULT_VALUE - INVALID_FIELD_OPTIONS_REQUIRED_DISABLED - INVALID_FIELD_VALUE_LENGTH - REQUIRED_FIELD_MISSING - INVALID_FIELD_PATTERN
        com.collabnet.ce.soap60.fault.InvalidOperationFault - if the operation is not allowed. See FaultSummary for detail for the following: - INVALID_OPTION_DISABLE_RESERVED_FIELD - INVALID_OPTION_DISABLE_IN_USE_FIELD
        com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system error occurs.
        com.collabnet.ce.soap60.fault.DependencyViolationFault - if changing a status violates artifact dependency
        RemoteException
        Since:
        16.7
        See Also:
        FaultSummary
      • 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:
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id or fieldData is invalid
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.VersionMismatchFault - if the object has been updated since this fieldDO was fetched
        com.collabnet.ce.soap60.fault.IllegalArgumentFault - if the arguments are incorrectly specified
        com.collabnet.ce.soap60.fault.InvalidOperationFault - if the operation is not allowed
        com.collabnet.ce.soap60.fault.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,
                                       com.collabnet.ce.soap60.types.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:
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id or fieldData is invalid
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.VersionMismatchFault - if the object has been updated since this fieldDO was fetched
        com.collabnet.ce.soap60.fault.IllegalArgumentFault - if the arguments are incorrectly specified
        com.collabnet.ce.soap60.fault.InvalidOperationFault - if the operation is not allowed
        com.collabnet.ce.soap60.fault.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:
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id or fieldData is invalid
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.VersionMismatchFault - if the object has been updated since this fieldDO was fetched
        com.collabnet.ce.soap60.fault.IllegalArgumentFault - if the arguments are incorrectly specified
        com.collabnet.ce.soap60.fault.InvalidOperationFault - if the operation is not allowed
        com.collabnet.ce.soap60.fault.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:
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id or fieldData is invalid
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.VersionMismatchFault - if the object has been updated since this fieldDO was fetched
        com.collabnet.ce.soap60.fault.IllegalArgumentFault - if the arguments are incorrectly specified
        com.collabnet.ce.soap60.fault.InvalidOperationFault - if the operation is not allowed
        com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system error occurs.
        RemoteException
        Since:
        4.3-HOTFIX1
      • addUserSelectField

        void addUserSelectField(String sessionId,
                                String trackerId,
                                String fieldName,
                                int displayLines,
                                boolean isRequired,
                                boolean isDisabled,
                                boolean isHiddenOnCreate,
                                String[] defaultValues,
                                String userFilter,
                                String helpText)
                         throws RemoteException
        Adds a custom User selection 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
        defaultValues - default values for this field. Must be valid usernames
        userFilter - is the filter
        helpText - The help text of the field
        Throws:
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id or fieldData is invalid
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.VersionMismatchFault - if the object has been updated since this fieldDO was fetched
        com.collabnet.ce.soap60.fault.IllegalArgumentFault - if the arguments are incorrectly specified
        com.collabnet.ce.soap60.fault.InvalidOperationFault - if the operation is not allowed
        com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system error occurs.
        RemoteException
        Since:
        4.3-SP1
        See Also:
        TrackerFieldSoapDO.FIELD_USER_FILTER_PROJECT_MEMBER, TrackerFieldSoapDO.FIELD_USER_FILTER_ALL
      • 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:
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id or fieldData is invalid
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.VersionMismatchFault - if the object has been updated since this fieldDO was fetched
        com.collabnet.ce.soap60.fault.IllegalArgumentFault - if the arguments are incorrectly specified
        com.collabnet.ce.soap60.fault.InvalidOperationFault - if the operation is not allowed
        com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system error occurs.
        RemoteException
        Since:
        4.3-SP1
      • deleteField

        void deleteField(String sessionId,
                         String objectId,
                         String fieldId)
                  throws RemoteException
        Deletes a custom/flex-field .
        Parameters:
        sessionId - User session id.
        objectId - Object (e.g. tracker).
        fieldId - the id of the field to delete
        Throws:
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id or fieldData is invalid
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.InvalidOperationFault - if the operation is not allowed.
        com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system error occurs.
        RemoteException
        Since:
        4.3-HOTFIX1
      • getFields

        TrackerFieldSoapDO[] getFields(String sessionId,
                                       String trackerId)
                                throws RemoteException
        Deprecated. use getFields2 instead
        Returns the custom/flex-fields associated with a specific tracker. This method has been introduced to also return the properties of the planning folder, the actual, estimated and remaining effort fields as well as the autosumming flag.
        Parameters:
        sessionId - User session id.
        trackerId - The tracker for which to return field information.
        Returns:
        Array of all field values.
        Throws:
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id is invalid.
        com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system error occurs.
        RemoteException
        Since:
        4.3-HOTFIX1
      • getFields2

        TrackerField2SoapDO[] getFields2(String sessionId,
                                         String trackerId)
                                  throws RemoteException
        Returns the custom/flex-fields associated with a specific tracker. In addition to the features of getFields api, it returns the field role filters of the field(eg: 'assignedTo' field) in the Tracker
        Parameters:
        sessionId - User session id.
        trackerId - The tracker for which to return field information.
        Returns:
        Array of all field values.
        Throws:
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id is invalid.
        com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system error occurs.
        RemoteException
        Since:
        16.7
      • addSeparator

        void addSeparator(String sessionId,
                          String trackerId,
                          String separatorType,
                          String separatorLabel)
                   throws RemoteException
        Adds a separator to a tracker. The separator will be added at the end of tracker fields. To reorder separator and fields, use getOrderedTrackerFields and reorderTrackerFields.
        Parameters:
        sessionId - User session id.
        trackerId - The tracker to add the separator to.
        separatorType - the type of the separator, either OrderedTrackerFieldSoapRow.ROW_SEPARATOR OrderedTrackerFieldSoapRow.COLUMN_SEPARATOR or OrderedTrackerFieldSoapRow.SECTION_SEPARATOR.
        separatorLabel - the label of the separator
        Throws:
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id is invalid
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.IllegalArgumentFault - if the arguments are incorrectly specified
        com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system error occurs.
        com.collabnet.ce.soap60.fault.ObjectAlreadyExistsFault - if a separator with the same id exists
        RemoteException
        Since:
        5.4.1
      • deleteSeparator

        void deleteSeparator(String sessionId,
                             String trackerId,
                             String layoutId)
                      throws RemoteException
        Deletes a separator of a tracker layout.
        Parameters:
        sessionId - User session id.
        trackerId - The tracker to delete the separator from.
        layoutId - the layout id of the separator. To get the layout id, use getOrderedTrackerFields.
        Throws:
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id is invalid
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.IllegalArgumentFault - if the arguments are incorrectly specified
        com.collabnet.ce.soap60.fault.InvalidOperationFault - if the operation is not allowed
        com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system error occurs.
        RemoteException
        Since:
        5.4.1
      • getOrderedTrackerFields

        OrderedTrackerFieldSoapList getOrderedTrackerFields(String sessionId,
                                                            String trackerId)
                                                     throws RemoteException
        Returns all fields and separators in the given tracker with layout information.
        Parameters:
        sessionId - User session id.
        trackerId - The tracker for which to return field information.
        Returns:
        Array of all fields and separators.
        Throws:
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id is invalid.
        com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system error occurs.
        RemoteException
        Since:
        5.4.1
      • reorderTrackerFields

        void reorderTrackerFields(String sessionId,
                                  String trackerId,
                                  String[] layoutIds)
                           throws RemoteException
        Sets a new order of the fields and the separators within a tracker. The fields and separators will be listed in this new order in UI and in the methods that list the fields and separators in the SOAP calls.
        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(). Layout id is different from field id and some system fields and separators do not have field id but only layout id.
        Throws:
        com.collabnet.ce.soap60.fault.InvalidSessionFault - When the specified session id is invalid.
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - When any of the specified object id is invalid.
        com.collabnet.ce.soap60.fault.IllegalArgumentFault - If invalid argument value is passed.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - When the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.SystemFault - When an unexpected system level error occurs.
        RemoteException
        Since:
        5.4.1
      • getArtifactList

        ArtifactSoapList getArtifactList(String sessionId,
                                         String containerId,
                                         com.collabnet.ce.soap60.types.SoapFilter[] filters)
                                  throws RemoteException
        Deprecated. in fovor of getArtifactList2
        Returns a filtered list of artifacts within the specified container (project or tracker). See ArtifactSoapDO for filter constant values: ArtifactSoapDO.FILTER_ASSIGNED_TO, etc.
        Change History
        Version 4.2
        • Added additional parameter (filters) for filtering artifact lists.
        Version 4.4
        • Added a limit to the number of rows that could be retrieved. This limit is by default 5000 but is configurable
        • it is substantially obsolete by enhancements to getArtifactDetailList(), which now includes the ability to select which columns are returned, as well as the ability to fetch subsets of data on a "paged" basis, and to return sorted results.
        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:
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.InvalidFilterFault - when the specified filters are invalid.
        com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system error occurs.
        RemoteException
        Since:
        4.1
      • getArtifactList2

        Artifact2SoapList getArtifactList2(String sessionId,
                                           String containerId,
                                           com.collabnet.ce.soap60.types.SoapFilter[] filters)
                                    throws RemoteException
        Returns a filtered list of artifacts within the specified container (project or tracker). See ArtifactSoapDO for filter constant values: ArtifactSoapDO.FILTER_ASSIGNED_TO, etc.
        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:
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.InvalidFilterFault - when the specified filters are invalid.
        com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system error occurs.
        RemoteException
        Since:
        8.0
      • getCrossTrackerArtifactList

        ArtifactDetailSoapList getCrossTrackerArtifactList(String sessionId,
                                                           String containerId,
                                                           com.collabnet.ce.soap60.types.SoapFilter[] filters,
                                                           String[] selectedColumns)
                                                    throws RemoteException
        Deprecated. in favor of getCrossTrackerArtifactList2
        Returns a filtered list of artifacts within the specified container (project or tracker). Since this is a cross tracker query, flex fields may not be populated.
        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). See ArtifactSoapDO for column names constant values e.g. ArtifactSoapDO.COLUMN_CATEGORY
        Returns:
        List of filtered artifacts.
        Throws:
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.InvalidFilterFault - when the specified filters are invalid.
        com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system error occurs.
        RemoteException
        Since:
        5.3
      • getCrossTrackerArtifactList2

        ArtifactDetail2SoapList getCrossTrackerArtifactList2(String sessionId,
                                                             String containerId,
                                                             com.collabnet.ce.soap60.types.SoapFilter[] filters,
                                                             String[] selectedColumns)
                                                      throws RemoteException
        Returns a filtered list of artifacts within the specified container (project or tracker). Since this is a cross tracker query, flex fields may not be populated.
        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). See Artifact2SoapDO for column names constant values e.g. Artifact2SoapDO.COLUMN_CATEGORY.
        Returns:
        List of filtered artifacts.
        Throws:
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.InvalidFilterFault - when the specified filters are invalid.
        com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system error occurs.
        RemoteException
        Since:
        8.0
      • getArtifactDetailList

        ArtifactDetailSoapList getArtifactDetailList(String sessionId,
                                                     String trackerId,
                                                     String[] selectedColumns,
                                                     com.collabnet.ce.soap60.types.SoapFilter[] filters,
                                                     com.collabnet.ce.soap60.types.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. It gives the user the ability to ask only for certain results with the parameters startIndex and maxRows. In this way the method can be used to implement paging. A special value of -1 for the maxRows parameter will be interpreted as asking for the complete list. Unlike the corresponding method in earlier versions of the soap interface (soap44, etc.), this method now returns data for all flex fields, whether they have values or not. Flex fields with no values will have NULL values in the values[] array

        This method makes use of server-side caching of the complete list in order to more efficiently return results for requests for subsequent "pages" of data. In normal usage, requesting a subsequent page of a given list will return data from this cache unless the cache has expired, in which case the query will transparently be re-executed before return the results. Note that this transparent re-execution can result in slight inconsistencies in the data, if the underlying data has changed. The exceptionIfExpiredCache and forceNewQuery flags can be used to tune cache behavior.

        Caching is managed transparently by the application server, using the filters and selectedColumns parameters to identify subsequent requests for subsets of the same data set. The cache is associated with the user session. Note that the implementation may choose not to cache results if the entire list is being fetched (via specifying -1 for maxRows).

        Note: You can't sort or filter by a non selected column.

        See ArtifactSoapDO for column and filter names constant values: ArtifactSoapDO.COLUMN_TITLE, ArtifactSoapDO.COLUMN_ASSIGNED_TO, FILTER_PRIORITY, FILTER, FILTER_CATEGORY, etc.

        Parameters:
        sessionId - User session id.
        trackerId - Tracker id.
        selectedColumns - String array of column names to be selected (null to return all columns). See ArtifactSoapDO for column names constant values e.g. ArtifactSoapDO.COLUMN_CATEGORY
        filters - Array of filters to apply (null to return unfiltered list). See ArtifactSoapDO for filters names constant values e.g. ArtifactSoapDO.FILTER_PRIORITY. Valid date formats are SoapFilter.DATE_FORMAT and SoapFilter.DATE_ONLY_FORMAT.
        sortKeys - Array of SortKey to apply (null to return a default order list that is by ID). See ArtifactSoapDO for column names constant values e.g. ArtifactSoapDO.COLUMN_PRIORITY
        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 results in the cache, rather than the default behavior of silently re-executing the query. This can be used if the caller is fetching paged data and wants to be assured that the pages are from one consistent snapshot of the data.
        forceNewQuery - force the re-execution of the query, ignoring any cached copy of the search result.
        Returns:
        List of filtered artifacts.
        Throws:
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.InvalidFilterFault - when the specified filters are invalid.
        com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system error occurs.
        RemoteException
        Since:
        4.3-HOTFIX1
      • getArtifactDetailList2

        ArtifactDetail2SoapList getArtifactDetailList2(String sessionId,
                                                       String trackerId,
                                                       String[] selectedColumns,
                                                       com.collabnet.ce.soap60.types.SoapFilter[] filters,
                                                       com.collabnet.ce.soap60.types.SoapSortKey[] sortKeys,
                                                       int startIndex,
                                                       int maxRows,
                                                       boolean exceptionIfExpiredCache,
                                                       boolean forceNewQuery)
                                                throws RemoteException
        Returns a filtered and ordered list of artifacts from the specified tracker. It gives the user the ability to ask only for certain results with the parameters startIndex and maxRows. In this way the method can be used to implement paging. A special value of -1 for the maxRows parameter will be interpreted as asking for the complete list. Unlike the corresponding method in earlier versions of the soap interface (soap44, etc.), this method now returns data for all flex fields, whether they have values or not. Flex fields with no values will have NULL values in the values[] array

        This method makes use of server-side caching of the complete list in order to more efficiently return results for requests for subsequent "pages" of data. In normal usage, requesting a subsequent page of a given list will return data from this cache unless the cache has expired, in which case the query will transparently be re-executed before return the results. Note that this transparent re-execution can result in slight inconsistencies in the data, if the underlying data has changed. The exceptionIfExpiredCache and forceNewQuery flags can be used to tune cache behavior.

        Caching is managed transparently by the application server, using the filters and selectedColumns parameters to identify subsequent requests for subsets of the same data set. The cache is associated with the user session. Note that the implementation may choose not to cache results if the entire list is being fetched (via specifying -1 for maxRows).

        Note: You can't sort or filter by a non selected column.

        See ArtifactSoapDO for column and filter names constant values: ArtifactSoapDO.COLUM ArtifactSoapDO.COLUMN_ASSIGNED_TO, FILTER_PRIORITY, FILTER, FILTER_CATEGORY, etc.

        Parameters:
        sessionId - User session id.
        trackerId - Tracker id. See ArtifactSoapDO for filters names constant values e.g. ArtifactSoapDO.FILTER_PRIORITY. Valid date formats are SoapFilter.DATE_FORMAT and SoapFilter.DATE_ONLY_FORMAT.
        sortKeys - Array of SortKey to apply (null to return a default order list that is by ID). See ArtifactSoapDO for column names constant values e.g. Artifact2SoapDO.COLUMN_AUTO_SUMMING_POINTS
        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 results in the cache, rather than the default behavior of silently re-executing the query. This can be used if the caller is fetching paged data and wants to be assured that the pages are from one consistent snapshot of the data.
        forceNewQuery - force the re-execution of the query, ignoring any cached copy of the search result.
        Returns:
        List of filtered artifacts.
        Throws:
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.InvalidFilterFault - when the specified filters are invalid.
        com.collabnet.ce.soap60.fault.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:
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified project id is invalid.
        com.collabnet.ce.soap60.fault.SearchQuerySyntaxFault - when the specified search query string is syntactically invalid.
        com.collabnet.ce.soap60.fault.IllegalArgumentFault - when the specified query string is invalid.
        com.collabnet.ce.soap60.fault.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:
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified project id is invalid.
        com.collabnet.ce.soap60.fault.SearchQuerySyntaxFault - when the specified search query string is syntactically invalid.
        com.collabnet.ce.soap60.fault.IllegalArgumentFault - when the specified query string is invalid.
        com.collabnet.ce.soap60.fault.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 getArtifactData2
        Returns data associated with the specified artifact. Unlike the corresponding method in earlier versions of the soap interface (soap44, etc.), this method now returns data for all flex fields, whether they have values or not. Flex fields with no values will have NULL values in the values[] array
        Parameters:
        sessionId - User session id.
        artifactId - Artifact id.
        Returns:
        the data associated with the artifact at the given path
        Throws:
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system error occurs.
        RemoteException
        Since:
        4.1
      • getArtifactData2

        Artifact2SoapDO getArtifactData2(String sessionId,
                                         String artifactId)
                                  throws RemoteException
        Returns data associated with the specified artifact. Unlike the corresponding method in earlier versions of the soap interface (soap44, etc.), this method now returns data for all flex fields, whether they have values or not. Flex fields with no values will have NULL values in the values[] array
        Parameters:
        sessionId - User session id.
        artifactId - Artifact id.
        Returns:
        the data associated with the artifact at the given path
        Throws:
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system error occurs.
        RemoteException
        Since:
        8.0
      • setArtifactData

        void setArtifactData(String sessionId,
                             ArtifactSoapDO artifactData,
                             String comment,
                             String attachmentFileName,
                             String attachmentMimeType,
                             String attachmentFileId)
                      throws RemoteException
        Deprecated. in favor of setArtifactData3
        Sets data associated with the specified artifact.
        Parameters:
        sessionId - User session id.
        artifactData - the data associated with the artifact at the given path
        comment - Comment associated with the change.
        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
        Throws:
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.VersionMismatchFault - when the object data is stale.
        com.collabnet.ce.soap60.fault.IllegalArgumentFault - when the artifact data is invalid.
        com.collabnet.ce.soap60.fault.InconsistentFieldValueFault - when field hierarchy has been changed and the values are no longer valid.
        com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system error occurs.
        com.collabnet.ce.soap60.fault.WorkflowViolationFault - when workflow rule is violated
        com.collabnet.ce.soap60.fault.DependencyViolationFault - when dependency rule is violated
        com.collabnet.ce.soap60.fault.PlanningFolderRuleViolationFault - when planning folder rule is violated
        RemoteException
        Since:
        4.1
      • setArtifactData2

        void setArtifactData2(String sessionId,
                              ArtifactSoapDO artifactData,
                              String comment,
                              AttachmentSoapDO[] attachments)
                       throws RemoteException
        Deprecated. in favor of setArtifactData3
        Sets data associated along with multiple attachments with the specified artifact.
        Parameters:
        sessionId - User session id.
        artifactData - the data associated with the artifact at the given path
        comment - Comment associated with the change.
        attachments - attached file List
        Throws:
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.VersionMismatchFault - when the object data is stale.
        com.collabnet.ce.soap60.fault.IllegalArgumentFault - when the artifact data is invalid.
        com.collabnet.ce.soap60.fault.InconsistentFieldValueFault - when field hierarchy has been changed and the values are no longer valid.
        com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system error occurs.
        com.collabnet.ce.soap60.fault.WorkflowViolationFault - when workflow rule is violated
        com.collabnet.ce.soap60.fault.DependencyViolationFault - when dependency rule is violated
        com.collabnet.ce.soap60.fault.PlanningFolderRuleViolationFault - when planning folder rule is violated
        RemoteException
        Since:
        6.2
      • setArtifactData3

        void setArtifactData3(String sessionId,
                              Artifact2SoapDO artifactData,
                              String comment,
                              AttachmentSoapDO[] attachments)
                       throws RemoteException
        Sets data associated along with multiple attachments with the specified artifact.
        Parameters:
        sessionId - User session id.
        artifactData - the data associated with the artifact at the given path
        comment - Comment associated with the change.
        attachments - attached file List
        Throws:
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.VersionMismatchFault - when the object data is stale.
        com.collabnet.ce.soap60.fault.IllegalArgumentFault - when the artifact data is invalid.
        com.collabnet.ce.soap60.fault.InconsistentFieldValueFault - when field hierarchy has been changed and the values are no longer valid.
        com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system error occurs.
        com.collabnet.ce.soap60.fault.WorkflowViolationFault - when workflow rule is violated
        com.collabnet.ce.soap60.fault.DependencyViolationFault - when dependency rule is violated
        com.collabnet.ce.soap60.fault.PlanningFolderRuleViolationFault - when planning folder rule is violated
        RemoteException
        Since:
        8.0
      • 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,
                                      com.collabnet.ce.soap60.types.SoapFieldValues flexFields,
                                      String attachmentFileName,
                                      String attachmentMimeType,
                                      String attachmentFileId)
                               throws RemoteException
        Deprecated. in favor of createArtifact3
        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:
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.IllegalArgumentFault - when the artifact data is invalid.
        com.collabnet.ce.soap60.fault.InconsistentFieldValueFault - when field hierarchy has been changed and the values are no longer valid
        com.collabnet.ce.soap60.fault.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,
                                       com.collabnet.ce.soap60.types.SoapFieldValues flexFields,
                                       AttachmentSoapDO[] attachments)
                                throws RemoteException
        Deprecated. in favor of createArtifact3
        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:
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.IllegalArgumentFault - when the artifact data is invalid.
        com.collabnet.ce.soap60.fault.InconsistentFieldValueFault - when field hierarchy has been changed and the values are no longer valid
        com.collabnet.ce.soap60.fault.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,
                                        com.collabnet.ce.soap60.types.SoapFieldValues flexFields,
                                        AttachmentSoapDO[] attachments)
                                 throws RemoteException
        Creates a new artifact with calculate the autosumming_point 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. 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:
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.IllegalArgumentFault - when the artifact data is invalid.
        com.collabnet.ce.soap60.fault.InconsistentFieldValueFault - when field hierarchy has been changed and the values are no longer valid
        com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system error occurs.
        RemoteException
        Since:
        8.0
      • moveArtifact

        ArtifactSoapDO moveArtifact(String sessionId,
                                    String artifactId,
                                    String targetFolderId,
                                    String newAssignee)
                             throws RemoteException
        Deprecated. in favor of moveArtifact2
        Moves an artifact to a specified target folder.
        Parameters:
        sessionId - User session id.
        artifactId - ID of artifact to move.
        targetFolderId - Target folder ID.
        newAssignee - The username to assign the newly moved artifact to.
        Returns:
        New artifact data object
        Throws:
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the sessionId is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when permission is denied for the specified operation.
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object is invalid.
        com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system error occurs.
        com.collabnet.ce.soap60.fault.IllegalArgumentFault - when an invalid argument is passed in.
        com.collabnet.ce.soap60.fault.PlanningFolderRuleViolationFault - when planning folder rule is violated
        RemoteException
        Since:
        4.2
      • moveArtifact2

        Artifact2SoapDO moveArtifact2(String sessionId,
                                      String artifactId,
                                      String targetFolderId,
                                      String newAssignee)
                               throws RemoteException
        Moves an artifact to a specified target folder.
        Parameters:
        sessionId - User session id.
        artifactId - ID of artifact to move.
        targetFolderId - Target folder ID.
        newAssignee - The username to assign the newly moved artifact to.
        Returns:
        New artifact data object
        Throws:
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the sessionId is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when permission is denied for the specified operation.
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object is invalid.
        com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system error occurs.
        com.collabnet.ce.soap60.fault.IllegalArgumentFault - when an invalid argument is passed in.
        com.collabnet.ce.soap60.fault.PlanningFolderRuleViolationFault - when planning folder rule is violated
        RemoteException
        Since:
        8.0
      • deleteArtifact

        void deleteArtifact(String sessionId,
                            String artifactId)
                     throws RemoteException
        Deletes an artifact.
        Parameters:
        sessionId - User session id.
        artifactId - Artifact id.
        Throws:
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.
        RemoteException
        Since:
        4.1
      • getAllowedWorkflowTransitionList

        WorkflowTransitionSoapList getAllowedWorkflowTransitionList(String sessionId,
                                                                    String trackerId)
                                                             throws RemoteException
        Gets workflow transitions for the tracker.
        Change History
        Version 4.4 SP 1
        • Added the missing [new artifact] transitions to the list
        • The returning list now will contain [new artifact] transition list with the following format [from value] [to value] null open null close null pending
        Parameters:
        sessionId - User session id.
        trackerId - Tracker id.
        Returns:
        Workflow definitions list. For requiredFields property of workflow definition, following special field IDs are used (in addition to standard field definitions in ArtifactSoapDO): "comment", "attachment", "assignedTo", "priority".
        Throws:
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id is invalid.
        com.collabnet.ce.soap60.fault.SystemFault - when ...
        RemoteException
        Since:
        4.3
      • copyWorkflowTransitions

        void copyWorkflowTransitions(String sessionId,
                                     String srcTrackerId,
                                     String dstTrackerId)
                              throws RemoteException
        Copies workflow transitions between two trackers. In order for this operation to succeed, the following conditions must be met: - caller needs to have tracker admin permission for both srTracker and destTracker - every transition req role in srcTracker must have corresponding role with the same name in dstTracker - every transition req field in srcTracker must have corresponding field with the same name in dstTracker or be a custom field name.
        Parameters:
        sessionId - User session id.
        srcTrackerId - Tracker id.
        dstTrackerId - Tracker id.
        Throws:
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.WorkflowViolationFault - when the copy of workflow transition cannot be completed
        com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.
        RemoteException
        Since:
        4.3-SP1-HOTFIX3
      • cloneTracker

        Tracker2SoapDO cloneTracker(String sessionId,
                                    String srcTrackerId,
                                    String destTrackerTitle,
                                    String destTrackerDescription)
                             throws RemoteException
        Clone Tracker within the same project
        Parameters:
        sessionId - User session id.
        srcTrackerId - Tracker id.
        destTrackerTitle - destination Tracker tile
        destTrackerDescription - destination Tracker description
        Returns:
        returns cloned Tracker
        Throws:
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.ObjectAlreadyExistsFault - if an existing tracker already exists.
        com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.
        RemoteException
        Since:
        8.0
      • 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:
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.ObjectAlreadyExistsFault - if an existing tracker already exists.
        com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.
        RemoteException
        Since:
        8.0
      • createArtifactDependency

        void createArtifactDependency(String sessionId,
                                      String originId,
                                      String targetId,
                                      String desc)
                               throws RemoteException
        Creates an artifact dependency between two artifacts. If an existing artifact dependency already exists, the descriptions are simply overridden.
        Parameters:
        sessionId - User session id.
        originId - Origin artifact id.
        targetId - Target artifact id.
        desc - Description for the dependency.
        Throws:
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.WorkflowViolationFault - when the copy of workflow transition cannot be completed
        com.collabnet.ce.soap60.fault.DependencyViolationFault - when the creation of the dependency causes violation
        com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.
        RemoteException
        Since:
        4.4
      • removeArtifactDependency

        void removeArtifactDependency(String sessionId,
                                      String originId,
                                      String targetId)
                               throws RemoteException
        Removes an artifact dependency between two artifacts.
        Parameters:
        sessionId - User session id.
        originId - Origin artifact id.
        targetId - Target artifact id.
        Throws:
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.WorkflowViolationFault - when the copy of workflow transition cannot be completed
        com.collabnet.ce.soap60.fault.DependencyViolationFault - when the creation of the dependency causes violation
        com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.
        com.collabnet.ce.soap60.fault.NoSuchRelationshipFault - when ...
        RemoteException
        Since:
        4.4
      • 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, in the context of a specific planning folder. If two artifacts are specified for artfBeforeId and artfAfterId, then the moved artifact is placed between them. If only artfBeforeId is specified, the moved artifact is placed after it; if only artfAfterId, the moved artifact is moved before it.

        The ranking will be invalid if it doesn't respect certain rules:

        - artifacts cannot be ranked relative to other artifacts unless at least one of the following is true:

        1. they are children of the same parent
        2. they appear at the top level in the planning folder view, i.e. do not have a parent in the specified planning folder.

        - all specified artifacts must belong to the same project as the specified planning folder.

        As of TeamForge 5.4, this operation requires the Planning Folder Admin permission; edit permission on the trackers involved is not sufficient. In the future, a distinct role permission for rank operations may be defined.

        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:
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when one of the specified object id is invalid.
        com.collabnet.ce.soap60.fault.IllegalArgumentFault - when the specified id is invalid.
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.
        com.collabnet.ce.soap60.fault.InvalidRankFault - when the requested rank operation is invalid
        RemoteException
        Since:
        5.4
      • getChildDependencyList

        ArtifactDependencySoapList getChildDependencyList(String sessionId,
                                                          String artifactId)
                                                   throws RemoteException
        Gets the dependency list for an artifact where the artifact is the origin artifact.
        Parameters:
        sessionId - User session id.
        artifactId - Artifact id.
        Returns:
        dependency list
        Throws:
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.WorkflowViolationFault - when the copy of workflow transition cannot be completed
        com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.
        RemoteException
        Since:
        4.4
      • getParentDependencyList

        ArtifactDependencySoapList getParentDependencyList(String sessionId,
                                                           String artifactId)
                                                    throws RemoteException
        Gets the dependency list for an artifact where the artifact is the target artifact. While in 5.3, an artifact can only have a single parent, that can be changed in future releases.
        Parameters:
        sessionId - User session id.
        artifactId - Artifact id.
        Returns:
        dependency list
        Throws:
        com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified object id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.WorkflowViolationFault - when the copy of workflow transition cannot be completed
        com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.
        RemoteException
        Since:
        4.4
      • reorderTrackers

        void reorderTrackers(String sessionId,
                             String[] trackerIds)
                      throws RemoteException
        Sets a new order of the trackers within a project. The trackers will be listed in this new order in UI and in the methods that list the trackers in the SOAP calls.
        Parameters:
        sessionId - User session id.
        trackerIds - An array of the tracker ids in their new order. All the tracker ids must belong to the same project
        Throws:
        com.collabnet.ce.soap60.fault.InvalidSessionFault - When the specified session id is invalid.
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - When any of the specified object id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - When the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.SystemFault - When an unexpected system level error occurs.
        com.collabnet.ce.soap60.fault.IllegalArgumentFault - If invalid argument value is passed.
        RemoteException
        Since:
        5.4
      • getUnitsByProject

        TrackerUnitSoapList getUnitsByProject(String sessionId,
                                              String projectId)
                                       throws RemoteException
        Gets the units for a given project.
        Parameters:
        sessionId - User session id.
        projectId - The id of the project to retrieve the units
        Throws:
        com.collabnet.ce.soap60.fault.InvalidSessionFault - When the specified session id is invalid.
        com.collabnet.ce.soap60.fault.NoSuchObjectFault - When any of the specified object id is invalid.
        com.collabnet.ce.soap60.fault.PermissionDeniedFault - When the user has insufficient privileges.
        com.collabnet.ce.soap60.fault.SystemFault - When an unexpected system level error occurs.
        com.collabnet.ce.soap60.fault.IllegalArgumentFault - If invalid argument value is passed.
        RemoteException
        Since:
        6.2

Copyright © 2017 CollabNet. All Rights Reserved.