Custom fields

Every organization is different and has different data to store. That’s why most entities in Group-Office can be extended with custom fields.

Custom fields show in the:

  • Edit dialogs
  • Detail views
  • Grid columns
  • Advanced search and filters

You can create custom fields via System settings at:

  • Notes
  • Address book
  • Billing
  • Tickets
  • Calendar
  • Tasks
  • Files

Note

The above list depends on the modules installed. You may have less or more options

Creating fields

Navigate to System settings -> Address book for example.

Click the + icon to add a field set first. A field set is a group of fields that has a title and an optional description that will be shown on the form. You can also hide field set in some cases. This depends on the module. In the address book you can only show it on certain address books for example.

When you’ve created a field set you can add a field via the ‘+’ button on the field set row:

../_images/custom-fields-add.png

Add custom field

The image also shows the custom field types you can add.

Note

The types of custom fields that you can add depend on the modules you have installed.

The custom field will show in the:

../_images/custom-fields-form.png

Edit dialog

../_images/custom-fields-detail.png

Detail view

../_images/custom-fields-grid.png

Grid columns

Conditionally required fields

It’s possible to make fields required based on a simple condition. You can also hide the field if the condition does not match.

For example you could create a checkbox called “provideDetails” and create a text field “details” with a condition ‘provideDetails = true’. The result will be that when you check the box the provideDetails field will be shown and made required.

The condition syntax is very simple:

<fieldName> <operator> <value>

Where:

  • fieldName can be any property or custom field
  • operator can be: =, !=, >, >=, <, <=
  • value is a string without quotes. For checkboxes you can use 0,1 or true or false.