Requirements Traceability with IBM DOORS Next

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

  1. In Simulink, in the Apps tab, click Requirements Manager.

  2. In the bottom pane, in the View drop-down menu, ensure that Links is selected.

  3. In the Requirements tab, in the toolstrip, select Link Settings > Linking Options.

  4. Switch to the Selection Linking tab and ensure that DOORS is selected in the Enabled applications field.

    Note

    If DOORS is disabled as an option in the Selection Linking tab, see Link with Requirements in IBM DOORS Next and its section Configuring MATLAB Session.

  5. Select Modify destination for bidirectional linking.

Link to Requirements in IBM DOORS Next

To link and trace your Simulink model elements to requirements in IBM DOORS Next, 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 DOORS Next requirements.

  2. Select Requirements > Open Outgoing Links dialog.

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

  4. Click Browse.

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

  6. If your DOORS project has modules, the Document Index tab will list module names. Click the module that contains the item you want to link with.

  7. When the list updates to display requirements in the module, select the requirements that you want to link with. To create the link, click OK or Apply to create the link.

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

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

  1. In IBM DOORS Next, 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 DOORS Next requirements.

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

  6. Right click the Simulink element again to see the new link at the top of the Requirements context menu. Click the link label to test navigation.

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 DOORS Next 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 DOORS Next by clicking the navigation shortcut at the top of the menu.

Additionally, you can find the link destination in Requirements Editor in the Links pane when Requirements is selected in the View drop-down menu, or in the Properties pane when Links is selected in the View drop-down menu.

Work with IBM DOORS Next Projects with Configuration Management Enabled

Projects with configuration management enabled in IBM DOORS Next 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 DOORS Next Project and the configuration stream or changeset you want to work with. At the MATLAB command prompt, enter:

slreq.dngConfigure
For additional information on traceability between IBM DOORS Next and Simulink Requirements, see IBM Rational DOORS Traceability, specifically the functions beginning with slreq.dng. You can redirect existing links to another stream or changeset using these functions.

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 DOORS Next 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 DOORS Next . Alternatively, you can change the active configuration stream in IBM DOORS Next.