In the ReqIF™ file format, a requirement is represented as a
which has user-defined attributes. Simulink®
Requirements™ enables you to map the attributes of a
SpecObject to either
built-in or custom attributes of a requirement and to save this mapping as an XML file for
future use. With the mapping, you can customize how requirements imported from an external
requirements management tool are displayed in Simulink
Simulink Requirements provides attribute mappings for ReqIF files from:
IBM® Rational® DOORS®
IBM Rational DOORS Next Generation
If you want to work with ReqIF files created in a different external requirements management tool, use the
Generic attribute mapping from the Source
tool drop-down list. If the
mapping does not correctly import your requirements, create your own custom attribute
Open the Requirements Editor and import the ReqIF file by selecting the
mapping from the Source tool drop-down list. See Import Requirements from ReqIF Files.
Navigate to the top Import node of the imported requirement set and expand the Attribute Mapping pane on the right.
Map each external attribute in the External Attribute Name column to a built-in or a custom attribute by using the drop-down list in the Mapped To column.
Click Save Mapping. Save the mapping in
matlabroot/toolbox/slrequirements/attribute_maps as an
Restart MATLAB® to include the newly created attribute mapping in the Source tool drop-down list in the Document Import dialog box.
To change the name or description of the attribute mapping, open the XML file that you
created in a text editor and modify the values of the
To have Simulink Requirements select the import attribute mapping based on the tool which originally created the ReqIF file you are importing:
In a text editor, open the attribute mapping and the ReqIF file.
Find the value of the
<REQ-IF-TOOL-ID> tag in the
Change the value of the
<name> tag in the attribute mapping
file to match the value of the
Some external requirements management tools such as Polarion REQUIREMENTS support multiple types of requirements. In this case, modify the attribute mapping file to specify the default ReqIF requirement type to use when exporting to ReqIF. For example:
<thisType>SpecObject</thisType> <thisSubType>System Requirement</thisSubType>
<thisSubType>tag indicates that each exported
SpecObjectwill have the
Some external requirements management tools such as Polarion REQUIREMENTS and IBM
DOORS require a specific set of ReqIF data type, attribute, and
SpecObject type definitions.
They may also require that the ReqIF specification be of a certain type. You can supply these definitions by
specifying in the mapping file the name of a template
produced by the external requirements management tool. During ReqIF export, Simulink
Requirements imports the template file and uses it to:
Create an instance of the ReqIF data model based on the template with the expected data type,
SpecObject type definitions.
Remap the requirements content to the expected data types and attributes.
Using the template ensures that the exported file can be readily imported into the external requirements management tool.
Save the template files in the same folder as the attribute mapping file
matlabroot/toolbox/slrequirements/attribute_maps). To specify a
template file in the attribute mapping, open the attribute mapping file corresponding to
the external requirements management tool in a text editor. Modify the value of the
<templateFile> tag to match the name of the template