Main Content

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.

  1. Run MATLAB as an administrator.

  2. At the command prompt, enter:

    rmi setup

  3. 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.

  1. Run MATLAB as an administrator.

  2. At the command prompt, enter:

    rmi setup doors

  3. Press Y to complete the ActiveX Automation Server setup.

  4. 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.

  5. Restart MATLAB using a non-administrator account.

  6. 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 ReleaseWidget NameWidget Folder nameHostname or IP AddressCompatibility with Other Releases
R2023bMathWorks Requirements ToolboxmwWidgetForDNG127.0.0.1
  • Works with R2022a and newer releases

  • Performance is slower for releases prior to R2022a

R2023a
R2022blocalhost
  • Works with R2019a–R2021b

  • Performance is slower for releases after R2021b

R2022a
R2021bSimulink Requirementsdngsllink_config
R2021a
R2020b
R2020a
R2019b
R2019a
R2018bSelection for Simulinkdngsllink
  • Not compatible with releases after R2018b

R2018a

To install the widget:

  1. In MATLAB, execute this code to identify the location of the resources folder in your MATLAB installation.

    fullfile(matlabroot,"toolbox","slrequirements","slrequirements","resources")

  2. Open the resources folder in your system file browser.

  3. In the resources folder, copy the widget folder, mwWidgetForDNG, into the extensions folder of your IBM DOORS Next installation. For releases prior to R2022a, use the table to determine the widget folder name.

  4. 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.

  5. 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.

  6. Specify the URL to the dngsllink_config.xml file in the widget folder, mwWidgetForDNG, in the extensions 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 is https://JAZZSERVERNAME:9443/extensions/mwWidgetForDNG/dngsllink_config.xml.

  7. Click Add Widget. The Mini Dashboard displays the widget.

See Also

Related Topics

External Websites