List Of Values
A List Of Values is a drop-down list. The values come from values that you type (Tags) or from a dictionary (Dictionary). It is available in HTML and PDF templates.
A new List Of Values is required, and both the client and the agent can edit it. For the settings that all fields share, such as the label, the permissions and the dependencies, see Field settings. To show all the options on the form instead of a list, use a Radio.
At the top of the Values & Display tab, select Tags or Dictionary. Switching between them clears the values and the default value of the list.
Type a value and press Enter, or type a comma, to add it. To remove the last value, press Backspace in the empty box.
The client sees the value, and the same text is saved.
Two values with the same text, or a value with a comma, are reported as warnings on the Issues tab. See Issues.
Dictionary
Section titled “Dictionary”| Setting | What it does |
|---|---|
| Select dictionary | The dictionary that supplies the values. The client sees the Text of each value; the field saves its Value. |
| AJAX search | The list searches the dictionary as the client types, instead of loading all its values when the form opens. Use it for large lists. For a dictionary with more than 200 values (the default limit), it is turned on and can’t be turned off. |
| Search type | Shown when AJAX search is on. Fuzzy (the default) or Strict. See Search types. |
| Filter list | Another List Of Values field. This list shows only the values whose Group is the value selected in the other list. For example, a list of streets that shows only the streets of the city selected in a list of cities. |
With AJAX search, the client types at least 2 characters to search. In the form, AJAX search is used only when Multi select is off.
Search types
Section titled “Search types”| Search type | How it finds values |
|---|---|
| Fuzzy | Finds texts that are similar to what the client typed, so small typos are allowed. For example, “aple” finds “apple”. A search of up to 2 characters, or of a number, finds the texts that contain it. |
| Strict | Finds the texts that contain exactly what the client typed. Upper and lower case don’t matter. For example, “appl” finds “apple”, but “aple” finds nothing. Use it for codes and technical terms. |
Multi select and default value
Section titled “Multi select and default value”These settings apply to both Tags and Dictionary:
| Setting | What it does |
|---|---|
| Multi select | The client can choose several values. The field’s value is the chosen values, separated by commas. Changing this setting clears the default value. |
| Default value | The value that is selected when the form opens. With Multi select, you can select several values. It is not shown when Filter list is set. For a large dictionary, type to search for the value (“Dictionary too large, use direct search.”). |
In a PDF template, the chosen values of a Multi select list are shown on one line, separated by commas. Leave enough room for them.
Conditions
Section titled “Conditions”In conditions, a List Of Values supports Equal, Not Equal, Empty and Not Empty. With Multi select, it supports Contains, Not Contains, Empty and Not Empty.
For a Tags list, you select the value from the list’s values.
Dictionary values in conditions
Section titled “Dictionary values in conditions”For a list connected to a dictionary, conditions and conditional values work with the dictionary’s Value, not its Text:
- In a condition on the list, type the Value to compare with.
- To set the list’s value with a conditional value, enter the Value of the item to select.
For example, if a dictionary has the texts “Level 1”, “Level 2” and “Level 3” with the values 1, 2 and 3, enter 2 to select “Level 2”.