Suspect Links

Overview

R4J allows you to use Jira issue links to define the relationships and dependencies between requirements or other types of issues. When one requirement depends on another requirement, it can be useful to know when the requirement changes, since that may require corresponding changes in the dependent requirement.

R4J introduces the concept of suspect links to help you spot such cases and take appropriate action. R4J automatically monitors changes in your requirements and flags linked issues as "suspect" in order to identify them for review. This feature allows users to change requirements and then determine which other requirements might be affected by the changes. After review, the suspect flag can be removed.

Suspect links are identified in the following ways:

  • The Suspect Report (see below) provides a list of suspect links in a given project.

  • They appear in the affected requirements' Detail view in the section "Issue Links".

  • They are marked in the Coverage View and Traceability Matrix.

  • Requirements with suspect links can be identified using Advanced Search.

To configure the rules for flagging suspect links see Configuring the Suspect Logic.

Suspect Report

To create a Suspect Report, select Requirements > Suspect Report from the main navigation bar, select the relevant project and the “Go” button. The report is a table with a row for every suspect link. The Search field can be used to search the report for rows containing a given piece of text.

Report Options

Include links to other projects

Include cross-project links flagged as suspect.

Period

Restrict to issues with suspect flags created within the specified time period.

Link type(s)

Restrict to specified link types.

The link type name is used to specify the link type (e.g. “trace”), while in the report the link description is used (e.g. “trace to”).

User

Restrict to changes made by the specified users.

Report Columns

Changed Issue

The issue whose change triggered a suspect rule.

Linked Issue

The dependent issue that might be affected by the change.

Link Type

The link type between the changed issue and the dependent issue.

User

The user who made the change.

Suspect Timestamp

The date and time of the change.

Action

Provides the following actions:

  • Compare the differences between the two issues.

  • Review the exact change that triggered a suspect rule.

  • Clear the suspect flag.