Using crosstab formulas
Crosstab formula is a kind of extended formula used only in page report crosstabs. By using crosstab formulas, you can create custom aggregate functions in a crosstab to get the desired results. Crosstab formulas are private resources on crosstab level. They cannot be used beyond its crosstab.
Applying custom aggregate functions in a crosstab by creating crosstab formulas
Below example shows how to apply custom aggregate function in a crosstab simply by creating a crosstab formula:
- Open the catalog file JinfonetGourmetJava.cat in
<install_root>\Demo\Reports\TutorialReports
.
- Create a crosstab report with the query WorldWideSales stored in Data Source 1 of the catalog.
- In the Display screen of the Crosstab Wizard, add Customers_Country as the row field and Customers_Region as the column field.
- Click <Add Crosstab Formula...> in the Crosstab Formulas node in the Resources box.
- In the Input Crosstab Formula Name dialog, enter CustomAggregate and click OK. The Crosstab Formula Editor is displayed. Define the formula as follows:
currency ctsv1 = @(Sum(@Price)); currency ctsv2 = @(@Customers_Country:ALL,@Customers_Region:ALL,Sum(@Price)); if(ctsv1/ctsv2 >0.005) return ToText(ctsv1) else return "N/A" |
- Save the crosstab formula and add it to the Summaries box as the aggregate field.
- Switch to the Style screen and select Neutral as the report style from the Style list.
- Click Finish to create the crosstab and preview it. The crosstab will be shown somewhat as follows. You can see that in the aggregate cell, based on the formula expression, "N/A" is displayed if the price value equals to or is less than 5‰ of the grand total price $16,337.85, while the actual price is displayed if the price is more than 5‰ of the grand total price.
Managing crosstab formulas
You can manage the crosstab formulas of a crosstab in the Resource View panel as follows:
- Creating crosstab formulas
To create a crosstab formula, click <Add Crosstab Formula...> in the Crosstab Formulas node, enter a name for the crosstab formula in the Input Crosstab Formula Name dialog and click OK, then in the Crosstab Formula Editor, compose the formula as required. You can then insert the crosstab formula as aggregate field to the crosstab or use it to control the properties of objects in the crosstab.
- Editing a crosstab formula
To edit a crosstab formula, select it from the Crosstab Formulas node, then right-click the crosstab formula and click Edit Formula on the shortcut menu. In the Crosstab Formula Editor window, edit the crosstab formula as required.
- Deleting a crosstab formula
To delete a crosstab formula, right-click the crosstab formula and select Delete from the shortcut menu.
- Renaming a crosstab formula
To rename a crosstab formula, right-click the crosstab formula and select Rename from the shortcut menu. Input a new name in the Input Crosstab Formula Name dialog and click OK to confirm the change.
- Viewing properties of a crosstab formula
To view the properties of a crosstab formula, right-click the crosstab formula and select Properties to show the Properties table.
Notes:
- Crosstab formulas can only be used as aggregate fields in a crosstab.
- Global variables are not supported in crosstab formulas.
- Crosstab formulas cannot reference detail fields and record level pass one formulas, except for referencing them in simple sum expression.
- In crosstab formulas, the Array functions cannot be used as array_function (field_variable, groupby). Here array_function refers to any Array function defined in JReport. For example, Maximum(@dbfield, "group_field") and Average(@formula, @parameter) are not allowed in crosstab formulas.