Input control
Overview
Input controls add user input elements to a dashboard and pass the entered values to user-defined variables in query widgets. For example, changing the time range with a date input control or selecting a specific asset group with a list input control causes linked query widgets to re-query data with the updated conditions. Use input controls to build interactive dashboards where users can explore data by adjusting conditions directly.
Only accounts with the dashboard management or widget editing permission can add or modify input controls. An account with only the widget viewing permission can view settings but cannot make changes.
Input control types
| Type | Description |
|---|---|
| Date Input Control | Select a date or date range and pass it to a DATE-type variable |
| Text Input Control | Enter text directly and pass it to a STRING-type variable |
| List Input Control | Select a value from a predefined list and pass it to a variable |
Common settings
All input controls share the following common settings:
- Name: Widget name (required, up to 50 characters)
- Description: Widget description (up to 2,000 characters)
- Refresh (sec.): Interval at which the widget is automatically refreshed (in seconds, required, range: 0–2,147,483)
- Granted Users: Select the accounts to share this widget with.
- Granted Groups: Select the account groups to share this widget with.
- Title: Title displayed inside the widget on the dashboard
- Vertical: Vertical position of the input control within the widget (options: Top / Middle / Bottom)
- Horizontal: Horizontal position of the input control within the widget (options: Left / Center / Right)
For type-specific settings, refer to the corresponding input control page.