How Do I Use Parameters in a Custom Dashboard?

How Do I Use Parameters in a Custom Dashboard?

The parameter option in a custom dashboard lets you build one dashboard for many uses. Typically, you use the parameter value in a filter for each widget in the dashboard (e.g., filtering by parent course).

How to Define a Parameter

To define a parameter:
  1. From the left menu, click Analytics > Dashboard.

  2. If you don’t already have a custom dashboard, then make one by clicking the New Dashboard button.

  3. If you don’t already have a widget in the custom dashboard, then click Add a Widget, else click Edit Dashboard.

  4. At the top of the dashboard, click the Define Parameters button*.

  5. In the Define Dashboard Parameters form, enter the key Name, Default value, and select the parameter Type.



  6. In the widget, click the Edit Widget button (pencil) at the top-right, 

  7. In the Chart Builder, add a filter that changes the chart based on the parameter (in the screenshot, note the last two fields in the filter query — the parameter key name and the Param switch).



  8. Click the OK button.
Notes
*The Define Parameters button only appears while editing the dashboard.

How to Set a Parameter

To change a parameter:
  1. At the top of the dashboard, click the Set Parameter button.

  2. In the Set Dashboard Parameters form, click the Search button (magnifying glass) at the right.



  3. In the Search for Values form, select a picker from the list on the left and click the new value. 



  4. Click the OK button.
The dashboards refreshes, and all widgets that use the parameter will change to filter on the new value.

Unlike when defining a parameter, you can change a parameter while editing the dashboard or not. You can even change the parameter while in a Chart Builder, too.

Notes
The URL of the dashboard reflects any set parameter (and time range). You can use this when you click Get Link for the dashboard — in the Create Embed Link form, you’ll see the Fixed Parameter Value, as well as options to Allow Parameter Modification and Show Parameter Pickers.



How to Program a Parameter

If you’re using the Advanced Chart Builder, you can use a parameter in VQL like this:
"filter": {
    "context.contextActivities.parent.id": {
        "$param": {
            "path": "course"}}},



    • Related Articles

    • Which Advanced Dashboard Features Are Not in the Free Plans?

      In general, you have the same analytics in all Veracity Learning plans. All customers can open the same LRS Overview, Activity Overview, and Agent Overview default dashboards. All customers can also author custom dashboards. However, the advanced ...

    • How Do I Use the Markdown Widget?

      The Markdown widget is new (1.16.2). When you Add a Widget in a custom dashboard, you can find it under Graphics and Design, or in All Widgets. The Markdown widget lets you enter text and apply presentation styles to it, to help describe your custom ...

    • How Do I Add ‘Storytelling’ to a Dashboard?

      If you only use the out-of-the-box dashboards, or have a custom dashboard with one widget, then you’re all set. But, if you decide to build a custom dashboard (or more) with many widgets, then you must consider the overall design. “Widgets” include ...

    • What are xAPI Extensions and How Do I Use Them in My xAPI Statements?

      Best Practices for xAPI Extensions Activity, Context, and Result Extensions in xAPI Statements Do you need to know when and how to best use Activity, Context or Result Extensions in your xAPI Statements? This is a common challenge and a frequently ...

    • How Do I Add Custom xAPI to Storyline?

      While Articulate Storyline supports a handful of xAPI actions out-of-the-box, you may want more. In response, Articulate added an option to create a trigger that sends a custom xAPI statement. If you need help working with triggers, then the ...