Using the integration provider to integrate with JIRA

When you integrate with JIRA, you can import JIRA issues into IBM® UrbanCode Release.

Before you begin

Note: The IBM UrbanCode Deploy integration provider has been replaced with a plug-in. To use the plug-in download and install the plug-in. See Installing plug-ins for details.

About this task

IBM UrbanCode Release can integrate with JIRA version 6.x and later. The Accept remote API calls configuration option must be set to ON in JIRA. By default, Accept remote API calls is set to OFF.

During the import process, JIRA projects are mapped to IBM UrbanCode Release applications. All issues in a mapped project are represented by change items in IBM UrbanCode Release. IBM UrbanCode Release communicates with JIRA by using REST calls. The integration is not bidirectional; you cannot export from IBM UrbanCode Release to JIRA.

Note: Before IBM UrbanCode Release version 6.1, JIRA projects could not be imported unless they are mapped to initiatives. Starting with version 6.1, release changes are mapped to applications, and you can import JIRA projects even if they are not mapped to an application.

Procedure

To open the Integration pane, click the navigation list arrow, and then click Integrations > Add New.
In the Name field, type a name for the integration.
In the Description field, type a description.
From the Integration list, select Jira.
From the Frequency list, select a frequency. The frequency determines how often the JIRA server is polled for changes. If the server contains many artifacts, frequent updates might affect performance. Specify a frequency of 30 min initially. You can run manual updates at any time.
In the Base JIRA URL field, enter the URL where the JIRA server is located. The format is http://host_name:port_number. For instance, type http://myserver.example.com:8080.
In the User Name field, type a name for the integration.
In the Password field, type a password.
Click Connect.
A section opens below the connection information that you can use to map artifacts on the JIRA server to artifacts on the IBM UrbanCode Release server.
Map the JIRA artifacts to elements on the IBM UrbanCode Release server, according to the following table:
JIRA artifact IBM UrbanCode Release element

Projects Applications

Project versions Releases

Statuses Release statuses

Issue types Change types
Click Save.
Optional: Click Run Integration to run the integration immediately.

JIRA artifact	IBM UrbanCode Release element
Projects	Applications
Project versions	Releases
Statuses	Release statuses
Issue types	Change types

Results

When the integration runs, JIRA issues in the mapped project are imported as changes. JIRA bug-type issues become bug-type changes in IBM UrbanCode Release. All JIRA issue types are mapped in the integration and each type goes where it is mapped.

Feedback