8 min read
last updated: 03/27/2023
The look and feel of the application is similar to any classic Windows application. It has a main menu at the top, function icon groups that can be rearranged, main content area and a status bar at the bottom.
At first run a quick action dashboard is shown.
After opening a ReqIF file, the contents will be shown in the main user interface. If the ReqIF contains multiple specifications it will be displayed as color coded tabs.
Opening a ReqIF file will display all the specifications as tabs. Same color tabs are from a single ReqIF or ReqIF Archive file. The specification title is displayed as the tab title.
Keeping the mouse over a tab will display more info of the specification like: file location, document id, and so on.
Closing opened files
Close any tab by pressing the X of the tab or by pressing CTRL+W , if there are any unsaved changes a popup will ask to save the specification.
Closing all opened specifications of a ReqIF file by accessing File > Close All or by pressing CTRL+SHIFT+W, if there are any unsaved changes a popup will ask for confirmation.
Specification headlines are shown as a tree menu on the left panel. Numbering is added automatically to aid navigation. Clicking on the items will jump to the same requirement in the content area.
Show / Hide Navigator
Navigator can be toggled by clicking the pin icon.
Requirements with (ReqIF.ChapterName) headlines are shown in a tree menu structure, numbered by the position in the hierarchy. The numbering is automatically updated on each change of the requirements, new additions or deletions will affect this.
The levels of the menu represents sub items in the spec hierarchy. This is visible in the content as sub numbering of a main headline, all the content remains on a single level in the table.
Requirements are shown in the middle as a table, where the Main Column is a multi content field and the other columns are the associated metadata.
The Object menu (Right-click)
Right clicking any object (row) in the content area, displays the context menu. Contains editing functions like: creating, cut-copy-pasting, deleting, restoring, purging objects. Hierarchical editing si possible by promote / demote menu items.
Manage relations between objects by the lower menu items: Add, Edit, Delete link or Go to link targets.
Get the object ReqIF ID using the Copy ReqIF ID menu item.
Main Column is the most important content of the specification. It has the default value of the combination of headline (ReqIF.ChapterName), description (ReqIF.Name), xhtml content (ReqIF.text). If all there attributes are present it will be displayed together in the same cell and the headline will have a number assigned to it.
The Main column content can be customized in the Document Settings panel
Resizing columns or rows
Drag the column header separator bars or the row separator bars to resize the grid.
Double clicking on any object will enable the inline editor and activate the text formatting icon group. Right clicking the content will show a menu for adding attachments or tables and formatting the content.
To leave the inline editing click anywhere outside the yellow background.
Right clicking the column headers will display a menu, where the selected column or the other columns can be toggled visible or hidden.
If all the columns are hidden the View manager can reset the visibility back to a predefined state.
Views are visible column sets with optional custom sorting and filtering saved as presets. The view manager is located in the icon groups on the right side. The views are only for displaying the ReqIF contents in a more human friendly manner for large files with lots of metadata.
The view presets are not stored in a ReqIF file, they can be exported and later imported from the local hard drive.
ReqEdit offers an auto-backup feature which will create a snapshot of the current state of the opened files. Default setting is to create a backup every 10 minutes and rotating 10 backup files (the last will be deleted to have a max of 10 backups).
The backup settings can be changed in the User Settings panel
Show / Hide Backups
Backups can be toggled by clicking the pin icon in the title of the panel
Create a new ReqIF file .reqif (New File) or an archive with attachments as .reqifz. (New Archive)
ReqIF Archive supports attaching external images or files to any requirement. Creating a new archive will show a window asking for a filename.
ReqIF Archive (.reqifz)
Can have attachments
A template list will popup will ask for a specific template to use for the new file. For more information on templates, please read the Templates section.
By default, only xml, rif, reqif, zip, reqifz and ReqEdit encrypted files can be selected
Add new document to current file
Adds a new specification document to the currently active ReqIF file. Use this to add more than one specification to a single file.
Any change in the specifications will be displayed with asterisk * in the tab.
Changes to linked documents (e.g. Images or Word, Excel) will not be detected by the editor, a change needs to be made in the requirements in order to be able to Save
Save the currently active file to disk
Save the active file under a new name
Keep all UUIDs
Save As for saving encrypted file
To encrypt a file choose ReqEdit Encrypted File (*reqenc, *.reqzip) as file type then click SAVE.
More about encryption of a file read here: ReqEdit File Encryption/Decryption
Save as template
Single document ReqIF files can be saved as a template and reused later
Opened specifications can be hidden by clicking the X in the tab bar, if there are unsaved changes a popup will ask for confirmation. This is not removing the specification from the file.
Close all opened specifications, any unsaved change will notify the user. It will close all opened files.
Start an import wizard for ReqIf 1.0.1 files
Start an export wizard from ReqIF 1.0.1 to ReqIF compatibility mode or RIF 1.1 / RIF 1.1a arhive format.
Print the current specification Main Column or all visible columns.
Requires ReqEdit file server
Will authenticate the current user and create a connection
Requires ReqEdit file server
Lock the file and download for editing (other users that have permission to the same file cannot download it)
Requires ReqEdit file server
Upload a file to the server. If the file was previously locked by the user it will become unlocked and can be edited by others as well.
Editing objects and contents
Object / Requirement level editing
Create before, after
Delete (soft delete)
Restore deleted (soft deleted)
Purge (hard delete)
Content level editing
Attributes (columns) related
ReqEdit can show a sub-set of the requirements based on special conditions of the attributes. Filters can be set and reset. Filters will not be saved inside ReqIF files.
ReqEdit can sort the requirements based on multiple columns. It can be configured and then reset. The sorting is not saved inside the ReqIF file.
Show/Hide deleted requirement objects
Soft deleted objects will be marked for deletion but are not removed from a specification until PURGE is not pressed. The deleted objects can be shown or hidden
View definitions (views)
Views are a sub-set of the attributes that are displayed. The views are not saved inside the ReqIF. file Views can be exported and later imported.
The views can be imported and used on any specification as long as there are attributes with similar names.
Expert users can fine tune ReqEdit for their specific use case, and configure lots of ReqIF settings
Manage ReqIF file internal settings
Configure Main Column display settings
ReqEdit file server connection settings
Server user credentials
ReqEdit internal configuration
Auto backup settings
Doors table display settings
Displays all available add-ons which are active in the current license. Descriptions below.
Contains a user guide. Can display Information about the active license. Display keyboard shortcuts. Check for online updates. Display version information about the current ReqEdit release.
ReqEdit Ultimate comes with powerful addons that extends the base functionality.
Look inside ReqIF files and check the xml code. The editor comes with a built in ReqIF validation function that will debug any invalid code. Read more here.
Turn your excel files into ReqIF files. Data exchange is more realiable and lossless if ReqIF is used. Read more here.
Compare / Merge tool
Will generate a comparison report that can be handed out as a signle html file. Read more here.
Weak words are words that are confusing for readers and should be avoided if possible. This tool provides a case insensitive whole word search for this purpose, optionally writing the results back in the ReqIF file. Read more here.
License Detach tool
Take ReqEdit out of the licensing environment. This power feature will enable users not to depend on the local licensing servers and to be able to work from anywhere. Read more here.
Tab title configuration
ReqEdit exposes some settings that can be configured for the tabs. The configuration file is located in AppData\Local\REQTEAM\ReqEdit\ReqEditSettings.xml
|TabDocumentTextAlign||Left, Right||Alignment of document title in the tab|
|TabDocumentWidth||250px||width of the tabs in pixels|
|Ctrl+Shift+W||Close all file|
|Ctrl+E||Add new or edit filter|
|Alt+N||Add new object below|
|Alt+Shift+N||Add new child object|
|Ctrl+Tab||Switch between open tabs|
|Ctrl+C||Copy text information inside the cell|
|Ctrl+X||Cut text information inside the cell|
|Ctrl+V||Paste text (remove all formatings)|
|Ctrl+Alt+R||Reset start link|
|Ctrl+Alt+R||Reset start link|
|F2||Open selected cell in edit mode|
|F3||Check for update|