Track Changes to Requirements Links

After you Author Requirements in Simulink and create links between design elements and your requirements, Simulink® Requirements™ tracks the requirements links and detects when link artifacts (source or destination) or requirements change. In the Requirements Editor, changes to requirements links are highlighted in red. You can then resolve link issues or clear links changes that have no impact on the requirement status. Track change information from the Links view of the Requirements Editor.

Enable Change Tracking for Requirements Links

To view the change information for your requirements links:

  1. Open the Requirements Editor. In the Apps tab, click Requirements Manager. In the Requirements tab, click Requirements Editor.

  2. Open a requirements set.

  3. From the View drop-down list, select Links.

  4. To enable change tracking from the Requirements Editor, select Display > Change Information.

    The Links view of the Requirements Editor highlights any links with revision mismatch issues in red.

Alternatively, you can enable change tracking for requirement links from the Requirements Perspective. Right-click an item in the Requirements Perspective and select Change Information.

The Change Information section for each link details any requirement link change issues. Simulink Requirements reports any source or destination requirements that have more recent changes than when you established the requirement link. Simulink Requirements considers the revision information and timestamp for a requirement item when the link was created and the current revision information and timestamp for the requirement item.

Review Requirements Change Issues from the Requirements View

You can view change issues associated with a particular requirement item from the Requirements view. After you Enable Change Tracking for Requirements Links, select a requirement item from the Requirements view. Any requirements items with requirement link change issues are highlighted in red. The relevant requirement link with a change issue is also highlighted in red in the Links section of the Requirements Editor.

To view the link change issue, and then Resolve Change Issues for Requirement Links, click the link icon to the right of requirement link.

Resolve Change Issues for Requirement Links

If you enable change tracking for requirements links, changes to your requirements that cause link issues are highlighted in red in the Links view of the Requirements Editor. If a change has no impact, you can clear the issue to update to the latest revision number for the requirement. In the Links view of the Requirements Editor, select the link with a link change issue. In the Change Information section, click Clear Issue. To clear all change issues for an entire link set, right-click the link set and select Clear All Change Issues.

If the link issue affects the status of your requirements, you can change the model, the requirements, the test cases, or the links themselves to resolve the discrepancy between the requirements and your model and testing.

Add Comments to Links

Whenever you resolve link issues, it is good practice to add a comment to the link describing the action that you took. Each link has a Comments section. To add a comment:

  1. In the Links view of the Requirements Editor, select the link.

  2. In the Comments section, select Add Comment.

Considerations for Using Links Change Tracking

Change tracking information is updated only when you enable change tracking or when you manually refresh the change tracking information. To refresh the change tracking information manually:

  • From the Requirements Editor, select Analysis > Refresh Change Information .

  • From the Requirements Perspective, or from the Requirements Editor, click the Refresh button .

Simulink Requirements provides change tracking information only for link sources that are resolved when you view the change information.

You can resolve some links by using the Requirements Editor.

  1. In the Links view of the Requirements Editor, select the link with an unresolved link item. The Change Information section shows Unresolved Link Item(s).

  2. To open the link source, click the Source link in the Properties section.

When the link model opens, the link source is loaded and the Change Information section displays a resolved link. For more information, see Review Requirement Links.

Related Topics