How to build User Input Control components

Highlights

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

Overview

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:

Component Structure

Date Picker

Text Field

Drop-Down List

  • 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. 

  1. Select one of Drop-Down List, Text Field or the Date Picker component.
  2. Select a variable from the Set Value for menu.
  3. Provide a default value for the component to use.
To learn more about variables, see how to use variables.

Scope

Scope sets the level your User Input Control component will control: Klip, Dashboard or All Dashboards.  Only Klips that use variables are affected.

Scope changes


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,
you must perform the following steps to reset the variable controls.
  1. Remove the affected dashboards.
  2. Sign out.
  3. Sign in.
  4. Re-add the dashboards removed in step 1.

Klip scope

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.


Dashboard scope

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.  



Learn more

Important concepts

These articles provide essential information about Klip building that you can apply to your User Input Control components:

Related examples




Feedback and Knowledge Base