Link Test Cases to Requirements Documents

Since requirements specify behavior in response to particular conditions, you can build test cases (test inputs, expected outputs, and assessments) from the model requirements. Test cases reproduce specific conditions using test inputs, and assess the actual model output against the expected outputs. As you develop the model, build test files that check system behavior and link them to corresponding requirements. By defining these test cases in test files, you can periodically check your model and archive results to demonstrate model stability.

Establish Requirements Traceability for Testing

If you have a Simulink® Test™ and a Simulink Requirements™ license, you can link requirements to test harnesses, test sequences, and test cases. Before adding links, review Supported Requirements Document Types.

Requirements Traceability for Test Harnesses

When you edit requirements links to the component under test, the links immediately synchronize between the test harness and the main model. Other changes to the component under test, such as adding a block, synchronize when you close the test harness. If you add a block to the component under test, close and reopen the harness to update the main model before adding a requirement link.

To view items with requirements links, on the Apps tab, under Model Verification, Validation, and Test, click Requirements Manager. In the Requirements tab, click Highlight Links .


Requirements Traceability for Test Sequences

In test sequences, you can link to test steps. To create a link, first find the model item, test case, or location in the document you want to link to. Right-click the test step, select Requirements, and add a link or open the link editor.

To highlight or remove the highlighting from test steps that have requirements links, toggle the requirements links highlighting button in the Test Sequence Editor toolstrip. Highlighting test steps also highlights the model block diagram.

Requirements Traceability for Test Cases

If you use many test cases with a single test harness, link to each specific test case to distinguish which blocks and test steps apply to it. To link test steps or test harness blocks to test cases,

  1. Open the test case in the Test Manager.

  2. Highlight the test case in the test browser.

  3. Right-click the block or test step, and select Requirements > Link to Current Test Case.

Requirements Traceability Example

This example demonstrates adding requirements links to a test harness and test sequence. The model is a component of an autopilot roll control system. This example requires Simulink Test and Simulink Requirements.

  1. Open the test file, the model, and the harness.

    open AutopilotTestFile.mldatx,
    open_system RollAutopilotMdlRef,'RollAutopilotMdlRef/Roll Reference',...
  2. In the test harness, on the Apps tab, under Model Verification, Validation, and Test, click Requirements Manager. In the Requirements tab, click Highlight Links .

    The test harness highlights the Test Sequence block, component under test, and Test Assessment block.

  3. Add traceability to the Discrete Derivative block.

    1. Right-click the Discrete Derivative block and select Requirements > Open Outgoing Links dialog.

    2. In the Requirements tab, click New.

    3. Enter the following to establish the link:

      • Description: DD link

      • Document type: Text file

      • Document: RollAutopilotRequirements.txt

      • Location: 1.3 Roll Hold Reference

    4. Click OK. The Discrete Derivative block highlights.

  4. To trace to the requirements document, right-click the Discrete Derivative block, and select Requirements > DD Link. The requirements document opens in the editor and highlights the linked text.

  5. Open the Test Sequence block. Add a requirements link that links the InitializeTest step to the test case.

    1. In the Test Manager, highlight Requirement 1.3 Test in the test browser.

    2. Right-click the InitializeTest step in the Test Sequence Editor. Select Requirements > Link to Current Test Case.

      When the requirements link is added, the Test Sequence Editor highlights the step.

See Also