<u>'''#REDIRECT [[Custom Field Display'''</u> Type: Select One - Dropdown List]]
==General Description==Displays as a set of values in a combo box. The [[User|user]] can select a single value. The size of scrolling window is controlled by the '''Height Setting'''. ==Field Display== [[Image:cf_socb_ex1.png]]<br />'' '''Select One - Combo Box''' field, in '''Edit Mode''' (above)''<br /> [[Image:cf_socb_ex2.png]]<br />'' '''Select One - Combo Box''' field, in '''View Mode''' (above)''<br /> [[Image:cf_socb_ex3.png]]<br />'' Setting the values for the '''Select One - Combo Box''' field, in '''General Settings''' (above)''
[[Image:Cf54.png]]
'''View Mode'''
[[Image:Cf55.png]]
<u>'''General Description'''</u>
Displays as a set of values in a combo box. The [[User|user]] can select a single value. The size of scrolling window is controlled by the '''Height Setting'''.
{{FieldOptions}}
{{ParentField}} * '''Values''': The values to be used for each check box delimited by a semi-colon with no spaces{{ToolTip}}{{HideFieldForNewRecord}}{{SmartFieldView}} {{OptionsTab}}{{AllowEmpty}}
{{AppearMandatory}}
{{LabelAboveField}}
{{Searchable}}
{{TrackChanges}}
{{EnableMultipleSelect}}
{{ShowDisplayValueInListViews}}
{{ShowAsRadioButtons}}
{{ShowDisplayValueInListViewsEnableKML}}{{HideFieldForNewRecordDisableQuickEdit}} {{DisableFromGlobalSearch}}<u>'''Special Options for Field'''</u>
'''Values''': The values to be used within the combo box, delimited by a semi-colon with no spaces.{{Validation}}
The first value listed will be the default value when a new record is created.
'''Note:''' 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:{{Formatting}} ''StoreValue1=DisplayValue1;StoreValue2=DisplayValue2;StoreValue3=DisplayValue3;{{CaptionStyle}}
The value * '''beforeWidth''' : Enables the equal sign will be stored. The value '''after''' user to set the width of the equal sign is what will be displayed Lookup field in the combo box, but does not get saved. pixels* 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.{{CustomHTMLTag}}
<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==Value Storage==* '''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> {{ValueStoresTo}}
* '''Type''': Select Date, Numeric, or Alphabetic validation
* '''[[JavaScript Validation]]''': Custom JavaScript validation formulas can be entered in this field
* '''[[Validation Message|Message]]''': The message that the user will see if the data in the field fails a validation check
<u>'''Value Stores To'''</u>{{CFPermissionsTab}}
* '''Custom Field''': Enables linking two different custom fields to the same user data
<u>'''Field Formatting Options'''</u>
* '''Width''': Determines the width of the field
* '''[[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 color="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 visible
<u>'''[[Role Field Permissions|Role - Field Permissions]]'''</u> ==Configuration Best Practices=={{CFComboBoxBP}}
These [[Role Field Permissions|fields]] allow you to control by [[Role]] who is allowed to view and/or modify the field.
<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.
==Referencing the Value==
: <span style="font-size: medium;">'''@''fieldname''@''' </span>
: <span style="font-size: medium;">'''@''fieldname''.combovalue@''' </span>
or
: <span style="font-size: medium;">'''@#''fieldid''#@''' </span>
: <span style="font-size: medium;">'''@#''fieldid''.combovalue#@''' </span>
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.
:<font size="3">'''Using @fieldname.value@''' </font>:<font size="3">'''@fieldname.combovalue@''' </font>or :<font size="3">'''@#fieldid.value#@''' </font>:<font size="3">'''@#fieldid.combovalue#@''' </font>When trying to reference will display the values full HTML of this custom field type, you must use '''@fieldname.value@''' or '''@fieldname.combovalue@''', depending on how the field is setup. Typically; in other words, you can use @fieldname.value@ but there is a special case where you must use @fieldname.combovalue@ when dropdown box containing the values in of the combo box are 1=Yes;2=No;3=Maybefield will be displayed.<!-- ssRetiredOption ssRetiredOptions -->
Using @fieldname.value@ will return the Yes, No, or Maybe. But using @fieldname.combovalue@ will return 1, 2, or 3.==Notes=={{StoredValue}}
* The first value listed will be the default value when a new record is created.
* 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.
==Notes==
{{AllowEmptyDescription}}
{{RetiredOptions}}
==See Also==
* [[Custom Field Language Settings]]
[[Category:Custom Fields]]{{CustomFieldPageFooter}}
