Main Content

Link to Test Cases from Requirements

If you have Simulink® Test™ and Requirements Toolbox™, you can link your requirements to test cases in the Test Manager. Linking to tests lets you see how requirements are confirmed with tests.

These links also help you to see your progress toward verifying the implementation of each requirement. Requirements Toolbox can display verification status. Verification status helps you to see the requirements that are verified, the requirements that are missing tests, and whether tests associated with your requirements passed or failed.

In this tutorial, you link requirements to test cases associated with a controller model of an automobile cruise control system, managed in a project. After you run the tests, you include the results in the Requirements Editor.

  1. Open the project. At the MATLAB® command prompt, enter:

  2. Open the controller model. At the command prompt, enter:

  3. Open the Test Manager. In the Apps tab, click Simulink Test. In the Test tab, click Simulink Test Manager.

  4. In the Simulink Test Test Manager, from the tests folder, open the DriverSwRequest_Tests.mldatx test file.

  5. In the Test Browser pane, expand the test case hierarchy. The test file contains the test cases for several of the requirements in the crs_controller model. Most of these tests cases already link to requirements.

    Link the Increment button hold test to a requirement. Select that test case.

  6. Open the Requirements Editor. Navigate back to the crs_controller Simulink model. In the Apps tab, under Model Verification, Validation, and Test, click Requirements Editor.

  7. Click Show Requirements. Display the requirements hierarchy for crs_req_func_spec.

  8. Right-click the requirement with the ID 1.3 (Long Switch recognition) and select Link from Selected Test Case.

    The link to the test case appears in the right pane, under Links.

  9. View verification information for other requirements 1.4, 1.6, 1.8, and 1.9 by selecting each requirement. The links are displayed in the right pane, under Links, under Verified by.

  10. To run linked tests, in the Test Manager, select the top node in the test hierarchy in the Test Browser pane, then click Run.

    The Results and Artifacts pane in the Test Manager shows that 7 tests passed and 1 test failed. Expand the results. The Cancel button test failed and the other tests passed.

  11. In the Requirements Editor, select Columns > Verification Status. Resize the requirements browser window to see the Verified column.

    This view shows you the progress toward verification. Some requirements do not yet have tests. Some requirements are fully verified. The width of the verified display shows the proportion of subrequirements that have links to verification. The color of the display indicates the proportion of tests that have passed, failed, or not run.

    Here, the Cancel Switch Detection verification status shows that the test failed. Some requirements are partially verified because the subrequirements are not yet verified, such as requirement 1.8 in the figure. Hover over the verification status bar for details about the subrequirements. Other requirements are unverified because they are not linked to a test case.

Related Topics