Parameter
Parameter shows a value on the dashboard and lets the reader change it. Connected to a Formula or a Strata block setting, it changes the data behind your visuals.
Change a threshold and recalculate
A slider sets how many hours a delivery may take, and a Formula block uses that number to calculate each carrier's On time share. The dashboard is read-only, but the slider still works.
Parameter interactive example
Loading interactive example…
The live example needs a desktop screen. The result it produces is shown here, and the explanation and settings below work on any screen.
| Carrier | Hours | On time |
|---|---|---|
| Northwind | 22 | 100 |
| Northwind | 25 | 100 |
| Northwind | 36 | 100 |
| Northwind | 41 | 0 |
| Baltic | 33 | 100 |
| Baltic | 41 | 0 |
| Baltic | 28 | 100 |
| Baltic | 52 | 0 |
- Drag the Late after (hours) slider left to
24. On time falls from 56% to 6%, and the chart shows only Northwind above zero. - Drag it right to
60. Every delivery now counts as on time, so On time reads 100%. - Look at the flow below the dashboard: Vista Parameter feeds the Formula block.
When to use
Use Parameter to change a number or choice used in a calculation, such as a late-delivery threshold or a discount rate. Every row stays in the data. To leave rows out by a column's value, use Filter.
Inputs
- ParameterOptional
Accepts: Tables.
Accepts one connection on this port.
Settings
To set one up, add Parameter from the Controls tab and choose Create parameter. Choose Calculation to write a formula with it, or Control a Strata block to drive a setting. In Properties you can set Type, Value, Allowed values, Minimum, Maximum and Step. Add another use connects the same parameter elsewhere. See Parameters and filters.
- Show label
Shows or hides the control label.
Default:
true- Label
Leave empty to use the parameter name.
- Percent
Shows Number values as percentages.
Default:
false- Text size
Size of the text, in pixels.
Default:
14- Presentation
How the control appears. A typed field is labeled Input for non-date parameters and Date field when a calendar is available.
Default:
AutomaticOptions: Automatic, Slider, Dropdown, List, Buttons, Switch, Calendar, Date field.
- Orientation
Arranges the value buttons horizontally or vertically.
Default:
HorizontalOptions: Horizontal, Vertical.
- Calendar placement
Opens the calendar in a popup, or keeps it visible in the control.
Default:
PopupOptions: Popup, Always visible.
- Show input fields
Shows or hides a field for an exact value beside the slider.
Default:
false- Search
Shows or hides the search box, or lets the control decide automatically.
Default:
AutomaticOptions: Automatic, Show, Hide.
- Corner radius (px)
Corner radius in whole logical pixels.
Default:
0- Border width (px)
Border width in whole logical pixels.
Default:
0
Parameter FAQs
- Is a parameter the same as a filter?
- No. A filter removes rows. A parameter supplies a value that a calculation or block setting uses.
- Do I have to write SQL?
- A calculation uses a Formula expression, where params.name reads the parameter. Control a Strata block needs no expression.
- Do parameter changes affect other viewers?
- No. On a published dashboard, viewer selections affect only their own session.
Chart your data. Build it in Vista.
Vista opens in your browser, with no account.