Multi-Valued Parameters

A parameter associated with a textbox control or a dropdown control can now have multiple values associated with it. A parameter is designated a multi-valued parameter, in the Parameter Definition by: selecting the Allow Multiple Values checkbox. A text box parameter input control that allows multiple values expands to a full text area when the user clicks the textbox. A single value is entered per line. When they click outside of the text area a comma delimited list of specified values will appear in the textbox. A dropdown parameter input control that allows multiple values has checkboxes to indicate the selected values. You CANNOT pass a value from a top level MULTI value parameter into a lower level SINGLE value parameter.

Parameter macros

Multiple values are represented as follows in the various parameter contexts:

• Chart Title – a comma-delimited list of values
• Chart Filter – a comma-delimited list of values suitable for an IN clause
• The multi-valued parameter macro can also be used in a filter with a typical single valued operator and the logic will be expanded to apply or criteria to the resulting clauses.

One important thing to remember about multi-valued parameters is that a multi-valued parameter can only provide a value for another multi-valued parameter. This becomes another component of the parameter value resolution process when determining whether or not a particular value can be assumed by a given parameter. A single-valued parameter CAN provide the value for a multi-valued parameter.

The following rules are good to keep in mind when working with Multi-Values Parameters:

1.        Multi-Value Parameter can provide/ pass value to another Multi-Value Parameter
2.        Single-Value Parameter can provide/ Pass value to another Multi-Value Parameter
3.        Single-Value Parameter can provide/ Pass value to another Single-Value Parameter
4.        Multi-Value Parameter cannot provide/ Pass value to another Single-Value Parameter

For More Information:

• Input Parameters 11:05
• JavaScript Array Methods
• Previously Read: Charts: Formatting Parameters
  
• Read Next: Creating Cascading Input Parameters
• iDashboards Builder Manual 13. Input Parameters

If the above is unable to resolve the issue, then please contact iDashboards Support for further assistance.