Changes

Jump to: navigation, search

Custom Field Type: Select Many – Check Boxes

1,713 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=]]''': The leading question or prologue before the field<br />* '''Allow Empty''': This checkbox allows Setting the field to be left empty* '''Appear Mandatory''': Makes values for the field appear as through it required even though "Allow Empty" is selected.* '''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
'''Note:''' If you want the value(s) ''stored'' in the field to be different from what is ''displayed'' beside the check boxes 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 by each check box==Field Options==All common options:<br />[[Custom Fields - General Information #General_Settings|General Settings]]<br />[[Custom Fields - General Information #Role Field Permissions and Status Field Permissions|Permissions & Availability]]<br />[[Custom Fields - General Information #Classic Options|Classic Options]]<br />For further information, but does not get savedplease refer to [[Custom Fields – General Information]]. <ubr />'''Services'''<br /u> Options listed below are specific to this particular field type.{{ParentField}}
* '''Enable Map ServicePredefined Options''': displays the map icon next The values to the field name that will launch the user’s selected map service and display be used for each checkbox, delimited by 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> semicolon with no spaces.
* '''Type''': Select Date, Numeric, or Alphabetic validation* '''[[JavaScript Validation]]''': Custom JavaScript validation formulas can be entered in this field{{SortValuesToDisplayVertically}}* '''[[Validation Message|Message]]Enable as Attributes''': The message that the user will see if the data in the field fails a validation check-
<u>==Notes==If you want the value(s) ''stored'Value Stores To'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:
* '''Custom Field''': Enables linking two different custom fields to the same user data <u>'''Field Formatting Options'''</u>  * '''# of Columns''': Determines the number of columns to be used for display purposes* '''[[Number Format]]''': Allows you to define how numbers in this field will be displayed. See [[Number Format|here]] for details. * '''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 Permissions|Role - Field Permissions]]before'''</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 [[Role Custom Field PermissionsLanguage Settings|fieldshere]] allow you to control by [[Role]] who is allowed to view and/or modify the fieldfor further information.
<u>'''[[Status Field Permissions|Status - Field Permissions]]'''</u>
* ''Only present within the [[Universal Tracking Application]]''
These [[Status Field Permissions|fields]] allow you to control by the [[Status]] of the record whether or not the field can be viewed and/or modified.
==Notes==
'''<u>Referencing the Value</u>'''
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]]
* [[Custom Field Language Settings]]
 
[[Category:Custom Fields]]{{CustomFieldPageFooter}}
Smartstaff, administrator
421
edits

Navigation menu