|Component||The User Input Control component allows you to select from three different options: a Text Field, Drop-Down List, and Date Picker.|
|Overview||It lets you use a value to cycle through different data or date selections on your dashboard. The values that you can select are determined by what variables you set up.|
|Key Features||Set the scope of the component to Dashboard, Klip, or All Dashboards.
Use a Text Field to search for values directly on your dashboard.
Use a Drop-Down List to select which values to show on your dashboard.
Use a Date Picker to select a date range.
|Important||In order for the User Input Control component to work, you need to set up variables and then use those variables in formulas within your Klips.
Learn more: How to use variables.
|Video||User Input Control component and variables|
The User Input Control component allows you to control your dashboard display according to variables assigned to that component. The control can either be a Text Field which works like a search function, a Drop-Down List that provides a list of values to select from, or a Date Picker that allows you to select start and end dates.
The most important thing to know about the User Input Control component is that it uses variables to determine the data to show. The User Input Control can be set to control values at the Klip, Dashboard or All Dashboards level.
Here is an example of the User Input Control component using the Text Field control in a multi-component Klip:
- Values. The list of possible values to be assigned to the variable associated with the Drop-Down List.
- Labels. Optional. Needed only to provide user-visible values different from Values. For example, if Values are a list of employee numbers (used to index into a data source), the Labels may be the corresponding employee names which are easier for a user to select. If Labels are specified, the number of Labels must be the same as the number of Values. If Labels are not specified, the Drop-Down List will display the Values.
Assign a Variable
To assign the variable that the User Input Control component will set.
- Select one of Drop-Down List, Text Field or the Date Picker component.
- Select a variable from the Set Value for menu.
- Provide a default value for the component to use.
Scope sets the level your User Input Control component will control: Klip, Dashboard or All Dashboards. Only Klips that use variables are affected.
If you change the scope of a variable from a smaller to a larger scope, that is,
- from Klip to Dashboard,
- from Klip to All Dashboards or
- from Dashboard to All Dashboards,
- Remove the affected dashboards.
- Sign out.
- Sign in.
- Re-add the dashboards removed in step 1.
A User Input Control component with Scope set to Klip will control the values displayed on Klips (using its variable) in the same multi-component Klip as the User Input Control component.
A User Input Control component with Scope set to Dashboard will control the values displayed on Klips (using its variable) on the same dashboard as the User Input Control component.
All Dashboards scope
A User Input Control component with Scope set to All Dashboards will control the values displayed on Klips (using its variable) on all dashboards.
These articles provide essential information about Klip building that you can apply to your User Input Control components:
- Working with variables and text fields to build a pie chart
- Filtering by date range
- Creating a filter to display related data