You can add parameters to dashlet names, text dashlets, web page dashlets, image dashlets, and hyperlinks in chart dashlets. When you add a parameter, you must map a filter in the dashboard to the parameter. See Mapping parameters in Parameter Mapping for more information.

Simple parameters:

For text dashlets, web links, and dashboard names, use the syntax $P{parameter_name} to directly pass the parameter value to the web page. Examples:

Product Family: $P{Product Family}

http://en.wikipedia.org/wiki/$P{Store Country}

repo:/public/Samples/Reports/$P{Store Country}/flag.png

Unit Sales for $P{Product Family}

For repository hyperlinks in a chart dashlet, use the syntax ?filter_in_target=$P{dashlet_param}. For example, the following link sets the c_country_1 input control in the 05. Unit Sales Trend report to the value of a Store Country parameter in the dashlet.

repo:/public/Samples/Reports/05._Unit_Sales_Trend?c_country_1=$P{Store Country}

Parameters in multi-valued input controls:

For multi-valued input controls, you can define a separator for the input control values:

Product Family: $P{Product Family ? " + "}

repo:/public/Samples/Reports/05._Unit_Sales_Trend?$P{"c_country_1=", Store Country, "&"}

When Mexico and USA are selected, this expands to the following link:

repo:/public/Samples/Reports/05._Unit_Sales_Trend?c_country_1=Mexico&c_country_1=USA

Auto-complete parameters

When you type the $ symbol into a dashlet's text box, a drop-down list of available parameters is displayed. Select a parameter from the list or continue typing to narrow down the list of parameters. The auto-complete parameters feature is available for text fields, image link, and web links, but it is not available for the dashlet name field.

Mapping parameters in Parameter Mapping

After you have created a parameter, create a mapping for it as follows:

Mapping parameters in dashboard names and text, image, or web page dashlets:

1.

In the Dashboard Designer, click

2.

In the filter row where you want to add the new filter, click

Mapping parameters in chart hyperlinks:

To have JasperReports Server create a parameter mapping automatically:

To create a mapping in Parameter Mapping:

2.

In the filter row where you want to add the new filter, click

Creating a Web Page Dashlet

When working with Web Page dashlets in the Dashboard Designer, you can include a parameter reference in the dashlet's URL. The parameter references an existing filter in another dashlet, and uses that filter to display a specific web page relevant to the filtered information.

The following example takes you through the steps for creating a simple dashboard in the Dashboard Designer, adding a sample chart with geographic filters, and creating a Web Page dashlet that displays a Wikipedia page for the country the sample chart is filtered on.

First, create the simple dashboard:

The Dashboard Designer appears, displaying the list of available content and the canvas.

Next, add the filter input control to the dashboard:

The input controls associated with the 08. Key Performance Metric Trend report appear.

Now, add the Web Page dashlet with the parameter reference and add it to the filter:

The Dashlet URL window opens.

http://en.wikipedia.org/wiki/$P{Store Country}

7.

Click

8.

In the Store Country filter group, click

A row containing the new affected dashlet and filter/parameter dropdown menus appears.

Finally, preview the new dashboard functionality:

In “Dashboard with web page parameters” you can see how the dashboard preview looks at this point:

Dashboard with web page parameters

5.

Click