Integrating with Rational Quality Manager

IBM® Rational® Quality Manager 2.0.1 and 3.0 can use the Rational Change OSCM-CM API to submit new change requests. It can also link execution results to them 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 have 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:

  1. 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 a new entry by typing or selecting the following:

      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.

  2. 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.
  3. Add links or services.

    If you see error messages during these steps, you may want to access Rational Quality Manager through its fully-qualified hostname.

    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 in to Rational Change.
    6. Click Finish or OK.
    7. Scroll to the top, and then click Save.
  4. Optionally, modify your Rational Change lifecycle.
    So 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

Feedback