Changes

Custom Field Type: Select Many – Check Boxes

426 bytes removed, 16:36, 23 November 2018
no edit summary
<u>==General Description==Displays as a set of check boxes in '''Field DisplayEdit'''</u>mode. The [[User|user]] can select multiple values. In '''View''' mode the values are displayed as text, semi-colon delimited. The # of columns option is used to define the number of columns required for display.
==Field Illustrated==[[Image:Cf_smcb_ex1.png|link=]]<br />'' '''Select Many - Check Boxes''' field, in '''Edit Mode''' (above)''
[[Image:Cf48.png]]
'''View Mode'''
[[Image:Cf49Cf_smcb_ex3.png|link=]] <ubr />'''General Description''Select Many - Check Boxes''' field, in '''View Mode''' (above)''</u>
Displays as a set of check boxes in '''Edit''' mode. The [[User|user]] can select multiple values. In '''View''' mode the values are displayed as text, semi-colon delimited. The # of columns option is used to define the number of columns required for display.
<u>'''Field Options''' </u>
* '''Display Order''': The order (relative to other fields) in which this field is displayed* '''Tab Name''': Displays the field under a given tab* '''Field Name''': The name of the field, used internally to reference the user's input* '''[[CaptionImage:Cf_smcb_ex2.png|link=]]<br />''': The leading question or prologue before Setting the field* '''Allow Empty''': This checkbox allows values for the field to be left empty* '''SearchableSelect Many - Check Boxes''': This field can be searched within the tracking application* , in '''Track ChangesGeneral Settings''': Keeps track of changes made to this field <u>(above)'''Special Options for Field'''</u>
* '''Values''': The values to be used for each check box delimited by a semi-colon with no spaces
<u>'''Services'''</u>
* '''Enable Map Service''': displays the map icon next to the field name that will launch the user’s selected map service and display a map of the content of the field
* '''Enable People Search Service''': displays the search Internet icon next to the field name that will launch a variety of search services and display the contact details from those services
* '''Enable Organization Search Service''': displays the search Internet icon next to the field name that will launch a variety of search services and display the organisations details from those services
<u>'''Field Validation'''</u>
* '''Type'''==Field Options==All common options: Select Date, Numeric, or Alphabetic validation<br />[[Custom Fields - General Information #General_Settings|General Settings]]<br />* '''JavaScript Validation''': Here can be entered any specific JavaScript validation for this field[[Custom Fields - General Information #Role Field Permissions and Status Field Permissions|Permissions & Availability]]<br />* '''[[Validation MessageCustom Fields - General Information #Classic Options|MessageClassic Options]]<br />For further information, please refer to [[Custom Fields – General Information]''': Message the user will see if entry fails validation check].<br /><br />Options listed below are specific to this particular field type.{{ParentField}}
<u>* '''Value Stores ToPredefined Options'''</u>: The values to be used for each checkbox, delimited by a semicolon with no spaces.
{{SortValuesToDisplayVertically}}* '''Custom FieldEnable as Attributes''': Enables linking two different custom fields to the same user data-
<u>==Notes==If you want the value(s) ''stored'Field Formatting Options'in the field to be different from what is ''</u> displayed'' beside the check boxes you can use the following syntax in the '''Values''' section:
* '''# of Columns''': Determines the number of columns to be used for display purposes* '''Number Format''': Formats any numbers entered into this field* '''Style''': '''Bold''', <u>Underline</u>, ''Italic'', <font colorStoreValue1=DisplayValue1;StoreValue2=DisplayValue2;StoreValue3="red">Highlight</font> * '''[[Tool Tip]]''': Enter help text to be shown on mouse-over* '''Read Only''': Checkbox* '''HTML Tag''': Additional attributes to the field HTML tag* '''[[Visibility Condition]]''': Conditions upon which the field is visibleDisplayValue3;
<u>The value '''Role - Field Permissionsbefore'''</u> the equal sign will be stored. The value '''after''' the equal sign is what will be displayed by each check box, but does not get saved.
These * This technique is important when translating to other languages. The '''StoreValue''' must be the same in all languages. See [[Custom Fields UTA Status PermissionsField Language Settings|fieldshere]] allow you to control who is allowed and who is denied viewing and/or modifying the fieldfor further information.
 '''<u>Referencing the Value</u>''' When trying to reference the values of this custom field type, you must use '''@fieldname.value@''' when the values in the combo box are 1=Yes;2=No;3=Maybe. Using @fieldname.value@ will return the 1, 2, or 3. {{RetiredOptions}} ==See Also==* [[Select Check Boxes by Default]]* [[Allowing Only One Check Box to be Selected]]* [[Category:Custom FieldsField Language Settings]]  {{CustomFieldPageFooter}}
Smartstaff, administrator
421
edits