Requirement operations in the web client

Use these operations to edit the details, attributes, or relationships of a requirement in Dimensions CM, notify users about changes to associated requirements, or launch Requirements Management using Dimensions RM.

Select requirements

In the web client, the requirements are located in the Catalog node.

To select requirements:

  1. In the My Current Project tab or My Current Stream tab, in the navigation pane, expand the Catalog node and select the Requirements node.

    The requirements related to the project are displayed in the content pane.

    To view the requirements in a container of requirements, expand the Requirements node and click the appropriate node, for example, a collection or a baseline.

  2. In the content pane, select one or more requirements.

Back to top

Edit requirement details

To edit a requirement, you need the Perform Requirement Related Operation (PRODUCT_REQUIREMENTMAN) privilege.

To edit the details of a requirement:

  1. In the My Current Project tab or My Current Stream tab, in the navigation pane, expand the Catalog node and select a requirement.

  2. Click Open open_change_document_button.gif, or click the requirement name. The Dimensions RM Browser Edit Attributes dialog box opens (through the Dimensions RM integration).

    For details on how to edit the attributes, see the associated online help or the Dimensions RM help.

  3. Exit to return to the Dimensions CM web client.

Back to top

Relate a requirement to a request

To relate a requirement to an existing request:

  1. In the My Current Project tab or My Current Stream tab, in the navigation pane, expand the Catalog node and select a requirement.

  2. Click Relate Relate_button.gif . The Relate dialog box opens.

  3. In the Relate to field, enter the existing request, or use the browse button to select the request.

  4. Click OK.

Note: When creating a baseline, you can scope it by Requirement rather than Request. See Create a baseline with requests and requirements.

Back to top

Create a request to relate to an requirement

To create a request to relate to a selected requirement:

  1. In the My Current Project tab or My Current Stream tab, expand the Catalog node and select a requirement. Click New Request and select a request type.

  2. In the New Request dialog box, enter the request details in the relevant fields in the General and Attributes tabs. The Related requirement(s) field is prepopulated with the selected requirement.

  3. Click OK.

Note: When creating a baseline, you can scope it by Requirement rather than Request. See Create a baseline with requests and requirements.

Back to top

Create a baseline with requests and requirements

If your items are used in builds, after requirements have been linked to requests and the work for those requests has been completed, you need to create a baseline for all the items before they are used in the build.

You create a baseline using the requirements that were worked on for this build and project milestone. The baseline ensures that the specific versions of requirements, requests, and items are associated.

When you create this baseline in Dimensions CM, a baseline with the same name is created in Dimensions RM, containing the requirements linked or associated to the requests. The baseline in Dimensions RM will be associated with the Dimensions CM baseline that was created.

To create a baseline that contains requests and requirements:

  1. Before creating the baseline in Dimensions CM, first create the Request Baseline Template in the Dimensions CM Administration Console.

  2. In the My Current Project tab or My Current Stream tab, expand the Catalog node and select a requirement.

  3. Click New Baseline .

  4. In the New Baseline dialog box, enter the new request details in the General and Attributes tabs.

    When creating the baseline in Dimensions CM, specify the requirements for the baseline in the General tab. Click the Requirement radio button and then enter the requirement PUIDs that will be part of the baseline (the PUID numbers can be browsed). A PUID is a requirement's unique identifier in Dimensions RM.

  5. Click OK.

This process creates one baseline in Dimensions CM and another one in Dimensions RM. The CM baseline contains all objects (items, requests, and requirements), while the RM baseline contains the requirements.

Back to top

Notify CM users about changes in RM requirements

Email notification of changes to associated RM requirements requires the following:

  1. For all users who want to receive notifications, the administrator must have previously set up through the Administration Console:

    1. An email subscription to the event 'Someone has made a change to a Requirement related to a Request pending for me'.

    2. The granting of the product-level Perform Requirement Related Operation (PRODUCT_REQUIREMENTMAN) privilege.

  2. The subscribing, privileged Dimensions CM users must have pending requests that are related to requirements.

You can use the Dimensions CM dmemail utility to notify users about changes to associated Dimensions RM requirements. For example, when requirements are added to or removed from a collection, when collections are associated or unassociated from a Dimensions CM project, or when requirements (contained in an associated collection) are updated or replaced.

For details about managing notification emails, see the Administration Console online help.

In addition to the administrator setting up email subscriptions and privileges, you need to edit the following configuration files:

email_config.dat

This configuration file contains settings specific to dmemail.

File location:

  • Windows: %DM_ROOT%\dfs 

  • UNIX: $DM_ROOT/dfs

When dealing with associated Dimensions RM requirements, you need to add some Dimensions RM-specific settings to the section concerned with databases for dmemail to process, for example:

host = <Dimensions RM_host_name>

dmuser = <Dimensions CM_System_Administrator_User_ID>

By default, <Dimensions CM_System_Administrator_User_ID> is dmsys.

dm.cfg

In this configuration file, you schedule dmemail.

File location:

  • Windows: %DM_ROOT% 

  • UNIX: $DM_ROOT

Back to top

Start a Dimensions RM session

You can start a Dimensions RM session from the web client.

To start a Dimensions RM session:

  1. On the Items tab, Projects/Streams tab, Request tab, or Baselines tab, click More More_commands_button.gif and select Requirements ...

    The Dimensions RM browser window opens (accessed through the Dimensions RM integration). For details about using Dimensions RM, see the Dimensions RM help.

  2. Close the Dimensions RM window to return to the Dimensions CM web client.

Back to top

See also: