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.

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
- Start the JIRA server if it is not already started. Login
to your JIRA server with administrative privileges.
- Click Administration, located at
the top right of the page.
- Click Custom Fields from the Issues
section in the lower left of the page
- Click Add Custom field, and on
the next page, and select OSLC Links. This selection is available after you have installed the plug-in.
- Click Next. Provide any name that
you prefer for the field, such as OSLC Links.
- Under Choose applicable issue types, make sure Any
issue type is selected.
- Under Chose applicable context, select a project to integrate
with Rational® solution
for Collaborative Lifecycle Management or accept the default Global
context.
- Click Finish.
- 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.