Znuny Dynamic Fields - Customizing Ticket Forms

Dynamic Fields in Znuny

Dynamic fields allow you to flexibly extend ticket forms in Znuny with your own data fields. They are managed via Admin → Processes & Automation → Dynamic Fields.

Creating, Editing, and Deleting Fields

• Create New: Select the object type and field type in the action bar, enter the data, and click Save.
• Edit: Select the field from the list, make changes, and save.
• Delete: Click the trash icon next to the field and confirm.

Tip

Use the filter function to quickly find a specific field.

General Settings

Every dynamic field has the following basic settings:

Setting	Meaning
Name	Unique alphanumeric identifier
Label	Display name in the system
Field Order	Display position
Validity	Active or inactive
Field Type	Defined during creation, cannot be changed

Available Field Types

Type	Description
Checkbox	Yes/No selection with configurable default value
Date / Date+Time	Date fields with optional time offset as default
Dropdown	Single selection from predefined values
Multiselect	Like dropdown, multiple values can be selected
Text	Single-line free text field
Textarea	Multi-line free text field (rows/columns configurable)
Contact with Data	Contact data with configurable attributes directly in the ticket
Database / Web Service	Populated from an external data source

Displaying Fields on Screens

To display a field in a form (e.g., Create Ticket):

1. Set the validity of the field to valid.
2. Navigate to System Configuration in the Admin area.
3. Select the desired screen under Frontend → Agent → View.
4. Edit the ###DynamicField setting and add the field.
5. Determine whether the field should be optional or a mandatory field.

Setting Default Values Automatically

Using the Ticket Event Module, default values can be set automatically when creating a ticket:

1. In System Configuration, navigate to Core → Ticket → DynamicFieldDefault.
2. Activate the desired setting (e.g., Ticket::TicketDynamicFieldDefault###Element1).
3. Save changes.

If more than 16 automatic default values are required, a custom XML configuration file is necessary.

Default Values per User

Users can store individual default values for dynamic fields in their Personal Settings, provided this is enabled in the System Configuration.

Further Information

There are plugins that add new field types or make the manual creation of fields unnecessary. These are not part of the standard installation and must be installed separately.