Linking between JIRA projects and CLM project areas

Use the Jazz™ project administration interface to establish project associations between CLM project areas and JIRA projects. The association of project areas enables team members to create links from artifacts in one project area to artifacts in another project area. An artifact can be a test case, a requirement, or a work item.

Before you begin

Friend relationships are set and OAuth access requests are approved. Web browser preferences are not set to block pop-up windows. JIRA projects exist to associate with CLM project areas.

You might also want to review the project associations that are possible between JIRA projects and CLM projects. For details, see Using the JIRA adapter.

About this task

When you associate JIRA projects to CLM project areas, the adapter provides services for the CLM project. A service can be a requirement, a change request, a defect, or a quality task. These services are the link types that you can establish from an artifact in the CLM project to a JIRA issue. The CLM project also uses its own services to support activities in the associated project area. For example, a service such as requirements management when you work in a requirements management project.

Procedure

  1. Log in to the Jazz server by using an account that has Jazz Administrator privileges.
    • For Rational® Requirements Composer or Rational DOORS® Next Generation by using the default context root value:
      https://fully qualified hostname:port/rm/admin
    • For Rational Team Concert™ by using the default context root value:
      https://fully qualified hostname:port/ccm/admin
    • For Rational Quality Manager by using the default context root value:
      https://fully qualified hostname:port/qm/admin
  2. For Rational Team Concert projects or Rational Quality Management projects:
    1. On the Server Administration home page, click Project Areas for one of the applications in the Application Administration section.
    2. Select a project area from the Active Project Areas list that you want to create associations for in Change and Configuration Management or in Quality Management.
  3. For Rational Requirements Composer projects:
    1. On the Server Administration home page, click Manage Lifecycle Projects for one of the applications in the Application Administration section.
    2. Select a project area that you want to create associations for in Requirements Management.
  4. Scroll to the Associations section.
  5. Click Add.
  6. In the Add Association window in the Application list, select a target JIRA relationship that you identified when you established friend relationships by using Friends (Outbound).
  7. If you are prompted to do so, log in to the target JIRA server by using an account with administrator privileges. Entries for the target JIRA server are displayed in the Artifact Containers field. These entries correspond to JIRA projects.
  8. In the Association field, select the association for the type of artifacts for which you want to establish links. For more information about possible project associations between JIRA projects and CLM project areas, see Using the JIRA adapter.
    • For associations with Requirements Management projects, select Uses - Implementation Requests or Uses - Requirements Change Requests.
    • For associations with Rational DOORS Next Generation projects, select Uses - Implementation Requests or Uses - Requirements Change Requests.
    • For associations with Quality Management projects, select Uses - Quality Management Tasks or Uses - Defects or Provides - Related Change Request.
    • For associations with Change and Configuration Management projects, select Provides Related Change Requests.
  9. Select an artifact container entry. As you select options in the fields in this window, the selected link relationship is described in the Preview section at the bottom of the window.
  10. Click OK.
  11. Repeat this procedure to add project associations between CLM projects and JIRA projects.

What to do next

Users can now create links from artifacts in the local CLM project area to issues in the target JIRA project, see Using the JIRA adapter.

Feedback