AgileApps Support Wiki Pre Release

Difference between revisions of "Manage and Reorder Enumerated Values"

From AgileApps Support Wiki
imported>Aeric
imported>Aeric
Line 1: Line 1:
__FORCETOC__
====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]]


{{Note|These options are available only when ''viewing'' an enumerated field, not when ''editing'' it.}}
The ''Enumerated Values'' section of the field-definition page, lets you specify the picklist values and the order in which they appear.


Click '''[Manage Values]''' to specify display text, color, images, and grouping labels.
====Specify Display Text, Colors, Images, and Grouping Labels====
:[[File:Picklist_ManageValues.png]]
 
:*;Fields:
::[[Alphanumeric Characters]] are allowed in labels and values, including special characters (<tt><nowiki>+  /  '  -  _</nowiki></tt>) 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 which values appear:
:: 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 '''[Manage Values]'''
::[[File:Enumeratedstatuscheck.gif|none]]
# Click the box under the Trash can to remove an item.
# Click '''[Add More Rows]''' to add additional items
# Click '''[Save]''' when done


:*;[[File:Picklistgroupbylabel.gif|right|upright|thumb|''Fruit'' and ''Vegetable'' are group labels]]Specify grouping labels:
;Settings:
::Click ''Use Label for Grouping'' to use a label as a group indicator, rather than making it a selection the user can click.
:* '''Display Label''' - The label to display in the list.
::This option is useful when a picklist is long, and can be organized into groups.  
:* '''Value''' - The actual value that is stored in a record (or returned to a program) when the item is chosen from the list.


::;Considerations:
{{Note|[[Alphanumeric Characters]] are allowed in labels and values, including special characters (<tt><nowiki>+  /  ' -  _</nowiki></tt>) and spaces.}}
:::*The ''Use Label for grouping'' option is available only for Picklists
:::*After the ''Use Label for grouping'' option is selected, the ''Sort List Alphabetically'' option is reset to ''No'' (otherwise, the label won't be helpful).
:::*If the ''Use Label for grouping'' option is selected, the enumerated values are not available for dependent field associations.


====Reorder Values====
====Reorder Values====

Revision as of 20:51, 25 June 2013

The Enumerated Values section of the field-definition page, lets you specify the picklist values and the order in which they appear.

Specify Display Text, Colors, Images, and Grouping Labels

To specify which values appear:

  1. Click [Manage Values]
  2. Click the box under the Trash can to remove an item.
  3. Click [Add More Rows] to add additional items
  4. Click [Save] when done
Settings
  • 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 the item is chosen from the list.

Notepad.png

Note: Alphanumeric Characters are allowed in labels and values, including special characters (+ / ' - _) and spaces.

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.

Retrieved from "https://agileappscloud.info/aadev-src/index.php?title=Manage_and_Reorder_Enumerated_Values&oldid=16540"