Project management integration

Use the Project management integration to connect your Atlassian Jira tasks to CloudBees Unify. Once connected, Jira tickets can be used to do the following:

Query their references in flow metrics reports (organization level)
Link and view work items for feature traceability (component level)
Track security issues in Jira projects (application level)

For more information on setting up flow metrics reports and understanding the flow metrics dashboard, refer to:

For more information on setting up feature traceability, refer to Feature traceability.

Create an Atlassian personal access token to set up the connection to your Jira account.

Create a Jira integration

Use the following steps to create a Jira integration. However, the specific fields to complete may differ based on the purpose of the integration. For example, a Jira integration for flow metrics does not require setting up the webhook URL and secret. Be sure to complete the fields based on the purpose of your integration.

The following fields are required for all Jira integrations:
- URL, username, and personal access token to connect the Jira instance to CloudBees Unify.
The following fields are required for flow metrics:
- URL, username, and personal access token to connect the Jira instance to CloudBees Unify.
The following fields are required for feature traceability:
- Webhook URL and secret to connect the Jira instance to CloudBees Unify.
The following fields are required to track security issues in Jira projects:
- Jira severity mapping to map the severity levels in the Jira project to the severity levels in CloudBees Unify.

Fields not required for the purpose of the integration are optional and may be left blank, but must be completed if the integration is used for that purpose. For example, if the Jira integration is created for flow metrics, the webhook URL and secret fields may be left blank. However, if the same Jira integration is also used for feature traceability, the webhook URL and secret fields must be completed.

Jira integration steps

Navigate to Configurations Integrations.
Select Create integration. The list of available integrations displays.
Select Jira from the list of available integration types.
Complete the following fields:
1. Name: Enter a name for the integration.
2. Description: (Optional) Enter a description for the integration.
3. URL: Enter the URL for the Jira instance to connect to.
4. Username: Enter the username for the Jira account to connect to.
5. Personal access token: Enter the personal access token for the Jira account to connect to.
Select Test integration. If the connection is successful, the Jira severity mapping section displays.
Map the Jira severity levels to the severity levels in CloudBees Unify.
1. Drag and drop the Jira severity levels to the appropriate severity level in CloudBees Unify.
2. Select Reset mapping to reset the mapping.
To set up the webhook, copy the Webhook URL and secret provided in the Jira integration configuration to your Jira instance.
1. Select Copy to clipboard next to the Webhook URL and secret to copy the values.
2. Select Regenerate URL & Secret to create a new webhook, if needed.
  
  If a new Webhook URL and secret are generated, the associated Jira instance must be updated with the new values.
Select Submit.

The Jira integration is connected and listed in Integrations.

To create a Jira integration for a component, refer to Integrations.

For more information about integrations, refer to Manage integrations.

For more information about feature traceability, refer to Feature traceability.