Integrating with OSLC consumers

You can integrate IBM® Rational® Change as an OSLC provider with Rational Quality Manager and other OSLC CM consumers such as Rational Team Concert™ and Rational ClearQuest®.

Integrating with Rational Quality Manager

IBM Rational Quality Manager 2.0.1 and later versions can use the Rational Change OSCM-CM API to submit new change requests. It can also link execution results directly from the Rational Quality Manager web interface.

Before you begin

You must be a Rational Quality Manager administrator to perform this setup.

When you type your Rational Change server host, you must match the style that Rational Change uses for its generated links. By default, this address is the IP address of the host. If you configured Rational Change to use the hostname instead, type the hostname on to Rational Quality Manager as well.

Procedure

To integrate with Rational Quality Manager:

Setup cross-server communication or friends.
1. In the Rational Quality Manager 2.0.1 Admin interface, select Server > Cross-Server Communication. Or in the Rational Quality Manager 3.0 Admin interface, select Application > Friends (Outbound).
2. Add an entry by selecting the following information:
  Title: Rational Change (or name of your choice)
  
  Root Services URI: http://change_host:change_port/change/rootservices
  
  OAuth Secret: A password to securely identify this server to Rational Change.
  
  Trusted: Leave as is. Rational Change does not use this value.
Approve the request in Rational Change.
1. In the Rational Change Admin interface, select System Administration > Integrations > To This Server (Consumer Keys).
2. Locate the provisional key for your Rational Quality Manager server, and then in Rational Change, click Approve.
Add links or services.
If you see error messages during these steps, access Rational Quality Manager through its fully qualified host name.
1. In the Rational Quality Manager 2.0.1 Admin interface, select Project Areas > Manage Project Areas > Your RQM Project Area. Or in the Rational Quality Manager 3.0 Admin interface, click Project Areas > Your RQM Project Area.
2. Scroll to the Links or Associations section, and then click Add.
3. Choose your Rational Change server.
4. Choose the Change Management (Defects) type, if necessary.
5. From Service Providers, choose the Rational Change database and role you want to use to log on to Rational Change.
6. Click Finish or OK.
7. Scroll to the top, and then click Save.
Optionally, modify your Rational Change lifecycle.
So that Rational Quality Manager can automatically create links from CRs back to their related execution results, add the following string attributes to your lifecycle and show forms with the OSLC_LINK web type:
- affectsExecutionResult
- blocksTestExecutionRecord
- affectsTestResult
- relatedTestCase

Integrating with other CM consumers

You can integrate IBM Rational Change as an OSLC provider with other OSLC CM consumers such as Rational Team Concert and Rational ClearQuest.

Procedure

To set up communication, use the similar steps in the Integrating with Rational Quality Manager section of this topic.
When the communication is set up, to see the back links created in Rational Change, modify your Rational Change lifecycle to add the attribute relatedChangeRequest of OSLC_LINK web type to your lifecycle and to show forms.