Enabling link validity in AM, QM, and RM project areas
For each Architecture Management (AM), Quality Management (QM), and Requirements Management (RM) project area that is enabled for configurations, you can choose to show or hide the link validity status of links and the validity summary of artifacts. Show this information to help determine which artifacts and relationships you need to examine and update when changes are made. Hide this information to reduce the clutter on the page when you know that your team does not need it. In a distributed environment, additional setup is required.
Before you begin
- Ensure that you are familiar with the concepts and examples described in Link validity.
In the Change and Configuration Management (CCM) application, no additional steps are required to enable configuration management or show validity status. Link validity status information is shown only in the web client and is shown by default on links between source control management (SCM) files and artifacts that support validity status. The CCM application does not support validity summary information.
About this task
Link validity shows the status of links between artifacts and indicates whether the content of the artifacts meet the intended meaning of the link between them.
For details and examples that explain link validity status and validity summary information, see Link validity.
By default, the Show link validity option is disabled, and you can change it at any time. For example, when work begins at the start of a release or milestone, the link validity status might not be as important to consider, so you might enable it later in the release.
Starting from 9.7.0 release, Engineering Requirements Management DOORS® (DOORS) is enabled for configuration management, but there is no support for link validity. Hence, even though DOORS projects are enabled for configuration management, the link validity status in Engineering Test Management (ETM) is always shown as unknown for DOORS links.
- Distributed environments only: For each product node, complete the following steps. For a topology overview, see the related Deployment wiki article.
Complete the steps for the application you are enabling. In a distributed environment, for each
product node, complete this step for each application that supports link validity.
Application Steps Architecture Management (AM)
- Click Architecture Management.
- Click Save.
Quality Management (QM)
- From the Administration menu , select Manage Project Properties.
- In the Properties section, click Link Validity.
- To show or hide link validity status, select or clear the Show link validity check box.
- Click Save.
- (Optional) When a test case is approved, mark all links as Valid: When you select this option, the system automatically marks each link to corresponding requirements as Valid after a team member approves a test case. This option saves team members time when they work with large numbers of test cases because they do not need to manually validate each test case-to-requirement link.
- Configure the functional user for each RM project area that the QM project area links to:
- On the Administration menu , click .
- Copy the consumer keys for the RM (/rm) entries in the Jazz Team Server Friends table.
- Go to the Jazz Team Server administration page at https://host-name:9443/jts/admin; then, click .
- In the Authorized Keys section, for each consumer key that you copied, click the Edit Consumer icon , and in the Functional User ID field, assign the functional user for that application (such as rm_user or dm_user); then, click Finish.
Requirements Management (RM) You must enable link validity for each component in a project area whose links team members show and set validity status for.
- From the Administration menu , select Manage Component Properties.
- To show or hide link validity status, on the Link Validity tab, select or clear the Show link validity check box.
- Click Save.
- Grant permission for team members to set link validity. For details, see Modifying role-based permissions.
After you enable the Show link validity option, link validity information is shown where links to artifacts are shown. For details, see Viewing and changing link validity status in ELM projects.
Link validity status information is collected by the Lifecycle Query Engine (LQE) data source whether you show or hide this information.
What to do next
For team members to create Report Builder reports that include RM and QM application link validity information, you must grant them access to link validity data. For details, see the related topic.