Main Content

Import Requirements from Third-Party Applications

You can work with third-party requirements management applications by importing requirements. You can import requirements as new requirement sets, or reference requirements in the third-party application. Supported applications include:

You can only use third-party import with Microsoft Word, Microsoft Excel, and IBM Rational DOORS on Microsoft Windows® platforms. To import requirements using third-party requirements management applications on a Mac or Linux® platform, you must use IBM DOORS Next or an application that uses ReqIF.

Path Settings

Add requirements documents to the MATLAB® path. You can:

  • Store the relative path for the currently running instance of MATLAB,

  • Add the parent folder of the requirements document to the MATLAB path, or

  • Update the Simulink® Requirements™ path preference to always use the relative path. For more information on requirements document path preference, see Document Path Storage.

Import Requirements from Microsoft Office Documents

Importing requirements from Microsoft Office documents is only supported on Windows platforms.

In the Requirements Editor:

  1. Select File > Import.

  2. Select the Document type.

  3. Import the most recently opened document, or browse for another document.

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 and tables.

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

  • Predefined bookmarks in Microsoft Word to identify items and to serve as custom IDs. It is recommended to use bookmarks as requirement Custom IDs as they are persistently stored in the document and cannot be duplicated.

  • Regular expression search patterns to identify items by occurrence. See Regular Expressions.

  • You can choose to ignore outline numbers in the section headers of your Microsoft Word document. If you import requirements as references, it is recommended to ignore outline numbers to prevent issues with the Update process.


If you do not have images in your requirements document, consider importing your requirements as plain text to prevent some issues related to font, style, or whitespace differences.

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. In the Configure columns dialog box, select the range of rows and columns to import. Select how each column in your spreadsheet can be mapped to Properties and Custom Attributes by choosing an option from that drop-down list. When you map columns to Properties and Custom Attributes, consider:

    • You can select only one column each for the Custom ID and Summary. If you cannot map one of the columns in the spreadsheet to a column that holds unique requirement Custom IDs, the Import operation automatically generates unique Custom IDs based on the rows in the spreadsheet. These Custom IDs might not be persistent. If you explicitly select a column that does not have unique Custom IDs, you cannot update the requirements document later.

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

    To omit columns from the import, select the Ignore option.

  3. You can use regular expression search patterns to selectively identify and import items by occurrence. See Regular Expressions.

Import Requirements from ReqIF Files

Many third-party requirements management applications can export and import requirements using the ReqIF format. You can import requirements from a ReqIF file as references to a third-party source, or as new requirement sets. You can import requirements from a ReqIF file on Microsoft Windows, Linux and Mac platforms.

Third-party applications that use ReqIF with particular attribute mapping include:

  • Polarion™

  • PREEvision

  • IBM Rational DOORS

  • IBM Rational DOORS Next Generation

Other third-party applications can use generic ReqIF mapping.

Third-party Specific Server Configuration

Polarion: When working with Polarion, modify the Polarion server configuration to use the actual server name in repo and base.url property values. Do not use localhost.

  1. Open the file found in the <polarion_installation>/polarion/configuration/ folder.

  2. Modify these lines:

    • repo=http://localhost:80/repo/

    • base.url=http://localhost:80/

    by replacing localhost with the externally known name for your server.

ReqIF Import Workflow

To import requirements from a ReqIF file:

  1. In the Requirements Editor, select File > Import.

  2. For Document type, select ReqIF file (*.reqif or *.reqifz).

  3. For Document location, select the ReqIF file location.

  4. Simulink Requirements detects the source tool of the ReqIF file. You can also manually select a Source tool, or select Generic if the source is unknown.

  5. Select the location for the destination requirement set.

  6. Select whether to allow updates to the imported requirements:

    1. If your requirements are maintained in an external tool, and you want to be able to update the imported requirement set with updated versions of the ReqIF file, select Allow updates from external source.

    2. To establish the Simulink Requirements set as the primary requirements artifact, do not select Allow updates from external source.

  7. Complete the import process by clicking Import.

Importing Multiple ReqIF Specifications

You can import multiple source specifications from ReqIF files. When you import ReqIF files that contain multiple source specifications, you can choose to:

  1. Select a single ReqIF source specification to import into a requirement set.

  2. Combine ReqIF source specifications into one requirement set. Each specification is imported into its own Import node. You can update each Import node independently.

  3. Import each ReqIF source specification into a separate requirement set. Instead of selecting a destination requirement set, you select a destination folder. The import operation creates multiple requirement set files in the destination folder.

If a ReqIF file contains a single specification, options 2 and 3 above are not available.

For large ReqIF files, import each source specification into a separate requirement set. This can help reduce file conflicts and simplify change tracking and differencing of individual requirement sets.

In ReqIF, a link is represented as a SpecRelation between two SpecObjects. Select Import links to preserve links in the ReqIF file. Import links is enabled if the ReqIF file has SpecRelations between SpecObjects. After import, Simulink Requirements link set files contain links between requirements or external URLs.

If the ReqIF file does not define SpecRelations, the Import links option is disabled. Only valid links are imported. The link import operation depends on how you import the source specifications:

  1. Importing a single specification into a requirement set imports only the SpecRelations within the specification's SpecObjects. As a result, some links can be omitted.

  2. Combining ReqIF source specifications into one requirement set imports resolved links into one link set.

  3. Importing each ReqIF source specification into a separate requirement set imports resolved links are into separate link sets.

Customize Attribute Display

ReqIF represents a requirement as a SpecObject with user-defined attributes. You can customize how the Requirements Editor and Requirements Browser displays imported requirements data and properties.

To customize the display of imported requirements data, map the attributes of the SpecObject to either built-in or custom attributes of a requirement. You can save this mapping as an XML file for future use.

To modify the attribute mapping after you import, select the top-level Import node of the requirement set (denoted by ) and expand the Attribute Mapping pane. You can also load a previously saved attribute mapping by clicking Load mapping.

Import Modes

Simulink Requirements provides two import modes for importing requirements content. Before you complete the Import process, you must specify if you want to allow updates to your imported requirements from the external requirements document by selecting or clearing Allow updates from external source.

Import Requirements

If you want to permanently migrate your requirements from the external requirements management application, do not allow updates to imported requirements from the external source document. Requirements are then imported as slreq.Requirement objects and are represented by in the Requirements Spreadsheet. Importing requirements as slreq.Requirement objects allows you to freely edit, delete, and rearrange requirements.

Import Referenced Requirements

If you choose to allow updates, requirements are imported as referenced requirements (slreq.Reference objects) that you can unlock and edit within Simulink Requirements.

Referenced requirements retain some dependencies to the source document and are locked for editing by default. Locked requirements are represented by in the Requirements Spreadsheet. Edit an individual requirement by navigating to it and clicking Unlock in the Properties pane. Unlocked requirements are represented by in the Requirements Spreadsheet. Unlock all referenced requirements by navigating to the top import node (denoted by ) and clicking Unlock all in the Requirement Interchange pane. You cannot relock requirements after you unlock them, except by updating them. You cannot delete or change the hierarchy of referenced requirements from within Simulink Requirements.

If your requirements are imported from an external source, other users are likely to change them in the external source document. To make your referenced requirements reflect the latest version of the requirements as in the external source document, obtain an updated file from the external source. Updating requirements from the external document overwrites all the local changes that you made to imported requirements content.

The Update operation preserves local custom attributes you create within Simulink Requirements. If you have attributes with the same name in the requirement set and in the external source document, the Update operation overwrites the local values with the attribute values defined in the external source document.

When working with referenced requirements, you can navigate to the requirement in the external source document by clicking Show in document in the Properties pane. If there is a change in the source document's file name or location, right-click the top node of the requirement set and select Update source document name or location.

See Also

Related Topics