Documentation

    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.

    The live example needs a desktop screen. The result it produces is shown here, and the explanation and settings below work on any screen.

    Result
    CarrierHoursOn time
    Northwind22100
    Northwind25100
    Northwind36100
    Northwind410
    Baltic33100
    Baltic410
    Baltic28100
    Baltic520
    1. Drag the Late after (hours) slider left to 24. On time falls from 56% to 6%, and the chart shows only Northwind above zero.
    2. Drag it right to 60. Every delivery now counts as on time, so On time reads 100%.
    3. 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

    1 port
    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: Automatic

    Options: Automatic, Slider, Dropdown, List, Buttons, Switch, Calendar, Date field.

    Orientation

    Arranges the value buttons horizontally or vertically.

    Default: Horizontal

    Options: Horizontal, Vertical.

    Calendar placement

    Opens the calendar in a popup, or keeps it visible in the control.

    Default: Popup

    Options: 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: Automatic

    Options: 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.