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. This association of project areas enables team members to create links from artifacts such as test cases, requirements, and work items in one project area to artifacts in another project area.

Before you begin

You must establish cross-server communication and approve OAuth access requests before you do this procedure. Ensure that your web browser preferences are not set to block pop-ups. In addition, you must have existing JIRA projects to associate with CLM projects.

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 associating JIRA projects to CLM project areas, the Rational Adapter for JIRA provides services (such as requirements, change requests, defects, or quality tasks) for the CLM project. For example, these services are the link types you can establish from an artifact in the CLM project to a JIRA issue. Additionally, the CLM project also uses its own services (such as requirements management when you work in a requirements management project) to support activities in the associated project area.

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 Manager.
  4. Scroll to the Associations section.
  5. Click Add.
  6. In the Add Association window in the Application drop-down list, select a target JIRA relationship that you identified when you establish cross-server communication 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 Manager 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 Manager projects, select Uses - Quality Management Tasks or Uses - Defects or Provides - Related Change Request.
    • For associations with Change 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