User tags are user-defined keywords that you associate with specific requirements. With user tags, you can highlight a model or generate a requirements report for a model in the following ways:
Highlight or report only those requirements that have a specific user tag.
Highlight or report only those requirements that have one of several user tags.
Do not highlight and report requirements that have a specific user tag.
To apply one or more user tags to a newly created requirement:
Open the example model:
Open the fuel rate controller subsystem.
To open the requirements document, right-click the Airflow calculation subsystem and select Requirements Traceability > Open Link Editor.
The Requirements Traceability Link Editor opens with the details about the requirement that you created.
In the User tag field, enter
one or more keywords, separated by commas, that the RMI can use to
filter requirements. In this example, after
enter a comma, followed by the user tag
specify a second user tag for this requirement.
Are not case sensitive.
Can consist of multiple words. For example, if you
design requirement, the entire phrase constitutes
the user tag. Separate user tags with commas.
Click Apply or OK to save the changes.
slvnvdemo_fuelsys_officereq model includes
several requirements with the user tag
This section describes how to highlight only those model objects that
have the user tag,
In the Simulink® Editor, remove highlighting from
slvnvdemo_fuelsys_officereq model by selecting Analysis > Requirements Traceability > Unhighlight model.
Select Analysis > Requirements Traceability > Settings.
In the Requirements Settings dialog box, click the Filters tab.
To enable filtering with user tags, click the Filter links by user tags when highlighting and reporting requirements option.
To include only those requirements that have the user
test in the Include
links with any of these tags field.
In the Simulink Editor, select Analysis > Requirements Traceability > Highlight model.
The RMI highlights only those model objects whose requirements
have the user tag
test, for example, the MAP sensor.
Reopen the Requirements Settings dialog box to the Filters tab.
In the Include links with any
of these tags field, delete
In the Exclude links with any
of these tags field, add
In the model, the highlighting changes to exclude objects whose
requirements have the
test user tag. The MAP sensor
and Test inputs blocks are no longer
In the Simulink Editor, select Analysis > Requirements Traceability > Generate Report.
The report does not include information about objects whose
requirements have the
test user tag.
When creating a succession of requirements links, you can apply the same user tags to all links automatically. This capability, also known as selection-based linking, is available only when you are creating links to selected objects in the requirements documents.
When creating selection-based links, specify one or more user tags to apply to requirements:
In the Simulink Editor, select Analysis > Requirements Traceability > Settings.
Select the Selection Linking tab.
In the Apply this user tag to new links field, enter one or more user tags, separated by commas.
The RMI applies these user tags to all new selection-based requirements links that you create.
Click Close to close the Requirements Settings dialog box.
In a requirements document, select the specific requirement text.
Right-click a model object and select Requirements Traceability.
The selection-based linking options specify which user tags
the RMI applies to the link that you create. In the following example,
you can apply the user tags
reqtslink to the link that you create to your
In the Requirements Settings dialog box, on the Filters tab, are the following options for filtering requirements in a model.
|Filter links by user tags when highlighting and reporting requirements||Enables filtering for highlighting and reporting, based on specified user tags.|
|Include links with any of these tags||Includes information about all requirements that have any of the specified user tags. Separate multiple user tags with commas.|
|Exclude links with any of these tags||Excludes information about all requirements that have any of the specified user tags. Separate multiple user tags with commas or spaces.|
|Apply same filters in context menus||Disables link labels in context menus if any of the specified filters are satisfied, for example, if a requirement has a designated user tag.|
|Apply same filters in consistency checking||Includes or excludes requirements with specified user tags when running a consistency check between a model and its associated requirements documents.|
|Under Link type filters, Disable DOORS surrogate item links in context menus|
Disables links to IBM® Rational® DOORS® surrogate items from the context menus when you right-click a model object. This option does not depend on current user tag filters.