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:
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.
Open the Requirements Editor:
slreq.editor
In the Requirements Editor, click Import.
In the Importing Requirements dialog box, set Document type to
IBM DOORS Next
.Set Document location to the project that you want to work with.
Under Get requirements from, select Full module hierarchy (takes time if large module). Wait for the DNG Module list to populate.
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.
Select the desired module from the DNG Module list.
Enter the name and file path for the Requirement Set. You can click Browse to browse for a save location.
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
Open the Requirements Editor by entering:
slreq.editor
In the Requirements Editor, click Import.
In the Importing Requirements dialog box, set Document type to
IBM DOORS Next
.Set Document location to the project that you want to work with.
Under Get requirements from, select Filter by query (flat list of matched items).
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
andStakeholder Requirement
.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.
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.
Enter the name and file path for the Requirement Set. You can click Browse to browse for a save location.
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.
See Also
Requirements
Editor | slreq.dngConfigure