Interface IssueTypeManager

All Known Implementing Classes:
DefaultIssueTypeManager

@PublicApi public interface IssueTypeManager
Manager for IssueTypes.
Since:
v5.0
  • Method Details

    • createIssueType

      @Deprecated IssueType createIssueType(String name, String description, String iconUrl)
      Deprecated.
      Use createIssueType(String, String, Long) instead. Since v6.3.
      Create a new (non-subtask) issue type. The new issue type will be added to the default issue type scheme.
      Parameters:
      name - name of the issue type. Cannot be null or blank. Must be unique across issue types and subtask issue types.
      description - description for the issue type.
      iconUrl - icon URL for the issue type. Cannot be null or blank.
      Returns:
      the new IssueType
    • createIssueType

      IssueType createIssueType(String name, String description, Long avatarId)
      Create a new (non-subtask) issue type. The new issue type will be added to the default issue type scheme.

      After successful creation of the new issue type, this method publishes an instance of IssueTypeCreatedEvent.

      Parameters:
      name - name of the issue type. Cannot be null or blank. Must be unique across issue types and subtask issue types.
      description - description for the issue type.
      avatarId - avatarId for the issue type. Cannot by null.
      Returns:
      the new IssueType
      Since:
      v6.3
    • createSubTaskIssueType

      IssueType createSubTaskIssueType(String name, String description, String iconUrl)
      Create a new subtask issue type. The new issue type will be added to the default issue type scheme.
      Parameters:
      name - name of the issue type. Cannot be null or blank. Must be unique across issue types and subtask issue types.
      description - description for the issue type.
      iconUrl - icon URL for the issue type. Cannot be null or blank.
      Returns:
      the new IssueType
    • createSubTaskIssueType

      IssueType createSubTaskIssueType(String name, String description, Long avatarId)
      Create a new subtask issue type. The new issue type will be added to the default issue type scheme.
      Parameters:
      name - name of the issue type. Cannot be null or blank. Must be unique across issue types and subtask issue types.
      description - description for the issue type.
      avatarId - avatarId for the issue type. Cannot by null.
      Returns:
      the new IssueType
      Since:
      v6.3
    • editIssueType

      @Deprecated void editIssueType(IssueType issueType, String name, String description, String iconUrl)
      Edits an existing issue type.
      Parameters:
      issueType - existing issue type
      name - new name. Cannot be null or blank. Must be unique across issue types and subtask issue types.
      description - new description.
      iconUrl - icon URL for the issue type. Cannot be null or blank.
    • updateIssueType

      void updateIssueType(IssueType issueType, String name, String description, Long avatarId)
      Edits an existing issue type. After successful update of an issue type, this method publishes an instance of IssueTypeUpdatedEvent.
      Parameters:
      issueType - existing issue type
      name - new name. Cannot be null or blank. Must be unique across issue types and subtask issue types.
      description - new description.
      avatarId - avatar id the issue type. Cannot be null or blank.
      Since:
      v6.3
    • getIssueTypes

      Collection<IssueType> getIssueTypes()
      Returns all issue types regular and subtask issue types.
      Returns:
      a collection of IssueTypes
    • removeIssueType

      void removeIssueType(String id, String newIssueTypeId)
      Removes an issue type. All issues which use this issue type will be migrated to a different issue type which is specified in the second argument. After successful removal of an issue type, this method publishes an instance of IssueTypeDeletedEvent.
      Parameters:
      id - id of the issue type to remove
      newIssueTypeId - the id of the new issue type for all issues which are of the issue type which we are about to remove. Can be null.
    • getIssueType

      IssueType getIssueType(String id)
      Returns the IssueType for the specified id.
      Parameters:
      id - issue type id.
      Returns:
      an IssueType
    • getAvailableIssueTypes

      Collection<IssueType> getAvailableIssueTypes(IssueType issueType)
      Returns a collection of suitable alternative IssueTypes to which issues with the supplied issue type can be moved to. The suitable alternative IssueTypes will have to use the same workflow, the same field configuration and the same screen scheme.
      Parameters:
      issueType -
      Returns:
      a collection of IssueTypes
    • hasAssociatedIssues

      boolean hasAssociatedIssues(IssueType issueType)
      Checks if there are any issues associated with this issue type.
      Parameters:
      issueType - for which issues are searched.
      Returns:
      true if the issue type has any associated issues.