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
Select the element where the new fields should be added to.
Select "New field" in the top menu and chose desired field type from the drop-down menu, or right-click an element and select “New field → ”
Enter properties. Read more below.
Field types
Fields may be different types and also have different properties, according to type. The following fields types are available in dRofus:
Field type | Explanation |
Multi line text | Text field which cover several lines. Designed for fields that potentially will contain paragraphs of text. You can decide the size of the field. |
Formatted Text | Same usage as Multi line text with the addition that it allows for formatting (ie Bold, Italic, colored text etc). Formatted text fields cannot be used for excel import/export workflows and cannot be added as columns to lists. |
Yes/No | Yes/No field (checkbox). 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 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 radiogroups. |
Text | One-line text field |
Date | Field for setting date. |
Fixed text | Field for fixed text which cannot be edited. |
Properties
All of these fields have the following common properties:
Property | Explanation | Field type |
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
| 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
Select fields
Right-click
Select “Copy” to copy once or select “Copy..” to create more copies at the same time
Edit the properties on the new field(s)
Select “save to database”
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.