Versions Compared

Key

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

Add new fields either by coping or creating new: 

...

Fields are the lowest level in the User Interface Editor hierarchical structure. Fields can only be added to an element, not directly to a group or tab. When adding a field, you can chose from 8 different field types: Yes/No, Text, Multi line text. Formatted text, Numeric, Multiple choice, Fixed text and Date. The field types have some common characteristics and some special for the field type. We will explain what you can do with each field later on this page.

...

Create new field 

  1. Select the element where the new fields should be added to. 

  2. Select "New field" . in the top menu and chose desired field type from the drop-down menu, or right-click menu.an element and select “New field → ”

  3. Enter properties. Read more below.

    Image Removed
  4. Select “Save to database”

  5. Select “Refresh” to preview the new field.

Properties

  1. image-20240410-073226.pngImage Added

Field types

Fields may be different types and also have different optionsproperties, according to type. The following fields types are available in dRofus:

Field type

Explanation

Multi

-

line text

field

Text field

for text

which

may

cover several lines. Designed for fields that potentially will contain paragraphs of text. You can decide the size of the field.

Formatted Text

Functions as a multi-

Same usage as Multi line text

field

with the addition that it allows for formatting (ie Bold, Italic, colored text etc).

This format

Note

Formatted text fields cannot be used for excel import/export workflows

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

and cannot be added as columns to lists.

Yes/No

Yes/No field (checkbox)

.Numerical field

. Can be used alone or together with other field types. e.g. as an enabler of other fields.

Numeric

Field for numerical values. You can specify

the legal size and precision (number of decimal stops).Radio buttons/Combo-box

total number of digits allowed, and number of decimals.

Multiple choice

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

radio buttons

radiogroups.

Text

field

Default field for text on one line.

Time date selector

One-line text field

Date

Field for

choice of

setting date

and time

.

Read-only

Fixed 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.


Properties

All of these fields have the following common properties:

Field

Property

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

ID

Database unique ID for the field

All

Label

Optional label to be placed either before or after the field. Use the associated dropdown to define where to show the label.

All

Tooltip

Help text that will appear as users hover over the field in the user interface

All

Enabled/Disabled by

If you want the selected field to be enabled/activated by a Yes/No field. Use the associated dropdown list to select a yes/no field available within the tab. A field can not be enabled by a Yes/No field placed in another tab.

All

Read-only

Set to read-only to lock values. Setting this option will prevent changes from all sources (Desktop, WEB, Excel, Revit/Archicad, API etc.)

All, except Fixed text

Height

Option to overwrite default height. By default, the field will span to use available space. It’s recommended to use default behavior, but overwrite if you have special needs.

Insert height in rows vertically.

Multi line text, Formatted text

Width

Option to overwrite the default with of the field. By default, the field will span to use available space. It’s recommended to use default behavior, but overwrite if you have special needs.

Insert width in pixels horizontally.

Text, Multi line text, Formatted text, Numeric, Multiple choice, Fixed text

Text

Only available for Fixed text. This property contain the text value you want to show in the user interface.

Fixed text

Underline & Center

Only available for Fixed text. Controls underline of the text value and if text value should be center aligned or not. Default behavior is left aligned

Fixed text

Show label above

This option will place the element label, if used, above Formatted text or Multi line text fields. Making the field use more available space in the user interface and in PDF reports

Multi line text. Formatted text

Data type

Option to specify data type for numeric fields. If left blank the field will have default data type which is whole numbers

Numeric

Total number of digits

Define how many digits should be allowed in the numeric field. If left blank the default value of 7 will be used.

Numeric

Number of decimals

Define how many of the allowed digits to be decimals. If left blank the default value of 2 will be used.

Numeric

Style

Specifies the appearance of Multiple choice fields

  • Combo box, not editable , provides a drop-down menu which cannot be edited directly, but where you have to select one of the predefined options.

  • Combo-box, editable, provides a drop-down menu where you can enter text freely or select one of the predefined options.

Group without frame, label on side
  • Radiogroup. Positions radio buttons on top of each other per option

with background text on left-hand side.Horizontal radio box without frame
  • Radiogroup horizontal. 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

Multiple choice

Dropdown values

In Multiple choice fields, each value represent an option in the multiple choice list. If you wish to add a blank option, make sure to select “Add empty value” (see below). The dropdown values will be sorted by their input position.

Multiple choice

Add empty value

In Multiple choice fields, this option will add an empty value so users can clear the field if needed.

Multiple choice

Days rollback

Define how many days tp roll back as default. If left blank the current date will be set as default.

Create new predefined fields

New fields can be created as with the predefined option for creating new elements. Read more: https://drofus.atlassian.net/wiki/spaces/DV/pages/2612461578/3.+Add+or+edit+elements#Create-new%3A

Copy elements

  1. Select fields

  2. Right-click

  3. Select “Copy” to copy once or select “Copy..” to create more copies at the same time

  4. Edit the properties on the new field(s)

  5. Select “save to database”

  6. Select “refresh” to preview the changes.

Editing fields

It is possible to modify properties at a later time. However, it's important to note that if the format changes after data has been entered into the field, the entered data will be lost.

...