Main Content

Configure RMI for Interaction with Microsoft Office and IBM Rational DOORS

The Requirements Management Interface (RMI) communicates with external tools such as Microsoft® Office and IBM® Rational® DOORS® so that you can establish links between requirements and Simulink® model elements.

Configure the RMI to:

  • Use ActiveX® controls for navigation from Microsoft Office documents to Simulink models (PC only).

  • Use the RMI with IBM Rational DOORS software (Windows® only).

  • Use the RMI with IBM DOORS Next (DNG) web server.

Configure RMI for Microsoft Office

When you work with older requirements documents that include ActiveX controls inserted by previous versions of Simulink, register ActiveX controls. More recent Simulink versions use HTTP hyperlinks to navigate from Microsoft Office to Simulink.

  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 RMI for IBM Rational DOORS

You must configure your IBM Rational DOORS installation to communicate with MATLAB.

  1. Run MATLAB as an administrator.

  2. At the command prompt, enter:

    rmi setup

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

  4. Verify the path to your IBM Rational DOORS installation. The setup utility will list DOORS client installations found on your system. You can select a file path from the list or use the option to manually enter the path to the folder.

  5. If the DOORS installation was not detected in the previous step, press 2 to enter the installation folder.

Note

You can directly access the IBM Rational DOORS – MATLAB Interface setup utility. At the command prompt, enter:

rmi setup doors

Configure RMI for IBM DOORS Next

You do not need to use rmi setup for DOORS Next integration. However, if you use rmi setup for Microsoft Office or DOORS 9 integration, you can continue with the setup for DOORS Next. The utility prompts you to enter your DOORS Next server address and port number. You can enter the values at that point, and you can easily adjust those in each future MATLAB session. To read more about configuring MATLAB and Simulink with IBM DOORS Next, see Requirements Traceability with IBM DOORS Next.

Install the Simulink Requirements Widget in IBM DOORS Next

The Simulink Requirements™ widget enables you to propagate selection information from IBM DOORS Next.

  1. In the Windows File Explorer, navigate to the folder toolbox\slrequirements\slrequirements\resources in your MATLAB installation.

  2. Copy the dngsllink_config folder into the extensions subfolder of your IBM DOORS Next installation. The location of this folder depends on your server version.

  3. Configure the DOORS Next server for custom extensions, and then restart the server. For details on this process, see the IBM RM Extensions Hosting Guide

  4. After copying the dngsllink_config folder to your server, add the Simulink Requirements widget to the Mini Dashboard in DOORS Next.

  5. In the Mini Dashboard, select Add Widget > Add OpenSocial Gadget.

  6. Specify the URL to dngsllink_config.xml that corresponds to the extensions\​dngsllink_config subfolder in your server installation folder.

For example, if you have Liberty server installed on Windows, the extensions subfolder may be located in: C:/Program Files/IBM/JazzTeamServer/server. The corresponding URL for adding the widget will be: https://JAZZSERVERNAME:9443/extensions/dngsllink_config/dngsllink_config.xml.