dhis2-devs team mailing list archive
-
dhis2-devs team
-
Mailing list archive
-
Message #11327
[Branch ~dhis2-documenters/dhis2/dhis2-docbook-docs] Rev 284: More changes in the Setting up report functionality section
------------------------------------------------------------
revno: 284
committer: Bjørnar Valbø <heia@xxxxxxxx>
branch nick: dhis2-docbook-docs
timestamp: Tue 2011-03-29 15:28:45 +0200
message:
More changes in the Setting up report functionality section
modified:
src/docbkx/en/dhis2_user_man_creating_reporting.xml
src/docbkx/en/resources/images/dhis2_creating_reporting/ireport/33_editchart_2.jpg
--
lp:~dhis2-documenters/dhis2/dhis2-docbook-docs
https://code.launchpad.net/~dhis2-documenters/dhis2/dhis2-docbook-docs
Your team DHIS 2 developers is subscribed to branch lp:~dhis2-documenters/dhis2/dhis2-docbook-docs.
To unsubscribe from this branch go to https://code.launchpad.net/~dhis2-documenters/dhis2/dhis2-docbook-docs/+edit-subscription
=== modified file 'src/docbkx/en/dhis2_user_man_creating_reporting.xml'
--- src/docbkx/en/dhis2_user_man_creating_reporting.xml 2011-03-25 13:41:51 +0000
+++ src/docbkx/en/dhis2_user_man_creating_reporting.xml 2011-03-29 13:28:45 +0000
@@ -441,11 +441,9 @@
</imageobject>
</mediaobject>
</screenshot>
- <para>
-The iReport document is divided into seven main bands, divided by layout separators (the blue lines). These lines are used to decide how big each of the areas should be on the report.
+ <para>The iReport document is divided into seven main bands, divided by layout separators (the blue lines). These lines are used to decide how big each of the areas should be on the report.
</para>
- <para>
-The areas all have different purposes:
+ <para>The areas all have different purposes:
</para>
<itemizedlist>
<listitem>
@@ -540,146 +538,63 @@
</emphasis>
</para>
</section>
- <section>
- <title>Adding Charts</title>
- <para>
-It is possible to add charts to reports. In the example below, we will make a chart comparing the ANC Coverage among organisation units. We start by dragging a "Chart" element from the "Palette" onto the report.
-</para>
- <screenshot>
- <screeninfo>Drag a Chart element to the report</screeninfo>
- <mediaobject>
- <imageobject>
- <imagedata width="50%" fileref="resources/images/dhis2_creating_reporting/ireport/29_addchart_1.jpg" format="JPEG"/>
- </imageobject>
- </mediaobject>
- </screenshot>
- <para>
-A new window appears where we can choose chart type. In this example, we use a regular bar chart. Click "OK", and then "Finish" on the next screen.
-</para>
- <screenshot>
- <screeninfo>Select a chart type</screeninfo>
- <mediaobject>
- <imageobject>
- <imagedata width="50%" fileref="resources/images/dhis2_creating_reporting/ireport/30_addchart_2.jpg" format="JPEG"/>
- </imageobject>
- </mediaobject>
- </screenshot>
- <para>
-We have now added the chart and can place it at the desired position on the screen. However, we have not yet added any data. To do this, we start by right clicking on the chart and selecting "Chart Data"
-</para>
- <screenshot>
+ <section><title>Charts</title><para>The auto-generated report comes shipped with a chart within. This can however be edited. To do that, right-click on the chart and select "Chart Data".</para><screenshot>
<screeninfo>Select Chart Data by right clicking on the chart</screeninfo>
<mediaobject>
<imageobject>
<imagedata width="50%" fileref="resources/images/dhis2_creating_reporting/ireport/32_editchart_1.jpg" format="JPEG"/>
</imageobject>
</mediaobject>
- </screenshot>
- <para>
-Choose the "Details" tab, then click "Add".
-</para>
- <screenshot>
+ </screenshot><para>Go to the "Details" tab to see what is actually shown in the chart.
+</para><screenshot>
<screeninfo>Go the Details and Add a Category series</screeninfo>
<mediaobject>
<imageobject>
<imagedata width="50%" fileref="resources/images/dhis2_creating_reporting/ireport/33_editchart_2.jpg" format="JPEG"/>
</imageobject>
</mediaobject>
- </screenshot>
- <para>
-A new window will appear, where we can add the actual data series. There are four fields that we can fill out, where the three first are mandatory.
-</para>
- <screenshot>
+ </screenshot><para>If you select a series and then click the "Modify" button, a new window will appear. There are four fields that we can fill out, where the three first are mandatory and are already automatically filled.
+</para><screenshot>
<screeninfo>The Category series window</screeninfo>
<mediaobject>
<imageobject>
<imagedata width="50%" fileref="resources/images/dhis2_creating_reporting/ireport/34_editchart_3.jpg" format="JPEG"/>
</imageobject>
</mediaobject>
- </screenshot>
- <para>
-In our example, we want to create a bar chart with organisation units along the category/x-axis, and the ANC coverage indicator value along the value/y-axis. The "Series Expression" is not relevant for this, so we only put in an empty quote. To add the organisation units to the "Category expression", we click the edit-button.
-</para>
- <screenshot>
+ </screenshot>You can edit each field by pressing the edit button on the right:<screenshot>
<screeninfo>Edit the category expression</screeninfo>
<mediaobject>
<imageobject>
<imagedata width="66%" fileref="resources/images/dhis2_creating_reporting/ireport/35_editchart_4.jpg" format="JPEG"/>
</imageobject>
</mediaobject>
- </screenshot>
- <para>
-A new window appears with the available fields. We double click on "organisationunitname", which will automatically create the desired expression. Then click "Apply".
-</para>
- <screenshot>
+ </screenshot><para>A new window appears with the available fields. A list of available fields to put in the chart will show. If you double-click one of the items, it will be added to the Expression editor.
+</para><screenshot>
<screeninfo>Double click on the desired field</screeninfo>
<mediaobject>
<imageobject>
<imagedata width="66%" fileref="resources/images/dhis2_creating_reporting/ireport/36_editchart_5.jpg" format="JPEG"/>
</imageobject>
</mediaobject>
- </screenshot>
- <para>
-We do the same for "Value expression", this time clicking on "anc_coverage_reporting_month" instead.
-</para>
- <screenshot>
- <screeninfo>Double click on the desired field</screeninfo>
- <mediaobject>
- <imageobject>
- <imagedata width="66%" fileref="resources/images/dhis2_creating_reporting/ireport/37_editchart_6.jpg" format="JPEG"/>
- </imageobject>
- </mediaobject>
- </screenshot>
- <para>
-Our table should now look like the one below, with all the required fields filled out. Click "OK" and then close the "Chart details" window.
-</para>
- <screenshot>
- <screeninfo>Close the window the the required expressions are filled</screeninfo>
- <mediaobject>
- <imageobject>
- <imagedata width="66%" fileref="resources/images/dhis2_creating_reporting/ireport/38_editchart_7.jpg" format="JPEG"/>
- </imageobject>
- </mediaobject>
- </screenshot>
- <para>
-Use "Preview" to check that the chart is displayed with the correct values.
-</para>
- <para>
+ </screenshot><para>
To make the chart more informative and better looking, we can select it by clicking on it and use the "Properties" panel on the right hand side to make adjustments. For example, you can add a title to the chart, change the font, rotate the axis labels (as shown below) and so on.
-</para>
- <screenshot>
+</para><screenshot>
<screeninfo>Edit the chart properties</screeninfo>
<mediaobject>
<imageobject>
<imagedata width="66%" fileref="resources/images/dhis2_creating_reporting/ireport/39_editchart_9.jpg" format="JPEG"/>
</imageobject>
</mediaobject>
- </screenshot>
- </section>
+ </screenshot></section>
<section>
<title>Adding the Report to DHIS 2</title>
- <para>
-To use the report we have created as a Standard Report in DHIS 2, we must first prepare the file in iReport and then upload the file to DHIS 2.
-</para>
- <para>
-The first step is to correct the expression language of the report to a format DHIS 2 understands. We do this by clicking on the report in the "Report Inspector", and then changing the "Language" property to Java.
-</para>
- <screenshot>
- <screeninfo>Set report language to Java</screeninfo>
- <mediaobject>
- <imageobject>
- <imagedata width="60%" fileref="resources/images/dhis2_creating_reporting/ireport/22_language.jpg" format="JPEG"/>
- </imageobject>
- </mediaobject>
- </screenshot>
- <para>
-Next, we must change the file format of the report from .jrxml to .xml. We do this by selecting "File -> Save As..." and simply replacing .jrxml with .xml in the file name. Then click "Save".
-</para>
- <para>
-We can now switch to DHIS 2 and import our report. Enter the Report Module in DHIS 2, and select "Standard Report". In the "Standard Report" screen, click "Add new".
-</para>
- <para>
-In the following screen, there are several actions we need to take. First, enter a name for the new "Standard Report". Second, for design, click "Choose File" and find the .xml-file we created in iReport. Then, we select the report table that we used as a basis for the report in iReport. In our case, that was the "Outpatient" table. Click add, and it should move to the "Selected report tables" area. Finally, click save.
+ <para>To use the report we have created as a Standard Report in DHIS 2, we must first prepare the file in iReport and then upload the file to DHIS 2.
+</para>
+ <para>We must change the file format of the report from .jrxml to .xml. We do this by selecting "File -> Save As..." and simply replacing .jrxml with .xml in the file name. Then click "Save".
+</para>
+ <para>We can now switch to DHIS 2 and import our report. Go to the Report Module in DHIS 2, and select "Standard Report". In the "Standard Report" screen, click "Add new", or edit an existing one.
+</para>
+ <para>In the following screen, there are several actions we need to take. First, enter a name for the new "Standard Report". Second, for design, click "Choose File" and find the .xml-file we created in iReport. Then we select the report table that we used as a basis for the report in iReport. Click add, and it should move to the "Selected report tables" area. Finally, click save.
</para>
<screenshot>
<screeninfo>Upload the file and choose the right report table</screeninfo>
@@ -689,8 +604,7 @@
</imageobject>
</mediaobject>
</screenshot>
- <para>
-The report is now available as a "Standard Report" in DHIS 2.
+ <para>The report is now available as a "Standard Report" in DHIS 2.
</para>
<screenshot>
<screeninfo>The report is available as a Standard Report</screeninfo>
@@ -705,7 +619,7 @@
<title>Some final guidelines</title>
<itemizedlist>
<listitem>
- <para>Use the same version of IReport and DHIS 2's version of Jasper reports. See the About page in DHIS 2 for the Jasper version in use.</para>
+ <para>Use the same version of iReport and DHIS 2's version of Jasper reports. See the About page in DHIS 2 for the Jasper version in use.</para>
</listitem>
<listitem>
<para>Use report tables with cross tab dimensions as your data source for your report designs. This will make it a lot easier to design reports where you need to put specific indicators, periods, or orgunits on columns.</para>
=== modified file 'src/docbkx/en/resources/images/dhis2_creating_reporting/ireport/33_editchart_2.jpg'
Binary files src/docbkx/en/resources/images/dhis2_creating_reporting/ireport/33_editchart_2.jpg 2011-02-24 07:41:08 +0000 and src/docbkx/en/resources/images/dhis2_creating_reporting/ireport/33_editchart_2.jpg 2011-03-29 13:28:45 +0000 differ
