Skip to content

Notebook Attribute Representation ​

This section provides an overview of how various types of attributes are visualized in an Notebook and how they can be modified in the AttrRep class attribute.

Attribute of type INTEGER (integer) ​

An INTEGER Attribute is defined as an integer from between -1,999,999.999 and +1,999,999.999. The ADOxx integer is limited to 10 decimal places plus (optionally) algebraic sign. Standard value is 0, or other value defined in application library.

Hint

The INTEGER attribute domain can be limited by the definition of application library. When there are inputs which do not fulfil the defined requirements, an error massage will be shown.

In case of integer attributes, the attribute value is always displayed in its own text box.

Additionally, there is a possibility to define an integer attribute as an option box, by a modifier ctrltype:check.

The deactivated option of the integer attributes has the value null, and the activated option has the value one.

Attribute of type DOUBLE (floating-point number) ​

Attribute of type DOUBLE comes from between +/- 999,999.999,999,999 for whole numbers and +/-999,999.999,999,999 for numbers with (maximum) 6 decimal places (in a sum 15 places plus, if necessary, algebraic sign). Default value is 0,000000 or any other defined in the application library.

Hint

The range of values of a DOUBLE Attribute and the number of decimal places can be defined during the definition of the application library. When there are inputs which do not fulfil the defined requirements, error massage will be shown.

A floating-point number attribute value is shown by default:

Attribute of type STRING ​

Attributes of type STRING can contain texts with a maximum 3700 characters. The standard value is "" (empty) or any other, defined in the application library.

Hint

Entity names can contain texts with maximum 250 characters.

For text attributes in the library definition you specify whether the field for the attribute will be displayed as one line or several lines.

For text fields that are comprised of several lines, the number of lines can be specified by using the modifier lines in the notebook definition. The default value is 5.

Independent of a text field's size you can press - in a displayed notebook - the "Maximise" button to open a window with a larger text field so that it is easier for you to enter or view the text.

For attributes for which a specific dialogue has been specified in the notebook definition, the "Dialogue" button which supports the input will be shown.

The following types of dialogues are available:

ValueDescription
actordialogue for the assignment of performers,
distributiondialogue for the assignment of a distribution function,
subprocessdialogue for the selection of a subprocess,
resourcedialogue for the assignment of resources,
model namedialogue which allows you to select the name of a model which will be entered in the attribute field,
instance namedialogue which allows you to select an object from the models currently opened - the name of the object will be entered in the attribute field,
person's calendardialogue for defining the personal calendar for a performer,
process start calendardialogue for defining a process start calendar.

Attribute of type LONGSTRING (Long text) ​

The rules concerning long text attributes are the same as for attributes of type STRING, but the maximum length of the texts here can be 32.000 characters.

Attribute of type TIME ​

The value of time attributes is always shown in a single-line text field. The format is always YY:DDD:HH:MM:SS (Years:Days:Hours:Minutes:Seconds). In addition, it is possible to call a supporting dialogue via the "Dialogue" icon displayed in the notebook. This interface allows you to enter time values easily and accurately. This dialogue can also be called for write-protected time attributes - however in this case it only provides a clearer representation of the value.

Attribute of type ENUMERATION ​

ENUMERATION attribute values can only be selected from its pre-defined list. This list is defined in an application library, but can always be widened.

The following types of representation are available for attributes of type enumeration:

  • Complete list of all values. You select a value by clicking on it, the current value is then marked by an activated radio button.

  • Display of current value. You select the particular value from a dropdown list:

  • Display as option field. This selection is possible through making an attribute active, or inactive:

The type of representation can be defined by the modifier ctrltype.

The complete representation ("ctrltype:radio") is normally chosen when there is a smaller range of values. The representation of only the current value ("ctrltype:dropdown") is normally selected when there is a larger number of values to select from.

Hint

By default, all values are listed for up to four possible values. Otherwise, only the current value is represented.

For the representation of two attribute values it is possible to define one option field ("ctrltype:check"). However, in such a case it must be quoted additionally which of the two values stand for the activated option (e.g. 'checked value:"yes"') and which one for the deactivated option (e.g. 'unchecked value:"no"').

Attribute of type ENUMERATIONLIST ​

ENUMERATIONLIST attributes can only be selected from its pre-defined list. In contrats to the attributes of type ENUMERATION, the Enumerationlists can contain one, more than one, or no values. The standard value is defined in the application library, and can always be changed.

The enumeration list attributes are shown in a list consisting of several rows. Values are added via a dialogue which can be called using the "Add" button .

Entries selected in the list can be removed using the "Delete" button in the notebook.

Attribute of type PROGRAMCALL ​

A PROGRAMCALL attribute is characterised by a fixed set of items. These items are related to AdoScripts which can be called via the user interface. A PROGRAMCALL attribute value consists of at most one of the defined items and an optional parameter. The Syntax looks like the following:

Non-terminalDefinition
ProgramCallDomain :{ ItemDefinition } .
ItemDefinition :ITEM itemText [ ParameterDefinition ] { FDlgFilter } AdoScript .
ParameterDefinition :param: paramText [ : defaultTextValue ] .
FDlgFilter :fdlg-filter <i> : filterText fdlg-type <i> : filterDescriptionText .
itemText, paramText, defaultTextValue, filterText, filterDescriptionText :strValue .

Program call attributes are represented in notebooks by two fields grouped together . One field defines the program to be called, the other the program parameters.

PROGRAMCALL in the Notebook:

A program specified in the program call attribute can be called from the notebook using the "Execute" button . The available programs are selected from a dropdown list . Thus the selection is restricted to the programs listed here. Any text can be entered for the parameters or the dialogue "Search file" can be used to select a particular file.

This standard setup can be modified with several notebook definition commands in the class attribute "AttrRep":

Through the quotation of the modifier push-button at only one available program instead of the selection list "executing program" a button for the program call will be displayed.

The quotation of the modifier no-param suppresses the display of the attribute field "parameter" .

The quotation of the modifier no-auto suppresses the value "<automatically>" in the field "executing program" . By selection of the value "<automatically>" the appropriate application will be started automatically (with respect to dependency of entered parameters).

Attribute of type RECORD ​

Tables (RECORDs) will be represented in the notebooks according to the definition of the existing table classes.

Attention

Table attributes may only be used in objects and not in relations!

The following types of attributes can be contained in tables:

The quotation of the modifier width: and a floating-point number enables the determination of the column width of the attribute within a table. The quoted values of the column width will be relatively calculated on the available space in the table through which all columns in the table will be displayed. When extending and reducing the table, the column widths will be adapted accordingly.

Hint

The width modifiers must define all contained attributes (ATTR), as otherwise the display of the optimal column width is executed and therefore the width of all columns can be larger than the place available in the table.

Attribute of type EXPRESSION ​

EXPRESSION attributes can be used to save formulas, which can then be used to calculate new values. The formulas can be defined while characterising an application library ("fixed"), or can be changed according to the current needs in models at any time ("non-fixed").

Each expression attribute has its own type of result, defined in an application library. Possible types are STRING, INTEGER, DOUBLE or TIME.

Expressions (EXPRESSIONs) will be displayed in notebooks according to their definition in a text field with one or more lines .

For text fields with more than one line, it is possible to determine the number of lines over the modifier lines in a notebook. The default number is 5.

The definition of an expression through the ADOxx user can be done through clicking on the Smart-Icon .

Attribute of type INTERREF (Reference) ​

Inter-model references are displayed in notebooks in a special list.

A new reference may be created ("Create" button ), existing references deleted ("Delete" button ) and existing references can be followed ("Follow"-Button ). If you wish to create references, a dialogue is called when you click on the "Add" button, which will support the selection of the model or object(s) referenced.

Attribute of type ATTRPROFREF (Attribute profile reference) ​

Attribute profile references will be represented according to the definition in the notebooks of the referenced attribute profiles.

The following types of attribute can be defined in attribute profiles:

Attribute of type DISTRIBUTION ​

The values inserted in distribution attributes are shown in a text field . In addition, it is possible to call a supporting window via the "Dialogue" icon , where the modifier dialog:distribution is shown.

The modifier lines allow you to specify the number of lines.

Attribute of Type DATE ​

The assignment of date attributes will always be made in a row text field, in the following form

YYYY:MM:DD (year:month:day)

Additionally, the user can (by using a "Dialogue" icon from a notebook) call the supporting window where the modifier dialog:date will be set. It refers also to read-only attributes, but in such a case the dialogue only helps to improve clarity of a presentation.

Attribute of type DATETIME ​

The assignment of date and time attributes will always be made in a row text field, in the following form

YYYY:MM:DD hh:mm:ss (Year:month:day hour:minute:second)

Additionally, the user can (by using a "Dialogue" icon from a notebook) call the supporting window where the modifier dialog:date will be set. It refers also to read-only attributes, but in such a case the dialogue helps only to improve clarity of a presentation.