Main Content

Import Requirements from IBM DOORS Next

You can manage requirements in IBM® DOORS® Next and import either the entire requirements module or requirements that match a query into Simulink® Requirements™. Simulink Requirements imports the requirements as slreq.Reference objects, which are also called referenced requirements. After you establish links with the imported referenced requirements, you can use the Requirements Editor or Requirements Perspective to navigate from the imported referenced requirements to the original requirement in DOORS Next. You can also measure how the requirements contribute to the implementation status, verification status, and change tracking. For more information, see:

Configure IBM DOORS Next Session

To interface with IBM DOORS Next, you must configure MATLAB® every session. At the MATLAB command prompt, enter:

slreq.dngConfigure
In the DOORS Server dialog box, provide the DOORS Next server address, port number, and service root as they appear in the web browser when accessing DOORS Next. If you do not see a port number, enter the default value of 443. In the Server Login Name and Server Login Password dialog boxes, enter your login credentials. In the DOORS Project dialog box, select the project and, if applicable, the configuration context. If your configuration context is not listed in the Select configuration stream or changeset list, load additional configurations by selecting <more>. For more information about configurations, see Specifying and Updating the IBM DOORS Next Configuration.

MATLAB then tests the connection in your browser. If the connection is successful, the MATLAB Connector Test dialog box appears with a confirmation message. Click OK. If the dialog does not appear or if an error appears after you enter slreq.dngConfigure, see the Tips section of slreq.dngConfigure.

Import DOORS Next Requirements

You can import requirements by selecting a DOORS Next module or by creating a query. Because Simulink Requirements imports requirements as slreq.Reference objects, you must import the requirements into a new requirement set.

Note

When you import requirements from a DOORS Next project that has configuration management enabled, you must select the desired configuration context for your MATLAB session before importing. For more information about enabling configuration management in DOORS Next, see Configuration management in the RM application on the IBM website. For more information about configuring your MATLAB session, see slreq.dngConfigure. The imported requirement set is associated with this configuration for updating and navigating referenced requirements. For more information about configuration management, see Specifying and Updating the IBM DOORS Next Configuration.

Importing a Requirements Module

When you import requirements from a DOORS Next module, the Simulink Requirements imports the entire module.

  1. Open the Requirements Editor:

    slreq.editor

  2. In the Requirements Editor, click Import.

    In the Importing Requirements dialog box, set Document type to IBM DOORS Next.

  3. Set Document location to the project that you want to work with.

  4. Under Get requirements from, select Full module hierarchy (takes time if large module). Wait for the DNG Module list to populate.

  5. Select the desired module from the DNG Module list.

  6. Enter the name and file path for the Requirement Set. You can click Browse to browse for a save location.

  7. Click Import and wait for the process to import the data from the server into Simulink Requirements. When the import completes, the Requirements Editor displays the hierarchy of the imported items.

Importing Requirements by Using Queries

  1. Open the Requirements Editor:

    slreq.editor

  2. In the Requirements Editor, click Import.

    In the Importing Requirements dialog box, set Document type to IBM DOORS Next.

  3. Set Document location to the project that you want to work with.

  4. Under Get requirements from, select Filter by query (flat list of matched items).

  5. Click Query Builder to open the OSLC Query Builder dialog box and specify your query. Use the drop-down menus next to Object Type to choose the object type to import.

    For example, you can import only stakeholder requirements by setting the drop-down menus to Is A and Stakeholder Requirement.

  6. To create a query with other query parameters, click Add Filter.

    Note

    If an attribute is only defined for a given type of object, you must set Object Type to that object type before you can filter by that attribute.

  7. When you are done building your query, click Add to Query, then click OK. In the Importing Requirements dialog, the Raw query string is populated.

  8. Enter the name and file path for the Requirement Set. You can click Browse to browse for a save location.

  9. Click Import and wait for the process to import the data from the server into Simulink Requirements.

Update Referenced Requirements

If you update the requirements in DOORS Next after importing them to Simulink Requirements, you can update the requirement set to reflect the changes. In the Requirements Editor, select the top import node and, in the Details pane, under Requirement Interchange, click Re-import Module or Re-run Query, depending on the type of import you originally did.

Tip

Re-importing a large module might take some time. If you know which requirement has changed on the DOORS Next server, you can select that referenced requirement in the Requirements Editor and in the Details pane, under Properties, click Update from Server to update that individual requirement.

If your DOORS Next project has configuration management enabled and you selected a configuration context when you configured your MATLAB session, then the DOORS Next requirement updates from the configuration context.

Navigate from Referenced Requirements to Requirements in DOORS Next

You can use the Requirements Editor to navigate from the referenced requirement to the original requirement in DOORS Next. Select the referenced requirement in the Requirements Editor. In the Details pane, under Properties, click Show in document.

You can also use the Requirements Perspective to navigate from the imported referenced requirement to the original requirement. In a Simulink model, navigate to the Apps tab and select Requirements Manager. Ensure that Layout > Requirements Browser is selected. In the Requirements pane, in the View drop-down, select Requirements. Select a requirement. In the Property Inspector, in the Details tab, under Properties, click Show in document.

If your DOORS Next project has configuration management enabled and you selected a configuration context when you configured your MATLAB session, then the DOORS Next requirement opens in the configuration context.

Linking with Referenced Requirements

After importing requirements from DOORS Next to Simulink Requirements, you can link these referenced requirements the same way you link other slreq.Reference objects. For more information, see Requirement Links.

You can also add backlinks in your DOORS Next project, which allow you to navigate from DOORS Next requirements to items that are linked to the corresponding referenced requirement in Simulink Requirements. For more information, see Inserting Backlinks in DOORS Next.

See Also

Related Examples

More About