Difference between revisions of "Conditional Lists of Values"

From SmartWiki
Jump to: navigation, search
Line 12: Line 12:
  
 
:<font size="3">&lt;ssOption: ''Parent Value 1''>;''Dependent Value 1'';''Dependent Value 2''&lt;/ssOption></font>
 
:<font size="3">&lt;ssOption: ''Parent Value 1''>;''Dependent Value 1'';''Dependent Value 2''&lt;/ssOption></font>
 +
 +
In the configuration shown below:
 +
* In the ''Province'' field
 +
**''--Select One--'' will always be shown,
 +
**''Ontario'' and ''British Columbia'' will only be shown if ''Canada'' is selected in the ''Country'' field, and
 +
**''Texas'' will only be shown if ''United States'' is selected in the ''Country'' field.
 +
*In the ''City'' field
 +
**''-- N/A --'' will always be shown,
 +
**''Toronto'' and ''Ottawa'' will only be shown if ''Ontario'' is selected in the ''Province'' field, and
 +
**''Vancouver'' will only be shown if ''British Columbia'' is selected in the ''Province field.
  
 
[[Image:Conditional Lists - Combined.jpg|link=]]
 
[[Image:Conditional Lists - Combined.jpg|link=]]
- new option "Parent Field" added for custom field types of combo boxes, radio buttons, and check boxes
 
- "Parent Field" is to indicate if the options of the combo box/check box field are dependent to the value of another field
 
- once selected, you can put <ssOption> syntax to indicate what options to show based on what values
 
eg. --Select One--<ssOption:Canada>;Ontario;British Columbia</ssOption>
 
- this means, "--Select One--" will always show
 
- "Ontario" and "British Columbia" will only show if the parent field is "Canada"
 
another eg: -- N/A --<ssOption:Ontario>;Toronto;Ottawa</ssOption><ssOption:British Columbia>;Vancouver</ssOption>
 
- "-- N/A --" always show
 
- "Toronto" and "Ottawa" will show if the parent field is "Ontario"
 
- "Vancouver" will show if the parent field is "British Columbia"
 
  
This supports up to n levels and it does NOT support dynamic control fields
+
Any number of lists of values can be made dependent on other lists of values.
 +
 
 +
This feature will not work in conjunction with [[Custom Field Type: Dynamic Data – Dynamic Control Field|Dynamic Control fields]].
  
 
[[Category:Custom Fields]]
 
[[Category:Custom Fields]]

Revision as of 13:15, 2 May 2014

The list of values selectable in a custom field can be made conditional upon the value selected in another custom field. This functionality can be configured on the following custom field types:

Canada-Ontario-Cities.jpg

To configure this functionality, for each dependent field:

  • define the field that will condition the dependent values as the "Parent Field"
  • surround the dependent values with the ssOption syntax:
<ssOption: Parent Value 1>;Dependent Value 1;Dependent Value 2</ssOption>

In the configuration shown below:

  • In the Province field
    • --Select One-- will always be shown,
    • Ontario and British Columbia will only be shown if Canada is selected in the Country field, and
    • Texas will only be shown if United States is selected in the Country field.
  • In the City field
    • -- N/A -- will always be shown,
    • Toronto and Ottawa will only be shown if Ontario is selected in the Province field, and
    • Vancouver will only be shown if British Columbia is selected in the Province field.

Conditional Lists - Combined.jpg

Any number of lists of values can be made dependent on other lists of values.

This feature will not work in conjunction with Dynamic Control fields.