Difference between revisions of "Modify an iReport Template"

Revision as of 17:39, 16 September 2013

Adding a Group to an Existing Report

The field on which you would like to group your report results must be included in the report.

To add a group to an existing report:

1. From the View menu, select Report Groups.
2. A window displays the groups for the report.
3. Click the New button.

The Add/modify group window displays.

4. Enter an identifier for the group. This should be a meaningful name that allows you to easily identify the contents of the group such as the field on which the results are grouped.
5. Click the File:IRepExpress.png icon.

The Expression editor window displays.

6. Ensure that the Objects and expressions tab is selected.
7. Click Fields.
8. Double-click the name of the field on which you would like to add a grouping.

The Expression editor window shows $F{FieldName} where FieldName is the name of the field that you selected previously.

9. Click the Apply button.

The Add/modify group window displays the expression in the Group Expression field.

10. Click the OK button.

The Add/modify group window closes.

You may also enter the expression in the Group Expression field if you know the exact spelling of the field name on which you would like to group the results. The syntax is $F{FieldName}.

Adding Fields

If you need to include a field that was not selected while using the Report Wizard, you will need to know the name of the field that is used by the data source. Find a list of available field names by using the Report Wizard.

To add a field to your report:

1. From the View menu, select the Fields option.

A window displays three tabs (Fields, Variables, and Parameters).

2. From the Fields tab, click the New button.

The Add/modify field window displays.

3. In the Field Name field, enter the name of the field that you would like to include.
4. Click the OK button.

The field is included on the Fields tab.

5. Close the window that displays the Fields, Variables, and Parameters tabs.
6. Reposition the fields on your report as needed to accommodate the new field.
7. Click the File:IRepF.png icon.
8. Click the detail section of the report.
9. While holding down the mouse button, drag the cursor to form the rectangle which will contain the new field.
10. Release the mouse button.

A placeholder for the field is displayed in the design section of the report.

11. Double-click the placeholder that was added for the field.
12. Change the placeholder text so that the field that you added is between the brackets.

Sorting Report Results

It may be helpful to sort the report results using the value in one or more of the fields. Sorting the results makes it easier to review the results and locate any records that you may be searching for. To sort report results:

13. Create the report.
14. From the Data menu, select the Report Query option.

The Report query window displays.

15. Click the Sort options button that is located at the bottom of the Report query window.

The Sorting Options window displays.

16. Click the Add Field button.

The Sort Field window displays. The Sort by list displays all the fields that you have selected for the report.

17. From the Sort by list, select the field by which you would like to sort the report results.

When sorting data in reports that contain groups, ensure the “Group by” fields appear first in the sort order.

18. From the Sort Type list, select either the Ascending or Descending sort order.
19. Click the OK button.

The selected field displays in the Sorting Options window.

20. Repeat steps 4-7 for each field on which you would like to sort the results.
21. After you have completed adding the fields on which you would like to sort the results, click the Close button.

The Sorting Options window closes.

22. From the Report query window, click the OK button.

The Report query window closes.

You will need to compile and execute the report for the sort options to take effect.