Difference between revisions of "Modify an iReport Template"

From IMSMA Wiki
Jump to: navigation, search
(Overview)
(Adding a Field to an iReport Template)
Line 14: Line 14:
 
==Fields, Variables, and Parameters==
 
==Fields, Variables, and Parameters==
 
===Adding a Field to an iReport Template===
 
===Adding a Field to an iReport Template===
<p>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.</p>
+
<p>If you need to include a field that was not selected while using the Report Wizard, there are several options for including additional fields. The definition of a field  
<p>To add a field to your report:</p>
+
 
<ol>
+
Option 1: Using the Report Query dialogue, you can select the option to Get Fields from Datasource Provider, which will automatically add all fields from the selected datasource to the report template. You can then remove any unwanted fields from the report {{warning | Make sure that the datasource selected in iReports corresponds to the data source for the report}}  To add fields from the Report Query dialogue:
<li>From the '''View''' menu, select the '''Fields''' option.</li>
+
# Choose the Report Query button
:A window displays three tabs (Fields, Variables, and Parameters).
+
# something
<li>From the Fields tab, click the '''New''' button.</li>
+
#something else.
:The Add/modify field window displays.
+
 
<li>In the '''Field Name''' field, enter the name of the field that you would like to include.</li>
+
Option 2: Alternatively, you can create a new report template using the Wizard and add the desired fields to the new report. Fields can then be copied and pasted from the new report to the original report.
<li>Click the '''OK''' button.</li>
+
# Create a new report using the iReport Wizard and the same data source
:The field is included on the Fields tab.
+
# Select the desired fields and finish the report
<li>Close the window that displays the Fields, Variables, and Parameters tabs.</li>
+
# Using the Report Inspector, navigate to the desired fields
<li>Reposition the fields on your report as needed to accommodate the new field.</li>
+
#Right click on the field and select copy.
<li>Click the [[Image:iRepF.png]] icon.</li>
+
# Navigate to the original report with the missing fields
<li>Click the detail section of the report.</li>
+
# Right-click on the fields tree in Report Inspector and choose paste.
<li>While holding down the mouse button, drag the cursor to form the rectangle which will contain the new field.</li>
+
 
<li>Release the mouse button.</li>
+
Option 3: Manually add the field to the report.
:A placeholder for the field is displayed in the design section of the report.  
+
Fields can be added to the iReport template by:
<li>Double-click the placeholder that was added for the field.</li>
+
# Right click on the Report Inspector
<li>Change the placeholder text so that the field that you added is between the brackets.</li>
+
# Choose "Add Field"
</ol>
+
# In the Properties pane, enter the name of a field that exists on that datasource. '''Note: Fields are case sensitive.''' Make sure to select the correct data-type for the data source.
  
 
===Adding a Parameter to an iReport Template===
 
===Adding a Parameter to an iReport Template===

Revision as of 03:00, 17 September 2013

Overview

Once an iReport template has been created, there are many options for modifying the report template including adding new fields, creating variables, filtering the query results and many other options. This section covers the main customizations performed on iReport templates for use in IMSMANG

Fields, Variables, and Parameters

Adding a Field to an iReport Template

If you need to include a field that was not selected while using the Report Wizard, there are several options for including additional fields. The definition of a field Option 1: Using the Report Query dialogue, you can select the option to Get Fields from Datasource Provider, which will automatically add all fields from the selected datasource to the report template. You can then remove any unwanted fields from the report

Warning.jpg Make sure that the datasource selected in iReports corresponds to the data source for the report
To add fields from the Report Query dialogue:
  1. Choose the Report Query button
  2. something
  3. something else.

Option 2: Alternatively, you can create a new report template using the Wizard and add the desired fields to the new report. Fields can then be copied and pasted from the new report to the original report.

  1. Create a new report using the iReport Wizard and the same data source
  2. Select the desired fields and finish the report
  3. Using the Report Inspector, navigate to the desired fields
  4. Right click on the field and select copy.
  5. Navigate to the original report with the missing fields
  6. Right-click on the fields tree in Report Inspector and choose paste.

Option 3: Manually add the field to the report. Fields can be added to the iReport template by:

  1. Right click on the Report Inspector
  2. Choose "Add Field"
  3. In the Properties pane, enter the name of a field that exists on that datasource. Note: Fields are case sensitive. Make sure to select the correct data-type for the data source.

Adding a Parameter to an iReport Template

Adding a parameter to an iReport Template.

  1. Right click -> Create Parameter
  2. Add a name, leave type as string

Adding a Variable to an iReport Template

Two ways to do it.

  1. Add a variable manually
  2. Drag to Summary Band

Adding a variable manually:

  1. Right click -> Add Variable

Report Query Filtering

Filtering results/Query Limitation

the SQL Field

Editing the SQL Field

Sorting and Grouping

Grouping

<p>Grouping allows you to organise the report results using the values of a particular field. Grouping results makes it easier to identify the records which share a common value. Rather than having to visually scan the report results to determine which records have a common value, grouping automatically organises the results for you.

To illustrate, suppose you wanted to create a report to list all land within each location ID. An ungrouped report would simply list all land along with their location ID. Although the location ID is included in the report, it would be difficult, tedious, and time-consuming to scan the entire report to identify those land that have a common location ID.

Figure 7. Land report with no grouping

Figure 7. Land report with no grouping

Grouping report results automatically organises the records using the values on the specified field. Using the example above, the land in the report shown in Figure 8 are organised within the location to which they are associated. Records that do not contain a value for the selected grouping are put into their own group.

 Land grouped by location

Land grouped by location

Adding a Group to an iReport Template

Note.jpg 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.
  4. The Add/modify group window displays.
  5. 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.
  6. Click the File:IRepExpress.png icon.
  7. The Expression editor window displays.
  8. Ensure that the Objects and expressions tab is selected.
  9. Click Fields.
  10. Double-click the name of the field on which you would like to add a grouping.
  11. The Expression editor window shows $F{FieldName} where FieldName is the name of the field that you selected previously.
  12. Click the Apply button.
  13. The Add/modify group window displays the expression in the Group Expression field.
  14. Click the OK button.
  15. The Add/modify group window closes.
Note.jpg 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}.

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:

  1. Create the report.
  2. From the Data menu, select the Report Query option.
  3. The Report query window displays.
  4. Click the Sort options button that is located at the bottom of the Report query window.
  5. The Sorting Options window displays.
  6. Click the Add Field button.
  7. The Sort Field window displays. The Sort by list displays all the fields that you have selected for the report.
  8. From the Sort by list, select the field by which you would like to sort the report results.
Note.jpg When sorting data in reports that contain groups, ensure the “Group by” fields appear first in the sort order.
  1. From the Sort Type list, select either the Ascending or Descending sort order.
  2. Click the OK button.
  3. The selected field displays in the Sorting Options window.
  4. Repeat steps 4-7 for each field on which you would like to sort the results.
  5. After you have completed adding the fields on which you would like to sort the results, click the Close button.
  6. The Sorting Options window closes.
  7. From the Report query window, click the OK button.
  8. The Report query window closes.

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

Working with Images=

Adding an Image to an iReport Template

????