Main Content

Track Changes to Requirement Links

After you Author Requirements in MATLAB and create links between design elements and your requirements, Requirements Toolbox™ tracks the links and detects when linked requirements change. Track change information from the Requirements Editor or in the Traceability Matrix. You can then resolve change issues or clear changes that have no impact on the requirement status.

Enable Change Tracking for Requirement Links

To enable change tracking for requirement links:

  1. Open the Requirements Editor. From your Simulink® model, in the Apps tab, click Requirements Manager. In the Requirements tab, click Requirements Editor. Alternatively, at the MATLAB® command prompt, enter:

    slreq.editor
  2. Open a requirement set.

  3. Ensure that Information > Change Information is selected.

When you enable Change Information, this setting stays enabled even after you close the Requirements Editor.

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.

Review Changes to Requirements and Test Objects

After you enable change tracking, you can use the Requirements Editor to review the changes in your requirements or test objects.

Review Changes to Requirements

You can link requirements to other types of items. For a full list of linkable items, see Linkable Items. When you change linked requirement, the Requirements Editor and Traceability Matrix window indicate that it has a change issue. After you enable change tracking for requirements links, you can view the change issues associated with a particular requirement from the Requirements Editor or the Traceability Matrix window.

Note

Requirements Toolbox provides change tracking information for unresolved links only if the linked requirement is valid. For more information on why a link might become unresolved, see Resolve Links.

In the Requirements Editor, click Show Requirements. The linked requirements with changes are highlighted in red. When you select a requirement, the associated link is also highlighted in red in the Details pane, under Links. To view the change issue, select a requirement and, under Links, point to the link, then click the link icon () to the right of the linked item.

In the Traceability Matrix window, click Highlight Missing Links > Highlight Changed Links to highlight the row, column, and cell associated with the linked requirement. To view changes to the linked requirement, select the cell and, in the dialog box that appears, click the requirement hyperlink next to Source or Destination. To view the change issue, click the link hyperlink next to Link. To learn more about using the Traceability Matrix window to find change issues, see View and Clear Change Issues for Links.

Review Changes to Test Objects

To create links between requirements and test objects, see, Link to Test Cases from Requirements. When you change Simulink Test™ test objects, Requirements Editor and Traceability Matrix window highlight the link to indicate that the source object changed.

In the Requirements Editor, click Show Requirements. The linked requirements show the change issues related to the source of the links. The editor indicates linked requirements that have change issues with the change issue icon.

The linked test objects with changes are highlighted in red. When you select a requirement, the associated link is also highlighted in red in the Details pane, under Links. To view the change issue, select the link, then click on Change Information.

You can clear the change issues for test cases from the Requirements Editor or the Traceability Matrix by:

  • Comparing requirement sets or link sets files: You can compare the two versions of requirement sets or link sets files.

  • Clearing the issues in the Requirements Editor: If a change has no impact, you can clear the change issue. If the change issue affects the requirements or the test cases, resolve the discrepancy, then clear the issue.

  • Clear the issue by using the Traceability Matrix window: In the Traceability Matrix, click Highlight Missing Links > Highlight Changed Links to highlight the row, column, and cell associated with the changed requirement. From the Filter Panel, select Change Tracking > With Change Issues to filter the test cases that changed.

Resolve Change Issues

The Requirements Editor displays change information, including change issues, for each link. Click Show Links and, in the Details pane, expand Change Information. Requirements Toolbox compares the stored timestamp and revision to the current timestamp and revision for the linked artifact. If you change the source or the requirement after you create the link, or after the last time you changed it, then the Requirements Editor indicates a change issue.

You can resolve change issues from the Requirements Editor or the Traceability Matrix. If a change has no impact, you can clear the change issue. The link change information is updated with the current timestamp and revision for the requirement. If the change issue affects the status of your requirements, you can change the model, the requirements, the test cases, or the links themselves to resolve the revision discrepancy, and then clear the issue.

In the Requirements Editor, links with change issues are highlighted in red when Show Links is selected. To clear a change issue, select the link and, in the Details pane, under Change Information, click Clear Issue.

In the Traceability Matrix, you can highlight links with change issues by selecting Highlight Missing Links > Highlight Changed Links. To clear the change issue, select the cell containing the link and, in the toolstrip, click Clear Change Issue.

Clear Change Issues for Multiple Links

You can clear change issues for multiple links at a time in the Requirements Editor or in the Traceability Matrix.

In the Requirements Editor, select multiple links by pressing Shift or Ctrl and clicking the links. Right-click one of the selected links and click Clear Issue from the context menu. To clear all change issues for an entire link set, select the link set and, in the Details pane, under Change Information, click Clear All. You can also right-click the link set and select Clear All Change Issues from the context menu.

In the Traceability Matrix, select multiple cells by clicking and dragging, or pressing Shift or Ctrl, click the cells, and click Clear Change Issue in the toolstrip.

Add Comments to Links

When you resolve change issues, it is good practice to add a comment to the link describing the action that you took. Each link has a Comments property. When you clear a change issue in either the Requirements Editor or Traceability Matrix, a dialog box appears and you are prompted to add a comment.

To add an additional comment:

  1. In the Requirements Editor, click Show Links.

  2. Select the link.

  3. In the Details pane, under Comments, click Add Comment.

Manually Check for Using Links Change Tracking

Change tracking information is automatically updated in the Requirements Editor, but it can also be manually refreshed. To refresh the change tracking information:

  • In the Requirements Editor, click Refresh.

  • In the Traceability Matrix, click Update.

In the Traceability Matrix, change tracking information must be refreshed manually.

Related Topics