dhis2-devs team mailing list archive
-
dhis2-devs team
-
Mailing list archive
-
Message #22204
[Branch ~dhis2-documenters/dhis2/dhis2-docbook-docs] Rev 729: Polish.
------------------------------------------------------------
revno: 729
committer: Jason P. Pickering <jason.p.pickering@xxxxxxxxx>
branch nick: dhis2-docbook-docs
timestamp: Sun 2013-04-21 21:53:35 +0545
message:
Polish.
modified:
src/docbkx/en/dhis2_user_man_getting_started.xml
src/docbkx/en/dhis2_user_man_introduction.xml
--
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_getting_started.xml'
--- src/docbkx/en/dhis2_user_man_getting_started.xml 2011-04-28 19:13:18 +0000
+++ src/docbkx/en/dhis2_user_man_getting_started.xml 2013-04-21 16:08:35 +0000
@@ -1,292 +1,292 @@
-<?xml version='1.0' encoding='UTF-8'?>
-<!-- This document was created with Syntext Serna Free. --><!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd"; []>
-<chapter>
- <title>Getting started with DHIS 2</title>
- <section id="mod2_1">
- <title>Getting started with DHIS 2</title>
- <para>After reading this chapter you will be able to understand:</para>
- <itemizedlist>
- <listitem>
- <para>Start DHIS 2 from the desktop</para>
- </listitem>
- <listitem>
- <para>How to log-in from the desktop</para>
- </listitem>
- </itemizedlist>
- <itemizedlist>
- <listitem>
- <para>Create new users and user roles</para>
- </listitem>
- </itemizedlist>
- <itemizedlist>
- <listitem>
- <para>What steps are needed to design a DHIS 2 database for your organisation</para>
- </listitem>
- </itemizedlist>
- <section>
- <title>Prerequisites</title>
- <para>You must be sure that you have a current version of the Java Runtime installed on your machine. Depending on your operating system, there are different ways of installing Java. The reader is referred to this <ulink url="http://java.sun.com/javase/downloads/index.jsp";>website</ulink> for detailed information on getting java installed.</para>
- </section>
- <section>
- <title>Starting the DHIS 2 Live package</title>
- <para>The DHIS 2 Live package is the easiest way to get started with DHIS 2. DHIS 2 Live is appropriate for a stand-alone type of installation. Simply download the application from <ulink url="http://www.dhis2.org/downloads";>here</ulink>.
- Once the file is downloaded, you can simply double-click the downloaded file, and get started using DHIS 2. </para>
- <section>
- <title>Starting up with a blank database</title>
- <para>The live package comes with a demo database just like what you see on the online demo (which is based on the national Sierra Leone HMIS), and if you want to start with a blank system/database and build up your own system then you need to do the following:
-</para>
- <para>1) Stop the DHIS 2 live if it is already running. Right click on the tray icon and select Exit.
-The tray icon is the green symbol on the bottom right of your screen (on Windows) which should say' DHIS 2 Server running' if you hold your mouse pointer over it.</para>
- <para>2) Open the folder where the DHIS 2 live package is installed and locate the folder called "conf".
-</para>
- <para>3) In conf/ open the file called 'hibernate.properties' in a text editor (notepad or similar) and do the following modification:
-locate the string 'jdbc:h2:./database/dhis2' and replace the 'dhis2' part with any name that you want to give to your database (e.g. dhis2_test).</para>
- <para>4) Save and close the hibernate.properties file.
-</para>
- <para>5) Start DHIS 2 Live by double-clicking on the file dhis2-live.exe in the DHIS 2 Live installation folder or by using a desktop shortcut or menu link that you might have set up.
-</para>
- <para>6) Wait for the browser window to open and the login screen to show, and then log in with username: admin and password: district
-</para>
- <para>7) Now you will see a completely empty DHIS 2 system and you should start by adding your users, organisational hierarchy, data elements, and datasets etc. Please refer to the other sections of the user manual for instructions on how to do this.
-</para>
- </section>
- </section>
- <section>
- <title>Working directly with the H2 database</title>
- <para>
- DHIS 2 Live uses an embedded <ulink url="www.h2database.com/">H2</ulink> database. This has several advantages - there is no need
- to install a separate database engine such as PostgresSql or MySql, and backup can be made by just copying the file. The whole db
- exists in memory, which means high performance. The disadvantage is need for RAM. It is also not suitable for mulitiuser server
- installations.
- </para>
- <para>
- In general, it is recommended to work with the database through the DHIS 2 user interface, but in some situations one may need to
- manipulate the data directly. If one downloads H2 separately, it comes with a web interface. It can also be manipulated using
- <ulink url="http://openoffice.org";>OpenOffice.org</ulink>, using the following procedure. This assumes that dhis2-live is located in
- the user's Linux home directory (represented by ~). Substitute the absolute path to your dhis2-live installation.
- <itemizedlist>
- <listitem>
- <para>Start OpenOffice Word Processor and select Tools - Options, then Java - Class Path ... and click on Add Archive...</para>
- </listitem>
- <listitem>
- <para>Select the following file (version may differ): ~/dhis2-live/webapps/dhis/WEB-INF/lib/h2-1.1.119.jar</para>
- </listitem>
- <listitem>
- <para>Close OpenOffice completely and then open OpenOffice.org Database. Select connect to an existing database - JDBC</para>
- </listitem>
- <listitem>
- <para>Datasource URL is h2:~/dhis2-live/database/dhis2;AUTO_SERVER=TRUE, and JDBC driver class is org.h2.Driver</para>
- </listitem>
- <listitem>
- <para>User name is sa, password not needed. Finally, select a name and folder for the .odb file.</para>
- </listitem>
- </itemizedlist>
- <ulink url="http://www.oooforum.org/forum/viewtopic.phtml?t=97522";>More tips</ulink>
- </para>
- </section>
- <section>
- <title>Downloading and installing the server version</title>
- <para>The server version can be downloaded from dhis2.org/download. For detailed information on how to install it please refer to the installation chapter in the implementation manual.</para>
- </section>
- </section>
- <section id="mod2_2">
- <title>Logging on to DHIS 2</title>
- <para>Regardless of whether you have installed the server version of the
- desktop Live version, you will use a web-browser to log on to the
- application. DHIS 2 should be compatible with most modern web-browsers,
- although you will need to ensure that Java Script is enabled.</para>
- <para>To log on to the application just enter <ulink url="http://localhost:8080/dhis"; type="">http://localhost:8080/dhis</ulink> if you
- are using the DHIS 2 live package, or replace localhost with the name or IP
- address of the server where the server version is installed.</para>
- <para>Once you have started DHIS 2, either on-line or offline, the displayed
- screen will prompt you to enter your registered ‘user name’ and
- ‘password’. After entering the required information click on log-in button
- to log into the application. The default user name and password are 'admin' and 'district'. They should be changed immediately upon logging on the first time. </para>
- </section>
- <section id="users">
- <title>Creating new users and roles</title>
- <para>This section will describe how to add new users to the DHIS 2
- application.</para>
- <section>
- <title>Open User Menu</title>
- <para>To create or find a user begin with clicking on the ‘user’ module
- displayed in the drop down menu of the Maintenance module located on the
- main tool bar on the top part of the displayed screen.</para>
- <screenshot>
- <screeninfo>Select Users menu item</screeninfo>
- <mediaobject>
- <imageobject>
- <imagedata width="100%" fileref="resources/images/dhis2UserManual/select_user_menu.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </screenshot>
- <para>User names already registered will appear as a list as seen in the screen shot below.</para>
- <screenshot>
- <screeninfo>Search by user name</screeninfo>
- <mediaobject>
- <imageobject>
- <imagedata width="100%" fileref="resources/images/dhis2UserManual/search_user_by_name.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </screenshot>
- <para>You can search for specific user names in the user list by
- entering the name in the ‘filter by user name’ field as shown
- above.</para>
- </section>
- <section id="user_roles">
- <title>Define a new role</title>
- <para>As part of creating a user name you are required to define the user
- role. Do so by clicking on the ‘user role’ appearing on the left side of
- the displayed screen. This will lead you to the Role Management page where you will have
- to click on <guibutton>Add new</guibutton> to create a new role.</para>
- <screenshot>
- <screeninfo>Add new user role</screeninfo>
- <mediaobject>
- <imageobject>
- <imagedata width="100%" fileref="resources/images/dhis2UserManual/add_user_role.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </screenshot>
- <para>The following screen will open and here in the first text box you
- need to give Name of the Role such as Super User, Admin User, etc. The
- second text box called ‘Description’ gives more information about the
- type of User Role that is being created for e.g. State Admin User,
- District Data Entry.</para>
- <screenshot>
- <screeninfo>Role maintenance page</screeninfo>
- <mediaobject>
- <imageobject>
- <imagedata width="100%" fileref="resources/images/dhis2UserManual/role_maintenance_page.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </screenshot>
- <para>Next you will specify the particular data set(s) that are to be
- made available to the particular role. You will also need to specify the
- type of ‘authority’ to be given to the particular user. For each of the
- three options namely Datasets, Reports and Authorities user can select
- multiple options from the scroll down menu provided against each field.
- A user can choose multiple options either by moving them
- one-by-one.</para>
- <para>In order for particular users to be able to enter data, you must
- add them to both a dataset as well as an organisational unit level. You
- can also select multiple datasets individually by pressing the Ctrl key
- on the keyboard and clicking on individual datasets.</para>
- <para>Finally when you have entered the required fields click on
- <guibutton>Save</guibutton> which is located on the lower part of the
- displayed screen. The desired user role and related authorisation will
- be saved to the database, and can then be assigned to a particular
- user.</para>
- </section>
- <section>
- <title>Add New User</title>
- <para>Under particular user role there can be more than one user. To add
- new users go to the User options under the Maintenance module.</para>
- <para>To add a new user, just follow these steps:</para>
- <itemizedlist>
- <listitem>
- <para>Click on the <guibutton>Add New</guibutton> button.</para>
- </listitem>
- <listitem>
- <para>Enter New User details like <guilabel>User name</guilabel>, <guilabel>Password</guilabel>, <guilabel>Confirm password</guilabel>, <guilabel>Surname</guilabel>, <guilabel>First name</guilabel> and <guilabel>Email</guilabel> in new user’s option tabs.</para>
- </listitem>
- <listitem>
- <para>Click on <guibutton>Add</guibutton> button for confirmation of
- new user details and follow the user error while creation of new
- user.</para>
- </listitem>
- <listitem>
- <para>The recently created new user can be seen in main’ User
- management Screen</para>
- </listitem>
- <listitem>
- <para>You can edit (like password, surname….etc) and delete the
- details of new/old users by selecting corresponding User’s
- <guibutton>Edit</guibutton> and <guibutton>Delete</guibutton>
- Buttons.</para>
- </listitem>
- <listitem>
- <para>Click on <guibutton>Save</guibutton> tab after editing all
- details of a particular selected user.</para>
- <screenshot>
- <screeninfo>User management screen</screeninfo>
- <mediaobject>
- <imageobject>
- <imagedata width="100%" fileref="resources/images/dhis2UserManual/user_management.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </screenshot>
- </listitem>
- </itemizedlist>
- </section>
- </section>
- <section id="mod2_4">
- <title>Logging out of DHIS 2</title>
- <para>Just click on the Log out link in the top right corner to exit the application.</para>
- </section>
- <section id="database_design">
- <title>Quick intro to designing a DHIS 2 database</title>
- <para>The DHIS 2 application comes with a set of tools for data collection, validation, reporting and analysis, but the contents of the database, e.g. what to collect, who should collect it and on what format will depend on the context of use. This metadata need to be populated into the application before it can be used, and this can be done through the user interface and requires no programming or in-depth technical skills of the software. We call this initial process database design or customisation.</para>
- <para>This section will provide a very quick and brief introduction to DHIS 2 database design and mainly explain the various steps needed to prepare a new DHIS 2 system for use. How to do each step is explained in other chapters, and best practices on design choices will be explained in an implementers manual (expected during first half of 2011). Here are the steps to follow:</para>
- <para>1. Set up an organisational hierarchy</para>
- <para>2. Define data elements</para>
- <para>3. Define data sets and data entry forms</para>
- <para>4. Define validation rules</para>
- <para>5. Define indicators</para>
- <para>6. Define report tables and design reports</para>
- <para>7. Set up the GIS module</para>
- <para>8. Design charts and customise the dashboard</para>
- <section>
- <title>The organisational hierarchy</title>
- <para>The organisational hierarchy defines the organisation using the DHIS 2, the health facilities, administrative areas and other geographical areas used in data collection and data analysis. This dimension to the data is defined as a hierarchy with one root unit (e.g. Ministry of Health) and any number of levels and nodes below. Each node in this hierarchy is called an organisational unit in DHIS 2. The design of this hierarchy will determine the geographical units of analysis available to the users as data is collected and aggregated in this structure. There can only be one organisational hierarchy at the same time so its structure needs careful consideration. Additional hierarchies (e.g. parallel administrative boundaries to the health care sector) can be modelled using organisational groups and group sets, but the organisational hierarchy is the main vehicle for data aggregation on the geographical dimension. Typically national organisational hierarchies in public health have 4-6 levels, but any number of levels is supported. The hierarchy is built up of parent-child relations, e.g. a Country or MoH unit (the root) might have e.g. 8 parent units (provinces), and each province again ( at level 2) might have 10-15 districts as their children. Normally the health facilities will be located at the lowest level, but they can also be located at higher levels, e.g. national or provincial hospitals, so skewed organisational trees are supported (e.g. a leaf node can be positioned at level 2 while most other leaf nodes are at level 5). Typically there is a geographical hierarchy defined by the health system. e.g. where the administrative offices are located (e.g. MoH, province, district), but often there are other administrative boundaries in the country that might or might not be added, depending on how its boundaries will improve data analysis. When designing the hierarchy the number of children for any organisational unit may indicate the usefulness of the structure, e.g. having one or more 1-1 relationships between two levels is not very useful as the values will be the same for the child and the parent level. On the other extreme a very high number of children in the middle of the hierarchy (e.g. 50 districts in a province) might call for an extra level to be added in between to increase the usefulness of data analysis. The lowest level, the health facilities will often have a large number of children (10-60), but for other levels higher up in the hierarchy approx. 5-20 children is recommended. To few or too many children might indicate that a level should be removed or added. Note that it is quite easy to make changes to the upper levels of the hierarchy at a later stage, the only problem is changing organisational units that collect data (the leaf nodes), e.g. splitting or merging health facilities. Aggregation up the hierarchy is done based on the current hierarchy at any time and will always reflect the most recent changes to the organisational structure. Refer to the chapter on Organisation Units to learn how to create organisational units and to build up the hierarchy.</para>
- </section>
- <section>
- <title>Data Elements</title>
- <para>The Data Element is perhaps the most important building block of a DHIS 2 database. It represents the "WHAT" dimension, it explains what is being collected or analysed. In some contexts this is referred to an indicator, but in DHIS 2 we call this unit of collection and analysis a <emphasis role="italic">data element</emphasis>. The data element often represents a count of something, and its name describes what is being counted, e.g. "BCG doses given" or "Malaria cases". When data is collected, validated, analysed, reported or presented it is the data elements or expressions built upon data elements that describes the WHAT of the data. As such the data elements become important for all aspects of the system and they decide not only how data is collected, but more importantly how the data values are represented in the database, which again decides how data can be analysed and presented. </para>
- <para>It is possible to add more details to this "WHAT" dimension through the disaggregation dimension called data element categories. Some common categories are Age and Gender, but any category can be added by the user and linked to specific data elements. The combination of a data element's name and its assigned category defines the smallest unit of collection and analysis available in the system, and hence describes the raw data in the database. Aggregations can be done when zooming out of this dimension, but no further drill-down is possible, so designing data elements and categories define the detail of the analysis available to the system (on the WHAT dimension). Changes to data elements and categories at a later stage in the process might be complicated as these will change the meaning of the data values already captured in the database (if any). So this step is one of the more decisive and careful steps in the database design process.</para>
- <para>One best practice when designing data elements is to think of data elements as a unit of data analysis and not just as a field in the data collection form. Each data element lives on its own in the database, completely detached from the collection form, and reports and other outputs are based on data elements and expressions/formulas composed of data elements and not the data collection forms. So the data analysis needs should drive the process, and not the look an feel of the data collection forms. A simple rule of thumb is that the name of the data element must be able to stand on its own and describe the data value also outside the context of its collection form. E.g. a data element name like "Total referrals" makes sense when looking at it in either the "RCH" form or the "OPD" form, but on its own it does not uniquely describe the phenomena (who are being referred?), and should in stead be called "Total referrals from Maternity" or "Total referrals from OPD". Two different data elements with different meanings, although the field on the paper form might only say "Total referrals" since the user of the form will always know where these referrals come from. In a database or a repository of data elements this context is no longer valid and therefore the names of the data elements become so important in describing the data. </para>
- <para>Common properties of data elements can be modelled through what is called data element groups. The groups are completely flexible in the sense that they are defined by the user, both their names and their memberships. Groups are useful both for browsing and presenting related data, but can also be used to aggregate data elements together. Groups are loosely coupled to data elements and not tied directly to the data values which means they can be modified and added at any point in time without interfering with the raw data. </para>
- </section>
- <section>
- <title>Datasets and data entry forms</title>
- <para>All data entry in DHIS 2 is organised through the use of Datasets. A Dataset is a collection of data elements grouped together for data collection, and in the case of distributed installs they also define chunks of data for export and import between instances of DHIS 2 (e.g. from a district office local installation to a national server). Datasets are not linked directly to the data values, only through their data elements and frequencies, and as such a dataset can be modified, deleted or added at any point in time without affecting the raw data already captured in the system, but such changes will of course affect how new data will be collected. </para>
- <para>A dataset has a period type which controls the data collection frequency, which can be daily, weekly, monthly, quarterly, six-monthly, or yearly. Both which data elements to include in the dataset and the period type is defined by the user, together with a name, short name, and code.</para>
- <para>In order to use a dataset to collect data for a specific orgunit you must assign the orgunit to the dataset, and this mechanism controls which orgunits that can use which datasets, and at the same time defines the target values for data completeness (e.g. how many health facilities in a district expected to submit RCH data every month). </para>
- <para>A data element can belong to multiple datasets, but this requires careful thinking as it may lead to overlapping and inconstant data being collected if e.g. the datasets are given different frequencies and are used by the same orgunits.
-</para>
- <section>
- <title>Data entry forms</title>
- <para>Once you have assigned a dataset to an orgunit that dataset will be made available in Data Entry (under Services) for the orgunits you have assigned it to and for the valid periods according to the dataset's period type. A default data entry form will then be shown, which is simply a list of the data elements belonging to the dataset together with a column for inputting the values. If your dataset contains data elements with categories such as age groups or gender, then additional columns will be automatically generated in the default form based on the categories. In addition to the default list-based data entry form there are two more alternatives, the section-based form and the custom form.</para>
- <section>
- <title>Section forms</title>
- <para>Section forms allow for a bit more flexibility when it comes to using tabular forms and are quick and simple to design. Often your data entry form will need multiple tables with subheadings, and sometimes you need to disable (grey out) a few fields in the table (e.g. some categpories do not apply to all data elements), both of these functions are supported in section forms. After defining a dataset you can define it's sections with subsets of dataelements, a heading and possible grey fields i the section's table. The order of sections in a datsaset can also be defined. In Data Entry you can now start using the Section form (should appear automatically when sections are available for the selected dataset). You can switch between default and section forms in the top right corner of the data entry screen. Most tabular data entry forms should be possible to do with sections forms, and the more you can utilise the section forms (or default forms) the easier it is for you. If these two types of forms are not meeting your requirements then the third option is the completely flexible, although more time-consuming, custom data entry forms.</para>
- </section>
- <section>
- <title>Custom Forms</title>
- <para>When the form you want to design is too complicated for the default or section forms then your last option is to use a custom form. This takes more time, but gives you full flexibility in term of the design. In DHIS 2 there is a built in HTML editor (FcK Editor) for the form designer and you can either design the form in the UI or paste in your html directly (using the Source window in the editor. In the custom form you can insert static text or data fields (linked to data elements + category) in any position on the form and you have complete freedom to design the layout of the form. Once a custom form has been added to a dataset it will be available in data entry and used automatically. You can switch back to default and section (if exists) forms in the top right corner of the data entry screen. </para>
- </section>
- </section>
- </section>
- <section>
- <title>Validation rules</title>
- <para>Once you have set up the data entry part of the system and started to collect data then there is time to define data quality checks that help to improve the quality of the data being collected. You can add as many validation rules as you like and these are composed of left and right side expressions that again are composed of data elements, with an operator between the two sides. Typical rules are comparing subtotals to totals of something. E.g. if you have two data elements "HIV tests taken" and "HIV test result positive" then you know that in the same form (for the same period and organisational unit) the total number of tests must always be equal or higher than the number of positive tests. These rules should be absolute rules meaning that they are mathematically correct and not just assumptions or "most of the time correct". The rules can be run in data entry, after filling each form, or as a more batch like process on multiple forms at the same time, e.g. for all facilities for the previous reporting month. The results of the tests will list all violations and the detailed values for each side of the expression where the violation ocurred to make it easy to go back to data entry and correct the values.</para>
- </section>
- <section>
- <title>Indicators</title>
- <para>Indicators represent perhaps the most powerful data analysis feature of the DHIS 2. While data elements represent the raw data (counts) being collected the indicators represent formulas providing coverage rates, incidence rates, ratios and other formula-based units of analysis. An indicator is made up of a factor (e.g. 1, 100, 100, 100 000), a numerator and a denominator, the two latter are both expressions based on one or more data elements. E.g. the indicator "BCG coverage <1 year" is defined a formula with a factor 100, a numerator ("BCG doses given to children under 1 year") and a denominator ("Target population under 1 year"). The indicator "DPT1 to DPT3 drop out rate" is a formula of 100 % x ("DPT1 doses given"- "DPT3 doses given") / ("DPT1 doses given"). </para>
- <para>Most report modules in DHIS 2 support both data elements and indicators and you can also combine these in custom reports, but the important difference and strength of indicators versus raw data (data element's data values) is the ability to compare data across different geographical areas (e.g. highly populated vs rural areas) as the target population can be used in the denominator.</para>
- <para>Indicators can be added, modified and deleted at any point in time without interfering with the data values in the database. </para>
- </section>
- <section>
- <title>Report tables and reports</title>
- <para>Standard reports in DHIS 2 is a very flexible way of presenting the data that has been collected. Data can be aggregated by any organisational unit or orgunit level, by data element, by indicators, as well as over time (e.g. monthly, quarterly, yearly). The report tables are custom data sources for the standard reports and can be flexibly defined in the user interface and later accessed in external report designers such as iReport or BIRT. These report designs can then be set up as easily accessible one-click reports with parameters so that the users can run the same reports e.g. every month when new data is entered, and also be relevant to users at all levels as the organisational unit can be selected at the time of running the report.</para>
- </section>
- <section>
- <title>GIS</title>
- <para>In the integrated GIS module you can easily display your data on maps, both on polygons (areas) and as points (health facilities), and either as data elements or indicators. By providing the coordinates of your organisational units to the system you can qucikly get up to speed with this module. See the GIS section for details on how to get started. </para>
- </section>
- <section>
- <title>Charts and dashboard</title>
- <para>On of the easiest way to display your indicator data is through charts. An easy to use chart dialogue will guide you through the creation of various types of charts with data on indicators, organisational units and periods of your choice. These charts can easily be added to one of the four chart sections on your dashboard and there be made easily available right after log in. Make sure to set the dashboard module as the start module in user settings. </para>
- </section>
- </section>
-</chapter>
+<?xml version='1.0' encoding='UTF-8'?>
+<!-- This document was created with Syntext Serna Free. --><!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd"; []>
+<chapter>
+ <title>Getting started with DHIS 2</title>
+ <section id="mod2_1">
+ <title>Getting started with DHIS 2</title>
+ <para>After reading this chapter you will be able to understand:</para>
+ <itemizedlist>
+ <listitem>
+ <para>Start DHIS 2 from the desktop</para>
+ </listitem>
+ <listitem>
+ <para>How to log-in from the desktop</para>
+ </listitem>
+ </itemizedlist>
+ <itemizedlist>
+ <listitem>
+ <para>Create new users and user roles</para>
+ </listitem>
+ </itemizedlist>
+ <itemizedlist>
+ <listitem>
+ <para>What steps are needed to design a DHIS 2 database for your organisation</para>
+ </listitem>
+ </itemizedlist>
+ <section>
+ <title>Prerequisites</title>
+ <para>You must be sure that you have a current version of the Java Runtime installed on your machine. Depending on your operating system, there are different ways of installing Java. The reader is referred to this <ulink url="http://java.sun.com/javase/downloads/index.jsp";>website</ulink> for detailed information on getting Java installed.</para>
+ </section>
+ <section>
+ <title>Starting the DHIS 2 Live package</title>
+ <para>The DHIS 2 Live package is the easiest way to get started with DHIS2. DHIS2 Live is appropriate for a stand-alone installation and demos. Simply download the application from <ulink url="http://www.dhis2.org/downloads";>here</ulink>.
+ Once the file is downloaded, you can simply double-click the downloaded file, and get started using DHIS 2. </para>
+ <section>
+ <title>Starting up with a blank database</title>
+ <para>The live package comes with a demo database just like what you see on the <ulink url="http://apps.dhis2.org/demo/";>online demo</ulink> (which is based on the national Sierra Leone HMIS), and if you want to start with a blank system/database and build up your own system then you need to do the following:
+</para>
+ <para>1) Stop DHIS2 live if it is already running. Right click on the tray icon and select Exit.
+The tray icon is the green symbol on the bottom right of your screen (on Windows) which should say' DHIS 2 Server running' if you hold your mouse pointer over it.</para>
+ <para>2) Open the folder where the DHIS 2 live package is installed and locate the folder called "conf".
+</para>
+ <para>3) In conf/ open the file called 'hibernate.properties' in a text editor (notepad or similar) and do the following modification:
+locate the string 'jdbc:h2:./database/dhis2' and replace the 'dhis2' part with any name that you want to give to your database (e.g. dhis2_test).</para>
+ <para>4) Save and close the hibernate.properties file.
+</para>
+ <para>5) Start DHIS 2 Live by double-clicking on the file dhis2-live.exe in the DHIS 2 Live installation folder or by using a desktop shortcut or menu link that you might have set up.
+</para>
+ <para>6) Wait for the browser window to open and the login screen to show, and then log in with username: admin and password: district
+</para>
+ <para>7) Now you will see a completely empty DHIS 2 system and you should start by adding your users, organisational hierarchy, data elements, and datasets etc. Please refer to the other sections of the user manual for instructions on how to do this.
+</para>
+ </section>
+ </section>
+ <section>
+ <title>Working directly with the H2 database</title>
+ <para>
+ DHIS 2 Live uses an embedded <ulink url="www.h2database.com/">H2</ulink> database. This has several advantages - there is no need
+ to install a separate database engine such as PostgresSql or MySql, and backup can be made by just copying the file. The whole database
+ exists in memory, which means high performance. The disadvantage is need for RAM. It is also not suitable for muliti-user server
+ installations.
+ </para>
+ <para>
+ In general, it is recommended to work with the database through the DHIS2 user interface, but in some situations one may need to
+ manipulate the data directly. If one downloads H2 separately, it comes with a web interface. It can also be manipulated using
+ <ulink url="http://openoffice.org";>OpenOffice.org</ulink>, using the following procedure. This assumes that dhis2-live is located in
+ the user's Linux home directory (represented by ~). Substitute the absolute path to your dhis2-live installation.
+ <itemizedlist>
+ <listitem>
+ <para>Start OpenOffice Word Processor and select Tools - Options, then Java - Class Path ... and click on Add Archive...</para>
+ </listitem>
+ <listitem>
+ <para>Select the following file (version may differ): ~/dhis2-live/webapps/dhis/WEB-INF/lib/h2-1.1.119.jar</para>
+ </listitem>
+ <listitem>
+ <para>Close OpenOffice completely and then open OpenOffice.org Database. Select connect to an existing database - JDBC</para>
+ </listitem>
+ <listitem>
+ <para>Datasource URL is h2:~/dhis2-live/database/dhis2;AUTO_SERVER=TRUE, and JDBC driver class is org.h2.Driver</para>
+ </listitem>
+ <listitem>
+ <para>User name is sa, password not needed. Finally, select a name and folder for the .odb file.</para>
+ </listitem>
+ </itemizedlist>
+ <ulink url="http://www.oooforum.org/forum/viewtopic.phtml?t=97522";>More tips</ulink>
+ </para>
+ </section>
+ <section>
+ <title>Downloading and installing the server version</title>
+ <para>The latest stable server version can be downloaded from this <ulink url="http://stable.dhis2.org/";>website</ulink>. For detailed information on how to install it please refer to the installation chapter in the implementation manual.</para>
+ </section>
+ </section>
+ <section id="mod2_2">
+ <title>Logging on to DHIS 2</title>
+ <para>Regardless of whether you have installed the server version of the
+ desktop Live version, you will use a web-browser to log on to the
+ application. DHIS2 should be compatible with most modern web-browsers,
+ although you will need to ensure that Java Script is enabled.</para>
+ <para>To log on to the application just enter <ulink url="http://localhost:8080/dhis"; type="">http://localhost:8080/dhis</ulink> if you
+ are using the DHIS2 live package, or replace localhost with the name or IP
+ address of the server where the server version is installed.</para>
+ <para>Once you have started DHIS2, either on-line or offline, the displayed
+ screen will prompt you to enter your registered ‘user name’ and
+ ‘password’. After entering the required information click on log-in button
+ to log into the application. The default user name and password are 'admin' and 'district'. They should be changed immediately upon logging on the first time. </para>
+ </section>
+ <section id="users">
+ <title>Creating new users and roles</title>
+ <para>This section will describe how to add new users to the DHIS 2
+ application.</para>
+ <section>
+ <title>Open User Menu</title>
+ <para>To create or find a user begin with clicking on the ‘user’ module
+ displayed in the drop down menu of the Maintenance module located on the
+ main tool bar on the top part of the displayed screen.</para>
+ <screenshot>
+ <screeninfo>Select Users menu item</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata width="100%" fileref="resources/images/dhis2UserManual/select_user_menu.png" format="PNG"/>
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ <para>User names already registered will appear as a list as seen in the screen shot below.</para>
+ <screenshot>
+ <screeninfo>Search by user name</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata width="100%" fileref="resources/images/dhis2UserManual/search_user_by_name.png" format="PNG"/>
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ <para>You can search for specific user names in the user list by
+ entering the name in the ‘filter by user name’ field as shown
+ above.</para>
+ </section>
+ <section id="user_roles">
+ <title>Define a new role</title>
+ <para>As part of creating a user name you are required to define the user
+ role. Do so by clicking on the ‘user role’ appearing on the left side of
+ the displayed screen. This will lead you to the Role Management page where you will have
+ to click on <guibutton>Add new</guibutton> to create a new role.</para>
+ <screenshot>
+ <screeninfo>Add new user role</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata width="100%" fileref="resources/images/dhis2UserManual/add_user_role.png" format="PNG"/>
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ <para>The following screen will open and here in the first text box you
+ need to give Name of the Role such as Super User, Admin User, etc. The
+ second text box called ‘Description’ gives more information about the
+ type of User Role that is being created for e.g. State Admin User,
+ District Data Entry.</para>
+ <screenshot>
+ <screeninfo>Role maintenance page</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata width="100%" fileref="resources/images/dhis2UserManual/role_maintenance_page.png" format="PNG"/>
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ <para>Next you will specify the particular data set(s) that are to be
+ made available to the particular role. You will also need to specify the
+ type of ‘authority’ to be given to the particular user. For each of the
+ three options namely Datasets, Reports and Authorities user can select
+ multiple options from the scroll down menu provided against each field.
+ A user can choose multiple options either by moving them
+ one-by-one.</para>
+ <para>In order for particular users to be able to enter data, you must
+ add them to both a dataset as well as an organisational unit level. You
+ can also select multiple datasets individually by pressing the Ctrl key
+ on the keyboard and clicking on individual datasets.</para>
+ <para>Finally when you have entered the required fields click on
+ <guibutton>Save</guibutton> which is located on the lower part of the
+ displayed screen. The desired user role and related authorisation will
+ be saved to the database, and can then be assigned to a particular
+ user.</para>
+ </section>
+ <section>
+ <title>Add New User</title>
+ <para>Under particular user role there can be more than one user. To add
+ new users go to the User options under the Maintenance module.</para>
+ <para>To add a new user, just follow these steps:</para>
+ <itemizedlist>
+ <listitem>
+ <para>Click on the <guibutton>Add New</guibutton> button.</para>
+ </listitem>
+ <listitem>
+ <para>Enter New User details like <guilabel>User name</guilabel>, <guilabel>Password</guilabel>, <guilabel>Confirm password</guilabel>, <guilabel>Surname</guilabel>, <guilabel>First name</guilabel> and <guilabel>Email</guilabel> in new user’s option tabs.</para>
+ </listitem>
+ <listitem>
+ <para>Click on <guibutton>Add</guibutton> button for confirmation of
+ new user details and follow the user error while creation of new
+ user.</para>
+ </listitem>
+ <listitem>
+ <para>The recently created new user can be seen in main’ User
+ management Screen</para>
+ </listitem>
+ <listitem>
+ <para>You can edit (like password, surname….etc) and delete the
+ details of new/old users by selecting corresponding User’s
+ <guibutton>Edit</guibutton> and <guibutton>Delete</guibutton>
+ Buttons.</para>
+ </listitem>
+ <listitem>
+ <para>Click on <guibutton>Save</guibutton> tab after editing all
+ details of a particular selected user.</para>
+ <screenshot>
+ <screeninfo>User management screen</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata width="100%" fileref="resources/images/dhis2UserManual/user_management.png" format="PNG"/>
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </listitem>
+ </itemizedlist>
+ </section>
+ </section>
+ <section id="mod2_4">
+ <title>Logging out of DHIS 2</title>
+ <para>Just click on the Log out link in the top right corner to exit the application.</para>
+ </section>
+ <section id="database_design">
+ <title>Quick intro to designing a DHIS 2 database</title>
+ <para>The DHIS 2 application comes with a set of tools for data collection, validation, reporting and analysis, but the contents of the database, e.g. what to collect, who should collect it and on what format will depend on the context of use. This metadata need to be populated into the application before it can be used, and this can be done through the user interface and requires no programming or in-depth technical skills of the software. We call this initial process database design or customisation.</para>
+ <para>This section will provide a very quick and brief introduction to DHIS 2 database design and mainly explain the various steps needed to prepare a new DHIS 2 system for use. How to do each step is explained in other chapters, and best practices on design choices will be explained in an implementers manual (expected during first half of 2011). Here are the steps to follow:</para>
+ <para>1. Set up an organisational hierarchy</para>
+ <para>2. Define data elements</para>
+ <para>3. Define data sets and data entry forms</para>
+ <para>4. Define validation rules</para>
+ <para>5. Define indicators</para>
+ <para>6. Define report tables and design reports</para>
+ <para>7. Set up the GIS module</para>
+ <para>8. Design charts and customise the dashboard</para>
+ <section>
+ <title>The organisational hierarchy</title>
+ <para>The organisational hierarchy defines the organisation using the DHIS 2, the health facilities, administrative areas and other geographical areas used in data collection and data analysis. This dimension to the data is defined as a hierarchy with one root unit (e.g. Ministry of Health) and any number of levels and nodes below. Each node in this hierarchy is called an organisational unit in DHIS 2. The design of this hierarchy will determine the geographical units of analysis available to the users as data is collected and aggregated in this structure. There can only be one organisational hierarchy at the same time so its structure needs careful consideration. Additional hierarchies (e.g. parallel administrative boundaries to the health care sector) can be modelled using organisational groups and group sets, but the organisational hierarchy is the main vehicle for data aggregation on the geographical dimension. Typically national organisational hierarchies in public health have 4-6 levels, but any number of levels is supported. The hierarchy is built up of parent-child relations, e.g. a Country or MoH unit (the root) might have e.g. 8 parent units (provinces), and each province again ( at level 2) might have 10-15 districts as their children. Normally the health facilities will be located at the lowest level, but they can also be located at higher levels, e.g. national or provincial hospitals, so skewed organisational trees are supported (e.g. a leaf node can be positioned at level 2 while most other leaf nodes are at level 5). Typically there is a geographical hierarchy defined by the health system. e.g. where the administrative offices are located (e.g. MoH, province, district), but often there are other administrative boundaries in the country that might or might not be added, depending on how its boundaries will improve data analysis. When designing the hierarchy the number of children for any organisational unit may indicate the usefulness of the structure, e.g. having one or more 1-1 relationships between two levels is not very useful as the values will be the same for the child and the parent level. On the other extreme a very high number of children in the middle of the hierarchy (e.g. 50 districts in a province) might call for an extra level to be added in between to increase the usefulness of data analysis. The lowest level, the health facilities will often have a large number of children (10-60), but for other levels higher up in the hierarchy approx. 5-20 children is recommended. To few or too many children might indicate that a level should be removed or added. Note that it is quite easy to make changes to the upper levels of the hierarchy at a later stage, the only problem is changing organisational units that collect data (the leaf nodes), e.g. splitting or merging health facilities. Aggregation up the hierarchy is done based on the current hierarchy at any time and will always reflect the most recent changes to the organisational structure. Refer to the chapter on Organisation Units to learn how to create organisational units and to build up the hierarchy.</para>
+ </section>
+ <section>
+ <title>Data Elements</title>
+ <para>The Data Element is perhaps the most important building block of a DHIS 2 database. It represents the "WHAT" dimension, it explains what is being collected or analysed. In some contexts this is referred to an indicator, but in DHIS 2 we call this unit of collection and analysis a <emphasis role="italic">data element</emphasis>. The data element often represents a count of something, and its name describes what is being counted, e.g. "BCG doses given" or "Malaria cases". When data is collected, validated, analysed, reported or presented it is the data elements or expressions built upon data elements that describes the WHAT of the data. As such the data elements become important for all aspects of the system and they decide not only how data is collected, but more importantly how the data values are represented in the database, which again decides how data can be analysed and presented. </para>
+ <para>It is possible to add more details to this "WHAT" dimension through the disaggregation dimension called data element categories. Some common categories are Age and Gender, but any category can be added by the user and linked to specific data elements. The combination of a data element's name and its assigned category defines the smallest unit of collection and analysis available in the system, and hence describes the raw data in the database. Aggregations can be done when zooming out of this dimension, but no further drill-down is possible, so designing data elements and categories define the detail of the analysis available to the system (on the WHAT dimension). Changes to data elements and categories at a later stage in the process might be complicated as these will change the meaning of the data values already captured in the database (if any). So this step is one of the more decisive and careful steps in the database design process.</para>
+ <para>One best practice when designing data elements is to think of data elements as a unit of data analysis and not just as a field in the data collection form. Each data element lives on its own in the database, completely detached from the collection form, and reports and other outputs are based on data elements and expressions/formulas composed of data elements and not the data collection forms. So the data analysis needs should drive the process, and not the look an feel of the data collection forms. A simple rule of thumb is that the name of the data element must be able to stand on its own and describe the data value also outside the context of its collection form. E.g. a data element name like "Total referrals" makes sense when looking at it in either the "RCH" form or the "OPD" form, but on its own it does not uniquely describe the phenomena (who are being referred?), and should in stead be called "Total referrals from Maternity" or "Total referrals from OPD". Two different data elements with different meanings, although the field on the paper form might only say "Total referrals" since the user of the form will always know where these referrals come from. In a database or a repository of data elements this context is no longer valid and therefore the names of the data elements become so important in describing the data. </para>
+ <para>Common properties of data elements can be modelled through what is called data element groups. The groups are completely flexible in the sense that they are defined by the user, both their names and their memberships. Groups are useful both for browsing and presenting related data, but can also be used to aggregate data elements together. Groups are loosely coupled to data elements and not tied directly to the data values which means they can be modified and added at any point in time without interfering with the raw data. </para>
+ </section>
+ <section>
+ <title>Datasets and data entry forms</title>
+ <para>All data entry in DHIS 2 is organised through the use of Datasets. A Dataset is a collection of data elements grouped together for data collection, and in the case of distributed installs they also define chunks of data for export and import between instances of DHIS 2 (e.g. from a district office local installation to a national server). Datasets are not linked directly to the data values, only through their data elements and frequencies, and as such a dataset can be modified, deleted or added at any point in time without affecting the raw data already captured in the system, but such changes will of course affect how new data will be collected. </para>
+ <para>A dataset has a period type which controls the data collection frequency, which can be daily, weekly, monthly, quarterly, six-monthly, or yearly. Both which data elements to include in the dataset and the period type is defined by the user, together with a name, short name, and code.</para>
+ <para>In order to use a dataset to collect data for a specific orgunit you must assign the orgunit to the dataset, and this mechanism controls which orgunits that can use which datasets, and at the same time defines the target values for data completeness (e.g. how many health facilities in a district expected to submit RCH data every month). </para>
+ <para>A data element can belong to multiple datasets, but this requires careful thinking as it may lead to overlapping and inconstant data being collected if e.g. the datasets are given different frequencies and are used by the same orgunits.
+</para>
+ <section>
+ <title>Data entry forms</title>
+ <para>Once you have assigned a dataset to an orgunit that dataset will be made available in Data Entry (under Services) for the orgunits you have assigned it to and for the valid periods according to the dataset's period type. A default data entry form will then be shown, which is simply a list of the data elements belonging to the dataset together with a column for inputting the values. If your dataset contains data elements with categories such as age groups or gender, then additional columns will be automatically generated in the default form based on the categories. In addition to the default list-based data entry form there are two more alternatives, the section-based form and the custom form.</para>
+ <section>
+ <title>Section forms</title>
+ <para>Section forms allow for a bit more flexibility when it comes to using tabular forms and are quick and simple to design. Often your data entry form will need multiple tables with subheadings, and sometimes you need to disable (grey out) a few fields in the table (e.g. some categpories do not apply to all data elements), both of these functions are supported in section forms. After defining a dataset you can define it's sections with subsets of dataelements, a heading and possible grey fields i the section's table. The order of sections in a datsaset can also be defined. In Data Entry you can now start using the Section form (should appear automatically when sections are available for the selected dataset). You can switch between default and section forms in the top right corner of the data entry screen. Most tabular data entry forms should be possible to do with sections forms, and the more you can utilise the section forms (or default forms) the easier it is for you. If these two types of forms are not meeting your requirements then the third option is the completely flexible, although more time-consuming, custom data entry forms.</para>
+ </section>
+ <section>
+ <title>Custom Forms</title>
+ <para>When the form you want to design is too complicated for the default or section forms then your last option is to use a custom form. This takes more time, but gives you full flexibility in term of the design. In DHIS 2 there is a built in HTML editor (FcK Editor) for the form designer and you can either design the form in the UI or paste in your html directly (using the Source window in the editor. In the custom form you can insert static text or data fields (linked to data elements + category) in any position on the form and you have complete freedom to design the layout of the form. Once a custom form has been added to a dataset it will be available in data entry and used automatically. You can switch back to default and section (if exists) forms in the top right corner of the data entry screen. </para>
+ </section>
+ </section>
+ </section>
+ <section>
+ <title>Validation rules</title>
+ <para>Once you have set up the data entry part of the system and started to collect data then there is time to define data quality checks that help to improve the quality of the data being collected. You can add as many validation rules as you like and these are composed of left and right side expressions that again are composed of data elements, with an operator between the two sides. Typical rules are comparing subtotals to totals of something. E.g. if you have two data elements "HIV tests taken" and "HIV test result positive" then you know that in the same form (for the same period and organisational unit) the total number of tests must always be equal or higher than the number of positive tests. These rules should be absolute rules meaning that they are mathematically correct and not just assumptions or "most of the time correct". The rules can be run in data entry, after filling each form, or as a more batch like process on multiple forms at the same time, e.g. for all facilities for the previous reporting month. The results of the tests will list all violations and the detailed values for each side of the expression where the violation ocurred to make it easy to go back to data entry and correct the values.</para>
+ </section>
+ <section>
+ <title>Indicators</title>
+ <para>Indicators represent perhaps the most powerful data analysis feature of the DHIS 2. While data elements represent the raw data (counts) being collected the indicators represent formulas providing coverage rates, incidence rates, ratios and other formula-based units of analysis. An indicator is made up of a factor (e.g. 1, 100, 100, 100 000), a numerator and a denominator, the two latter are both expressions based on one or more data elements. E.g. the indicator "BCG coverage <1 year" is defined a formula with a factor 100, a numerator ("BCG doses given to children under 1 year") and a denominator ("Target population under 1 year"). The indicator "DPT1 to DPT3 drop out rate" is a formula of 100 % x ("DPT1 doses given"- "DPT3 doses given") / ("DPT1 doses given"). </para>
+ <para>Most report modules in DHIS 2 support both data elements and indicators and you can also combine these in custom reports, but the important difference and strength of indicators versus raw data (data element's data values) is the ability to compare data across different geographical areas (e.g. highly populated vs rural areas) as the target population can be used in the denominator.</para>
+ <para>Indicators can be added, modified and deleted at any point in time without interfering with the data values in the database. </para>
+ </section>
+ <section>
+ <title>Report tables and reports</title>
+ <para>Standard reports in DHIS 2 is a very flexible way of presenting the data that has been collected. Data can be aggregated by any organisational unit or orgunit level, by data element, by indicators, as well as over time (e.g. monthly, quarterly, yearly). The report tables are custom data sources for the standard reports and can be flexibly defined in the user interface and later accessed in external report designers such as iReport or BIRT. These report designs can then be set up as easily accessible one-click reports with parameters so that the users can run the same reports e.g. every month when new data is entered, and also be relevant to users at all levels as the organisational unit can be selected at the time of running the report.</para>
+ </section>
+ <section>
+ <title>GIS</title>
+ <para>In the integrated GIS module you can easily display your data on maps, both on polygons (areas) and as points (health facilities), and either as data elements or indicators. By providing the coordinates of your organisational units to the system you can qucikly get up to speed with this module. See the GIS section for details on how to get started. </para>
+ </section>
+ <section>
+ <title>Charts and dashboard</title>
+ <para>On of the easiest way to display your indicator data is through charts. An easy to use chart dialogue will guide you through the creation of various types of charts with data on indicators, organisational units and periods of your choice. These charts can easily be added to one of the four chart sections on your dashboard and there be made easily available right after log in. Make sure to set the dashboard module as the start module in user settings. </para>
+ </section>
+ </section>
+</chapter>
=== modified file 'src/docbkx/en/dhis2_user_man_introduction.xml'
--- src/docbkx/en/dhis2_user_man_introduction.xml 2012-10-10 14:59:19 +0000
+++ src/docbkx/en/dhis2_user_man_introduction.xml 2013-04-21 16:08:35 +0000
@@ -22,12 +22,12 @@
</highlights>
<section id="mod1_1">
<title>DHIS 2 Background</title>
- <para>The DHIS 2 is a tool for collection, validation, analysis, and presentation of aggregate statistical data, tailored (but not limited) to integrated health information management activities. It is a generic tool rather than a pre-configured database application, with an open meta-data model and a flexible user interface that allows the user to design the contents of a specific information system without the need for programming. DHIS 2 and upwards is a modular web-based software package built with free and open source Java frameworks.</para>
- <para>DHIS 2 is open source software released under the BSD license and can be used at no cost. It runs on any platform with a JRE 6 (or higher) installed. Simply download (from dhis2.org), unpack and run the executable file and you are good to go.</para>
- <para>The DHIS 2 is developed by the Health Information Systems Programme (HISP) as an open and globally distributed process with developers currently in India, Vietnam, Tanzania, Ireland, and Norway. The development is coordinated by the University of Oslo with core support from Norad. </para>
+ <para>DHIS 2 is a tool for collection, validation, analysis, and presentation of aggregate statistical data, tailored (but not limited) to integrated health information management activities. It is a generic tool rather than a pre-configured database application, with an open meta-data model and a flexible user interface that allows the user to design the contents of a specific information system without the need for programming. DHIS2 and upwards is a modular web-based software package built with free and open source Java frameworks.</para>
+ <para>DHIS2 is open source software released under the BSD license and can be used at no cost. It runs on any platform with a Java Runtime Environment (JRE 6 or higher) installed. </para>
+ <para>DHIS 2 is developed by the Health Information Systems Programme (HISP) as an open and globally distributed process with developers currently in India, Vietnam, Tanzania, Ireland, and Norway. The development is coordinated by the University of Oslo with core support from NORAD. </para>
<para>As of October 2012, the DHIS 2 software is used in more than 30 countries in Africa, Asia, and Latin America, and countries that have adopted DHIS 2 as their nation-wide HIS software include Kenya, Tanzania, Uganda, Rwanda, Ghana, Liberia, and Bangladesh. A rapidly increasing number of countries and organisations are starting up new deployments.</para>
- <para>The documentation provided in herewith, will attempt to provide a comprehensive overview of the application. Given the abstract nature of the application, this manual will not serve as a complete step-by-step guide of how to use the application in each and every circumstance, but rather will seek to provide illustrations and examples of how DHIS2 can be implemented in a variety of situations through generalized examples.</para>
- <para>Before implementing DHIS 2 in a new setting we highly recommend reading the DHIS 2 Implementation Guide (a separate manual from this one), also available at dhis2.org.</para>
+ <para>The documentation provided herewith, will attempt to provide a comprehensive overview of the application. Given the abstract nature of the application, this manual will not serve as a complete step-by-step guide of how to use the application in each and every circumstance, but rather will seek to provide illustrations and examples of how DHIS2 can be implemented in a variety of situations through generalized examples.</para>
+ <para>Before implementing DHIS 2 in a new setting, we highly recommend reading the DHIS 2 Implementation Guide (a separate manual from this one), also available at the main DHIS2 <ulink url="http://dhis2.org/documentation/";>website</ulink>.</para>
</section>
<section>
<title>Key features and purpose of DHIS 2</title>
@@ -137,12 +137,12 @@
entered into it. Data entry can be done in lists of data elements or in
customised user defined forms which can be developed to mimic paper based forms in order to ease the process of data entry.</para>
<para>As a next step, DHIS 2 can be used to increase data quality.
- Firstly, at the point of data entry, a check can be made to see if data
+ First, at the point of data entry, a check can be made to see if data
falls within acceptable range levels of minimum and maximum values for
any particular data element. Such checking, for example, can help to
identify typing errors at the time of data entry. Further, user can
define various validation rules, and DHIS 2 can run the data through the
- validation rules to identify violations.</para>
+ validation rules to identify violations. These types of checks help to ensure that data entered into the system is of good quality from the start, and can be improved by the people who are most familiar with it. </para>
<para>When data has been entered and verified, DHIS 2 can help to make
different kinds of reports. The first kind are the routine reports that
can be predefined, so that all those reports that need to be routine
@@ -184,6 +184,7 @@
Windows, Linux, Macintosh etc. DHIS 2 is platform independent, and is
extremely useful in the context of public health, where multiple operating systems may be in use.</para>
<para>Furthermore, DHIS 2 is also platform independent when it comes to the Database Management System (DBMS). DHIS 2 uses the Hibernate database abstraction framework and is compatible with any DBMS supported by Hibernate, such as PostgreSQL, MySQL, H2, MS SQL Server, Oracle and many more. PostgreSQL is the recommended DBMS for DHIS 2.</para>
+ <para>Lastly, and perhaps most importantly, since DHIS2 is a browser-based application, the only real requirement to interact with the system is with a web browser. DHIS2 supports most web browsers, although currently either Google Chrome, Mozilla Firefox or Opera are reccommended.</para>
</section>
<section>
<title>Deployment strategies - online vs offline</title>
@@ -193,16 +194,16 @@
<para>An offline deployment implies that multiple standalone offline instances are installed for end users, typically at the district level. The system is maintained primarily by the end users/district health officers who enters data and generate reports from the system running on their local server. The system will also typically be maintained by a national super-user team who pay regular visits to the district deployments. Data is moved upwards in the hierarchy by the end users producing data exchange files which are sent electronically by email or physically by mail or personal travel. (Note that the brief Internet connectivity required for sending emails does not qualify for being defined as online). This style of deployment has the obvious benefit that it works when appropriate Internet connectivity is not available. On the other side there are significant challenges with this style which are described in the following section.</para>
<itemizedlist>
<listitem>
- <para>Hardware: Running stand-alone systems requires advanced hardware in terms of servers and reliable power supply to be installed, usually at district level, all over the country. This requires appropriate funding for procurement and plan for long-term maintenance.</para>
- </listitem>
- <listitem>
- <para>Software platform: Local installs implies a significant need for maintenance. From experience, the biggest challenge is viruses and other malware which tend to infect local installations in the long-run. The main reason is that end users utilize memory sticks for transporting data exchange files and documents between private computers, other workstations and the system running the application. Keeping anti-virus software and operating system patches up to date in an offline environment are challenging and bad practises in terms of security are often adopted by end users. The preferred way to overcome this issue is to run a dedicated server for the application where no memory sticks are allowed and use an Linux based operating system which is not as prone for virus infections as MS Windows.</para>
- </listitem>
- <listitem>
- <para>Software application: Being able to distribute new functionality and bug-fixes to the health information software to users are essential for maintenance and improvement of the system. Relying on the end users to perform software upgrades requires extensive training and a high level of competence on their side as upgrading software applications might a technically challenging task. Relying on a national super-user team to maintain the software implies a lot of travelling.</para>
- </listitem>
- <listitem>
- <para>Database maintenance: A prerequisite for an efficient system is that all users enter data with a standardized meta-data set (data elements, forms etc). As with the previous point about software upgrades, distribution of changes to the meta-data set to numerous offline installations requires end user competence if the updates are sent electronically or a well-organized super-user team. Failure to keep the meta-data set synchronized will lead to loss of ability to move data from the districts and/or an inconsistent national database since the data entered for instance at the district level will not be compatible with the data at the national level.</para>
+ <para><emphasis role="bold">Hardware:</emphasis> Running stand-alone systems requires advanced hardware in terms of servers and reliable power supply to be installed, usually at district level, all over the country. This requires appropriate funding for procurement and plan for long-term maintenance.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Software platform:</emphasis> Local installs implies a significant need for maintenance. From experience, the biggest challenge is viruses and other malware which tend to infect local installations in the long-run. The main reason is that end users utilize memory sticks for transporting data exchange files and documents between private computers, other workstations and the system running the application. Keeping anti-virus software and operating system patches up to date in an offline environment are challenging and bad practices in terms of security are often adopted by end users. The preferred way to overcome this issue is to run a dedicated server for the application where no memory sticks are allowed and use an Linux based operating system which is not as prone for virus infections as MS Windows.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Software application:</emphasis> Being able to distribute new functionality and bug-fixes to the health information software to users are essential for maintenance and improvement of the system. Relying on the end users to perform software upgrades requires extensive training and a high level of competence on their side as upgrading software applications might a technically challenging task. Relying on a national super-user team to maintain the software implies a lot of traveling.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Database maintenance: </emphasis>A prerequisite for an efficient system is that all users enter data with a standardized meta-data set (data elements, forms etc). As with the previous point about software upgrades, distribution of changes to the meta-data set to numerous offline installations requires end user competence if the updates are sent electronically or a well-organized super-user team. Failure to keep the meta-data set synchronized will lead to loss of ability to move data from the districts and/or an inconsistent national database since the data entered for instance at the district level will not be compatible with the data at the national level.</para>
</listitem>
</itemizedlist>
</section>
@@ -212,19 +213,19 @@
<para>This online deployment style has huge positive implications for the implementation process and application maintenance compared to the traditional offline standalone style:</para>
<itemizedlist>
<listitem>
- <para>Hardware: Hardware requirements on the end-user side are limited to a reasonably modern computer/laptop and Internet connectivity through a fixed line or a mobile modem. There is no need for a specialized server, any Internet enabled computer will be sufficient.</para>
- </listitem>
- <listitem>
- <para>Software platform: The end users only need a web browser to connect to the online server. All popular operating systems today are shipped with a web browser and there is no special requirement on what type or version. This means that if severe problems such as virus infections or software corruption occur one can always resort to re-formatting and installing the computer operating system or obtain a new computer/laptop. The user can continue with data entry where it was left and no data will be lost.</para>
- </listitem>
- <listitem>
- <para>Software application: The central server deployment style means that the application can be upgraded and maintained in a centralized fashion. When new versions of the applications are released with new features and bug-fixes it can be deployed to the single online server. All changes will then be reflected on the client side the next time end users connect over the Internet. This obviously has a huge positive impact for the process of improving the system as new features can be distributed to users immediately, all users will be accessing the same application version, and bugs and issues can be sorted out and deployed on-the-fly.</para>
- </listitem>
- <listitem>
- <para>Database maintenance: Similar to the previous point, changes to the meta-data can be done on the online server in a centralized fashion and will automatically propagate to all clients next time they connect to the server. This effectively removes the vast issues related to maintaining an upgraded and standardized meta-data set related to the traditional offline deployment style. It is extremely convenient for instance during the initial database development phase and during the annual database revision processes as end users will be accessing a consistent and standardized database even when changes occur frequently.</para>
+ <para><emphasis role="bold">Hardware:</emphasis> Hardware requirements on the end-user side are limited to a reasonably modern computer/laptop and Internet connectivity through a fixed line or a mobile modem. There is no need for a specialized server for each user, any Internet enabled computer will be sufficient. A server will be required for online deployments, but since there is only one (or several) servers which need to be procured and maintained, this is significantly simpler (and cheaper) than maintaining many separate servers is disparate locations.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Software platform:</emphasis> The end users only need a web browser to connect to the online server. All popular operating systems today are shipped with a web browser and there is no special requirement on what type or version. This means that if severe problems such as virus infections or software corruption occur one can always resort to re-formatting and installing the computer operating system or obtain a new computer/laptop. The user can continue with data entry where it was left and no data will be lost.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Software application:</emphasis> The central server deployment style means that the application can be upgraded and maintained in a centralized fashion. When new versions of the applications are released with new features and bug-fixes it can be deployed to the single online server. All changes will then be reflected on the client side the next time end users connect over the Internet. This obviously has a huge positive impact for the process of improving the system as new features can be distributed to users immediately, all users will be accessing the same application version, and bugs and issues can be sorted out and deployed on-the-fly.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Database maintenance: </emphasis>Similar to the previous point, changes to the meta-data can be done on the online server in a centralized fashion and will automatically propagate to all clients next time they connect to the server. This effectively removes the vast issues related to maintaining an upgraded and standardized meta-data set related to the traditional offline deployment style. It is extremely convenient for instance during the initial database development phase and during the annual database revision processes as end users will be accessing a consistent and standardized database even when changes occur frequently.</para>
</listitem>
</itemizedlist>
- <para>This approach might be problematic in cases where Internet connectivity is volatile or missing in long periods of time. DHIS 2 however has certain features which requires Internet connectivity to be available only only part of the time for the system to work properly, such as the MyDatamart tool presented in a separate chapter in this guide.</para>
+ <para>This approach might be problematic in cases where Internet connectivity is volatile or missing in long periods of time. DHIS2 however has certain features which requires Internet connectivity to be available only only part of the time for the system to work properly, such as offline data entry and the MyDatamart tool presented in a separate chapter in this guide, which cater to information flow in situations when Internet connectivity may be challenging.</para>
</section>
<section>
<title>Hybrid deployment</title>
@@ -275,7 +276,7 @@
</orderedlist>
<para>All of these aspects must be covered in order to create an appropriate hosting environment. The hardware requirement is deliberately put last since there is a clear tendency to give it too much attention.</para>
<para>Looking back at the three main hosting options, experience from implementation missions in developing countries suggests that all of the hosting aspects are rarely present in option one and two at a feasible level. Reaching an acceptable level in all these aspects is challenging in terms of both human resources and money, especially when compared to the cost of option three. It has the benefit that is accommodates the mentioned political aspects and building local capacity for server administration, on the other hand can this be provided for in alternative ways.</para>
- <para>Option three - external hosting - has the benefit that it supports all of the mentioned hosting aspects at a very affordable price. Several hosting providers - of virtual servers or software as a service - offer reliable services for running most kinds of applications. Example of such providers are Linode and Amazon Web Services. Administration of such servers happens over a network connection, which most often anyway is the case with local server administration. The physical location of the server in this case becomes irrelevant as that such providers offer services in most parts of the world. This solution is increasingly becoming the standard solution for hosting of application services. The aspect of building local capacity for server administration is compatible with this option since a local ICT team can be tasked with maintaining the externally hosted server.</para>
+ <para>Option three - external hosting - has the benefit that it supports all of the mentioned hosting aspects at a very affordable price. Several hosting providers - of virtual servers or software as a service - offer reliable services for running most kinds of applications. Example of such providers are <ulink url="http://www.linode.com";>Linode</ulink> and <ulink url="http://aws.amazon.com";>Amazon Web Services</ulink>. Administration of such servers happens over a network connection, which most often anyway is the case with local server administration. The physical location of the server in this case becomes irrelevant as that such providers offer services in most parts of the world. This solution is increasingly becoming the standard solution for hosting of application services. The aspect of building local capacity for server administration is compatible with this option since a local ICT team can be tasked with maintaining the externally hosted server, but with not being burdened with worrying about power supply and bandwidth constraints which usually exist outside of major data centres.</para>
<para>An approach for combining the benefits of external hosting with the need for local hosting and physical ownership is to use an external hosting provider for the primary transactional system, while mirroring this server to a locally hosted non-critical server which is used for read-only purposes such as data analysis and accessed over the intranet.</para>
</section>
</section>
