Configure custom redirection from a dashboard

  • Release version: Washingtondc
  • Updated July 23, 2024
  • 1 minute to read

    • If you have created a page in your workspace from the Dashboard page template, you can customize the on-click redirection from the dashboard components on that page that were created in the inline editor.

    Before you begin

    You have created a workspace in UI Builder with a page generated from the Dashboard page template. You then added a dashboard as described in Add a dashboard to a Dashboards page. The dashboard must have been created in the inline editor.

    Role required: ui_builder_admin

    About this task

    Important:
    The procedure described here applies only to dashboards created in the inline editor. For technical dashboards, you configure redirection through a drilldown event for each data visualization. For more information, see Add a drilldown event to a data visualization in a technical dashboard.

    Procedure

    1. Open your workspace in UI Builder.
    2. Open the relevant page.
      You will have built this page using the Dashbords page template.
    3. Select the dashboard component.
    4. In the configuration panel, turn off Use default redirections.

      Turning off default redirections.
      You have turned off redirections. Clicking on a chart during runtime does not trigger any actions.
    5. In the events panel, select + Add event mapping.
    6. From the list of available events, select Dashboard widget clicked.

      Selecting the Dashboard widget clicked event.
    7. In the Data and scripts area of the page, under Client scripts, open Dashboard Widget Clicked.

      Opening the Dashboard widget clicked script in the editor.
    8. In the Edit client script pane, find the line api.emit('NAV_ITEM_SELECTED', payload);.
    9. Update the payload to align with your custom redirection logic.

    Result

    All redirections from data visualizations on that dashboard open your specified target.