Requirements Traceability with IBM Rational DOORS Next Generation

You can link and trace Simulink® model elements to requirements in IBM® Rational® DOORS® Next Generation. Before you begin, configure IBM Rational DOORS Next Generation for communication with MATLAB® by following the instructions in Install the Simulink Requirements Widget in IBM Rational DOORS Next Generation. Enable bidirectional requirements traceability with IBM Rational DOORS Next Generation:

  1. In the Apps tab, click Requirements Manager. In the Requirements tab, select Link Settings > Linking Options.

  2. Switch to the Selection Linking tab and select DOORS in the Enabled applications field.

  3. Select Modify destination for bidirectional linking.

Link to Requirements in IBM Rational DOORS Next Generation

To link and trace your Simulink model elements to requirements in IBM Rational DOORS Next Generation, use any of these workflows:

Link to Requirements by Using the Outgoing Links Editor Dialog Box

  1. Right-click the Simulink model element to which you want to link IBM Rational DOORS Next Generation requirements.

  2. Select Requirements > Open Outgoing Links dialog.

  3. In the Outgoing Links dialog box, click New and select OSLC Resource as the Document type.

  4. Click Browse.

  5. Enter your IBM Rational DOORS Next Generation login credentials. From the drop-down list, select the active project name in IBM Rational DOORS Next Generation.

  6. Switch to the Document Index tab and select the requirements that you want to link to from the list of requirements. To create the link, click OK.

Link to Selected Requirements in a Project by Using the Simulink Context Menu

Install the Simulink Requirements widget in IBM Rational DOORS Next Generation. For more information, see Install the Simulink Requirements Widget in IBM Rational DOORS Next Generation

  1. In IBM Rational DOORS Next Generation, open the Mini Dashboard and pin it to the screen.

  2. Switch to the Browse Artifacts view.

  3. Select the requirements that you want to link to by selecting the check box next to the requirement.

    The requirements that you select for linking are displayed in the Simulink Requirements widget in the Mini Dashboard.

  4. Right-click the Simulink model element to which you want to link IBM Rational DOORS Next Generation requirements.

  5. Establish links to the requirements by selecting Requirements > Link to Current Item in DNG.

    Click List Projects in the dialog box that appears and select the requirements from within IBM Rational DOORS Next Generation.

Link to the Requirements in a Project by Using the Numeric ID

Use this option if you are unable to link to requirements by using the Outgoing Links dialog box or by using the Simulink context menu.

  1. Right-click the Simulink model to which you want to link IBM Rational DOORS Next Generation requirements.

  2. Select Requirements > Link to Current Item in DNG.

  3. Click Manual entry in the dialog box that appears and enter the numeric ID for the link target. Establish links to the requirements by clicking OK.

Navigate to Requirements from Simulink

Right-click the Simulink model element that requirements have been linked to. Select Requirements and navigate to the corresponding requirement in IBM Rational DOORS Next Generation by clicking the navigation shortcut at the top of the menu.

Work with IBM Rational DOORS Next Generation Projects with Configuration Management Enabled

Projects with configuration management enabled in IBM Rational DOORS Next Generation support multiple branches called streams and changesets. Changesets are akin to shared development branches that can later be merged with the parent main stream. Simulink Requirements enables you to update the outgoing link destination for an existing link in Simulink to the same requirement in a different stream or changeset.

You can select the IBM Rational DOORS Next Generation Project and the configuration stream or changeset you want to work with. At the MATLAB command prompt, enter:

oslc.configure

The Simulink Requirements widget displays information about the current configuration stream context you work with in Simulink Requirements. The widget indicates if there is a mismatch between the active configuration stream contexts in Simulink Requirements and in IBM Rational DOORS Next Generation by highlighting the active configuration stream context in Simulink Requirements.

To resolve the mismatch, click the highlighted text in the widget. Click Update in the DNG Configuration Context Mismatch dialog box to update the configuration stream context in Simulink Requirements to be consistent with the current configuration stream context in IBM Rational DOORS Next Generation. Alternatively, you can change the active configuration stream in IBM Rational DOORS Next Generation.