Document Settings

ReqEdit Online Documentation

Document Settings

5 min read
last updated: 02/05/2024

Before describing the document properties, lets go through the internals of the ReqIF files.

TLDR jump to Document properties

Attribute types

Each specification document has its own set of attribute types that are used as attributes. The list can be displayed using the menu Settings > Document.

Automatic data types for documents
Each new document will have: integer, real, date, string, xhtml and boolean attribute types automatically created, which can be edited.

ReqEdit displaying list of attribute types of a specification document, highlighted is the data type column which displays the base type and restrictions of the attributes. Selected is an enumeration type attribute and the enumeration values are displayed on the right bottom in the Enumeration Type Values list box

Data types

Attributes in ReqIF files are constructed from underlaying data types with or without restrictions. The usage of restrictions in the data types can make the requirement specifications more robust by not letting invalid values to be used.

Properties of data types

Depending on data types, different properties are available. The following table describes all available properties per data type

 Long NameDescriptionMinMaxAccuracyEnum Values
BooleanXX    
DateXX    
EnumerationXX   X
IntegerXXXX  
RealXXXXX 
StringXX X  
XHTMLXX    

Boolean

Its value can be true of false. These two states are displayed by a check box on the screen. This is an exception type, double click on the cell is not necessary for editing. Its value can be altered by a single click.

Date

A real date can be written or set as its value. In the view mode, the cell shows the value of the date, but in the edit mode it displays the DateTimePicker controller used for selecting the date. This offers help for the user to select fast the exact date. The date value can also be removed by unchecking the box in the top left corner of the date picker.

Integer

An integer can be given as a value between previously determined limits. In case of not giving a numeric type, the program will display an alert and the user can only continue if a correct value is entered.

Real

The value can be a decimal number between previously determined limits. In case of not entering a numeric type, the program will display an alert and the user can only continue if a correct value is entered.

String

An unformatted text with a previously determined length can be entered as a value.
NOTE: The maximum allowed length of a string is 600 characters. This limitation was imposed in order for the files to be compatible with IBM Rational DOORS.

Enumeration

Represents a list of fixed values that can be used.

Each value has a Numeric Value, a Label displayed to the user, and an optional color in HEX or named color.

Enumeration type editor window

XHTML

XHTML format permits formatting of text in multiple ways, similar to any text processing application: Bold, Italic, Underline, Strikethrough, Superscript, Subscript, Unordered list, Ordered list, Paragraph, Normal text, Heading 1 – Heading 6

In addition to text formatting tables and images can be used in the content, as well as file attachments.

URI

The URI Represents the Resource types defined by DNG data models. All the attribute definitions, attributes, enum values may have URI values defined.

Attributes

Using the defined attribute types, attributes can be created to be used in the document or the objects. Each data type has its own properties shown in the following table

 Long NameDescriptionRead OnlyMultivaluedDefault Value
BooleanXX X
DateXX X
EnumerationXXXX
IntegerXXXX
RealXXXX
StringXX
XHTMLXX 
Each data type has its own properties

Enumeration attributes

Using enumeration data types in attributes has two main use cases

Single-value enumeration

You can choose only one value from a previously determined value set. It shows the chosen value in cell viewer mode. In the editor mode you can choose the required value from a values list (ComboBox or DropDownList).
Besides the values of an enumeration attribute type, the user can also select the value to remove the value of a cell.

Multivalue enumeration

You can choose multiple values from a previously determined value set. It shows the chosen value in cell viewer mode. In the editor mode you can choose the required values from a list by selecting each check box.

Multivalued enum attribute displayed as list of values with colors
Single value enum attributes are displayed as text

Document Properties

Information related to a specification document is visible in the Document tab. Document Name, description, attributes and statistics.

Statistic Information of:

  • Documents in file
  • Rows in selected document
  • Attributes in selected document
  • Attribute types in selected document
  • Incoming and outgoing links

Attributes that are defined internal to the specification are also listed with the value displayed on the right side.

ReqEdit displaying document properties

Main Column (heading and text) supports STRING and XHTML as attribute type.

Specification types

Currently not displayed, internally will be created and used exactly as in the ReqIF standard.

Object Attributes

List of attributes used in all objects of the selected document.

Object Attribute management window

System attributes are displayed by a PC icon in the list, these attributes cannot be deleted

ReqEdit internal attributes

  • ReqEditID – integer type, read-only attribute, internal unique ID
  • ReqEditModifiedOn – date type, read-only attribute, last modification date of the object
  • ReqEditModifiedBy – string type, read-only attribute, stores the Windows username who edited the object

Import attributes from other file

To import attributes from an other file:

  1. Open both files
  2. Click on Document settings\ Attribute tab\ Import
  3. Select source ReqIF
  4. Select the attributes to be imported
  5. Click Save

In case of Attrybute type – enumeration,

  • If enumeration attribute exist – after importing, the new values will be added to the enumeration.
  • if attribute already exist and type is not the same – the old attribute will be renamed to “… OLD” and does nothing to it

SpecObject types

Currently not displayed, internally will be created and used exactly as in the ReqIF standard.

Are covered in the Links chapter