Tool Mentor: Managing Stakeholder Requests Using Rational ClearQuest and Rational RequisitePro
This tool mentor describes how to create and associate requirements in Rational RequisitePro® with enhancement requests in Rational ClearQuest®, allowing the analyst to efficiently track the origin of requirements. It also describes how to manage requirement properties from within ClearQuest.
Tool: Rational Suite AnalystStudio
Relationships
Main Description

Note: Both RequisitePro and ClearQuest must be installed, and a Rational Administrator project must be configured with both products to access this functionality.

Overview

The analyst's role is to incorporate user feedback and stakeholder needs into the system definition. Rational's integration between ClearQuest and RequisitePro allows qualified enhancement requests to be easily associated with related requirements, thereby tracking the source of requirements.

For each enhancement request identified to drive system functionality from ClearQuest, the analyst can create or associate one or many requirements by reformulating the text of the enhancement request into a valid requirement definition. A well-defined requirement definition refers to those requirements that are testable, unambiguous, consistent, verifiable, and complete. Requirements are stored in RequisitePro, but can be created either in ClearQuest or RequisitePro, and their properties may be managed from within either ClearQuest or RequisitePro.

Note: You can only associate enhancement requests to requirements in RequisitePro or ClearQuest Windows applications--not in RequisiteWeb or ClearQuest Web.

Tool Steps

This document contains the following steps:

  1. Enable the ClearQuest and RequisitePro integration
  2. Use ClearQuest to select a RequisitePro project
  3. Use ClearQuest to associate requirements with enhancement requests
  4. Use ClearQuest to create requirements from enhancement requests
  5. Manage requirement properties from ClearQuest

1. Enable the ClearQuest and RequisitePro integration

Minimal setup is necessary to associate enhancement requests to requirements. This setup involves using a Rational Suite project to point to the ClearQuest database and the RequisitePro project. In the setup, the ClearQuest administrator defines the types of requirements that can be created from ClearQuest. Administrators can define a mapping to automate their project-specific needs. For information on enabling this integration, see the document entitled Rational Suite Administrator's Guide on your documentation CD.

2. Use ClearQuest to select a RequisitePro project

To associate enhancement requests with requirements, each enhancement request must identify a Rational Suite project to be used as the source of the available requirements.

To select a RequisitePro project from ClearQuest:

  1. Select an enhancement request and click Actions > Modify to allow the record to be edited.
  2. Click the Main tab.
  3. The RA Project list displays valid Rational Suite projects. Each Rational Suite project is associated with a unique RequisitePro project. Choose the appropriate project and click Apply. ClearQuest saves the project reference with the enhancement request record.

3. Use ClearQuest to associate requirements with enhancement requests

After a Rational Suite project has been identified in ClearQuest, the analyst is ready to associate enhancement requests with requirements. This association can only be done after the enhancement request has been submitted-not at the time of submission. If there is an existing requirement representing the stakeholder needs expressed in the enhancement request description, the analyst associates the enhancement request with the existing requirement by selecting the requirement from the complete list of requirements. Many enhancement requests can be associated with one requirement, and many requirements can be associated with one enhancement request.

To associate an enhancement request with an existing requirement:

  1. Select an enhancement request and click Actions > Modify to allow the record to be edited. You can select multiple enhancement requests to associate with the same requirement by pressing the Ctrl or Shift key while selecting enhancement requests.
  2. On the Main tab, select an RA Project.
  3. Click the Requirements tab. This tab is used to select and remove associated requirements as well as viewing the properties of the associated requirements.
  4. Click the Add to List button. The Select Requirement dialog box appears. Requirements displayed in this dialog box are dynamically queried from the associated RequisitePro project.
  5. In the Requirements of type list, select the FEAT requirement type. All FEAT requirements are displayed.
  6. Select the desired requirement and click OK.
  7. Click Apply to save your changes.

Refer to the Tool Mentor: Eliciting Stakeholder Requests Using Rational ClearQuest for further details.

4. Use ClearQuest to create requirements from enhancement requests

If the stakeholder need reflected in the enhancement request definition is not represented by any existing requirements, the analyst can create a new requirement from ClearQuest.

  1. Select an enhancement request and click Actions > Modify to allow the record to be edited. You can select multiple enhancement requests to associate with the same requirement by pressing the Ctrl or Shift key while selecting enhancement requests.
  2. On the Main tab, select an RA Project.
  3. Click the Requirements tab. This tab is used to select and remove associated requirements as well as viewing the properties of the associated requirements.
  4. Click the Add to List button. The Select Requirement dialog box appears. Requirements displayed in this dialog box are dynamically queried from the associated RequisitePro project.
  5. Select a requirement type for the new requirement.
  6. Click Create. The Requirement Properties dialog box appears.
  7. Click the General tab and type the requirement name and text. Make sure you select the appropriate package to contain your new requirement.
  8. Click the Attributes tab and set the requirement attribute values.
  9. Click OK. The Select Requirement dialog box reappears.
  10. Scroll to the bottom of the requirements list to locate the newly created requirement, highlight it, and click OK.
  11. Click Apply to save the changes. The requirement is associated with the enhancement request.

Note: Requirements created in this manner are located only in the database, not in documents. Within RequisitePro, you can relocate the requirement to a document for further elaboration by cutting the requirement out of the a view (using Edit > Cut) and pasting it into the desired RequisitePro document (using RequisitePro > Requirement > Paste).

For more information regarding the elaboration of feature requirements in a document, see Tool Mentor: Developing a Vision Using Rational RequisitePro.

5. Manage requirement properties from ClearQuest

Requirement properties for requirements created in a database can be accessed directly from within ClearQuest. After the enhancement request has been associated with a requirement, the analyst can review and modify the requirement properties of the associated requirement while working directly in ClearQuest. The Requirement Properties dialog box provides viewing and editing of requirements properties. These properties include requirement attributes, history, and relationships.

  1. Select an enhancement request and click the Requirements tab. This tab is used to view the properties of the associated requirement.
  2. Click Actions > Modify to allow the record to be edited.
  3. Select the associated requirement and click Properties at the bottom of the form. The requirement properties are displayed.
  4. Make changes to the requirement.
  5. Click OK to save the changes.

helpbook icon Refer to the topic Requirement properties overview (Index: requirements > properties) in the RequisitePro online Help.