Changes

Custom Field Type: Select One - Dropdown List

6,094 bytes added, 16:37, 23 November 2018

no edit summary

==Field Illustrated==

[[Image:Dropdown03.png|border]] ''Setting the values for the Select One - DropdownList, in '''Custom Field Settings''''' [[Image:DropdownUPDATED.png|border]] ''Select One - Dropdown List, in '''Edit Mode''' ~~(above)~~'' [[Image:Dropdown02UPDATED.png|border]] ''Select One - Dropdown List, in '''View Mode'''''

==Field Options==

All common options:

[[Custom Fields - General Information #General_Settings|General Settings]]

[[Custom Fields - General Information #Role Field Permissions and Status Field Permissions|Permissions & Availability]]

[[Custom Fields - General Information #Classic Options|Classic Options]]

For further information, please refer to [[Custom Fields – General Information]].

Options listed below are specific to this particular field type.

~~{{FieldOptions}}~~* '''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|here]] for further information.)* '''Enable as Attributes''' -

==Referencing the Value==: '''@''fieldname''@''' |: '''@''fieldname''.combovalue@''' ~~!|Predefined Options~~or: '''@#''fieldid''#@''' : '''@#''fieldid''.combovalue#@''' ~~||The~~ When trying to reference the values of this custom field type, you ~~want to be listed~~ 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 @''fieldname''.value@ will display the full HTML of the field; in ~~your~~ other words, a dropdown ~~list~~box containing the values of the field will be displayed.||==Notes==<!--|}'''Allow Empty'''

~~===Display==={| class="wikitable"~~|-~~!|Option!|Description!|Format~~|-~~!|Caption Location~~ ~~||Determines~~ Because the ~~positioning and visibility of~~ values in a Combo Box Custom Field are restricted to the ~~[[caption]] relative to~~ semi-colon delimited list in the ~~field. Options include: Left of Field, Above Field, No Caption, Hide Caption.~~ '''~~Note:~~Values''' ~~this option was previously called~~ field, the '''~~Label Display~~Allow Empty'''field has a slightly different behaviour than usual. It controls whether or not the record can be saved with the default value (~~[[Label Display Options|See examples here.]])~~||which is the first value listed in the '''Values'~~Not Applicable~~''section):|-~~!|Instructions||Text input here displays under the caption.~~ * If ~~caption has Hide Caption enabled then any defined instructions will continue to be displayed above~~ '''Allow Empty''' is checked, the ~~input.~~||record '''can'~~Not Applicable~~''|-~~!|[[Tool Tip]]||When the user hovers their mouse pointer over~~ be saved with the ~~caption of a field, the text in this section will appear~~default value.||* If ''~~Not Applicable~~'Allow Empty'|-~~!|Classify as Personal Data||For use in storing personal data.~~||''~~Not Applicable~~is '''not'|-~~!|SmartFields View||Include or exclude this field from SmartField Views (@SmartFields@) or only display this field for SmartField Views. See SmartField View for further details.~~||''~~Not Applicable~~checked, the record ''|-~~!|SmartFields PDF Formatting||PDF formatting option when rendered from SmartFields Views.||@SmartFields@~~|}~~===Formatting==={| class="wikitable"~~|-~~!|Option!|Description!|Format~~|-~~!|Width||Width of text box.~~||'cannot'~~Not Applicable~~''|}~~===Validation==={| class="wikitable"~~|-~~!|Option!|Description!|Format~~|-~~!|Mandatory||Selecting~~ be saved with the default value. In this ~~option means that this field is required and must be completed~~way you can force the user to select a value different from the default value.||* ''~~Not Applicable~~'Important'|-~~!|Appear Mandatory||Makes~~ '': Because the ~~field appear as though it is a required field. Typically used in conjunction~~ record cannot be saved with ~~browser scripts~~the default value, ~~JavaScript Validation or Submit Logic that perform validation.~~||the first item listed in the ''~~Not Applicable~~'Value'|-~~!|Custom Validation||-~~||''~~Not Applicable''~~|section should be either a space followed by a semi-~~!|Failed Validation Message||Message displayed~~ colon (if ~~validation fails.~~||you want the field to start out blank) or an instruction to the user such as ''~~Not Applicable''~~|}~~===Feature Options==={| class="wikitable"~~|-~~!|Option!|Description!|Format~~|-~~!|Track Changes~~||-||--Select One-----''~~Not Applicable~~; ''|-~~!|Show Display Value in List Views||-~~||Please choose''~~Not Applicable~~; 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 ''|}~~===Value Storage==={| class="wikitable"~~|-~~!|Option!|Description!|Format~~|-~~!|From Custom Field(s)||-~~||'Allow Empty'~~Not Applicable~~''|is deselected.-~~!|To Custom Field~~||->~~||''Not Applicable''~~|{{RetiredOptions}}

[[Category:Custom Fields]]

[[Category:Custom Field Types]]

← Older edit

Nancy Sabo

Smartstaff, administrator

421

edits

Changes

Custom Field Type: Select One - Dropdown List

SmartWiki