Custom Fields

In the file <project>/config/custom-fields.yaml, you can provide additional information (meta information) for custom fields.

The information you provide here is used and displayed on the content assistant in the Name column of the custom fields table in the developer workflow UI, in the Portal application. It is available to your applications via the Public API.

Editor

The Axon Ivy Designer offers a Yaml-Editor to edit the <project>/config/custom-fields.yaml file, where you maintain additional information about your custom fields.

 1CustomFields:
 2  Tasks:
 3    branchOffice:
 4      Label: Branch Office
 5      Description: The location (city) of the branch office
 6      Type: STRING
 7      Icon: gear
 8  Cases:
 9    MyCaseCustomField:
10      Label: My case custom field
11      Description: This new case custom field can be used to ...
12      Type: STRING
13  Starts:
14    MyStartCustomField:
15      Label: My start custom field
16      Description: This new start custom field can be used to ...
  • Label The label that is displayed on user interfaces instead of the custom field name.

  • Description The description that is displayed on user interfaces for the custom field.

  • Type The data type of the custom field. Can be either STRING, TEXT, NUMBER or TIMESTAMP.

  • Category The category of the custom field. You can use this to categorize your custom fields.

  • Hidden If hidden, the custom field will not be displayed to end users. Use this to hide technical custom fields from end users. Can be either true or false.

You can add as many other attributes as you like. E.g., Icon.

Warning

The indentation spaces needs to be the same in the whole yaml file.

Localize Label, Description and Category

For processes that support multiple languages the Label, Description and Category can be provided in multiple languages by using the CMS.

You need to add the following to the CMS:

  • folder /CustomFields/ in the CMS root folder. This folder is required.

  • the object kind of the entry - CASES, TASKS, or STARTS are supported. This folder is required.

  • content objects with paths /CustomFields/{kind}/{name}/Label, /CustomFields/{kind}/{name}/Description or /CustomFields/Categories/{category}, e.g., /CustomFields/Tasks/branchOffice/Label, /CustomFields/Categories/hrm