ReqView presents structure information about the current document in the left pane, structured table view of the document in the center pane and detailed information about the selected document object in right panes.
The left pane Contents displays the table of contents helping you with navigation in the document structure. You can toggle the Contents pane by View > Contents Pane menu or by CtrlAltT shortcut.
The right panes display details of the selected object. The Attributes pane list custom attributes of the current document object. You can toggle it by View > Attributes Pane menu or by CtrlAltA shortcut.
The Discussion pane shows discussion comments related to the current document object. You can toggle it by View > Discussion Pane menu or by CtrlAltD shortcut.
The Links pane shows traceability links related to the current document object grouped by link type. You can toggle it by View > Links Pane menu or by CtrlAltL shortcut.
The History pane displays history of changes of the current document object. You can toggle it by View > History Pane menu or by CtrlAltH shortcut.
The center pane displays the Requirements Table which combines a tree view of the current document structure and a table view with columns displaying additional information for each object. The Requirements Table can display following columns:
You can refresh the table view by by View > Refresh menu or by pressing F5 shortcut.
When you open a project, the visible columns and their widths are set up for each document according to the Default View saved in the Project File or Project Folder.
You can customize the table view for each document:
The current table view given by order, widths and display status of all table columns is persistently saved and restored after each application restart.
To save your current document view to the Project File or Project Folder as the Default View use the Document > Default View > Set Default View menu item and save the project by File > Save.
To restore the Default View saved in the Project File or Project Folder use the Document > Default View > Restore Default View menu item.
Note that Template Columns are only stored in your current view. If you want to persist a Template Column change in the Project File or Project Folder, you need to check the “Update the default view” check box in the Template Column dialog and save the project.
The ID column can display following status icons:
Icon | Description | Appears when |
---|---|---|
Unsaved change | The object was changed since the time the current document was opened and has not been saved yet to a file. | |
Comment | The object is commented. | |
Attachment | The object has at least one attachment. | |
Link | The object is linked with other requirement or object. | |
Deleted | The object is marked as deleted, but not yet purged (completely removed from the document). The object can be undeleted. | |
Cut | The object is cut in the clipboard and will be moved on paste operation. | |
Copied | The object is copied in the clipboard and will be copied on the paste operation. |
ReqView document is structured into numbered sections. A section number is automatically generated for an object either if the object has heading attribute set or the object has at least one child.
Tip: You can assign a section number to an object with only text description by setting heading attribute to a space (“ ”).
You can collapse or expand a selected document section by clicking on / icons on the right of the section name or by CtrlSpace shortcut.
You can collapse all document sections by View > Collapse All menu or expand them by View > Expand All menu.
Document objects can have image or file attachments. You can open an attachment in your browser by clicking on the attachment link in the Description column. If your browser cannot display the attachment, it will be automatically downloaded.
You can show / hide an image attachment by Show Image / Hide Image in the context menu.
You can also show / hide all image attachments by View > Image Attachments > Show All Images / View > Image Attachments > Hide All Images menu. If you enable Edit > Preferences menu > Show images** option then the images are loaded automatically after opening a project.
Tip: Hiding image attachments in large documents or documents with large number of attachments usually significantly improves application performance.
You can jump directly to an object with a specific ID by View > Go To menu or by using CtrlG shortcut. In the opened Go To dialog enter the object ID including document ID prefix if the object is from a different document.
You can sort the Requirements Table by clicking on a chosen column heading. If you click on the same column heading again then you change the sort order. Sorting can be reset to the default sorting by the natural document order by clicking on Description column heading.
Note that you cannot sort by Custom Attributes and Links columns and columns corresponding to custom attributes of xhtml type.
You can filter rows of the Requirements Table by entering a filter condition in the filter input field displayed on the top right corner of the screen. You can quickly focus this field by pressing CtrlShiftF shortcut.
You can activate or deactivate the current filter by clicking on icon or by pressing CtrlAltF shortcut.
Note that when the current filter is active then the Requirements Table does not show the document hierarchy, i.e., the Description column is not indented according the section level.
You can filter all objects with a given value of a boolean (bool) attribute by choosing a attribute item from the filter suggestions list.
Examples:
You can filter all objects with a given value of a numeric (int, real and date) custom attribute by choosing a attribute item from the filter suggestions list and entering one of <, >, <=, >=, = conditions.
Examples:
You can filter all objects matching a given text condition in a text (int, real and date) attribute or in a Template Column by choosing a attribute or template column item from the filter suggestions list and choosing a keyword from the list or entering a “substring” or a /regular expression/ condition.
Note that if you choose a keyword from the list without specifying an attribute before then the keyword is matched in all text attributes.
Examples:
You can filter all objects with a given value of an enumeration (enum) custom attribute by choosing attribute and then a enumeration value from the filter suggestions list.
Examples:
You can filter all objects with null value of a numeric or text attribute by choosing attribute from the filter suggestions list and pressing Enter without entering its value.
Example:
You can filter all objects from the given section by choosing Section item from the filter suggestion list and entering a section number.
Example:
You can filter all objects with outgoing or incoming links of a given type by choosing a link type or link type item respectively from the filter suggestions list.
Similarly, you can filter all objects with origin reference (see Inherited Links documentation section) by choosing Origin or Copies item respectively from the filter suggestion list.
You can optionally choose Suspect item from the filter suggestion list before a link type to add condition that the given link type should have Suspect Link Flag set.
Examples:
You can filter combination of several conditions using AND, OR and NOT logical operators in disjunctive normal Form (DNF) according to the following rules:
Example:
Lets assume that we want to filter all document objects with attribute type set to “User Story” AND attribute status set to “Verified”.
You can enter this filter as follows:
Example:
The following picture shows a filter matching all user stories in which an editor can open or save or an architect can create:
You can search a keyword using the search input field next to the filter. You can focus this field by View > Search menu item or CtrlF keyboard shortcut. You can jump to the next (resp. previous) object containing the searched keyword by clicking on the icon on the right of the search input field F3 (resp. ShiftF3) shortcut.
You can extend the Requirements Table by Template Columns rendering live dynamic view on the current project data. For instance, you can define new columns for:
You can define a new Template Column by Document > Template Column… menu which will open Template Column dialog.
In this dialog, enter a column label displayed in the table header and a template definition using Handlebars syntax same way as custom export templates. Note that Template Columns are rendered using document object context therefore you can directly use document object attributes.
The Template Column in this example has heading “Section” and displays the section number of each document section or the section number of the parent section for each leaf object.
If you press Check button then the template definition is validated and its output is displayed for the current document object. The Template Column is added to the current table view after pressing OK button.
Template Columns are only stored in your current view. If you want to persist a Template Column change in the Project File or Project Folder, you need to check the “Update the default view” check box or set the Default View and save the project.
You can edit or delete an existing Template Column using the context menu opened by right click on the column heading:
Let’s create a Template Column which calculates the risk priority number as a product of severity, probability and determinability custom attributes for each Risk or Action object in RISKS document of the ReqView Demo Project:
Template Column Definition:
{{#if (eval (eval type "==" "Risk") "||" (eval type "==" "Action"))}}
{{eval (eval detectability "*" probability) "*" severity}}
{{/if}}
Template Column Output:
Let’s create a Template Column which displays downstream traceability coverage of each top level user story in NEEDS document of the ReqView Demo Project by linked SRS requirements and their TESTS:
Template Column Definition:
{{#ifEqual type "User Story"}}
{{#ifHasInlinks "satisfaction"}}
<ul>
{{#eachInlinkWith type="satisfaction"}}
<li>
{{docObjId}}: {{shortDescription maxLength=40}}
<ul>
{{#ifHasInlinks "verification"}}
{{#eachInlinkWith type="verification"}}
<li>{{docObjId}}: {{shortDescription maxLength=40}}</li>
{{/eachInlinkWith}}
{{else}}
<li><i class='icon-li icon-warning-sign'></i> Missing verification links</span></li>
{{/ifHasInlinks}}
</ul>
</li>
{{/eachInlinkWith}}
</ul>
{{else}}
<ul>
<li><i class='icon-li icon-warning-sign'></i> Missing satisfaction links</li>
</ul>
{{/ifHasInlinks}}
{{/ifEqual}}
Template Column Output:
You can choose the displayed Requirements Table by clicking on the tab showing document IDs under the Requirements Table. You can also quickly switch to other document by Project > Next Document / Project > Previous Document menu item or by CtrlShiftPgDn / CtrlShiftPgUp or Ctrl1, Ctrl2, …, Ctrl9 shortcuts.
You can print the current document by View > Print menu item or CtrlP shortcut.
In the Print Options dialog you can select if the displayed custom attribute columns will be compacted into the single Custom Attributes column, if printed data will be filtered and sorted same way as the Requirements Table and if section folding shall be preserved.
After confirmation of Print Options dialog the WebApp opens the browser Print dialog displaying a print preview. In this dialog you can select a target printer and further customize printed document by changing page orientation, margins and add a custom header or footer:
In Chrome browser, you can export the opened document into PDF format using Print dialog by setting “Save as PDF” printer. In Mozilla browser you need to install Save as PDF add-on first and then click on Save as PDF button.
You can copy the selected text from ReqView UI to the system clipboard by CtrlC shortcut:
You can also select one or more document objects and copy to the system clipboard a table containing information in the visible columns by Edit > Copy menu, toolbar button or CtrlC shortcut:
You can then paste the data into other applications (MS Word, MS Excel or your email client) in HTML or CSV text format: