Custom asset fields

In addition to the existing fields of the asset data model, you can create custom asset fields. Data from the custom asset fields is displayed when you view information about the asset. Custom fields can be filled in with data either manually or using the API.

You can create or edit the custom fields in the KUMA web interface in the Settings → Assets section, in the Custom fields table. The table has the following columns:

• Name – the name of the custom field that is displayed when you view information about the asset.
• Default value – the value that is written to the custom field when an asset is added to KUMA.
• Mask – a regular expression to which the value in the custom field must match.

To create a custom asset field:

1. In the KUMA web interface, in the Settings → Assets section, click the Add field button.

   An empty row is added to the Custom fields table. You can add multiple rows with the custom field settings at once.

2. Fill in the columns with the settings of the custom field:
   • Name (required)–from 1 to 128 characters in Unicode encoding.
   • Default value–from 1 to 1,024 Unicode characters.
   • Mask–from 1 to 1,024 Unicode characters.
3. Click Save.

A custom field is added to the asset data model.

To delete or edit a custom asset field:

1. In the KUMA web interface, open Settings → Assets.
2. Make the necessary changes in the Custom fields table:
   • To delete a custom field, click the icon next to the row with the settings of the required field. Deleting a field also deletes the data written in this field for all assets.
   • You can change the values of the field settings. Changing the default value does not affect the data written in the asset fields before.
   • To change the display order of the fields, drag the lines with the mouse by the icon
3. Click Save.

The changes are made.