Custom Field Captions

Through the Custom Field Captions you define the labels with which custom fields are displayed throughout the entire application. This allows you to adapt the captions of additional fields to your own terminology and to store them in multiple languages.

This page is intended for administrators and is available exclusively to users with the Superadmin role.

1. Navigation

The page is accessible via the main menu under Global Settings › Custom Field Captions. If your account is not authorised as Superadmin, the page is not displayed.

2. Overview of Field Captions

The overview shows all existing custom field captions in a table. One caption is displayed per row.

Columns

Sorting and Pages

The table is split across pages and can be sorted in ascending or descending order by clicking a column header.

Search

Using the search field, you can narrow down the list with a free search term. Among other things, the search takes the translated caption of the entity type into account.

3. Filter by Group

With the group filter bar you narrow down which field captions are displayed:

1. Select the desired group in the Group field.
2. If required, activate the option Current group only to display exclusively the captions assigned to the current group.

The table is then updated according to the selected restriction.

4. Create or Edit a Field Caption

To create a new caption, use the Add button in the toolbar. To change an existing caption, mark the corresponding row and choose Edit (alternatively by opening the row). In both cases, a dialog with two tabs opens.

«General» Tab

Here you define the basic details of the field caption:

• Entity Type – Object type to which the field is assigned.
• Property Name – the specific custom field (see Section 5).
• Require actual value from the app – this option appears only for certain entity types (assignment of products to shipments) and controls whether an actual value from the app must be recorded for the field.

«Captions» Tab

On this tab you record the multilingual display texts of the field:

• Short Caption – in German, English, French and Italian respectively.
• Long Caption – also in all four languages.

Note: As soon as you click an empty Long Caption field, the value is automatically taken from the corresponding Short Caption. You can then adjust this suggestion.

Saving

With Save the details are applied. Please observe the following rule:

Note: The combination of entity type and property name must be unique. If a caption with the same combination already exists, saving is rejected with a corresponding message.

After saving, the translations are stored and the associated display captions are updated throughout the entire application.

5. Dependent Selection of the Property Name

The entries available in the Property Name field depend on the selected entity type. If you change the entity type on the «General» tab, the selection list of property names is automatically reloaded and populated to match the selected type. While reloading, the dialog is briefly locked. The entries are displayed sorted alphabetically.

6. Delete Field Captions

To remove, mark one or more rows in the table and choose the Delete action in the toolbar. Several captions can be deleted at the same time. When deleting, the associated short and long translations are also removed and the display captions in the application are updated.

7. Toolbar and Table Configuration

The toolbar of the overview provides the following functions:

• Add / Edit – create a new caption or open a marked caption.
• Manage Columns – show or hide columns of the table.
• Apply Layout Templates – apply saved table views.
• Layout Buttons – adjust and reset the table view.

Your individual table configuration is saved on a per-user basis and is available again at the next login.