How to Include Linked Requirements Details in Generated Report

The requirements report is a feature in RMI that scans the Simulink model for links to external requirements documents and generates a report. When documents are available for reading during requirements report generation, you have an option to insert referenced document fragments into the generated content to produce a more detailed report.

Requirements Report with Documents Content Inserted

When the target range in a Microsoft Word document includes a table, the table is now included in generated report.

When the target location in Microsoft Word is a subheader, child content is included in generated report. Use this feature with caution: linking to a major subheader in the document could mean large amounts of text are copied from the document into the report.

When the target location is a range of cells in Microsoft Excel, the target worksheet fragment is inserted in the report.

When the target location is a single cell in Microsoft Excel worksheet, the content of cells to the right of the target cell is also inserted into the report.

Include IBM Rational DOORS Attributes in RMI Report

For users linking with IBM Rational DOORS, RMI provides more control over which object attributes to include in the requirements tables.

The default configuration will include DOORS Object Heading, DOORS Object Text and all other attributes except: "Created Thru", all attributes with empty string values, and system attributes that are false.

The list of attribute names to include in generated report is stored as part of RMI settings under user prefdir.

current_settings =
5×1 cell array
'Object Heading'
'Object Text'
'$AllAttributes$'
'$NonEmpty$'
'-Created Thru'
RESULT = RptgenRMI.doorsAttribs(ACTION, ARG)
API for selecting which DOORS attributes to include in generated
requirements report when the "Include details from linked documents"
option in the Requirements Settings is enabled.
Returned RESULT indicates whether the current setting was modified,
except for the 'show' action, where RESULT is a cell array of the
currently configured items.
'add' and 'remove' ACTIONS allow you to add or remove attribute named ARG
Use TYPE actions to include/exclude groups of attributes. Valid ARG
values are 'all', 'user' or 'none'.
Attributes with empty string values are skipped by default to save space
in generated requirements tables. Use the 'nonempty' ACTION to set the
empty value filter 'on' or 'off' for user-defined attributes only.
Use 'show' to query the currently configured set of attributes. Use
'default' to restore the default state.
Examples:
>> RptgenRMI.doorsAttribs('default');
>> RptgenRMI.doorsAttribs('show')
ans =
'Object Heading'
'Object Text'
'$AllAttributes$'
'$NonEmpty$'
'-Created Thru'
where macro entries are labeled with '$', explicitly added attribute
names are prefixed with '+' and explicitly excluded attribute names are
prefixed with a '-'. The default configuration will include DOORS Object
Heading, DOORS Object Text, and all other attributes, except "Created
Thru", attributes with empty string values, and system attributes that
are false.
To limit the list of attributes to a user-defined subset:
>> RptgenRMI.doorsAttribs('type', 'user')
To exclude "Last Modified By" attribute:
>> RptgenRMI.doorsAttribs('remove', 'Last Modified By')
To include "Last Modified On" attribute, even when system attributes are
not included as a group:
>> RptgenRMI.doorsAttribs('add', 'Last Modified On')
To turn OFF the "empty value" filter for user-defined attributes:
>> RptgenRMI.doorsAttribs('nonempty', 'off')
If the link label is always the same as the Object Heading for the target
DOORS object and you do not want to duplicate the information in the
report, skip the Object Heading:
>> RptgenRMI.doorsAttribs('remove', 'Object Heading')

Cleanup

Steps in this example might have created files inside the examples folder and modified your stored mapping of .req file names. Click to cleanup.