Difference between revisions of "Custom Field Type: Lookup - Autocomplete Options"

From SmartWiki
Jump to: navigation, search
(General Description)
 
(7 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
==General Description==
 
==General Description==
Displays as a set of values in a [[Ajax]] lookup box.
+
Displays as a set of values in an [[Ajax]] lookup box.
  
 
==Field Illustrated==
 
==Field Illustrated==
Line 20: Line 20:
 
[[Image:AutoComplete03.png|border]]<br />
 
[[Image:AutoComplete03.png|border]]<br />
 
''Lookup - Autocomplete Options, in '''View Mode'''''
 
''Lookup - Autocomplete Options, in '''View Mode'''''
<br />
+
 
<br />
+
 
<br />
+
 
{{FieldOptions}}
+
 
 +
==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, please refer to [[Custom Fields – General Information]].<br /><br />
 +
Options listed below are specific to this particular field type.
 +
 
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
Line 29: Line 37:
 
||The values you want to be listed within your dropdown list, delimited by semi-colons with no spaces.
 
||The values you want to be listed within your dropdown list, delimited by semi-colons with no spaces.
 
|-
 
|-
||Notes
+
||
 
||
 
||
 
* The first value listed will be the default value when a new record is created.
 
* The first value listed will be the default value when a new record is created.
Line 35: Line 43:
 
* 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.)
 
* 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.)
  
* '''Values''': The values to be used within the combo box, delimited by semi-colons with no spaces.
+
|}
 +
===External Source Options===
 +
* '''Enable Lookup From External Source''' - once a source is selected (the only one available currently is Google Civic Information), you will be able to map external source values to custom Single or Multiple Line text box fields. Note: if there are multiple values in the search result, but you have mapped to a single-line text box custom field, only the first record will be returned.
  
{{ToolTip}}
+
<!--==Feature Options==
{{HideFieldForNewRecord}}
+
{| class="wikitable"
{{SmartFieldView}}
+
|-
 
+
!|Option
==Special Options for Field==
+
!|Description
'''Predefined Options''': The values to be used within the combo box, delimited by semi-colons with no spaces.
+
!|Format
 
+
|-
The first value listed will be the default value when a new record is created.
+
! style="width: 125px; text-align: left;"|Track Changes
 
+
||Keeps track of changes made to this field.
'''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:
+
||''Not Applicable''
 
+
|-
''StoreValue1=DisplayValue1;StoreValue2=DisplayValue2;StoreValue3=DisplayValue3;
+
! style="width: 125px; text-align: left;"|Show Display Value in List Views
 
+
||By default, the stored value is shown when fields are referenced in List Views. Selecting this option will display the display value.
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.
+
||''Not Applicable''
 
+
|-
* 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.
+
! style="width: 125px; text-align: left;"|Enable Multiple Select
 
+
||Enables users to select multiple values from the listed values.
{{OptionsTab}}
+
||''Not Applicable''
{{Searchable}}
+
|}
{{TrackChanges}}
 
{{EnableMultipleSelect}}
 
{{ShowDisplayValueInListViews}}
 
{{DisableQuickEdit}}
 
 
 
{{Formatting}}
 
{{CaptionStyle}}
 
{{FieldFormattingOptions}}...and see note on "[[Display_Additional_File_Attributes_for_PDF_Documents#Multiple_File_Fields|Extra Columns]]" below.
 
  
 
==Value Storage==
 
==Value Storage==
{{ValueStoresTo}}
+
{| class="wikitable"
 
+
|-
{{CFPermissionsTab}}
+
!|Option
 
+
!|Description
 +
!|Format
 +
|-
 +
! style="width: 125px; text-align: left;"|From Custom Field(s)
 +
||[[Value Stores To]]
 +
||''Not Applicable''
 +
|-
 +
! style="width: 125px; text-align: left;"|To Custom Field
 +
||[[Value Stores To]]
 +
||''Not Applicable''
 +
|}-->
 
==See Also==
 
==See Also==
 
* [[Ajax|Ajax Lookups]]
 
* [[Ajax|Ajax Lookups]]

Latest revision as of 17:15, 21 November 2018

General Description

Displays as a set of values in an Ajax lookup box.

Field Illustrated

AutoComplete04.png
Setting the values for the Lookup - Autocomplete Options, in Custom Field Settings


AutoComplete.png
Lookup - Autocomplete Options, in Edit Mode


AutoComplete02.png
Lookup - Autocomplete Options, in Edit Mode with Enable Multiple Select option selected - click on the grey 'x' to remove selection


AutoComplete03.png
Lookup - Autocomplete Options, in View Mode



Field Options

All common options:
General Settings
Permissions & Availability
Classic Options
For further information, please refer to Custom Fields – General Information.

Options listed below are specific to this particular field type.

Predefined Options The values you want to be listed within your dropdown list, delimited by semi-colons with no spaces.
  • 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 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 here for further information.)

External Source Options

  • Enable Lookup From External Source - once a source is selected (the only one available currently is Google Civic Information), you will be able to map external source values to custom Single or Multiple Line text box fields. Note: if there are multiple values in the search result, but you have mapped to a single-line text box custom field, only the first record will be returned.

See Also