Changes

==Creating a Basic Report iReport Template Using the Wizard==__NOEDITSECTION__{{IMSMANG}} provides an There is a wizard in iReport Wizard to help in the process of creating new iReport templates. To create an iReport template using the Wizard:

<li>From In the '''File''' menu, select &rarr; '''New...'''. </li>:The iReport Wizard window displays. <li>From the '''Report Templates''' list, select Select the template you would like to use for your report. Blank A4 or an IMSMA specific template are preferrable</li>

 [[Image:iRep01{{note|At iReport startup, it can take several seconds to load the window with the templates.png|center|500px|The next time you click on '''Figure 1New. iReport Wizard – Step 1..''']]however, the templates appear instantaneously.}}

[[Image:iReport Wizard1.png|center|500px|''Figure iReport Wizard – Step 1. '']]''iReport Wizard – Step 1''

<li>Click the '''NextLaunch Report Wizard''' button.</li>:The window to select the attributes to include in the report displays.

<div align="center">[[Image:iRep02iReport Wizard2.png|center|500px|''Figure 2. iReport Wizard - Step 2'']]<div>''Figure 2. iReport Wizard - Step 2''

<li>From the Step 2. select fields screen:</li><ol type="a"><li>Select the attributes that you would like to include in desired Data Source for the report. and choose '''Error! Reference source not found.Next''' describes the available buttons.</li>

| align="center" colspan="2" | '''Table 2. iReport Wizard – Buttons for selecting fields'''

| align="center" | [[Image:iRepLA.png]] || Removes Deletes the selected field from the report.

| align="center" | [[Image:iRepDLA.png]] || Indicates a tip for using IMSMADeletes all fields from the report.

</center> {{note|If you would like to organise the report results by country structure areas, you should include the country structure level by which you would like to group the results as one of the fields. Be aware that including the country structure level field in the report will return a string that contains all country structure levels above the selected level.}} <ol start="5"><ol type="a" start="2"><li>Click the '''Next''' button.</li>:A window displays the selected fields. </ol> <li>Click the '''Next''' button.</li> The window to group the report data displays. The group by step allows you to list item records that have the same value for the selected group by field together in the report. The below figure illustrates an example of a report that groups its results by gazetteer. For more information on grouping, refer to Grouping.</oldiv>

[[Image:iRep03.png|center|500px{{note|It is recommended to always include the ''Figure 3. Group by exampleguid'']]field when designing a report}}

<li>Click the '''Next''' button.The [[Modify an iReport Template#Sorting_and_Grouping|group by]] step allows you to list item records that have the same value for the selected group by field together in the report. If you would like to group the report data, select the attribute on which you would like to group the data from the Group list.</li>

<li>Click the '''Next''' button.and then '''Finish'''</li>The Wizard is complete and the iReport template designer window to select a layout displaysis open. The iReport wizard provides two layout options. The Columnar layout option displays Depending on your selections your template will look different from the field names in one column and their corresponding report result in another columnexample below.

[[Image:iReportHome1.png|center|500px|''iReport Wizard - Final Step'']]'Figure 4. Columnar layout'iReport Wizard - Final Step''

<p>The tabular ==iReport Designer Orientation==__NOEDITSECTION__Once your initial iReport template has been created you can begin adding data elements to the template, modifying the layout option displays and formatting, and other aspects of [[Modify an iReport Template|modifying an iReport Template]]. Below is a brief orientation to the field names across panes and functions available in the top iReport Designer. If any of the pagepanes or windows are unavailable they can be added back by selecting the relevant item from the '''Window''' menu.  ===Report Inspector === __NOEDITSECTION__The corresponding Report Inspector pane displays a hierarchical structure of the iReport template and provides access to the available fields, parameters, and variables as well as all formatting elements of the report results are displayed below each field name.</p>Each node can be expanded for more details about the elements contained in it.

[[Image:iRep05.png|center|500px|''Figure 5. Tabular layout'']]<div align="center">==Report Canvas ===__NOEDITSECTION__''Figure 5The middle area of the iReport Designer displays a graphical representation of the iReport template that corresponds to the hierarchical structure in the Report Inspector. In this pane you move elements around on the canvas as well as select individual elements for editing. Tabular layout''</div>

<ol start="7"><li>From the window to select a layout:</li><ol type="a">=Properties Pane ===__NOEDITSECTION__<li>Select This pane will display all of the layout option.</li><li>Click properties of items selected in the '''Next''' buttonReport Inspector or Report Canvas.</li>:The window Properties Pane displays a message stating that you have successfully created a new report.</ol><li>Click the '''Finish''' button.</li>:The template context-senstive list of properties for your report displays. <li>Ensure that the data source any selected matches the item of the reportfor editing.</li></ol>

[[Image:iRep06.png|center|500px|''Figure 6. Report data source'']]<div align="center">==Palette===__NOEDITSECTION__''Figure 6The Palette is the area where individual graphic elements can be selected and dragged onto the canvas. This includes subreports and crosstab elements. Report data source''</div>

<ol start="11">==Formatting Tools ===__NOEDITSECTION__<li>Click the [[Image:iRepCompile.png]] button The Formatting Tools pane provides access to compile the report.</li>:The Save report window displays.<li>Enter a name for the report in the File name field.</li><li>If there are no compilation errors, click the [[Image:iRepRun.png]] button various formatting functions designed to run manage the report.</li>:The results of size and space between elements on the report display in the iReport JasperViewer window. </ol>

===GroupingiReport Output ===__NOEDITSECTION__<p>Grouping allows you to organise This pane displays any problems or output from 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.</p><p>To illustrate, suppose you wanted to create a report to list all land within each location ID. The procedures that have been discussed so far in this training module 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 IDreports.</p>

[[Image:iRep07==XML and Preview Views==__NOEDITSECTION__In addition to the Designer View, iReport Designer provides 2 additional views, the XML View and the Preview.png|center|500px|''Figure 7Using the XML View you can get an editable version of the . Land jrxml file created by iReport Designer. This is useful for troubleshooting specific problems with a report with no grouping'']]but is generally only for advanced users.

[[Image:iReportXMLView.png|center|500px|''XML View'']]''Figure 7. Land report with no groupingXML View''</div> <p>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.</p>

[[Image:iRep08The Preview view runs the current version of the iReport template and generates an output file with the results of the report. This is useful for ensuring that the report is functioning as desired prior to importing into {{IMSMANG}}. This is the primary method for running iReport templates within the iReport Designer.png|center|500px|'' Land grouped by location'']]

[[Image:IReportPreview.png|center|500px|''Preview View'']]''Land grouped by locationPreview View''</div>[[Modify an iReport Template]].

{{NavBox HowTo use iReportStandardizing Data Analysis and Information Reporting}}[[Category:VIE]]