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 Requirements Toolbox™. Requirements Toolbox 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:

• Track Requirement Links by Using Implementation Status

• Review Requirements Verification Status

• Track Changes to Requirement Links

Note

Before you import requirements from IBM DOORS Next, you must configure the IBM DOORS Next session. For more information, see Configure IBM DOORS Next Session.

Import DOORS Next Requirements

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

When you import requirements from IBM DOORS Next, Requirements Toolbox sets the Type property based on the external type:

IBM DOORS Next Requirement Type	Requirements Toolbox Requirement Type
Heading	Container
Information	Informational
Diagrams and sketches	Informational
All other types	Functional

For more information, see Requirement Types.

Additionally, Requirements Toolbox disables index numbering for requirements that do not have the external type Heading. For more information, see Customize Requirement Index Numbering.

When you import requirements from a DOORS Next project that has configuration management enabled, you must select the configuration context for your MATLAB^® session before importing. The content of the imported requirements corresponds to the configuration. 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.

You can view the configuration context for the imported requirements by selecting the import node in the Requirements Editor. The Requirements Editor displays the configuration context in the right pane, under Properties, in the Description tab.

Importing a Requirements Module

When you import requirements from a DOORS Next module, the Requirements Toolbox 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. In the Configuration Context section, click Select to display the configuration contexts in the Select configuration stream or changeset list. Select the desired configuration context from the list. Alternatively, you can enter the configuration context name or URL in the Context name field.

   Tip

   To save time, enter the URL in the Context name field instead of entering the context name or using the Select button.

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

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

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

Importing Requirements by Using Queries

1. Open the Requirements Editor by entering:

   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 Requirements Toolbox.

Update Referenced Requirements

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

The software does not indicate that there are available changes from IBM DOORS Next to update in Requirements Toolbox.

If the update changes or removes a referenced requirement that has links, the links have a change issue. For more information, see Track Changes to Requirement Links.

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 right 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 right 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 Browser, 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 Requirements Toolbox, you can link these referenced requirements the same way you link other slreq.Reference objects. For more information, see Create and Store 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 Requirements Toolbox. For more information, see Insert and Remove Backlinks.