Specifying Parameters in Dashlets

You can add parameters to Dashlet names, text Dashlets, web page Dashlets, and hyperlinks in Chart Dashlets.

When you add a parameter, you must map a filter in the Dashboard to the parameter.

 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:
 

• In a text dashlet, enter the parameter in the Text box: Product Family: $P{Product Family}
  
  

• In a web page dashlet or a web link in a chart dashlet hyperlink, enter the parameter in the Web Page Address (URL) text box: http://en.wikipedia.org/wiki/$P\{Customer Country}
  
  

• Dashlet name: Enter the parameter in the Dashlet Name box: E.g. Unit Sales for $P{Product Family}
  
  

For repository hyperlinks in a chart dashlet, use the syntax "?filter_in_target=$P{dashlet_param}."
repo:/public/Samples/Reports/05._Unit_Sales_Trend?c_country_1=$P{Store Country} 

To find the correct name for a filter in a target resource, open the Dashboard Designer in a new window, and add the resource to the canvas. Then expand the resource's folder in the Filters panel and hover over the filter whose name you want to see. 

Parameters in Multi-Valued Input Controls

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

• For text dashlets, web links, and dashboard names, use the syntax "$P{parameter_name ? "separator"}." The following example in a text box displays results like "Product Family: Drink + Food": Product Family: $P{Product Family ? " + "}  

   

• For repository links in a chart dashlet, use the "syntax ?$P{"filter_in_target=", dashlet_param, ? "&"}."For example, the following link allows multi-select with the "c_country_1 input control": repo:/public/Samples/Reports/05._Unit_Sales_Trend?$P{"c_country_1=", Store Country, "&"}

Parameters in the Parameter Mapping Window

After you have created a parameter, create a mapping for it by completing the following steps:
 

1. In the Dashboard Designer, click the Parameter Mapping icon to open the Parameter Mapping window.
   
   

2. In the Filter row where you want to add the new filter, click the Add button . A row containing new Affected Dashlet and Filter/Parameter dropdown menus appears.
   
   

3. Using these new line-items, select the dashlet where you added a parameter, then select the parameter.
   
   

4. Click the OK button to apply and save, or the Cancel button to discard your changes.
   
   

Mapping parameters in chart hyperlinks:

To have Zoola™™ create a parameter mapping automatically, complete the following steps:
 

1. In the Dashlet Properties dialog box for your chart, use one of the names in the Available parameters list as the name of your parameter.  

    

2. Click the OK button to close the dialog box and create the mapping.
   
   

To create a mapping in the Parameter Mapping window:
 

1. In the Dashlet Properties dialog box for your chart, click Create Links in Parameter Mapping to open the Parameter Mapping window.
   
   

2. In the Filter row where you want to add the new filter, click the Add button . A row containing new Affected Dashlet and Filter/Parameter dropdown menus appears.
   
   

3. Using these new line-items, select the dashlet where you added a parameter, then select the parameter.
   
   

4. Click the OK button to apply and save, or the Cancel button to discard your changes.