An Issue Tracking System instance has the configuration details necessary to connect to a specific Issue Tracking System. This is used to query Issues, and update issue status and/or comments during project builds and deployments. Each instance is defined with unique name and code, and in addition has underlying system-specific properties for connection.
To create an Issue Tracking System instance, navigate to Configuration → Integrations and click the Issue Tracking tab. Click the + Create button to create a new Issue Tracking Instance. To edit an existing instance, Click on the name of an existing ITS in the list.
Enter values for the fields as described in the table below.
Field Name | Required | Description |
|---|---|---|
Name | Yes | Long display name for the instance. |
Code | Yes | Short name for the instance. |
Issue Tracking System | Yes | Jira, Redmine, Azure Boards, GitLab, and GitHub are the supported out-of-box issue tracking systems. Any custom issue tracking systems you create will also appear as an option here. Once the Issue Tracking Instance is saved, this cannot be modified. |
Description | Yes | A description of the instance. |
Active | Yes | Whether or not the instance is active in the system. Defaults to "Yes". |
Properties | No | If the selected Issue Tracking System has any properties defined, then you must set up values for those properties based on the property key definition. |
Click the Test Connection button to verify the credentials and other connection details. Click the Save button to save the changes and exit the popup.