The primary purpose of any information system must be to support operational use of the information it collects. That’s why IMSMA<sup>NG</sup> {{IMSMANG}} was designed with a robust reporting and analysis component that supports various reporting options. These options include:
<center>
{| class="wikitable" width="800"
|-
| align="center" colspan="5" | '''Comparison of IMSMA<sup>NG</sup> {{IMSMANG}} Reporting Options'''
|-
| width="20pt" |
|-
| align="left" | '''Uses'''
| align="left" | Navigating data in IMSMA<sup>NG</sup{{IMSMANG}}>
General summaries of pre-provided data
| align="left" |
*Pivot tables and charts based on one item
| align="left" |
*Linking or exporting IMSMA<sup>NG</sup> {{IMSMANG}} data for use in external tools*Building customised reporting tools for IMSMA<sup>NG</sup> {{IMSMANG}} data
*Linking data to ArcGIS Desktop, Crystal Reports and other tools
|-
*Supports charts
| align="left" |
*Easiest way to get IMSMA<sup>NG</sup> {{IMSMANG}} data into Excel
*Can manipulate data in common applications
| align="left" |
==Basic Reporting==__NOEDITSECTION__
IMSMA<sup>NG</sup> {{IMSMANG}} provides several reporting options that allow users to produce basic reports directly from IMSMA<sup>NG</sup>{{IMSMANG}}. These include printing data entry forms entered into the system, maps from the main navigation window and item summaries. Any of these reports can be sent directly to a printer or to an intermediate format such as rich text format (.RTF) or portable document format (.PDF) for transmitting in electronic format or for further editing.
IMSMA<sup>NG</sup> {{IMSMANG}} also includes a Map Layout manager that allows users to define map layouts and print high-quality maps with IMSMA<sup>NG</sup> {{IMSMANG}} data. Information managers can define map layout templates that include scale bars, annotations and legends or use more sophisticated tools like ArcGIS Desktop to prepare more complicated map layouts for displaying IMSMA<sup>NG</sup> {{IMSMANG}} data.
[[Image:AdminGuide_ExampleMapLayoutTemplate.png|center|500px|''Example of a Map Layout Template'']]
{{note|
* Map layouts can be printed and scaled to any size paper. This is a simple way of producing IMSMA<sup>NG</sup> {{IMSMANG}} maps without needing additional GIS software.* Map layout templates can be prepared and distributed to individual IMSMA<sup>NG</sup> {{IMSMANG}} clients, allowing information managers to prepare templates based on user preference or functional need.
}}
==Embedded Reporting==__NOEDITSECTION__
IMSMA<sup>NG</sup> {{IMSMANG}} supplements the basic reporting options available to all users with several more sophisticated reporting tools that are embedded within the system. In addition to reporting on individual elements, these embedded tools allow for statistical and aggregate reporting of data within the database. Instead of reporting the contents of a single report, statistical reporting allows information managers to produce reports about multiple items and to use functions such as sum, average and count to summarize summarise data.
There are two options for embedded reporting: iReports and data export. Both functions rely on IMSMA<sup>NG</sup> {{IMSMANG}} searches to filter data. Using iReports, information managers can build reporting templates to visualize visualise data in a specific and repeatable format. Using data export, managers can export search results to an external tool such as Microsoft Excel and perform aggregation and statistical analysis.
===iReports===__NOEDITSECTION__
With the iReport tool, information managers have access to an entire suite of report generation functions. iReport provides the ability to design report templates from the desired data elements; add page layout and formatting information including images, colours and text; and import the reports into IMSMA<sup>NG</sup> {{IMSMANG}} for data entry personnel to run. Information managers can also design complex reports to summarize summarise data using sum, count, average, subreports and other statistical reporting functions similar to packages such as Crystal Reports. Being fully integrated into IMSMA<sup>NG</sup>{{IMSMANG}}, iReport can be translated into any language supported by the system. Using this approach, only information managers are presented with the complexity of designing reports while traditional users simply have to select a report (and any preceding search) and run it.
Typical uses for iReport include producing reports commonly required by multiple users within a programme. These reports can include:
</div>
In the first example, no search parameter is applied and all data in IMSMA<sup>NG</sup> {{IMSMANG}} is used in the report. But by adding a search parameter, for example, limiting this to land whose status is Open, a different report is generated.
[[Image:AdminGuide_ReportUsingSearchParameters.png|center|500px|''Report Example Using a Search Parameter'']]
Moreover, if the land are further limited to minefields (excluding UXO and battle areas), another report is generated, all using the same template. In this way, information managers can build templates and searches to fulfil multiple reporting needs.
Reports created with iReport can be printed directly within IMSMA<sup>NG</sup> {{IMSMANG}} or saved to an intermediate format such as .RTF, .PDF or .XLS for electronic transmission or additional editing or inclusion in other reports. iReport supports the inclusion of charts, images and headers and footers, and it acts as a complete reporting package similar to Crystal Reports.
{{HowTo's
}}
===Data Export===__NOEDITSECTION__
IMSMA<sup>NG</sup> {{IMSMANG}} also provides data export functionality designed to allow users to export data to external tools such as Microsoft Excel for additional reporting and analysis. This lets users take advantage of functionality in these tools such as sums, counts, charts, pivot tables and other data manipulation functions to format and present data. Users access this functionality by performing a search in IMSMA<sup>NG</sup> {{IMSMANG}} and then exporting the results to .CSV format. Users can choose which columns to export, and the data can be manipulated in any external tool that supports .CSV.
Because data export is initiated with a search, it provides a flexible approach for getting data to an external tool. However, once the data is used in a tool outside of IMSMA<sup>NG</sup>{{IMSMANG}}, it is impossible to control how this data is manipulated which may limit the consistency of reports produced in this way.
{{note|IMSMA<sup>NG</sup> {{IMSMANG}} searches return information on only one item at a time, and data export is limited to the data returned by the search. Data from linked items (such as victim data linked to accidents) is not available for export}}
{{HowTo's
==External Reporting Tools==__NOEDITSECTION__
IMSMA<sup>NG</sup> {{IMSMANG}} also allows information managers to connect advanced reporting tools such as Crystal Reports or ArcGIS Desktop directly to its relational database for highly advanced report generation. With this capability, information managers can use custom reporting solutions to connect with IMSMA<sup>NG</sup>{{IMSMANG}}, allowing for complete control of IMSMA<sup>NG</sup> {{IMSMANG}} outputs. Or, managers can modify existing reporting solutions to connect to IMSMA<sup>NG</sup>{{IMSMANG}}, which leverages technology already implemented in the programme and limits the need for retraining.
{{note|Using external reporting tools is a complex activity requiring an advanced understanding of SQL, reporting tools and the IMSMA<sup>NG</sup> {{IMSMANG}} data model}}
The process for connecting external reporting tools is essentially the same for all tools. External tools connect to the IMSMA<sup>NG</sup> {{IMSMANG}} relational database via an ODBC connection. Information managers establish this connection by installing the ODBC driver for MySQL. When this is complete, information managers can connect any ODBC-compliant tool to the IMSMA<sup>NG</sup> IM{{IMSMANG}} database, including reporting tools, other database packages and SQL management tools. Examples include:
Reporting tools and
*Heidi SQL
When connecting an external reporting tool to IMSMA<sup>NG</sup>{{IMSMANG}}, it is recommended that information managers build database views within the database to do any necessary data transformations. While it is possible to directly import or connect IMSMA<sup>NG</sup> {{IMSMANG}} database tables in external tools and perform transformations within the external tools, the recommended method is to do transformations within the IMSMA<sup>NG</sup> IMS{{IMSMANG}} database using database views and then import the resulting views into the external tools.
{{note|Building database views to transform data before importing it into other tools significantly reduces the performance hit associated with connecting external tools}}
===Building Database Views===__NOEDITSECTION__
Building database views is the primary way of transforming data to support external reporting. Information managers can use SQL editing tools to build and save database queries as views that can be used to format data for easier reporting. Using database views, information managers can join data together into flat tables that allow for easier incorporation into reports or other analysis tools. Database views act like database tables and can be imported or queried from external tools. Moreover, views automatically refresh as data is added to IMSMA<sup>NG</sup> {{IMSMANG}} and provide an up-to-date data source for other applications.
Using database views, information managers can perform statistical and other operations on the IMSMA<sup>NG</sup> {{IMSMANG}} set for reporting purposes including sum, count and average or more complicated functions available in SQL. These operations can be combined with search criteria to provide a highly precise mechanism for providing data to reports. For example, information managers can create a view that returns the name of each clearance and a sum of the hours worked, AP mines found and area cleared on all progress reports linked to each clearance.
CL-2345 1,920 4 20 1
</center>
This view could then be pasted into Excel, linked with additional IMSMA<sup>NG</sup> {{IMSMANG}} data or external data or linked with a map to provide additional analysis. As such, database views provide a powerful way of formatting and analysing IMSMA<sup>NG</sup> {{IMSMANG}} data.
{{note|
* Database views created in IMSMA<sup>NG</sup> {{IMSMANG}} are backed up by the IMSMA<sup>NG</sup> {{IMSMANG}} backup functionality. However, it is important to correctly set the database permissions on views or it will cause problems when restoring the databases.
* Information managers should maintain separate files containing the view creation scripts so that they can be quickly and easily restored or modified. Using the CREATE OR UPDATE VIEW syntax from SQL is an easy way to build scripts for creating or updating views if they already exist.