Edit ReqIF requirement files

ReqEdit Online Documentation

Edit ReqIF requirement files

8 min read
last updated: 06/27/2023

ReqEdit presentation video

Why ReqIF files?

Requirement Interchange Format is the de facto standard for lossless requirement data exchange for any industry.

ReqIF simplifies the workflow of requirements exchange between suppliers and vendors in all industries. Mainly driven by the automotive industry.

ReqEdit was built from the ground up to aid the participants of the supply-chain to quickly use ReqIF files without the need for complex ALM/PLM software solutions. This is becoming more important with the digital transformation in more and more industries.

ReqIF based interchange offers seamless integration of supply chains in all industries making collaboration more standardized and efficient.

ReqEdit is an easy tool for ReqIF editing. Creating, comparing and merging requirements and specification documents with powerfull add-ons.

Large companies rely on lossless data exchange

ReqIF format simplifies and streamlines the data exchange of requirements between companies or departments and also on the management level. ReqEdit has multiple licensing models to support corporate environments and use cases.

Medium or small size companies needs cost effective solutions to participate in the supply-chain

ReqEdit is available as a standalone application. No other dependency is required. Cost effective solution for processing ReqIF requirement files.

ReqIF file structure

ReqEdit follows ReqIF standard on all levels. It will display contents of ReqIF files from structural to attribute definitions. More details you can find here.

ReqIF format

Attribute Types
atomic data types: boolean, date, enumeration, int, float, string, xhtml

Attributes
uses the basic attribute type definitions with optional restrictions: min, max, length, can be defined for objects and specifications also

Object types
collection of attribute types that are grouped together

Objects
uses a specific object type and has values for each attribute

Values
value objects for attributes of objects or specifications

Specification Types
a collection of object types and specification attributes

Specifications
uses a single specification type

Hierarchy
requirement object structure inside a specification

Relations
links between the objects

Edit Objects

Double click on a cell to edit the content. An inline editor appears for XHTML attributes. For other data types appear corresponding checkboxes or date pickers or single inputs.

To close inline editing click on any other cell.

The user can set the height of the main column: check the box in Settings / User … / Calculate only main column row height.

Use the quick action icons or the right-click menu for text formatting and XHTML content editing.

Editing and text formatting shortcuts

Single valued enumeration will show a dropdown selector

Multivalued enumeration attributes are displayed as a list of checkboxes

Dates will show a datepicker

String types editing as simple text

Boolean values editing as checkboxes

Integer and float types will only store numerical values

Insert rows

New rows can be created on the same level or as children to the current row.

For inserting a new row at the same level of the current row, right-click on a cell and choose where to insert it. A new generic object is displayed as an empty line or with default values.

Each spec object in ReqEdit has the same attributes (columns) in a document. Different object types are not supported in a single document.

Insert child row creates a new row in the table, below the selected line. It is a child in the tree hierarchy. A new empty line will appear. In case it is edited it will look like this:

ReqEdit displaying context menu

There is a possibility to insert rows based on customizable requirement patterns. To offer a quicker way to build requirement documents.

Use Insert row after.. and chose one of the patterns.

Delete rows

ReqEdit uses soft-deletions, delete will not remove objects from the ReqIF file.

Delete the selected row(s) by

  • selecting the row(s) and pressing DEL or
  • right-click menu or
  • the quick action icons.
ReqEdit displaying context menu, highlighted are the delete menu items

To confirm Delete action click Yes in the pop up window which appears next.

This function places the removed row(s) into a deleted state. (marked with red)

ReqEdit displaying deleted rows with red status indicator, highlighted is the Show deleted objects icon in the top bar

Restoring deleted rows

To restore a deleted row(s) select it/them and click on the „Restore deleted rows” button from the toolbar or right-click on the object and select the Restore menu item. It is possible to restore multiple deleted rows.

Restore deleted rows icon

PURGE (definitive deletion) of deleted objects

Use PURGE to remove objects, marked as deleted, with all attachments from a ReqIF file. Purge function is on the delete toolbars and right-click menus.

Once purged, objects cannot be recovered. Auto-backup feature will have 10 snapshots for recovery.

To clean up deleted rows:

  • purge a single deleted row or
  • purge all the deleted rows in the entire specification document.
Purge one row or all deleted rows icons

Copy and move rows

Use cut-copy-paste of existing row to create new one. Right-click the desired location and paste the copied object before / after or as a child row of another row.

If a copied row contains links, on paste, a notification asks what to do with the existing links.

If the row has child elements, these will also be copied or moved.

Copy-paste rows

To copy-paste multiple rows at a time select multiple rows and right-click on the last selected row, click Copy row than click on the first selected row and click Paste.

Copy-paste in the Navigator

Use right-click menu in the object navigator to copy-paste objects/rows.

If an object contains links to or from other objects, the links are copied too. A pop up window asks for copying the links or not.

Note: In Navigator is possible to copy-paste only one row at a time.

Use drag-and-drop to move objects

Object can be created by CTRL+Drag and release at the desired location

Editing Hierarchy

To change the hierarchy of objects use the promote and demote functions. They are in the quick action icons, and in right-click context menus.

Promote / demote objects with right-click menu

Promoting

Will move the object one level up in the hierarchy. If using the drag-and-drop way for promoting, an object/ row can be moved more levels up or down.

It is possible to Promote/Demote multiple rows of the same levels by selecting rows with shift and arrows than click Promote/Demote.

Demoting

Move the object one level down as children in the hierarchy.

Promote or demote a parent object include promote or demote the object together with its child objects.

Main column

Main column is a combined cell displaying the most important ReqIF attributes: ReqIF.ChapterName, ReqIF.Name, ReqIF.Text

In this cell, the main fields of the document can be edited at once. These fields are XHTML type attributes.

Double click the main column of an object displays an inline XHML editor with 3 tabs. One tab for each attribute.

Cell content editor using buttons or mouse right-click

The cell content editing menu Copy/Cut/Paste function refers to copy/cut/paste texts and pictures from the same document and external documents, too. (word file, excel spreadsheet cells, screenshots, images). The function converts external data format into ReqIF supported one. (text formatting doesn’t see, image cannot be downloaded). File format must be ReqIFz to be able to save the images, as attachments.

Note: Depending on corporate internet access, downloading copied images could be prevented by firewalls. ReqEdit will remove some formatting due to limitations of XHTML inside of the ReqIF format.

Copy-Cut-Paste the text of cells of the same ReqIFz file has no limitations regarding the possibilities shown in the right click menu. (Bold, underline, italic, strikethrough, subscript, superscript)

Copy-Cut-Paste of tables is with visible borders of cells. ReqEdit will add automatically borders to tables, even there was no set one before.

Note for experts with HTML knowledge: The HTML Source (experimental) menu item allows to edit and change the HTML source code of content of a cell.

Limitations on content editing Copy-Cut-Paste function:

  • Cell formatting settings in Excel spreadsheet
  • Attached objects from Wordpad (RTF documents)
  • Images can be copy-paste only in ReqIFz files
  • If the image/attachment cannot be copied, only file name of the preview images are displayed.

Recommendation: Before copy-cut content from an external source, save file to have a backup copy in case of the copied content is ReqIF invalid.

Properties

Properties menu gives information about the attachments / inserted files in main column cells. Right click on the inserted file, Properties

Right click menu in editor mode shows Properties window

HTML Source (experimental)

This function of the right click menu of content editor is recommended to expert users. This function allows to view and change the html source code of the attribute/cell.

Note: Currently the changes will not be validated at inserting time. So be very careful at any change!

Columns

Mass update of attributes

Update multiple rows with a specific attribute value.

The mass update function is designed to be used together with the filtering. This way, a set of objects can be selected according to specific criteria and updated at the same time.

The mass update function is not available for the main column

To use Mass update function first define a filter to select all the rows you want to change. Then right-click on the column header. Select Mass update….A popup window appears.

ReqEdit displaying the mass update menu item by right clicking the column header
Mass update popup window showing options

Mass update changes all values in the current view for the column.

To change individual cells, select multiple cells from the same column (either Ctrl + click or Shift + click). Right-click at the column heading to trigger the mass change.

Default values

Each attribute can have a default value defined in the Document settings. Selecting an attribute and access the “Attribute editor”.

To set back a cells default value for each attribute of a row, right-click the corresponding cell and select the “Set default value”.

Attachments

ReqIF Archive .reqifz files supports file attachments for objects.

Only XHTML attributes can have attachments inside .reqifz files

Image attachments:

png, bmp, jpg, gif, ico, wmf,

File attachments:

any file type is supported

pdf, doc, docx, xls, xlsx …

Opening file attachments

Double-click on the file’s icon. The attached file is opened by the installed applications on the machine.

Insert file attachments

To add an attachment right-click the XHTML inline editor area and select Insert image or Insert file

ReqEdit displaying context menu, highlighted is the ‘Insert image’ item
ReqEdit displaying attachment previews of an object, contains file icons and preview images

Tables

XHTML attributes by definition can have tables. All tables are rendered inside cells.

ReqEdit displaying tables inside XHTML attributes

To edit XHTML table structure use the inline editor right-click menu.

Save ReqIF files

If your file is a multi-document file, saving one of the documents will also save the changes made in the other documents of the ReqIF file.

NOTE: Changes on linked documents (e.g. Images or Word, Excel) are not detected. Make a content change to trigger update and enable saving.

Save as

Save the currently edited file as a new filename. Contents will be identical to the original one. Can convert ReqIF into ReqIFz.

Note: Actual file is closed and the file in new saved format will be opened.

Save as 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

Close files

ReqEdit can only close saved files. If there are any unsaved changes, a notification displays and asks to save files before closing.

Use CLOSE ALL to clean up the editor.