Integrating with Jira

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

Note: The integrated Jira plug-in is obsolete. It has been replaced with an installable plug-in. Install and use the Jira plug-in for IBM UrbanCode Release.

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.
  1. To open the Integration pane, click the navigation list arrow, and then click Integrations > Add New.
  2. In the Name field, type a name for the integration.
  3. In the Description field, type a description.
  4. From the Integration list, select Jira.
  5. 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.
  6. 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.
  7. In the User Name field, type a name for the integration.
  8. In the Password field, type a password.
  9. 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.

  10. 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
  11. Click Save.
  12. Optional: Click Run Integration to run the integration immediately.
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.