Creating a Rational Connector Project

There is a one-to-one correspondence between SAP Solution Manager projects and Rational® Connector projects. Rational Connector projects link to one or more from a set of CLM Rational Team Concert™, Rational Quality Manager, and Rational Requirements Composer projects. Typically, the CLM projects are the individual projects that make up a CLM lifecycle project.

About this task

You set up a Rational Connector project to work with CLM projects and an SAP Solution Manager project.

Procedure

Create a Rational Connector project and associate it with CLM projects and an SAP Solution Manager project.

  1. Log in to the Rational Connector.
  2. Click New Project to open the project creation wizard.

    Creating a SAP Connector Project

  3. Name the project and click Next.

    If the CLM projects to be associated with this Rational Connector project are part of a lifecycle CLM project, use the name of the CLM lifecycle project.

  4. Add a Rational Quality Manager project, otherwise click Next.
    1. Select a Rational Connector configuration that is associated with a Rational Quality Manager server. If a configuration does not yet exist, click New Configuration and create one now. For more information, see Creating a Rational Connector Configuration.

      Selecting Rational Quality Manager server configuration

    2. Select a project from the Quality Manager Project list and click Next.
  5. Add a Rational Requirements Composer project, otherwise click Next.
    1. Select a Rational Connector configuration that is associated with a Rational Requirements Composer server. If a configuration does not yet exist, click New Configuration and create one now. For more information, see Creating a Rational Connector Configuration.
    2. Select a project from the Requirements Composer Project list and click Next.
  6. Add a Rational Team Concert project, otherwise click Next.
    1. Select a Rational Connector configuration that is associated with a Rational Team Concert server. If a configuration does not yet exist, click New Configuration and create one now. For more information, see Creating a Rational Connector Configuration.
    2. Select a language from the Language list for the text of SAP Service Desk incidents that are created from a Rational Team Concert work item.
    3. Select a project from the Team Concert Project list.
    4. Add default fields by using the Select default fields list and by clicking Add. The fields must include required fields when you create a work item from an SAP Service Desk incident. Since that work item creation is done in the background, you cannot enter non-default field values at creation time. Add default values for the Tags field, such as from_service_desk, as that makes a query for SAP Service Desk incident work items easier.

      Rational Connector configuration for Rational Team Concert

    5. Click Configure OAuth

      OAuth Configuration dialog

    6. In the OAuth Configuration dialog, click Request Rational Team Concert Consumer Key .
    7. If you are not already logged in to the Rational Team Concert server, click Log in.
    8. In the Approve RTC Consumer Key dialog, click Approve.

      Approve the Rational Team Concert Consumer key

    9. Close the Approve RTC Consumer Key dialog.

      The Provisional key is marked approved

    10. Close the OAuth Configuration dialog.

      You need only one OAuth consumer key per Rational Team Concert application server.

  7. Click Next, in the new project wizard.
  8. If you want, set your Blueprint Mapping and click Next.

    Selecting the blueprint mapping between SAP items and Rational items

  9. Add a Solution Manager user and a Service Desk user. Add a new authorized user by completing the user name and User ID fields and select Add User. Be sure to select the Solution Manager user you want to grant access to the connector project.

    Adding Solution Managers users for the project

  10. Click Done to save the new connector project.

    The User ID is an SAP Solution Manager identity that is used to push test results from Rational Quality Manager into SAP Solution Manager and to create SAP Service Desk incidents from Rational Team Concert work items. The SAP Service Desk Customer ID is used for the Reporter field when an SAP Service Desk incident is created from Rational Team Concert.

    Tip: If either the User ID or the SAP Service Desk Customer ID fields are empty, Done is not enabled. Even after you enter those fields, though, Done might not be enabled. The Solution Manager User Information has an Authorized Users list of users. That list must have at least one name that is added and checked. Clearing and rechecking one name on that list, which is given that the User ID, or the SAP Service Desk Customer ID fields are entered, enables Done.
  11. Associate a Solution Manager project with the new Rational Connector project. For more information, see Linking an SAP Solution Manager Project to a Rational Connector Project.
  12. If you created an association with a Rational Team Concert project, add the Rational Connector project as a friend of Rational Team Concert.
    1. Log in to the Administration page of the Rational Team Concert server. For example, https://my.server.ibm.com:9443/ccm/admin
    2. In the navigation area on the left, click Friends (Outbound).

      Outbound Friends page that shows server friends

    3. Click Add.
    4. Specify the Name field with a name of your choosing.
    5. Specify the Root Services URI field with the URL to your connector project's root services document. For convenience, this URL is found in the project details section of your Rational Connector project.

      Project details that shows Root Services URI

    6. Specify the OAuth Secret fields with a secret of your choosing.

      Add friend dialog

    7. Click Create Friend.

      The Friend is added and a provisional key is generated.

    8. Click Next.

      Authorize provisional key

    9. Click Grant access for provisional key.
    10. If required, log in to the Rational Connector for SAP Solution Manager.
    11. Click Approve.

      Approve provisional key

    12. Click OK on the Success dialog.

      Success message that shows the provisional key was approved

    13. Click Finish.

      There must be one friend relationship from Rational Team Concert to the SAP Connector per SAP Connector project.

    14. Open your Team Concert project.

      Team Concert project opened in CCM

    15. Go to the associations section and click Add

      Add project association

    16. Add a project association and click OK.

      Add project association

    17. Click Save at the top of the project page to save the changes.
    18. Verify the setup of the SAP Service Desk and Rational Team Concert (CCM) integration by opening the SAP Service Desk. For example, https://yourserver.win.dom.company.com:8011/sap/bc/webdynpro/sap/ags_work_incident_create_app

Take a tour of configuring Rational Team Concert with SAP Solution Manager

About this task

This video provides a demonstration of configuring Rational Team Concert with SAP Solution Manager 7.1 using the Rational Connector 4.0.


Feedback