Documentation

Import Requirements from Third-Party Tools

Using the Requirements Editor in Simulink® Requirements™, you can work with requirements from third-party applications such as Microsoft® Word and Microsoft Excel®.

You can choose to import external requirements content into Simulink or to create read-only references to external requirements content in Simulink.

Importing external requirements into Simulink means that you can edit your requirements directly from within Simulink. If you are performing all requirements-based activity from within Simulink, choose this option. Requirements that you have imported into Simulink appear with a icon in the Requirements Editor.

You can choose to import requirements as read-only references. This option ensures that your imported requirements retain their dependencies to the original requirements document. Edit the original requirements document and click Update in the Properties pane of the Requirements Editor to change your imported requirements. Requirements that are referenced from external documents appear with a icon in the Requirements Editor.

Before starting the import process,

  1. Open the Microsoft Word or Microsoft Excel document.

  2. Open the Requirements Editor. by selecting Analysis > Requirements > Requirements Editor from the Simulink menu.

  3. Open the Document Import Wizard. In the Requirements Editor, select File > Import. Select the document type in the Source pane. The document location is populated automatically.

    Note

    If you have more than one document open, the most recently opened document is selected for import.

Import Options for Microsoft Word Documents

You can import requirements in plain and rich text formats from Microsoft Word documents. Use the rich text format to import requirements content such as graphics, tables, and other rich formatting.

By default, imported requirements content matches the Microsoft Word document outline of section headings. You can also import selectively requirements by using the following qualifiers from the Requirement Identification menu:

  • Predefined bookmarks in Microsoft Word to identify items and to serve as custom IDs.

  • Regular expression search patterns to identify items by occurrence. For more information on regular expression search patterns, see Regular Expressions (MATLAB).

  • You can also choose to ignore outline numbers in the section headers of your Microsoft Word document.

Import Options for Microsoft Excel Spreadsheets

You can import requirements in plain and rich text formats from Microsoft Excel spreadsheets. The plain text format imports only text and associates each column of your spreadsheet to a requirement property. The rich text format imports graphics, layouts, and captures multicell ranges.

Use the qualifiers from the Requirement Identification menu to select a subset of your spreadsheet to import requirements from:

  1. Choose individual rows and columns by mapping columns to requirement attributes. Select Specify rows and columns and click Configure columns. If there are no predefined headers in your spreadsheet, Simulink Requirements prompts you to specify the row that contains headers for attribute names.

  2. Select the range of rows and columns to import from the Configure columns dialog box. Select how each column in your spreadsheet can be mapped to Properties and Custom Attributes by choosing an option from the drop-down list. Consider the following when you map columns to Properties and Custom Attributes:

      • You can select only one column each for the Custom ID and Summary.

      • You can select one or more continuous columns for the Description and the Rationale. The contents of these columns are concatenated into one field after the import is completed.

      • You must select at least one column for the Summary or the Description.

    Skip columns from being imported by selecting the Ignore option.

  3. You can use regular expression search patterns to identify items by occurrence. For more information on regular expression search patterns, see Regular Expressions (MATLAB).

Was this topic helpful?