Design a DHIS 2 report with Report tool and iReport - DHIS Documentation

Why do we need this page?

The report tool can make a report automatically but just follow a few templates. Sometimes you need your own report template, and this page can help you.

Preparation

Download and install DHIS 2
Download and install iReport from http://sourceforge.net/projects/ireport/

Implementation

Run DHIS 2, go to Report tool, make new report, for example: children_report
Click edit button to choose the included data elements, indicators.
Click ?Generate design? button and then ?Done? button.
Start iReport.
Open the jrxml file was generated by report tool in user-home/dhis/rt/design/jrxml. In here is children_report.jrxml
One DHIS 2 report template includes 2 things:
- Static texts: we can modify all static text in report, and move them follow our template.
- Parameters: to get the values from report tool, we can move them follow our template, but cannot change the name.
After change the report follow our template, we can save and quit iReport, next time, when we export report, we will get new template.

Notice

If the report elements (data element, indicator name or shortname) include ?<?, ?>?, ?&? characters, report tool will be crashed. The solution is:

Before modifying the report template with iReport, we open it by a text editor, copy all of parameter tab to a difference file. (It?s easy to recognize them because they begin with ?<parameter name="??).

<parameter name="DataElement:Tá»?ng sá»? tráº» SS DC" isForPrompting="false" class="java.lang.String"/>
<parameter name="DataElement:TS tráº» SS&lt; 2500gr" isForPrompting="false" class="java.lang.String"/>
<parameter name="DataElement:Suy dinh dÆ°á»¡ng Ä?á»? 2" isForPrompting="false" class="java.lang.String"/>
<parameter name="DataElement:Suy dinh dÆ°á»¡ng Ä?á»? 3" isForPrompting="false" class="java.lang.String"/>
<parameter name="DataElement:TS tráº»&lt;36t uá»?ng A" isForPrompting="false" class="java.lang.String"/>

After modifying the report template with iReport, restore the backup parameters.