Skip to main content

Prerequisites for Configuring the Jira Connector

The following requirements must be met to ensure a successful creation of an issue on the Jira Server.

  • Latest Jira connector—Ensure that your Code Insight installation contains the latest Jira connector, particularly after migration to the latest Code Insight version. (The Jira connector is located on the core server in the config/core/plugins directory.)

  • Proper user credentials to access Jira—To access the Jira Server, each instance configured for the Jira connector requires the credentials of a valid user on the server. Additionally, the specified user must have full access to the Jira ALM instance on the Jira Server, particularly if Captcha or Single Sign-On is enabled on the Jira Server.

  • Compatible field configuration for Jira issues and Code Insight work items—The field configuration for Jira issues on the Jira Server must include Issue Type, Description, Summary, Assignee, and Priority to correspond with the work-item fields available on the Jira ALM instance in Code Insight. Any other field used to define issues on the Jira Server must be configured as optional (that is, it does not require a value). Deviation from this field configuration on the Jira Server can cause the creation of Jira issues from Code Insight to fail. For information about the configuration of fields used to define Jira issues, see https://support.atlassian.com/jira-cloud-administration/docs/specify-field-behavior/​.

  • Same priority scheme for Jira issues and Code Insight work items—The priority scheme for issues on the Jira Server must match the priority scheme used in the Jira ALM instance on Code Insight. If a different priority scheme is used on the Jira Server, the creation of an issue from Code Insight can fail. Code Insight uses the default Jira priority scheme 1 through 5, where 1 indicates “Highest” and 5 indicates “Lowest” (as described in https://confluence.atlassian.com/adminjiraserver/defining-priority-field-values-938847101.html​.)

You can use the Test Connection button for a specific Jira ALM instance on the ALM tab to validate a successful connection to the Jira Server (see Adding a Jira ALM Instance). However, this test does not guarantee a successful creation of a Jira issue from Code Insight. All the requirements listed in this section must be in place to help bring about a successful integration with Jira.