Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

If you want to edit these forms, go to Administration->Dynamic GUI-> and select the form you want to edit.

...

Editing

  1. Select the window or panel that you would edit

    Image Added

Window will appear:

Image Added

Read more:

1. Add or edit tabs

2. Add or edit groups

3. Add or edit elements

4. Add or edit fields

Saving

Please note that "Save to database" has to be selected if you want to permanently save your changes. Click on this option frequently to make sure you save all your changes.NOTE: The The functionality in this part of the program has not been as thoroughly tested as the parts designed for normal users. We therefore recommend that you save frequently. If anything should go wrong during the saving function, close dRofus and re-start (it is not enough to just close the editor). This will mean that data from the database will be re-loaded.

The tree on the left-hand side of the screen shows the structure explained in the previous paragraph with the tab for "Water/Waste water", the group for "Waste water - quantity", the element for "Basin/utility sink" and two fields, one numerical and one text. At the top right, you can see the properties of the tab/group/element/field you have selected in the tree. Below is a preview of the form. This can be re-drawn after you have edited by clicking on "Refresh".

Image Removedo

Add or edit tabs

If you want to add a new tab, right-click at the top of the tree (in this case Room Data) then click on "New". The following properties are linked to tabs:

...

Field

...

Explanation

...

Position

...

The reciprocal position of this tab in relation to the other tabs

...

Name

...

The text to be displayed on the tab and in the report

...

XSL report template

...

The appearance the group is to have in PDF reports

This is mainly managed at group level, see below, but if you have a two-column tab, you can choose "two-column-flag" here to have the column appearance shown on the screen. If you use two columns for the group below, the different fields will be shown by group from left to right and downwards. This may result in a slightly different sequence than on the screen.

Add or edit groups

Click on the tab where you want to add a new group and select "New". The following properties are linked to groups:

...

Field

...

Explanation

...

Name

...

The text to be displayed on the tab and in the report

...

Help text

...

NOT IN USE

...

Position row

...

Horizontal (row) position in relation to the other groups

...

Position column

...

Vertical (column) position in relation to the other groups

...

Box frame

...

Displays a frame which surrounds the group with the name of the group at the top

...

XSL report template

...

The appearance the group is to have in PDF reports, ref. below

...

The appearance of the PDF report is managed via the XSL report template option. You have the following options here:

...

Type

...

Explanation

...

group

...

Default group with background text for element, then field values for each field on a line. If the fields have a name which is marked for display in front of/behind the field, this will also be shown. Different types of fields (text, figures, logical) have different fixed widths.

...

document-group

...

Provides a "document style" for the group in certain reports which have been adapted as such, i.e. that group titles and element titles are shown as numbered headings and contents are formatted as in a document.

...

description-group

...

Used by groups which comprise one large multi-line text field. The name of the group will be displayed in bold above the text in the fields.

...

two-column

...

The elements are in two columns.

...

three-column

...

The elements are in three columns. Typical for elements where there is only one field.

...

dyn-field-table

...

Creates a table of the fields in the elements in this group. Elements are rows and fields are columns. Must only be used for groups where all elements have an equal number of fields. Will make use of the first element to deduce the number of columns in the table and any headings in the columns by looking at the field names. All subsequent elements must be equal! Will distribute positions regularly among the fields.

...

value-spec

...

Group for elements of e.g. the type for "Yes/No and comment" fields. Displayed with headings "Value specification" and any group heading if set. If there are more than two fields in the element, they will be displayed continuously after the second field.

...

value-spec-no-header

...

Same as above but without heading for several subsequent groups of same type.

...

value-spec-two-column

...

Same as value-spec but in two columns.

...

value-spec-two-column-no-header

...

Same as above but without headings.

...

yes-no-spec-min-max

...

For elements which are of the form "Yes/No, specify, min/max".

...

percent area

...

Template adapted to finishes %, m2.

...

percent-area-no-header

...

Same as above but without heading for use for several subsequent groups of same type.

...

percent-meter-no-color

...

% m column set-up for finishes.

Add or edit elements

Click on the group where you want to add a new element and select "New". You can also choose one of the predefined elements/fields from the right-click menu:

  • Yes/No comment field. Creates an element with a logical field and a text field.
  • Yes/No number of comments field. Creates an element with a logical field, numerical and a text field.
  • Yes/No % m2 field. Creates an element with a logical and two numerical fields designed for finishes.

The benefit of using one of the predefined templates is that all the field settings have been executed, for example that the fields are available when the logical field is flagged.

Following properties are available in the element level:

...

Field

...

Explanation

...

Position

...

The reciprocal position of this element in relation to the other elements

...

Name

...

The text to be used in front of the element, i.e. the background text for the fields

...

Help text

...

Help text for the field. In the Room Data screen, this will be displayed at the bottom of the screen when the user fills in the field.

...

XSL report template

...

NOT IN USE

...

Add or edit fields

Click on the group where you want to add a new field and select "New". Fields may be different types and also have different options, according to type. The following fields are available:

...

Field type

...

Explanation

...

Multi-line text field

...

Text field for text which may cover several lines. You can decide the size of the field.

...

Button

...

Field as a text field with two buttons where you can click on option. Only used in report user interface window. Not used in Rooms, Items or Occurrences.

...

Logical field

...

Yes/No field (checkbox).

...

Numerical field

...

Field for numerical values. You can specify the legal size and precision (number of decimal stops).

...

Radio buttons/Combo-box

...

Fields where you can choose between several predefined options (text). Can be presented as a drop-down menu (combo-box) or radio buttons.

...

Text field

...

Default field for text on one line.

...

Time date selector

...

Field for choice of date and time.

...

Read-only text

...

Field for fixed text which cannot be edited. The text is not displayed in reports. Can be used e.g. to create headings. Entering a hypertext link here (starting with http:// or https://) will lead to the content being presented to the user as a clickable hypertext link.

All of these fields have the following properties:

...

Field

...

Explanation

...

Field type

...

One of the types described above.

...

Position

...

Reciprocal position of the field within the element.

...

Name

...

Possible name of the field (in addition to the background text for the element). This must be specified in the next option if it is to be displayed.

...

Display name

...

Where the name is to be displayed (in front of or behind the field). This is not displayed in reports. You have to choose a suitable XSL template in order to display the significance of this field.

...

Help text

...

The text shown in a yellow box when you hold your cursor over the field. You should primarily use the background text for the element (ref. previous paragraph) to specify joint text for all fields within an element. Only specify help text here if it is a further specification.

...

Read-only

...

Option for whether the field shall not be open for editing.

...

Activated/deactivated by

...

The logical field which may control whether this field is activated/deactivated. As such, the logical field for example must be checked before you can enter text in another field in the same element.

...

Calculate field

...

Only used in finishes. Specifies which field to be calculated when this field is edited. This is only used by finishes form.

...

Calculation function

...

The function to be used to calculate the fields selected above.

...

IfcPropertySet

...

The name of the PropertySet (PSet_XXX) in which this field shall be exported under IFC export (synchronization in model). If this field is blank, the name of the tab will be utilized, if this is not to be written to the object (see below).

...

IfcProperty

...

The name of the Property with which this field is to be exported under PropertySet as selected above. If this field is blank and IfcPropertySet (above) is also blank, the name of the element is utilized. If this field is not blank but IfcPropertySet is blank, the export procedure will attempt to export directly to a property for the object. For example, if you want to set a value from Room Data to IfcSpace.Description, you set the field as Description, but leave IfcPropertySet (above) as blank.

...

IFD GUID

...

A Global Unique ID (GUID) which uniquely identifies the field. This can be an ID taken from IFD International Framework for Dictionaries. You can utilize the button on the left to automatically connect you to IFD in order to download this GUID.
This ID is used when data is exported/imported via IFC to identify similar fields/information in different databases. If the field does not have an ID, it cannot copy e.g. Room Data between fields.

...

Width/height

...

Width and height of the field. These fields do not need to be filled in for the majority of fields, as they will have default sizes. This must be specified for multi-line text fields. The size is specified in pixels with the exception of multi-line text fields where you can choose this (see below)

...

OwnerAlignment

...

Specifies how the field shall react when you change the size of the window. Only used for special cases.

...

Field type

...

Field

...

Explanation

...

Multi-line text field

...

Display name (label) above

...

Specifies whether the name of the element (background text) shall be displayed above the field instead of the background text being displayed on the side and the field afterwards.

...

Style/look

...

States how the size (width/height) is specified. Size of the field. This can be specified as number of pixels wide, number of elements high or % width, % height where % is a figure from 1 - 100 stating the size in percentage the field shall cover of the available space in the window.

...

Button

...

Button text

...

NOT IN USE

...

Sym name

...

Name of the method in the window which is called when you click on the button.

...

Type

...

Button style

...

Logical field

...

Underline

...

Specifies whether the background text shall be underlined.

...

Numerical field

...

Format

...

Specifies the format of the numerical field. This can be specified in two ways:

  • {number of characters including two decimal stops and comma}
  • {number of characters including decimals and comma, number of decimal stops}
    This implies that both {5} and {5,2} generate the same, i.e. XX,YY. {6,3} will return XX,YYY, while only whole figures up to 9999 can be specified as {4,0}.

...

Radio buttons/Combo-box

...

Style/look

...

Specifies the appearance of multi-choice fields

  • Combo-box, read-only, provides a drop-down menu which cannot be edited directly, but where you have to select one of the options.
  • Combo-box, editable, provides a drop-down menu where you can enter text freely or select one of the options.
  • Group without frame, label on side. Positions radio buttons on top of each other per option with background text on left-hand side.
  • Horizontal radio box without frame. Positions radio buttons one after the other in a horizontal line and not on top of each other as above.
    - Default design, group with frame. Positions radio buttons on top of each other with a frame round them and background text in the frame.

...

Elements

...

This is where you specify the options from which the user can choose. One per line.

...

Remove option button

...

For radio buttons, there is a button which you can use to reset all selections, i.e. remove all choices. For combo-boxes, there is a blank option in the drop-down menu, unless this is editable, where you can remove the selection by removing the actual text.

...

Button text

...

If "Remove selected button" is flagged and it is a radio box, you can specify the text for the button. If you do not specify text here, the default is "Remove selected".

...

Time/date selector

...

The number of days to reset

...

How many days before current date to be preselected.

...

Read-only text

...

Centre text

...

NOT IN USE

...

Underline

...

Whether the text is to be underlined or not

...

Text value

...

Text to be displayed

Saving and previewing

Any entries you type into the properties are automatically saved locally when you change group/field/tab/element. If required, you can click on the "Save" button at the bottom of the window. However, this is not necessary.

If you want to save to the database, click on "Save to database". Once you have done this, any other user logging in will be able to see the changes you have made.

Previewing

To view the changes in the window, click on "Refresh" or press F5. In order to view your changes, the values in the field must be saved locally, but not necessarily to the database.

Deleting fields, elements, groups and tabs

If you want to delete a field, element, group or tab, select it and choose "Delete". Click Save to database as soon as you have deleted something and every time you choose Delete. It It is often necessary to stop the log for your current form before you can delete fields. To do this, go to Administration->Main project/project->Main project->Logs. If you receive an error message when deleting, this is most probably the cause. 

...

  1. Select the field, element, group or tab that should be deleted

  2. Select "Delete" in the top menu or right click menu

  3. Select “Save to database”.

Note

NOTE

WARNING: When you delete a field, all the data saved for the field will also be deleted. All logs for the field will also be deleted.