ReqSuite® Requirements Manager (RM)
Enumerations and Notations

Enumerations and notations are displayed under the “Categories” tab in the main display area of the Designer. Both are help structures for configuration design:

  • Enumerations: An enumeration represents a variable with a predefined value range as a help structure, e.g. “PRIORITY” as a variable that can assume a value from the value set {“high”, “medium”, “low”}. In addition to basic data types such as text, integer and date, an enumeration with a suitable value range for use in description templates can also be selected from the list of defined enumerations when typing attributes in the course of later model refinement. A distinction is made between static enumerations, whose values you define during the configuration time, and dynamic enumerations, whose values result from the elements of a category at project runtime.
  • Notations: This help structure is used to store documents that define valid guidelines in the form of manuals and checklists or suitable procedures for creating detailed graphical descriptions of individual content elements or the relationships between several content elements of a content type. The appropriate notation can then be selected from the list of stored notations when defining content types. For example, you can define a specification to create a UML class diagram or flowcharts to visually describe the interaction and functionality of business processes.

Enumerations and notations can be added, edited and deleted (analogous to categories) as follows (see Figure 1 for content categories):

  • To add, click on the “plus” symbol in the list header of the corresponding list. An input window opens (see Figure 1 on the left) in which you must enter the respective identifier under “Name *”. In the case of enumerations, you then have the option of distinguishing between dynamic and static enumerations. If you select a dynamic enumeration, you must also select a category from whose values the value attributes result.
  • To edit an existing enumeration or notation, select it in the corresponding list and click on the “pencil icon” in the list header. An editing window will be opened which is similar in content and functionality to the input window for adding described above (see Figure 1, centre).
  • You can irrevocably delete an enumeration or notation from the system by selecting it in the corresponding list, clicking on the “trash can symbol” in the list header and clicking on the “Delete” button in the query dialog that appears (see Figure 1 on the right).
  • Each of the above mentioned operations can be aborted by clicking on “Cancel” in the respective dialog (see Figure 1).

Figure 1: Dialog windows for adding (top), editing (middle) and deleting (bottom) an enumeration

Figure 2: Dialog window for adding (top), editing (middle) and deleting (bottom) a notation

Figure 3: Clarification of an enumeration as a help structure by enumeration attributes

In addition to defining the value range of enumerations (see Figure 3), the functionality of the configuration also includes storing manuals and checklists for the notations defined to date (see Figure 2).

Figure 4: Specification of a notation as a help structure by depositing a specification document
  • To add a value attribute to the value range of a (static) enumeration, first select it in the “Enumerations” list and click the “Add” button in the list header of the loaded value list. An input window opens in which you must specify the identifier for the enumerated value under “Name”.
  • To edit an enumerated value attribute, first select the corresponding list entry under “Enumerations”, click on the value attribute to be edited in the loaded value list and click the “Edit” button. A editing window opens in which you can adapt the identifier for the enumerated value under “Name”.
  • You can irrevocably delete a value attribute of a (static) enumeration from the system by selecting it in the corresponding attribute list for the enumeration concerned, clicking on “Delete” in the list header and clicking on the “Delete” button in the query dialog that appears.
  • Each of the above mentioned processes can be aborted by clicking on “Cancel” in the respective dialog.
  • To save a document to a notation in order to replace an already saved document, first select the corresponding list entry in the “Notations” list and click on “Select manual” under “Manuals and checklists”. A file selection dialogue opens in which you can select the desired document from your file system.
  • You can irrevocably delete the document stored for a notation from the system by selecting the notation in the corresponding list and clicking on the “Delete” button next to the listed name of the document.