Learn more about Simulink Verification and Validation

Navigating from Requirements Documents to Simulink Objects

On this page…
Configuring the RMI to Insert Navigation Controls Enabling ActiveX Controls Creating Navigation Controls in Requirements Documents Troubleshooting Simulink Navigation Controls in Microsoft Office 2007

Configuring the RMI to Insert Navigation Controls

To create links from the requirements document to Simulink objects, the RMI inserts Microsoft^® ActiveX^® controls into the requirements document. To initiate that, first run the RMI setup script. At the MATLAB Command Window, enter the following command:

rmi setup

This command runs a setup script that registers ActiveX^® controls that the RMI inserts into requirements documents. If you enable this feature, as described in Enabling ActiveX Controls, the RMI can insert these controls into requirements documents when you create selection-based links. These controls allow you to navigate from a requirements document to the linked Simulink object.

Note   If you have installed IBM Rational DOORS software on the machine, this command also invokes the corresponding setup script for the IBM Rational DOORS software. For more information, see Configuring the Requirements Management Interface for DOORS Software.

Back to Top

Enabling ActiveX Controls

When you use selection-based linking to create a link from a Simulink object to a requirements document, the RMI does not automatically insert a navigation object in the requirements document. (It does insert a bookmark, when necessary, to enable the RMI to link to the correct location in the requirements document.)

To enable the RMI to insert a navigation object when creating a selection-based link:

1. In the Model Editor, select Tools > Requirements > Settings.

2. Select the Selection-based linking tab.

3. Select Modify documents to include links to models to allow the RMI to insert the navigation controls.

4. Click Close to close the Requirements Settings dialog box.

Note   For more information about the selection-based linking settings, see Customizing Selection-Based Linking.

Back to Top

Creating Navigation Controls in Requirements Documents

If you enable the Modify documents to include links to models option, you can create navigation controls that link from the requirements document back to the Simulink object. Follow these steps, used for selection-based linking with the sf_car_linking model:

1. Open the requirements document requirements.docx.

2. Select the text under "Engine Requirements."

3. Open the sf_car_linking model.

4. Right-click the engine RPM block and select Requirements > Add link to Word selection.

5. The RMI inserts an ActiveX control into the requirements document.

   

Back to Top

Troubleshooting Simulink Navigation Controls in Microsoft Office 2007

• Saving Requirements Documents to Microsoft Word 2007 Format

• Field Codes in Requirements Document

• ActiveX Control Does Not Link to Model Element

• Deleting an ActiveX Control from Microsoft Excel 2007 file

Saving Requirements Documents to Microsoft Word 2007 Format

If you create a requirements document with an earlier version of Microsoft Word than Word 2007, the two-way links automatically work. If you save the document in Microsoft Word 2007 format, make sure that the two-way links continue to work:

1. In the Microsoft Word window, in the upper-left corner, click the Microsoft Office Button.

   

2. Select Save As > Word Document.

   You see the following dialog box.

   

3. Click OK.

   You then see the following dialog box.

   

4. Click Yes to save the current document in Microsoft Word 2007 format, with a .docx extension.

Field Codes in Requirements Document

If your Microsoft Word requirements document displays the field codes in addition to, or instead of, the ActiveX icon, you must change a setting in Microsoft Word 2007.

The following graphic shows a requirements document created in Microsoft Word 2003, with the field codes displayed.

The following graphic shows a requirements document created in Microsoft Word 2007, with the field codes displayed.

To hide the field codes and display the ActiveX icon:

1. In the Microsoft Word window, in the upper-left corner, click the Microsoft Office Button.

   

2. In the pane that opens, at the bottom, click Word Options.

   

3. In the left-hand portion of the pane, click Advanced.

4. In the Advanced pane, scroll to the Show document content section and clear the Show field codes instead of their values option.

   

ActiveX Control Does Not Link to Model Element

If you click an ActiveX control that links to a Simulink or Stateflow object, and the object does not open, you have two options:

• Store your requirements documents in trusted locations, as described in the Microsoft Office 2007 documentation. The Trust Center does not check files for ActiveX controls stored in trusted locations, so you can maintain your Trust Center restrictions.

• Enable ActiveX controls:

  1. In the Microsoft Word or Microsoft Excel window, in the upper-left corner, click the Microsoft Office Button.

     

  2. In the pane that opens, at the bottom, click Word Options or Excel Options, depending on which program you are running.

     

     

  3. In the left-hand portion of the pane, click Trust Center.

  4. In the Trust Center pane, click Trust Center Settings.

  5. In the Trust Center pane, on the right select ActiveX Settings.

     

  6. Select the setting that you want for ActiveX controls:

     • Prompt me for enabling all controls with minimum restrictions to decide each time you click an ActiveX control if you want to enable all controls.

     • Enable all controls without restrictions and without prompting to enable all ActiveX controls.

  7. Close the application and restart your computer so that the settings go into effect.

Deleting an ActiveX Control from Microsoft Excel 2007 file

To remove an ActiveX control from your Microsoft Excel 2007 file:

1. Your document has an ActiveX control in a worksheet cell.

   

   In the Microsoft Excel window, in the upper-left corner, click the Microsoft Office Button.

   

2. In the pane that opens, at the bottom, click Excel Options.

   

3. In the Excel Options dialog box, in the left-hand pane, click Popular.

   

4. On the Popular pane, in the Top options for working with Excel section, select Show Developer tab in the Ribbon.

   

5. Click OK.

6. On the Developer tab, select Design Mode.

   

   When you select Design Mode, the ActiveX control is no longer visible in the cell.

7. Click where the ActiveX control was, and you see four handles showing the location of the control.

   

8. Select Home > Cut to delete the control.

Back to Top

Creating a Requirements Report

Linking to Custom Types of Requirements Documents

© 1984-2009- The MathWorks, Inc.    -   Site Help   -   Patents   -   Trademarks   -   Privacy Policy   -   Preventing Piracy   -   RSS