Configuring JIRA issues to support CLM linkages

After installing the adapter plug-in into JIRA, a custom field is automatically added to existing JIRA projects to support integration. Optionally, new JIRA projects intending to use the integration, will need to perform this configuration.

Before you begin

During the installation of the adapter, the install process automatically adds the custom field links OSLC Links to existing JIRA projects. When you add new JIRA projects, you must add the custom OSLC field type to your issues. This field is populated with linkages back to Collaborative Lifecycle Management artifacts during usage.Custom Fields in JIRA

About this task

You add a custom field to your JIRA issue type for any new JIRA projects that you intend to integrate with CLM projects.

Procedure

  1. Start the JIRA server if it is not already started. Login to your JIRA server with administrative privileges.
  2. Click Administration, located at the top right of the page.
  3. Click Custom Fields from the Issues section in the lower left of the page
  4. Click Add Custom field, and on the next page, and select OSLC Links. This selection is available after you have installed the plug-in.
  5. Click Next. Provide any name that you prefer for the field, such as OSLC Links.
  6. Under Choose applicable issue types, make sure Any issue type is selected.
  7. Under Chose applicable context, select a project to integrate with Rational® solution for Collaborative Lifecycle Management or accept the default Global context.
  8. Click Finish.
  9. On the Screens page, you must select the Default Screen checkbox. Make any additional selections and then click Update.
    Important:
    • A message displays recommending that the JIRA database be reindexed. Since reindexing can take some time to complete, you can choose to reindex the JIRA database at a convenient time.
    • For best results, make sure that the JIRA project contains the default issue types that come with the product: bugs, tasks, new features, and improvements. For bi-directional links to be created, your JIRA user must have permissions to edit issue types, as configured in JIRA administration.

Results

You have added a custom field to your JIRA issue type form so that links are created from JIRA issues to your CLM artifacts.

What to do next

Configure friend relationships between CLM servers and JIRA servers, see Establishing cross-server communication from CLM.

Feedback