Changes

Custom Field Type: Select One - Dropdown List

5,362 bytes added, 16:37, 23 November 2018

no edit summary

~~{| class~~=~~"wikitable"~~=Field Options==|-All common options: ~~! style="width: 125px; text~~[[Custom Fields -~~align: left;"~~General Information #General_Settings|~~Predefined Options~~General Settings]] [[Custom Fields - General Information #Role Field Permissions and Status Field Permissions|~~|The values you want to be listed within your dropdown list, delimited by semi-colons with no spaces.~~Permissions & Availability]] |[[Custom Fields -|General Information #Classic Options|Classic Options]] ||* The first value listed will be the default value when a new record is created.* If you want the value ''stored'' in the field to be different from what is ''displayed'' in the combo box you can use the following syntax in the '''Values''' section: ''StoreValue1=DisplayValue1;StoreValue2=DisplayValue2;StoreValue3=DisplayValue3;* The value '''before''' the equal sign will be stored. The value '''after''' the equal sign is what will be displayed in the combo boxFor further information, ~~but does not get saved. (This technique is important when translating~~ please refer to ~~other languages. The '''StoreValue''' must be the same in all languages. See~~ [[Custom ~~Field Language Settings|here~~Fields – General Information]] ~~for further information~~.) Options listed below are specific to this particular field type.

* '''Parent Field''' -* '''Predefined Options''' - The values you want to be listed within your dropdown list, delimited by semicolons with no spaces.Here are a few things to note: 1. The first value listed will be the default value when a new record is created. 2. If you want the value ''stored'' in the field to be different from what is ''displayed'' in the combo box you can use the following syntax in the '''Predefined Options''' section: ''StoreValue1=DisplayValue1;StoreValue2=DisplayValue2;StoreValue3=DisplayValue3; 3. The value '''before''' the equal sign will be stored. The value '''after''' the equal sign is what will be displayed in the combo box, but does not get saved. (This technique is important when translating to other languages. The '''StoreValue''' must be the same in all languages. See [[Custom Field Language Settings|}~~{{Display}}~~here]] for further information.)~~{{Validation}}~~* '''Enable as Attributes''' -

~~!|Option~~==Referencing the Value==~~!|Description!|Format~~|: '''@''fieldname''@''' ! : '''@''fieldname''.combovalue@'~~Not Applicable~~''|-or! : '''@#''fieldid''#@''' : '''@#''fieldid''.combovalue#@''' ~~||[[Value Stores To]]~~When trying to reference the values of this custom field type, you must use '''@fieldname@''' or '''@fieldname.combovalue@''', depending on how the field is setup. Typically, you can use @fieldname@ but there is a special case where you must use @fieldname.combovalue@ when the values in the combo box are 1=Yes;2=No;3=Maybe.Using @fieldname@ will return the Yes, No, or Maybe. But using @fieldname.combovalue@ will return 1, 2, or 3. ||Using @''~~Not Applicable~~fieldname''|}.value@ will display the full HTML of the field; in other words, a dropdown box containing the values of the field will be displayed.

==Notes==

<!--'''Allow Empty'''

Because the values in a Combo Box Custom Field are restricted to the semi-colon delimited list in the '''Values''' field, the '''Allow Empty''' field has a slightly different behaviour than usual. It controls whether or not the record can be saved with the default value (which is the first value listed in the '''Values''' section):

* If '''Allow Empty''' is checked, the record '''can''' be saved with the default value.

* If '''Allow Empty''' is '''not''' checked, the record '''cannot''' be saved with the default value. In this way you can force the user to select a value different from the default value.

* '''Important''': Because the record cannot be saved with the default value, the first item listed in the '''Value''' section should be either a space followed by a semi-colon (if you want the field to start out blank) or an instruction to the user such as ''-----Select One-----''; ''Please choose''; or similar. You do not want an actual value as the first item, since the record can never be saved with the first value if '''Allow Empty''' is deselected.-->{{RetiredOptions}}

[[Category:Custom Fields]]

[[Category:Custom Field Types]]

← Older edit

Nancy Sabo

Smartstaff, administrator

421

edits

Changes

Custom Field Type: Select One - Dropdown List

Navigation menu

Personal tools

Namespaces

Variants

Views

More

Search

Navigation

Tools