Configure Issue Tracking System Instance

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

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.

 

The following macros are not currently supported in the footer:
  • style