Use dynamic URL selection

You can select specific elements of widgets (for example, a grid row, a combobox entry, a pie slice, etc.) dynamically by specifying URL parameters. When you use the URL to open a dashboard in view mode, the elements are automatically preselected and, if applicable, the preselected elements are used as a filter or an action trigger.

You can select the URL parameters required for dynamic URL selection in the properties menu of a widget and copy them to the clipboard. You can set a data column preselection for each widget that supports data preselection, for example, Grid, Input field, or several charts.

Procedure

  1. Create a dashboard or open a dashboard in the dashboard editor.
  2. Click a widget that supports data preselection. The relevant properties dialog is displayed.

    Before you set a preselection you must assign the relevant data columns to the widget. See Assign data sources to widgets.

  3. Click the URL selection tab.
  4. You can enter a widget ID in the URL-ID input field. If you change the preset ID, you must choose a unique ID within your dashboard and you must save the dashboard to keep the new URL-ID.
  5. The URL example field contains a URL selection of the widgets including all assigned data columns and corresponding dummy values.
  6. You can edit the URL selection according to your requirements in the URL example field.

    Expected formats:

    Number: Do not use thousands separators and use dots as decimal separators.

    Date / time: yyyy-MM-ddThh:mm:ss

    Text: no restrictions (URL-encoded)

  7. Copy the URL selection to the clipboard. If your browser supports this function, a Copy to clipboard button is available.

    The URL parameters are copied to the clipboard of your operating system (URL-encoded).

  8. Add the parameters to a URL that you want to use to open a dashboard and enter the URL in your web browser.
  9. To open a specific dashboard tab, add the corresponding tab parameter to the dashboard URL.
    1. Click properties Show menu beside the tab title of the relevant tab.
    2. Click the URL selection tab.
    3. You can enter a tab ID in the URL-ID input field. If you change the preset ID, you must choose a unique ID within your dashboard.
    4. Save your settings.
    5. Copy the URL selection to the clipboard. If your browser supports this function, a Copy to clipboard button is available.
    6. Add the URL selection that was copied to the clipboard to your dashboard URL.

The dashboard is displayed in view mode with the specified selection.

Example

Dashboard preselection parameters

&cn16.Time=2015-12-23&cn16.Location=New%20York

Tab preselection parameter

&tab=tab1

URL with parameters added

http://<local host>:8080/mashzone/hub/dashboard/dashboard.jsp?editmode=false&guid=0bd1cbcc-49d2-4cb1-a5fe-72cfdc624cda &cn16.Time=2015-12-23&cn16.Location=New%20York&tab=tab1

These URL parameters are applied when you open the dashboard. To apply a modified preselection, you must reload the dashboard page. However, you can also apply a selection in an open dashboard without reloading the entire page. In this case, the selection string must begin with #... instead of &...

...#cn16.Time=2015-12-23&cn16.Location=New%20York