Follow Techotopia on Twitter

On-line Guides
All Guides
eBook Store
iOS / Android
Linux for Beginners
Office Productivity
Linux Installation
Linux Security
Linux Utilities
Linux Virtualization
Linux Kernel
System/Network Admin
Scripting Languages
Development Tools
Web Development
GUI Toolkits/Desktop
Mail Systems
Eclipse Documentation

How To Guides
General System Admin
Linux Security
Linux Filesystems
Web Servers
Graphics & Desktop
PC Hardware
Problem Solutions
Privacy Policy




Eclipse BIRT Report Developer Guide
Previous Page Home Next Page

Previous Next

How to format a report parameter value

This procedure assumes that you already created at least one report parameter in your report design.

In Data Explorer, expand Report Parameters, then choose the report parameter to edit. Edit Parameter displays the current property settings for the selected report parameter.
In Format as, choose Change. Change is not available for report parameters of Boolean type. Format Builder appears. Its contents differ, depending on the data type of the report parameter. Figure 12‑17 shows Format Builder for string data.

Figure 16-19 Format Builder for string data

Additional fields may appear, depending on the data type and format that you selected. A sample formatted value appears in Preview with format. Figure 12‑18 shows the additional fields that are available for a report parameter of decimal type when Currency format is selected.

Figure 16-20 Format Builder for Currency data

When you finish specifying the format, choose OK. Edit Parameter appears. Format shows the format that you specified.

How to create a parameter group

In Data Explorer, right-click Report Parameters, and choose New Parameter Group. New Parameter Group appears.
In Display Name, specify the name that the Enter Parameters dialog displays when it prompts a user for parameter values.
Figure 12‑19 shows an example.

Figure 16-23 Create a display name for a parameter group

Choose OK. BIRT Report Designer creates the new parameter group and displays it in Report Parameters in Data Explorer, as shown in Figure 12‑20.

Figure 16-24 New parameter group in Data Explore

Move an existing parameter to the parameter group. From the report parameters list in Data Explorer, drag an existing parameter, and drop it in the parameter group.
Create a new parameter in the parameter group. In Report Parameters, right-click the parameter group name, and choose New Parameter.
Figure 12‑21 shows Data Explorer after you move three report parameters to a parameter group called Office_Parameters.

Figure 16-25 Parameter group with three parameters

Figure 12‑22 shows the Enter Parameters dialog, which displays the new parameter group and its three report parameters.

Figure 16-26 Customer Information parameter group on Enter Parameters

Enter Parameters displays parameter groups and report parameters in the order in which they appear in the report parameters list. To display the groups or report parameters in a different order, change the order in Data Explorer.

How to create cascading parameters that use a single data set

Figure 16-29 New Cascading Single Data Set Parameter

On New Cascading Parameter, in Cascading Parameter Name, you can specify a different name. The name that you specify appears only in the list of report parameters in Data Explorer.
In Value, select the field that contains the values that you want to pass to the SQL query or filter condition at run time.
In Display Text, optionally select a field that contains the values that you want to display to the user. For example, the values to pass to the SQL query or filter condition are from the productcode field, but you want to display values from the productname field to the user.
In Properties, set the other properties for this report parameter, including the prompt text, display type, and default value.
To create the next report parameter, choose Add, and follow the same steps until you set up all levels of the cascading parameter group. Figure 12‑24 shows sample values in New Cascading Parameter.

Figure 16-29 New Cascading Single Data Set Parameter

When you finish creating all the report parameters in the group, choose OK. The cascading parameters appear in Report Parameters in Data Explorer.


(c) Copyright Actuate Corporation 2009

  Published under the terms of the Eclipse Public License Version 1.0 ("EPL") Design by Interspire