Creating a master-listener relation

Master-listener relation is a widget level interaction to display related details. You first set a source widget and then add a target widget to it.

Before you begin

Ensure that the dashboard contains all the widgets that you want to link as master and listener.
Ensure that the widgets are complete. For example, all the widget-level and page-level filters are mapped, and all the widget and chart properties are set.
Ensure that the widgets display proper data when previewed.
Ensure that the widgets that you plan to pair as master and listener widgets have a common metric value.
For widgets that contain custom data definition, ensure that the parameter name and the common metric value that you specify for the master widget are already specified in the custom data definition of the listener widget.
If you plan to use Map and Treemap charts as listener widgets, then you must use the column names that you entered in the ID and Parent fields as the common metric values. Ensure that these values are already specified in the custom data definition and in the Set Properties window.

Example of the custom data definition, SELECT * FROM <table_name> WHERE <ID_column_name> LIKE '<attribute>' OR <Parent_column_name> LIKE '<attribute>'
Where,
- <table_name> is the name of the database table.
- <ID_column_name> is the column name that you specified in the ID field in the Set Properties window.
- <Parent_column_name> is the column name that is specified in the Parent field in the Set Properties window.
- <attribute> is any attribute value to be mapped.
Map chart must either be used as a master widget or a listener widget but not as both. If you set a master-listener relation between two supported Map chart locations, then both the charts display similar map locations.

About this task

You can define master-listener relations is the following ways:

A single source widget can be connected to a single target widget.
For example, a single source widget can be connected to a single widget with an embedded website or web application.
A single source widget can be connected to multiple target widgets.
A single source widget can be connected to multiple target widgets that are in turn connected to one or more target widgets.
An all instances custom widget must always be set as a master widget only.

If a dashboard contains a multi-chart widget, then all the widgets in that multi-chart widget function as any other dashboard widgets. You can set a master-listener relation between any of the dashboard widgets, irrespective of whether they belong to a multi-chart widget or not.

Note: For setting master-listener relations that involve multiple widgets, you cannot reuse any widget.

Procedure

Complete the following steps to set a master-listener relation:

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

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

Note: The dashboard must display multiple widgets. The widgets for which you want to set master-listener relation must contain common metrics.
Click the Set Relation icon.

The Set Relation window opens. The window displays a Widgets tab and a Dashboard tab. The Widgets tab shows all the widgets that are available in the current dashboard. If the dashboard contains multi-chart widget, then those widgets are also displayed in the Widgets tab.

The Dashboard tab lists all the dashboards that are available in the user group.
From the Widgets 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 using an all instances custom widget, then you must set it as a source widget only.
Right-click the source widget and click Add a Listener Widget to add a target widget.
From the Widgets tab, select and drag a widget that you want to set as a target widget for communications.
Optional: If you want to add another master-listener relation, then right-click either the source widget or a target widget, and click Add Another Relation.

You can specify a source and target widget as mentioned in the earlier steps. Similarly, you can set master-listener relation for all the widgets within a dashboard or for a few widgets within a dashboard.
After all the master-listener relations are set, you must set parameters that must be passed from the source to the target widgets for communication. For more information, see Mapping metrics data.
Optional: You can complete any of the following steps to modify or delete the mapping or the relations:
- To delete a master-listener relation, you must first delete the mapping in its target widget. For more information, see Mapping metrics data.
- To delete an existing master-listener relation, right-click the target widget, and click Delete.
- To replace a widget in an existing master-listener relation, right-click either a source widget or a target widget, and click Delete Chart. You can then drag another chart to that widget area.
Click Save to save the relation.

What to do next

You can also add a drill-down relation to a target widget, and then map metrics data. For more information, see Creating a drill-down relation and Mapping metrics data.