AgileApps Support Wiki Pre Release

Manage and Reorder Enumerated Values

From AgileApps Support Wiki

Specify Display Text, Colors, Images, and Grouping Labels

The Enumerated Values section of the field-definition page lets you specify display-text, colors, images, and grouping labels, as well as the values returned by user selections:

File:Picklist EnumeratedValues.png

Notepad.png

Note: These options are available only when viewing an enumerated field, not when editing it.

Click [Manage Values] to specify display text, color, images, and grouping labels.

File:Picklist ManageValues.png
  • Fields
Alphanumeric Characters are allowed in labels and values, including special characters (+ / ' - _) and spaces.
  • Display Label - The label to display in the list.
  • Value - The actual value that is stored in a record (or returned to a program) when this item is chosen from the list.
  • Image - Specify an image to display (learn more below)
  • Show only Image in View mode - Whether to show the image alone, or together with the label.
  • Font color - Foreground color
  • Background color - Color of the area in which the text is displayed
  • Use Label for grouping - The specified label becomes a heading in the list, rather than a selectable value (learn more below)
  • Specify images
To specify images, first upload them to the platform as Documents. This example shows records that were created after selecting such images from a picklist:
Click Use Label for Grouping to use a label as a group indicator, rather than making it a selection the user can click.
This option is useful when a picklist is long, and can be organized into groups.
(To be helpful, the "Sort Alphabetically" box must be unchecked.)
Considerations
  • The Use Label for grouping option is only available for Picklists
  • After the Use Label for grouping option is selected, the Sort List Alphabetically option is reset to NO
  • If the Use Label for grouping option is selected, the enumerated values are not available for dependent field associations

Reorder Values

In the Enumerated Values section of the field-definition page, click [Reorder Values] to change the order in which the values appear:

Picklist ReorderValues.png

Notepad.png

Note: Reordering can be done only when the Sort List Alphabetically option is unchecked.