List Values (Data Field/Data Column Property)

⚠	ARTICLE UNDER CONSTRUCTION

This article is about the current version of Grooper. Note that some content may still need to be updated.

2025

"List Values" is a set of configurable properties for {DataFieldIcon}} Data Field and {DataColumnIcon}} Data Columns. When enabled and configured, List Values alters how users interact with Data Field input boxes and Data Column cell input boxes in a Data Viewer. It allows Grooper designers to set a list of values users can pick from a dropdown selection. Instead of a "free type" input, it users can pick from the list when reviewing the field.

Example List Values selection list

The items in the selection list can be generated in one of three ways (or a combination of the three):

• A local list
• A referenced Lexicon
• A list generated by a lookup (such as a Database Lookup or an XML Lookup)

The selection list can be "permissive" or "restrictive".

• Permissive lists are the default behavior.
  • Permissive lists lets users type in values that are not present in the selection list.
  • Permissive lists will accept values collected by the Data Field's Value Extractor that are not present in the selection list.
• Restrictive lists are enabled by enabling the "Restrict to List" property.
  • Restrictive lists prevent users from typing anything in the input box. They can only select an item from the selection list.
  • Restrictive lists will ignore values returned by the Data Field's Value Extractor if it is not present in the selection list.

Other features

Restrict to List

While technically not a "List Values" setting, the "Restrict to List" property is only used in conjunction with List Values. Enabling "Restrict to List" will only allow values from the selection list to be selected (whether a local list, referenced Lexicon or list populated by a lookup).