Changes

|[[HowTo:Start and Configure i-Report|Start and Configure i-ReportiReport]]|[[HowTo:Create a Basic i-Report iReport Template]]|Create a Basic i-Report [[Modify an iReport Template]]|[[HowTo:Create i-Report Templates with SubreportsFormat an iReport Template]]|[[Create i-Report iReport Templates with Subreports]]|[[HowTo:Summarize i-Report Template Data|Summarize i-Report iReport Template Data]]

==Introductionto iReport==__NOEDITSECTION__===i-Report===iReport Designer (also known as iReport) is a third-party application that allows you to generate custom-defined reports on IMSMA data. Using iReport, you may define the attributes that are returned by a report and also customise the appearance of the report.===How To Use This Manual===This guide provides information for using Report templates designed in iReport with IMSMAcan be imported into {{IMSMANG}} and run by {{IMSMANG}} users to extract data based on search criteria. It provides the steps for configuring Reports can be exported to PDF, RTF, XLS, and using other formats. iReport to report on IMSMA dataDesigner version 5.0. It 1 is not intended to serve as a complete guide for using included with the {{IMSMANG}} distribution. Using iReportDesigner, users create . For detailed information on using jrxml iReporttemplates, a kind of xml report definition, refer that can be used by {{IMSMANG}} to the iReport help or documentation[[Producing Reports Using IMSMANG|produce a formatted report]].

===Conventions===<u>Table 1</u> lists the conventions used in the manual.<center>{| class="wikitable" width="500"|-| align="center" colspan="2" | '''Table 1. Conventions'''|-| width="100pt" | '''Convention'''| align="center" width="400pt" | '''Meaning'''|-| ''Bold'' || Indicates menu, button, icon, or list names.|-| ''[Bold in brackets]'' || Indicates a keyboard key.|-| ''Italics'' || Indicates text that should be typed exactly as it is shown in the user manual into a field. Italicized text is also used to {note options that may be selected from a list.|-| [[Image:NoteiReport does not support Java 8.jpg|40px]] || Indicates a tip for using IMSMA.|-| [[Image:Warning.jpg|40px]] || Indicates steps for completing a task.|-| [[Image:MobilePen.png|40px]] || Indicates an error that you might encounter.|}</center>}

==Sample ReportsiReport Basics==__NOEDITSECTION__IMSMA includes several iReport sample reports. These reports may be used as is or used as a reference uses standard reporting terms to refer to create your reports. The sample reports are installed in the \iReports\IMSMA reports directory basic building blocks of your IMSMA installation directoryreport templates. === Article 7: Form AData Sources===__NOEDITSECTION__The ''Article 7: Form A'' report returns Data sources in iReport refer to the total area size of all reductions that are being reported on, connection between the total area size of all hazards that have been linked to the reported reductions, report template and a count of all victims that have been linked to the reported reductions{{IMSMANG}} database. If a search definition is associated with the report, the search definition name Each iReport template will be displayed have one data source. Data sources in the report titleiReport generally refer to items in {{IMSMANG}} such as Land, Activity, Education, Accident, Victim, etc. [[ImageAvailable data sources include:fig41SampleReport.png|center|500px|''Figure 41. Sample report - Article 7 form A'']]<div align="center">''Figure 41. Sample report - Article 7 form A''</div> ====Table 6===={| class="wikitable"style="margin: 1em auto 1em auto;"|+Available Data Sources

| File name Accident Device || Article 7 Form A.jrxml|-| Data source|| Hazard reduction|-| Variables MRE || Sum of hazard reduction area sizeSum of total hazard area sizeSum of victim counts|-| Derived fields || HazreducLinkedHazardAreaSize (Total Hazard Area Size)HazreducLinkedVictimCount (Victim Count)|-| Sub-reports|| None |} ===Article 7: Form C===The ''Article 7: Form C'' report returns a crosstab by district and hazard with the number of hazards by hazard type. [[Image:Article 7FormC.png|center|500px|''Figure 42. Sample report- Article 7-form C'']]<div align="center">''Figure 42. Sample report – Article 7 form C''</div> ====Table 7===={| class="wikitable"

| File nameAccident || Article 7 Form C.jrxmlMRE Detail

| Data sourceAssistance Classification || HazardNeeds Assessment Classification

| VariablesCause Classification || REPORT_COUNT (built-in iReport variable)Ordnance

| Derived fieldsField Report || NoneOrganisation

| Sub-reportsGazetteer || None|} ==Bar Chart Sample==The ''Bar Chart'' sample report returns the metal contamination level of hazards and area size. The report includes a bar chart which summarizes the total area size of hazards by their metal contamination level.  [[Image:BarChartSample.png|center|500px|''Figure 43.'' ''Sample report- Bar chart'' '']] ====Table 8===={| class="wikitable"Place

| File nameGeopoint || Bar Chart Sample.jrxmlQM

| Data sourceGeospatialinfo || HazardQuestion

| VariableHazard || Sum of area sizeCount of metal contamination levelReceived MRE

| Derived fieldsHazard Device || NoneTask

| Sub-reportsHazard Reduction || None|} ==Clearance by Year and District==The Clearance by Year and District report returns the total area cleared, hours spent, devices, and number of positive samples grouped by year and district.  [[Image:Clearance Operaitons by Year and District.png|center|500px|''Figure 44. Sample report-Clearance by year and district'']] ====Table 9===={| class="wikitable"Victim

| File NameHazard Reduction Device || Clearance by Year and District Sample.jrxmlVictim Assistance

| Data sourceImpact Survey || Hazard reductionVictim Assistance Assistance

| VariablesInterviewee || Count variables for all the derived fieldsVictim Cause

| Derived fieldsLink || One derived field for each device sub-category (i.e., Anti-Tank, Anti-Vehicle, etc.,) created by using parameterized derived field com.fgm.imsma.ext.report.OrdnanceWithSubCategoryExists, passing in the device subcategory imsma enum.Victim Needs Assessment

| Sub-reportsLocation || None|}Work Item

==MRE Audience Totals by Age==The MRE Audience Totals by Age report lists the different age categories of MRE audiences iReport datasource management and selection window can be found just below the total number of male, female, and unknown gender menu bar in each age categoryiReport Designer. [[Image:MRE audienceIReport Datasources Window.png|center|500px|''Figure 46.Datasource selection window'' ]]<div align="center">''Sample report- MRE audience totals by ageiReport Datasource Selection Window'']]</div>

===Fields=Table 11==__NOEDITSECTION__ Fields in iReport refer to individual IMSMA data elements that are available from a data source. Fields are denoted in iReport using the following syntax '''''$F{fieldname}''''' (e.g. '''''$F{guid}'''''). Each data source contains a list of available fields.===Variables===__NOEDITSECTION__ Variables in iReport are created within the iReport template to manipulate or calculate data. Using variables, users can create calculations such as sums, counts, averages, or other totals. Variables are denoted in iReport using the following syntax '''''$V{variablename}''''' (e.g. '''''$V{SumAreaSize}'''''). Variables can use field and/or parameter data.===Parameters===__NOEDITSECTION__ Parameters in iReport are used to accept and transfer external information, such as information from another report. Parameters are denoted in iReport using the following syntax '''''$P{parametername}''''' (e.g. '''''$P{ParentGuid}''''')===Bands===__NOEDITSECTION__ Bands are used in iReport to specify areas on the resulting report. Each band acts differently in a report. The most used bands in iReport are:{| class="wikitable" style="margin: 1em auto 1em auto;"

| Data sourceTitle || MRE DetailsDisplayed once at the beginning of the report

| VariablesColumn or Group Header || Sums Displayed at the top of each gender (derived fields) by group and reportSum of total audience by group and reportCount of number of events (MRE Details) by group and reportpage or section

| Derived FieldsDetail || MREDetailMaleAudience (Total Male Audience)MREDetailFemaleAudience (Total Female Audience)MREDetailUnknownAudience (Total Unknown Audience)Displayed once for each data row returned by the report. Most often data elements will exist in this band.

| Sub-reportsSummary || NoneDisplayed once at the end of the report. Useful for charts, crosstabs, and totals.

==Pie Chart Sample==The Pie Chart sample report returns the metal contamination level of hazards and area size. The report includes a pie chart which summarizes the total area size of hazards by their metal contamination level.  [[Image:Pie Chart.png|center|500px|''Figure 47.'' ''Sample report- Pie chart'']] ====Table 12==Groups=={| class="wikitable"|-__NOEDITSECTION__ | File name || Pie Chart Sample.jrxml|-| Data source || Hazard|-| Variables || Sum of area sizeCount of metal contamination level |-| Derived fields || None|-| Sub-reports|| None|} ==Accident Victim Summary Report==The Accident Victim Summary report lists accidents and the victims that Groups in iReport are linked to them. In this example, the victim data is linked used to the accident and returned via display records with one or more common values together on a sub-report. For this type of reportexample, compile Land with the sub-same value for "Province" could be grouped together in a report (Sub-reports\Summary_AccidentVictim_sub-report0.jrxml) before attempting to run Groups can be added in the main iReport Wizard or after a reporthas been created. Set the SUB-REPORT_DIR parameter to .\Sub-reports\. [[Image:Accident Victim.png|center|500px|''Figure 48.'' ''Sample report- Accident victim summary'']] ====Table 13=Subreports===__NOEDITSECTION__ {| class="wikitable"|-| File name|| Summary_AccidentVictim.jrxml|-| Data Subreports are used in iReport to include more than one data source|| AccidentQuery executor (used by victim sub-in a report)|-| Variables|| Sum of area sizeCount of metal contamination level|-| Derived fields|| None|-| Sub-reports|| Sub-reports\Summary_AccidentVictim_sub-report0.jrxml|} ==Hazard Summary Report==File: Summary_Hazard.jrxmlData source: Hazard [[Image:Hazard Summary.png|center|500px|''Figure 49.'' ''Sample For example, to include information about Activities performed on a particular Land, you would include an Activity subreport in the Land report- Hazard summary'']] ===Hazard Reduction Summary Report===File: Summary_Hazreduc.jrxmlData source: Hazard Reduction[[Image:Hazard Reduction.png|center|500px|''Figure 50.'' ''Sample report- Hazard reduction summary'']] ===Location Summary ReportCrosstabs, Charts, and Formatting Elements===__NOEDITSECTION__ File: Summary_Location.jrxmlData source: Location[[Image:Location Summary.png|center|500px|''Figure 51.'' ''Sample report- Location summary'']] ==MRE Summary Report==For this type of reportIn addition to the iReport elements addressed above, compile the sub-report (Sub-reports\Summary_Mre_sub-report1.jrxml) before attempting additional specialized iReport elements are available to run the main reportinclude in iReport templates including Crosstabs, Charts, and additional formatting elements such as lines, rectangles, etc. Set Crosstabs and chart elements typically belong only in the SUB-REPORT_DIR parameter to .\Sub-reports\.[[Image:MRE Summary.png|center|500px|''Figure 52.'' ''Sample band of a report- MRE summary'']] ====Table 15===={| class="wikitable"|-| File name|| Summary_MRE.jrxml|-| Data source|| MREQuery executor (used by while formatting elements including images can be included anywhere within the sub-report)|-| Derived fields|| None|-| Sub-reports|| Sub-reports\Summary_Mre_sub-report1template.jrxml|} ===Organisation List Report===File: Summary_Organisation.jrxmlData source: Organisation [[Image:Organisation List Report.png|center|500px|''Figure 53.'' ''Sample report- Organisation list'']]

===Place List Report===File: Summary_Place.jrxmlData source: Place[[Image:Place List Report.png{{Note |center|500px|''Figure 54.'' ''Sample reportAll field, variable, and parameter references in {{IMSMANG}} are case- Place list'']]sensitive}}

===Quality Control Summary Report===File: Summary_QA.jrxml{{NavBox HowTo Standardizing Data source: QaAnalysis and Information Reporting}}[[ImageCategory:Quality Control Summary Report.png|center|500px|''Figure 55.'' ''Sample report- Quality control summary''NAA]]