Creating a drill-down URL relation

Sets a widget to a web page communication. From a source widget, you can go to a target web page. You first set a source widget and then specify the URL of the target web page. You can either specify a static URL or a dynamic URL. You can add only a single drill-down URL to a source widget or to a controller-listener relation. You cannot add a drill-down URL to a drill-down dashboard.

Before you begin

  • You must ensure that the source widget is created or the controller-listener relation to which you want to add the drill-down URL is set.
  • All the widget-level and page-level filters are mapped.
  • All the chart properties are set.

About this task

A static URL renders a permanent web page whereas a dynamic URL renders a web page based on the query or search strings that are present in the URL. You can add multiple search string values to a URL. Search string values are the source widget or listener widget values that you map in the URL.
The following are the different search string values that you can map in a dynamic URL:
  • Column names that are mapped in the chart properties of the source widget.
  • Page-level and widget-level filters.

To view the valid search string values that you can use in a drill-down URL, enter an open curly bracket in the URL. A pop-up list with the valid search string values is displayed.

If you are adding a drill-down URL to an existing controller-listener relation, then you can map the search string values either from the listener widget or from both controller and listener widget. To view the valid search string values, enter an open curly bracket in the URL. The pop-up list displays the search string values of the listener widget only. You need to manually enter search string values of the controller widget.

The following dynamic URL is an example of a drill-down URL that is defined for a Monitoring source widget:

https://www.example.com/search?q={System Load} and {Timestamp} and {Aggregation} and {Datetime} and {Interval} and {Summarization}

Where,
  • {System Load} is the Y-axis value and {Timestamp} is the X-axis value of the source widget.
  • {Aggregation}, {Datetime}, {Interval}, and {Summarization} are the filters that are attached to the widget.
Note:
  • You must define dynamic URL query or search string values based on the web page that you want to view.
  • Sankey, Sunburst, Circos, Tag Cloud, Bullet, Quadrant Motion, and Treemap charts do not support drill-down URL relation.
  • You can add a drill-down URL only to the leaf node of a self drill-down widget.

Procedure

Complete the following steps to set a drill-down URL relation:

  1. In the navigation pane of Dashboard Designer, click Dashboards.

    Open a dashboard where you want to set drill-down relation. You can open a dashboard, either from the Most Recently Created Dashboard list, or from Manage Dashboards list.

  2. Click the Set RelationSet Relation icon.

    The Set Relation window opens. The window displays a Widgets/Data Sets tab and a Dashboard tab. The Widgets/Data Sets tab shows all the widgets that are available in the current dashboard. Individual widgets with a multi-chart widget and transformation widgets are also displayed in the Widgets/Data Sets tab.

    The Dashboard tab lists all the dashboards that are available in the user group.

  3. From the Widgets/Data Sets tab, either select a widget or locate it by entering its name in the Search field. Drag the widget to the widget area to set it as a source widget.
    Note: If you are adding a drill-down URL to a listener widget, then you must first set the mapping in the controller-listener relation, and then add the drill-down URL.
  4. Right-click the source widget and click Add a Drilldown URL to add a target web page.
  5. In the Drilldown URL field, enter either a dynamic or static web page URL.
    For dynamic URL, enter a curly bracket to view a list of search strings.
    Note: The auto populated search string list displays values of the immediate source widget. However, if you want to specify search string values of a controller widget instead of a listener widget, then you must enter those values manually in the URL.

    Example of a static URL format:

    https://www.example.com/pages/page.html

    Example of a dynamic URL format:

    https://www.example.com/search?q={SearchStr1}%20and%20{SearchStrN}

    Or

    https://www.example.com/search?q={SearchStr1}and{SearchStrN}

    Where,
    • https is the communication protocol. The other standard supported protocols are http, file, sftp, ssl, jdbc, and so on.
      Note: You must add a protocol in the URL. If you do not enter any protocol, then the web page is not displayed and the web address displays the Engine URL appended to your URL entry.
    • www.example.com is the hostname.
    • /pages/page.html is the static path to the web page.
    • ?q={SearchStr1}%20and%20{SearchStrN} is the search string in the dynamic path to the web page. You can add multiple search strings.
  6. Optional: If you want to add drill-down relation for another source widget, then right-click the source widget, and click Add Another Relation.

    You can specify a source widget and a target web page URL as mentioned in the earlier steps. Similarly, you can set drill-down URL relation for one or more widgets within a dashboard.

  7. Optional: You can complete any of the following steps to modify or delete the relations:
    • To delete an existing drill-down URL relation, right-click the target web page URL, and click Delete.
    • To modify or replace an existing web page URL, click the Drilldown URL field, and edit the URL.
  8. Click Save to save the relation.