Named value lists enable display names for predefined field values

When users of Opportunity Detect work with components to build trigger systems, they can select data fields from drop-down lists in the component editors. If a data source includes a field with predefined values, you can create a named value list to assign display names to these values.

The display names are what the user sees when working with component editors. Display names make the component-building process more intuitive.

Named value lists are reusable. For example, you might have several transaction data sources that have a Boolean field where the predefined values are 0 and 1, where 1=true and 0=false. In this case, you can create a named value list that you associate with these fields in several transaction data sources.

Named value list example

For example, you might have a field in a data source that is named FREQUENCY. This field contains three predefined values, which have the following significance.

  • F for customers who interact with your company frequently
  • A for customers whose interaction frequency is average
  • I for customers who interact with your company rarely

To help users understand what these values mean, you can map each value to a display name. You might create a named value list called Frequency and map the values as follows.

Table 1. Mapping data to display names
Value Display name
F Frequent customer
A Average customer
I Infrequent customer

After you map the values, you can associate the list with the field when you define the data source. Then, when a user selects this field in a component editor, the drop-down list that contains the predefined values shows the display names, which are more meaningful to the user than the actual values in the data source.

Predefined lists

Three lists are present when Opportunity Detect is installed, for use in the component editors. The values are mapped to display names as follows, but you can modify the values as needed to reflect your data.

Table 2. Display name mapping in predefined lists
List name Display name mapping
NUMERIC_YES_NO
  • Yes = 1
  • No = 0
DAY_WEEK_MONTH
  • Day = day
  • Week = week
  • Month - month
HIGH_MED_LOW
  • High = H
  • Medium = M
  • Low = L