Integrating with JIRA

You can integrate JIRA issues into IBM® UrbanCode Release.

Before you begin

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

About this task

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 6.1 release JIRA projects cannot be imported unless they are mapped to initiatives. Starting with 6.1 release changes are mapped to applications and you can import JIRA projects even if they are not mapped to an application.

Procedure

  1. From the home page, in the Administration section, click Integrations > Add New to open the New Integration Provider pane.
  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 a large number of artifacts, frequent updates might affect performance. A frequency of 30 min is a good initial choice. 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.

Results

When the integration runs, any 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