Configure Requirements Toolbox for Interaction with Microsoft Office and IBM DOORS
Requirements Toolbox™ communicates with external tools such as Microsoft® Office, IBM® DOORS®, and IBM DOORS Next so that you can import requirements and establish links between requirements and Model-Based Design items such as Simulink® model elements and tests.
You can configure MATLAB® and Simulink to:
Use ActiveX® controls for navigation from Microsoft Office documents to Simulink models (Windows® only).
Use Requirements Toolbox with IBM DOORS software (Windows only).
Use Requirements Toolbox with IBM DOORS Next web server.
Note
MATLAB Online™ does not support importing requirements from or linking to requirements in Microsoft Word, Microsoft Excel®, or IBM DOORS documents.
Configure Requirements Toolbox for Microsoft Office
If your external requirements document contains backlinks that use ActiveX controls, to use the backlinks, you must register ActiveX controls.
Run MATLAB as an administrator.
At the command prompt, enter:
rmi setup
Press
Y
to register the current MATLAB installation as an ActiveX Automation Server.
Configure Requirements Toolbox for IBM DOORS
After you install IBM DOORS, you must configure your IBM DOORS installation to communicate with MATLAB.
Run MATLAB as an administrator.
At the command prompt, enter:
rmi setup doors
Press
Y
to complete the ActiveX Automation Server setup.Verify the path to your IBM DOORS installation. The setup utility lists the DOORS client installations on your system. You can select a file path from the list or manually enter the path to the folder.
If MATLAB did not detect your DOORS installation, press
2
to enter the installation folder.Restart MATLAB using a non-administrator account.
At the command prompt, enter:
rmi setup doors
You only need to perform this configuration once.
Tip
If Requirements Toolbox does not communicate after performing this setup, try the setup process described in Configure Requirements Toolbox for IBM DOORS Software.
Configure an IBM DOORS Next Server for Integration with Requirements Toolbox
To interface with IBM DOORS Next, you must configure the server for integration with Requirements Toolbox by configuring custom extensions.
Additionally, at the start of each MATLAB session, you must configure your session to interface with IBM
DOORS Next by using slreq.dngConfigure
. For more information, see Configure IBM DOORS Next Session.
Configure the IBM DOORS Next Server for Custom Extensions
In order to integrate your IBM DOORS Next server with Requirements Toolbox, you must configure the server for custom extensions and enable dropins. Additionally, you can install the MathWorks Requirements Toolbox widget, which enables you to propagate selection information from IBM DOORS Next to Requirements Toolbox.
Note
Use this table to determine the installation configuration for the widget that matches your MATLAB version. There is limited cross-compatibility when your MATLAB version does not match the widget installation configuration for that release.
MATLAB Release | Widget Name | Widget Folder name | Hostname or IP Address | Compatibility with Other Releases |
---|---|---|---|---|
R2023b | MathWorks Requirements Toolbox | mwWidgetForDNG | 127.0.0.1 |
|
R2023a | ||||
R2022b | localhost
|
| ||
R2022a | ||||
R2021b | Simulink Requirements | dngsllink_config | ||
R2021a | ||||
R2020b | ||||
R2020a | ||||
R2019b | ||||
R2019a | ||||
R2018b | Selection for Simulink | dngsllink |
| |
R2018a |
To install the widget:
In MATLAB, execute this code to identify the location of the
resources
folder in your MATLAB installation.fullfile(matlabroot,"toolbox","slrequirements","slrequirements","resources")
Open the resources folder in your system file browser.
In the resources folder, copy the widget folder,
mwWidgetForDNG
, into theextensions
folder of your IBM DOORS Next installation. For releases prior to R2022a, use the table to determine the widget folder name.Configure the DOORS Next server for custom extensions and enable dropins, and then restart the server. For more information, see Hosting extensions on the IBM website.
Add the MathWorks Requirements Toolbox widget to the Mini Dashboard in DOORS Next. In the Mini Dashboard, select Add Widget > Add OpenSocial Gadget.
For releases prior to R2022a, consult the table to determine the widget name.
Specify the URL to the
dngsllink_config.xml
file in the widget folder,mwWidgetForDNG
, in theextensions
folder in your server installation folder.For example, if you have Liberty server installed on Windows, the
extensions
folder might be located in:C:/Program Files/IBM/JazzTeamServer/server
. The corresponding URL for adding the widget ishttps://JAZZSERVERNAME:9443/extensions/mwWidgetForDNG/dngsllink_config.xml
.Click Add Widget. The Mini Dashboard displays the widget.