Add a parameter

A parameter is a means to refine the data that is shown in a report. Parameters belong to the dashboard that contains the report, and are linked (bound) to filters in the report.

For example, you might have a report that displays evaluation scores for a specific contact center. This report shows all evaluation scores for all teams and all agents on those teams, and it is long and difficult to read. However, if you add parameters, you can narrow down what you see in the report. For example, you can choose a specific date or date range and just the agents on one team, or one agent.

Parameters can be bound to one or more reports on the dashboard. For example, a parameter that allows you to select a group might be bound to both a tabular report and a graphical report. When you select the desired group using the parameter control, both reports reflect your choice.

There are 4 things that must be completed in order to add parameters to a dashboard.

  1. Add the desired filters to the report—Your report must be configured with the filters you are going to use, and those filters must be changed to parameters. See “Add one or more report parameters” in Set a filter for more information on how to do this when creating your report.
  2. Add the report to the dashboard—Add a panel to your dashboard and configure it to contain your report. See Add a panel to learn how to add the report and what kind of panels are available to use.
  3. Add the parameter controls to the dashboard—A parameter control is a type of panel and is added to your dashboard similarly to how you add the panel that contains your report. See Parameter controls to learn about the kinds of parameter controls that are available.
  4. Bind the parameter controls to the report—Once your dashboard has the report and all the parameter controls on it, it is time to connect (or bind) the parameter controls to the report. This can be done automatically with the AutoBind feature, or manually.

Automatically bind the parameter controls to the report

The AutoBind feature discovers available report parameters in dashboard content panels, generates the necessary dashboard parameters to match, binds them together as appropriate, and then adds and binds pickers to those parameters. It lays out those pickers logically, either in a flyout parameter panel for the dashboard or into blank space on the dashboard.

  1. Click Parameters in the Dashboard Control. The Parameter Bindings dialog box opens.
  2. Click AutoBind to generate a list of recommended parameters and bindings for this dashboard. You can modify this list if necessary.

    NOTE   If you click AutoBind again, it replaces any parameter or binding modifications with the recommended parameters and bindings.

  3. Click Apply.

Manually bind the parameter controls to the report

  1. Click Parameters in the Dashboard Control. The Parameter Bindings dialog box opens.
  2. Click Add a new parameter in the lower left corner of the dialog box. A new parameter line is added.

  3. In the Parameter field, enter a name to identify the parameter.
  4. In the Type field, select the type of data the parameter is.
  5. In the Bindings drop-down field, select the name of the filter you set as a report parameter. The drop-down list shows the available filters. They are identified with the report parameter name and the report name, like this:

    ‘<report parameter name>’ on “<report name>”

  6. Click to the right of the Bindings field to add a second Bindings field below the first.
  7. In this second Bindings drop-down field, select the name of the parameter control you want to use to filter the report. The drop-down list shows the available parameter controls. They are identified with the collection displayed in the parameter control (for example, “members” or “time period”) and the parameter control name, like this:

    ‘<collection displayed in parameter control>’ on “<parameter control name>”

    NOTE   It does not matter in which order you put the selections in the binding fields. You can put the report filter name in the first field and the parameter control in the second field, or the reverse. All that matters is that they are associated with each other.

  8. Repeat steps 2 through 7 for as many parameter controls you have added to the dashboard.
  9. Click Apply.

Bind a parameter control to more than one report

  1. Add a parameter in the Parameter Bindings dialog box as in the above procedure.
  2. In the Bindings drop-down field, select the report parameter name and report name for the first report you want to bind the parameter control to.
  3. Click to the right of the Bindings field to add a second Bindings field below the first, and select the report parameter and report name for the second report you want to bind the parameter control to. Repeat this step for however many reports you want to bind the parameter control to.
  4. Click to the right of the Bindings field to add another Bindings field, and select the name of the parameter control you want to use to filter the report.

  5. Click Apply.