List field options

A List field allows users to select from items in a list.

To remove list items from the selection box on the device console, a user can select one or more items, swipe right or left, and then press the trash icon that appears to remove the selected items.
Option Description
Value

The value associated with the list item. This is the value that will be sent to the server. It is also used for the field RRT. Entries can be sorted by the Value column.

Label

The text associated with the list item that will be displayed to the user. Entries can be sorted by the Label column. If this field is empty, the Value text is used as the label that is displayed on an MFP

Description

This value in this field is displayed in the details section of the user interface. This option is only available with device panels that display in color.

Default

Select this check box for a list item to make the value in the Value column be the default value for the field.

Allow Multiple Selection

Select this check box to allow users to select multiple list items. When this option is selected, the value of the RRT will be the selected values separated by semicolons (;).

Allow user to add items

Allows the user to add new values.

Raise event after pressing the search button

Causes the field to raise an event when the user presses the search button. With device panels that display in black and white, the button is labeled Search. With device panels that display in color, the search button is displayed only as a search icon. You can respond to this event in the script that was configured for the dynamic form section in the general tab. For details on how to respond to form and field events refer to the Scripting Guide. This guide can be opened by clicking the help button in the script editor.

Maximum number for search results to display

Specifies the maximum number results to be listed after the user presses the search button.

Import Items

Click this button to import list items from an ASCII comma separated value (CSV) file. This allows you to reuse fields from a previous list.

Export Items

Click this button to export list items to an ASCII comma separated value (CSV) file. This allows you to reuse a list.