Architecture of Reporting Function
From Geoikia-english
Contents |
Introduction
A report consists of several files. This sets the type of files which together result in a report.
N.B. A GIS manager does not have to adjust the below mentioned files. In general the developer (IDgis) makes the first draft of the report layout. This can be adjusted by an application administrator using the graphical tool iReport.
File format
The files are delivered in a .jrxml iReport format. This is complied as a Jasper report. The next step is to compile these reports. This can also be done in iReport through the menu bar, select Build – Compile.
The result is a .jasper file. This is the file that will be eventually used in the web application
Structure: Main report versus sub-reports
One main report is available in which a title, introduction and logos are displayed. There is also a Feature Type a sub-report, so that each Feature Type can have its own lay-out. This is desirable because each Feature Type logically has different fields/columns and therefore should be its own format.
Initially there is a delivery of a report consisting of the following files:
- Main Report "rapportage.jrxml" and "rapportage.jasper"
- Aid Report "rapportageMetadataISO19139.jrxml" and "rapportageMetadataISO19139.jasper"
- Resource file "rapportage.properties" (and with suffixes in other languages)
- Images: Any images
- Subreports: Subreports per feature type (.Jrmxl and .Jasper file).
- Convention: A subreport should have a filename equal to the name of the feature type with the extension ".Jasper"
- Metadata: Descriptions of Feature Types. Displays iso19139-designed files, generated on the basis of for instance a shape file.
- Convention: A "metadata file" should have a filename equal to the name of the feature type with the suffix/extension ".iso.xml"
- index.xml: This file tells the webapp which reports are active. Here the mapping between a report, configured in the Geoide Author, and an implementation of this report by JasperReports is established.
Schematic representation
The report configuration in the Geoide Author forms together with the <rapportnaam>.jsp file, the configuration for a report in Geoide . In itself, the report configuration in the Geoide Author is still entirely separate from a report instance with Jasper Reports deployment. In principle, you can choose also for another type of report configuration.
In the Geoide Author, a Url is configured to <rapportnaam>.jsp. The <rapportnaam>.jsp provides the further specific configuration for a report. For instance in the <rapportnaam>.jsp, the mapping to a specific implementation of a report is displayed and the default title and subtitle. The value of the report parameter called "report" refers to a report in the index.xml. Index.xml contains the Jasper reports.
Configuration in the Geoide Author
The place where the URL should be configured in the Geoide Author is: Tab Contexts & Maps → Contexts → Maps → Reports.
> Main Page > Configuring the Geoide Viewer with the Geoide Author > Reporting Function > Architecture of Reporting Function
