Learn how to export Word HTML reports with requirement IDs embedded in the requirements text description paragraph instead of placing IDs in a separate column.
The common practice of capturing requirements in MS Word is to store requirement IDs at the start of the corresponding requirement description paragraph, for instance:
[SRS-123] The exported document in MS Word shall have the text description of all requirements prefixed by requirement ID.
From this reason, we have modified both predefined export templates of MS Word HTML — MS Word (Table) and MS Word (Book), to output requirement IDs as the corresponding requirements text description prefix instead of placing IDs in a separate column:
You can apply this formatting also in your custom HTML export templates. You can use formatPrefixedXHTML template helper (new in v2.2.4) which adds a custom prefix given by the child block to a given XHTML value. You can optionally provide a paragraph class name for
<div> tags in paragraphClass parameter and a character class name in charClass parameter.
The following HTML template snippet formats value of requirement text attribute (requirement text description) prefixed by the value of id attribute (unique identifier):
The id prefix is not added for section objects with heading attribute because these objects are displayed with section numbers. Exported requirement description paragraphs are marked by paragraph class text for which you can customize paragraph style in your MS Word template in which you insert the MS Word HTML file exported from ReqView, see Import into MS Word. For instance, you can increase its top and bottom paragraph margins as demonstrated on the above screenshot.
For more information about HTML export check following documentations sections:
You can download example templates after login to the ReqView support portal:
- WordTableExportTemplate.html — HTML export template which exports MS Word HTML with table layout
- WordBookExportTemplate.html — HTML export template which exports MS Word HTML with book layout
- ReqView-Word_Template.dotx — MS Word template with predefined ReqView export styles, a cover page, a table of content and a page header and footer