dhis2-devs team mailing list archive
-
dhis2-devs team
-
Mailing list archive
-
Message #18390
[Branch ~dhis2-documenters/dhis2/dhis2-docbook-docs] Rev 548: Update maintenance patient module.
------------------------------------------------------------
revno: 548
committer: Tran Chau <tran.hispvietnam@xxxxxxxxx>
branch nick: dhis2-docbook-docs
timestamp: Fri 2012-07-27 15:09:36 +0700
message:
Update maintenance patient module.
modified:
src/docbkx/en/dhis2_user_man_NBITS.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_NBITS.xml'
--- src/docbkx/en/dhis2_user_man_NBITS.xml 2012-07-26 10:15:24 +0000
+++ src/docbkx/en/dhis2_user_man_NBITS.xml 2012-07-27 08:09:36 +0000
@@ -25,13 +25,10 @@
<para>Reports for individual cases.</para>
</listitem>
<listitem>
- <para>Activity plans.</para>
- </listitem>
- <listitem>
<para>Linking data between tracker system and aggregate management system.</para>
</listitem>
</orderedlist>
- <para><emphasis role="bold">Advantages of tracker module:</emphasis></para>
+ <para><emphasis role="bold">Advantages of tracker module -</emphasis></para>
<orderedlist>
<listitem>
<para>Facilitate the health service provider in person's treatment follow-up by recording all treatment related information in one place and in effective monitoring of different health services and drill down to individual person information.</para>
@@ -99,13 +96,29 @@
</section>
<section>
<title>User guide</title>
- <para>The module has two basic modules as follows - </para>
+ <para>There are two additions in the module in both maintenance and services module - </para>
<orderedlist>
<listitem>
- <para>Maintenance module</para>
+ <para><emphasis role="italic">Persons and Programs maintenance module </emphasis>- Definition meta data, include person attributes, person attribute groups, identifier types, relationships, program and program-stages, validation for program and formula to generate aggregate data value.</para>
+ <para>When the ‘<emphasis role="italic">Persons and Programs</emphasis>’ options is chosen from the main <emphasis role="italic">Maintenance</emphasis> menu, the following screen appears -</para>
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata width="70%" fileref="resources/images/patients_programs/persons_and_programs_main_page.png" format="PNG"/>
+ </imageobject>
+ </mediaobject>
+ </screenshot>
</listitem>
<listitem>
- <para>Services module</para>
+ <para><emphasis role="italic">Individual records module</emphasis> - Support main functions for person registration, tracking information and individual reports.</para>
+ <para>When the ‘<emphasis role="italic">Individual Records</emphasis>’ options is chosen from the main <emphasis role="italic">Services</emphasis> menu, the following screen appears -</para>
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata width="70%" fileref="resources/images/patients_programs/individual_records_main_page.png" format="PNG"/>
+ </imageobject>
+ </mediaobject>
+ </screenshot>
</listitem>
</orderedlist>
<section>
@@ -122,8 +135,7 @@
</listitem>
<listitem>
<para>Person Identifier Type</para>
- <para>Create, modify and view Person identifier types. Any type and multiple identifiers can be registered.
-</para>
+ <para>Create, modify and view Person identifier types. Any type and multiple identifiers can be registered.</para>
</listitem>
<listitem>
<para>Relationship Type</para>
@@ -142,100 +154,44 @@
<para>Create, modify and view validation criteria. A criteria is used for validation of Person data. </para>
</listitem>
</itemizedlist>he options for the maintenance will be described in the following section - </para>
- <section>
+ <section id="patient_attribute">
<title>Person attribute</title>
- <section>
- <title>Creating and Editing person attributes</title>
- <para>From <emphasis role="italic">Maintenance</emphasis> menu, go to <emphasis role="italic">Persons and Programs</emphasis> option and click on it. Select <emphasis role="italic">Person Attribute</emphasis> option to create/editing a person attribute. </para>
- <screenshot>
- <screeninfo>Fig. 2.7.1.1.1</screeninfo>
- <mediaobject>
- <imageobject>
- <imagedata width="70%" fileref="resources/images/patients_programs/Fig. 2.7.1.1.1.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </screenshot>
- <para>After, click on <emphasis role="italic">Add</emphasis> button into <emphasis role="italic">Beneficiary Attribute Management</emphasis> window to go to <emphasis role="italic">Add New Beneficiary Attribute Management</emphasis> window.<screenshot>
- <screeninfo>Fig. 2.7.1.1.2</screeninfo>
- <mediaobject>
- <imageobject>
- <imagedata width="70%" fileref="resources/images/patients_programs/Fig. 2.7.1.1.2.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </screenshot><screenshot>
- <screeninfo>Fig. 2.7.1.1.3</screeninfo>
- <mediaobject>
- <imageobject>
- <imagedata width="70%" fileref="resources/images/patients_programs/Fig. 2.7.1.1.3.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </screenshot></para>
- <para>Basic information</para>
- <itemizedlist>
- <listitem>
- <para><emphasis role="italic">Name</emphasis>: Name of beneficiary attribute.</para>
- </listitem>
- <listitem>
- <para><emphasis role="italic">Description</emphasis>: Description of beneficiary attribute.</para>
- </listitem>
- <listitem>
- <para><emphasis role="italic">Mandatory</emphasis>: Entering value for this attribute is required or not.</para>
- </listitem>
- <listitem>
- <para><emphasis role="italic">Inheritable</emphasis>: </para>
- </listitem>
- <listitem>
- <para><emphasis role="italic">Number of characters</emphasis>: Maximum number of characters for value inputed.</para>
- </listitem>
- <listitem>
- <para><emphasis role="italic">Value Type</emphasis>: Data type of value inputed.</para>
- </listitem>
- </itemizedlist>
- </section>
- <section>
- <title>Define a beneficiary attribute group</title>
- <para>To access the beneficiary attribute group maintenance module, from <emphasis role="italic">Maintenance</emphasis> menu, go to <emphasis role="italic">Beneficiaries and Programs</emphasis> option and click on it. Select <emphasis role="italic">Beneficiary Attribute Group</emphasis> option to create a new an attribute group.</para>
- <screenshot>
- <screeninfo>Fig. 2.7.1.2.1</screeninfo>
- <mediaobject>
- <imageobject>
- <imagedata width="70%" fileref="resources/images/patients_programs/Fig. 2.7.1.2.1.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </screenshot>
- <para>To create a new attribute group, click the <emphasis role="italic">Add</emphasis> button into <emphasis role="italic">Beneficiary Attribute Group</emphasis> window to go to <emphasis role="italic">Add New Beneficiary Attribute Group</emphasis> window , click the <emphasis role="italic">Add new</emphasis> button. Fill in the <emphasis role="italic">Name</emphasis> and <emphasis role="italic">Description</emphasis> fields and then select attributes that should belong to the group from the left panel. </para>
- <para>Click the <emphasis role="italic">Move selected items</emphasis> button to add the selected attributes to the attribute group. Click the <emphasis role="italic">Remove selected items</emphasis> button to remove attributes from the group that have been selected in the right panel. </para>
- <para>Finally, click the <emphasis role="italic">Add</emphasis> button to save changes, or the <emphasis role="italic">Cancel</emphasis> button to discard any changes..</para>
- <screenshot>
- <screeninfo>Fig. 2.7.1.2.2</screeninfo>
- <mediaobject>
- <imageobject>
- <imagedata width="70%" fileref="resources/images/patients_programs/Fig. 2.7.1.2.2.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </screenshot>
- </section>
- </section>
- <section>
- <title>Define a beneficiary identifier type</title>
- <para>To access the beneficiary identifier type maintenance module, from <emphasis role="italic">Maintenance</emphasis> menu, go to <emphasis role="italic">Beneficiaries and Programs</emphasis> option and click on it. Select <emphasis role="italic">Beneficiary Identifier Type</emphasis> option to create a new identifier type.</para>
- <screenshot>
- <screeninfo>Fig. 2.7.2a</screeninfo>
- <mediaobject>
- <imageobject>
- <imagedata width="70%" fileref="resources/images/patients_programs/Fig. 2.7.2a.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </screenshot>
- <para>To creating a new identifier type, click the <emphasis role="italic">Add</emphasis> button into <emphasis role="italic">Beneficiary Identifier Type Management </emphasis>window to go to <emphasis role="italic">Add New Beneficiary Identifier Type</emphasis> window.</para>
- <screenshot>
- <screeninfo>Fig. 2.7.2b</screeninfo>
- <mediaobject>
- <imageobject>
- <imagedata width="70%" fileref="resources/images/patients_programs/Fig. 2.7.2b.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </screenshot>
+ <para>Create, modify and view person attributes. An attribute can be used to register extra information for a person.</para>
+ <para>From <emphasis role="italic">Maintenance</emphasis> menu, go to <emphasis role="italic">Persons and Programs</emphasis> option and click on it. Select <emphasis role="italic">Person Attribute</emphasis> option to create a new attribute for persons. </para>
+ <para>After, click on <emphasis role="italic">Add</emphasis> button into <emphasis role="italic">Person Attribute Management</emphasis> window to go to <emphasis role="italic">Add New Person Attribute Management</emphasis> window.</para>
+ <para>Basic information</para>
+ <itemizedlist>
+ <listitem>
+ <para><emphasis role="italic">Name</emphasis>: Name of person attribute.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="italic">Description</emphasis>: Description of person attribute.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="italic">Mandatory</emphasis>: Entering value for this attribute is required or not.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="italic">Inheritable</emphasis></para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="italic">Value Type</emphasis>: Data type of value inputed.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="italic">Program</emphasis>: Specify a program which this attribute belongs to.</para>
+ </listitem>
+ </itemizedlist>
+ </section>
+ <section id="patient_attribute_group">
+ <title>Person attribute group</title>
+ <para>To access the person attribute group maintenance module, from <emphasis role="italic">Maintenance</emphasis> menu, go to <emphasis role="italic">Persons and Programs</emphasis> option and click on it. Select <emphasis role="italic">Person Attribute Group</emphasis> option to create a new an attribute group.</para>
+ <para>To create a new attribute group, click the <emphasis role="italic">Add</emphasis> button into <emphasis role="italic">Person Attribute Group</emphasis> window to go to <emphasis role="italic">Add New Person Attribute Group</emphasis> window , click the <emphasis role="italic">Add new</emphasis> button. Fill in the <emphasis role="italic">Name</emphasis> and <emphasis role="italic">Description</emphasis> fields and then select attributes that should belong to the group from the left panel. </para>
+ <para>Click the <emphasis role="italic">Move selected items</emphasis> button to add the selected attributes to the attribute group. Click the <emphasis role="italic">Remove selected items</emphasis> button to remove attributes from the group that have been selected in the right panel. </para>
+ <para>Finally, click the <emphasis role="italic">Add</emphasis> button to save changes, or the <emphasis role="italic">Cancel</emphasis> button to discard any changes..</para>
+ </section>
+ <section id="patient_identifier_type">
+ <title>Person identifier type</title>
+ <para>To access the person identifier type maintenance module, from <emphasis role="italic">Maintenance</emphasis> menu, go to <emphasis role="italic">Persons and Programs</emphasis> option and click on it. Select <emphasis role="italic">Person Identifier Type</emphasis> option to create a new identifier type.</para>
+ <para>To creating a new identifier type, click the <emphasis role="italic">Add</emphasis> button into <emphasis role="italic">Person Identifier Type Management </emphasis>window to go to <emphasis role="italic">Add New Person Identifier Type</emphasis> window.</para>
<para>Basic information -</para>
<itemizedlist>
<listitem>
@@ -245,10 +201,10 @@
<para><emphasis role="italic">Description</emphasis>: Description of identifier type.</para>
</listitem>
<listitem>
- <para><emphasis role="italic">Mandatory</emphasis>: Entering value for the identifier is required or not.</para>
+ <para><emphasis role="italic">Mandatory</emphasis>: Entering value for the identifier is required or not.</para>
</listitem>
<listitem>
- <para><emphasis role="italic">Related</emphasis>: </para>
+ <para><emphasis role="italic">Related</emphasis></para>
</listitem>
<listitem>
<para><emphasis role="italic">Number of characters</emphasis>: Maximum number of characters for value inputed. </para>
@@ -256,12 +212,15 @@
<listitem>
<para><emphasis role="italic">Type</emphasis>: Data type of value inputted.</para>
</listitem>
+ <listitem>
+ <para><emphasis role="italic">Program</emphasis>: specify a program which the identyfier type belongs to.</para>
+ </listitem>
</itemizedlist>
</section>
- <section>
- <title>Define a relationship type</title>
- <para>Relationship type section provides a mechanism for defining any relationship types and link beneficiaries through these relationship types by creating specific relationships.</para>
- <para>To access the relationship type maintenance module, from <emphasis role="italic">Maintenance</emphasis> menu, go to <emphasis role="italic">Beneficiaries and Programs</emphasis> option and click on it. Select <emphasis role="italic">Relationship Type</emphasis> option to create a new relationship type.</para>
+ <section id="relationship_type">
+ <title>Relationship type</title>
+ <para>Relationship type section provides a mechanism for defining any relationship types and link persons through these relationship types by creating specific relationships.</para>
+ <para>To access the relationship type maintenance module, from <emphasis role="italic">Maintenance</emphasis> menu, go to <emphasis role="italic">Persons and Programs</emphasis> option and click on it. Select <emphasis role="italic">Relationship Type</emphasis> option to create a new relationship type.</para>
<screenshot>
<screeninfo>Fig. 2.7.3a</screeninfo>
<mediaobject>
@@ -270,7 +229,7 @@
</imageobject>
</mediaobject>
</screenshot>
- <para>To define a new relationship type, click <emphasis role="italic">Add</emphasis> button into <emphasis role="italic">Relationship Type Management </emphasis>window to go to <emphasis role="italic">Add new Relationship Type</emphasis> window.</para>
+ <para>To define a new relationship type, click <emphasis role="italic">Add</emphasis> button into <emphasis role="italic">Relationship Type Management </emphasis>window to go to <emphasis role="italic">Add new Relationship Type</emphasis> window.</para>
<screenshot>
<screeninfo>Fig 2.7.3b</screeninfo>
<mediaobject>
@@ -280,150 +239,64 @@
</mediaobject>
</screenshot>
</section>
- <section>
- <title>Beneficiary Registration</title>
- <para>Beneficiary registration section provides a mechanism for managing facilities which allow to registry new beneficiaries or not.</para>
- <para>To access the beneficiary registration maintenance module, from <emphasis role="italic">Maintenance</emphasis> menu, go to <emphasis role="italic">Beneficiaries and Programs</emphasis> option and click on it. Select <emphasis role="italic">Beneficiary Registration</emphasis> option to select facilities. </para>
- <screenshot>
- <screeninfo>Fig. 2.7.4</screeninfo>
- <mediaobject>
- <imageobject>
- <imagedata width="80%" fileref="resources/images/patients_programs/Fig. 2.7.4.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </screenshot>
- <warning>
- <para>There are two process for registering facilities. The first one is where the administrator will say which facility can register. The second is when end user logs in and then select a facility, system will display a waring message if the selected facility cannot register beneficiaries; else, the system will display the functions to register beneficiaries.</para>
- </warning>
- </section>
- <section>
- <title>Define a new program</title>
- <section>
- <title>Define a new program</title>
- <para>Program section provides a mechanism for defining a health program. All name based case entry is organised through the use of programs.
-
-</para>
- <para>To access the program maintenance module, from <emphasis role="italic">Maintenance</emphasis> menu, go to <emphasis role="italic">Beneficiaries and Programs</emphasis> option and click on it. Select <emphasis role="italic">Program</emphasis> option to create a new program.</para>
- <para>To create a new program, click the <emphasis role="italic">Add new</emphasis> button. Fill all fields with read asterisk, and then click the "Add" button.</para>
- <para><screenshot>
- <screeninfo>Figure 2.5.1.1</screeninfo>
- <mediaobject>
- <imageobject>
- <imagedata width="70%" fileref="resources/images/patients_programs/Fig. 2.5.1.1.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </screenshot></para>
- <para>Basic information :</para>
- <para><itemizedlist>
- <listitem>
- <para><emphasis role="italic">Name</emphasis>: The name of the program</para>
- </listitem>
- <listitem>
- <para><emphasis role="italic">Description</emphasis>: Descriptions, meanings, explanation, etc. of/about the program</para>
- </listitem>
- <listitem>
- <para><emphasis role="italic">Date of Enrolment Description</emphasis>: The date in which a beneficiary is registered to the system.
-For example: the date in which a beneficiary enrols to the system.</para>
- </listitem>
- <listitem>
- <para><emphasis role="italic">Date of Incidence Description</emphasis>: The date when the beneficiary got the disease or he/she has just been committed to an equivalent program for being followed-up. E.g. In the Immunization program for child under 1yr old, the incident date is the birthday; in the maternal program, the incident date is the date of last menstrual period (LMP).</para>
- </listitem>
- <listitem>
- <para><emphasis role="italic">Number of max days allowed to input data</emphasis>.</para>
- </listitem>
- </itemizedlist></para>
- </section>
- <section>
- <title>Define stages for a health program</title>
- <para>To define a program stage, click the <emphasis role="italic">Program Stage Management</emphasis> icon (Fig. 2.5.1.2a) and then <emphasis role="italic">Add new</emphasis> button (Fig. 2.5.1.2b). Fill in the <emphasis role="italic">Name</emphasis> and <emphasis role="italic">Description</emphasis> fields and then select the data elements that should belong to the group from the left panel. Click the <emphasis role="italic">Move selected</emphasis> button to add the selected data elements to the right panel. Click the <emphasis role="italic">Remove selected</emphasis> button to remove data elements that have been selected in the right panel. Finally, click the <emphasis role="italic">Add</emphasis> button to save changes, or the <emphasis role="italic">Cancel</emphasis> button to discard any changes.</para>
- <screenshot>
- <screeninfo>Figure 2.5.1.2a</screeninfo>
- <mediaobject>
- <imageobject>
- <imagedata width="70%" fileref="resources/images/patients_programs/Fig. 2.5.1.2a.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </screenshot>
- <screenshot>
- <screeninfo>Figure 2.5.1.2b</screeninfo>
- <mediaobject>
- <imageobject>
- <imagedata width="70%" fileref="resources/images/patients_programs/Fig. 2.5.1.2b.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </screenshot>
- <screenshot>
- <screeninfo>Figure 2.5.1.2c</screeninfo>
- <mediaobject>
- <imageobject>
- <imagedata width="70%" fileref="resources/images/patients_programs/Fig. 2.5.1.2c.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </screenshot>
- <para>Fig. 2.5.1.2c illustrates for stage named “<emphasis role="italic">Birth Details</emphasis>” of “<emphasis role="italic">Child Health</emphasis>” program.
-More explanation for the figure:</para>
- <para><emphasis role="bold">
- <emphasis role="italic">
- <emphasis role="italic">
- <emphasis role="underline">Area with blue frame labelled 1:</emphasis>
- </emphasis>
- </emphasis>
- </emphasis></para>
- <itemizedlist>
- <listitem>
- <para><emphasis role="italic">Name</emphasis>: Name of the stage</para>
- </listitem>
- <listitem>
- <para><emphasis role="italic">Description</emphasis>: The description of the stage</para>
- </listitem>
- <listitem>
- <para><emphasis role="italic">Min no of days to wait from start of Program</emphasis>: The minimum number of days to wait for starting the program</para>
- </listitem>
- <listitem>
- <para><emphasis role="italic">Program</emphasis>: The name of the program which is already defined before.</para>
- </listitem>
- </itemizedlist>
- <para><emphasis role="italic">
- <emphasis role="bold">
- <emphasis role="italic">
- <emphasis role="underline">Area with blue arrow and labelled 2:</emphasis>
- </emphasis>
- </emphasis>
- </emphasis></para>
- <para>Choose the data elements from the list on the left to the right one. These chosen elements are highlighted with BLUE color.</para>
- <para><emphasis role="italic">
- <emphasis role="bold">
- <emphasis role="italic">
- <emphasis role="underline">Area with blue arrow and labelled 3:</emphasis>
- </emphasis>
- </emphasis>
- </emphasis></para>
- <para>Function area with button labeled “<emphasis role="italic">Add</emphasis>”, see the arrow labelled 3 and in BLUE to execute the function.</para>
- <para>If successfully, the new stages will showed in the list of stages:</para>
- <screenshot>
- <screeninfo>Figure 2.5.1.2d</screeninfo>
- <mediaobject>
- <imageobject>
- <imagedata width="70%" fileref="resources/images/patients_programs/Fig. 2.5.1.2d.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </screenshot>
- <para>Your program will then be ready to be used to enroll beneficiaries (which are modified/created under <emphasis role="italic">Maintenance->Beneficiaries and Programs->Beneficiaries</emphasis>) and enter data under the data-entry function <emphasis role="italic">Services->Individual Records->Data Entry</emphasis> or <emphasis role="italic">Multiple Data. Entry</emphasis> for the facilities that you have assigned.</para>
- </section>
- <section>
- <title>Other functionalities</title>
- <para>You can assign the facilities to a program in the Program Management ( in which a list of available programs are shown) by clicking on the blue folder icon, which is the first icon under Operations, corresponding to the program you would like to modify.
-
-</para>
- <para>The function <emphasis role="italic">Define Program Validation</emphasis> is designed for defining validations of a program in which you would like to modify after entering patient data values for program stages.
-
-For instance, Parity, Previous live birth male, Previous live birth female, Previous still birth are patient data elements. They belong to many stages. And if data value of Parity is 0, then ( Previous live birth female + Previous still birth ) = 0. Besides, if a patient data element exists into many program stages, the system will check whether the values of the patient data element are in all program stages of the program or not.
-
-For instance, TT1 is a patient data element. It exists into program stages as follows Checkup 1, Checkup 2, Checkup 3. If the data value of this data element into Checkup 1 is null, the data values into Checkup 2, Checkup 3 should be null.</para>
- </section>
- </section>
- <section>
- <title>Person Aggregation Query Builder</title>
+ <section id="program">
+ <title>Program and Program stage</title>
+ <section>
+ <title>Program</title>
+ <para>Program section provides a mechanism for defining a health programme.</para>
+ <para>To access the program maintenance module, from <emphasis role="italic">Maintenance</emphasis> menu, go to <emphasis role="italic">Persons and Programs</emphasis> option and click on it. Select <emphasis role="italic">Program</emphasis> option.</para>
+ <para>To define a new program, click the <emphasis role="italic">Add new</emphasis> button on the main page. Fill all fields with read asterisk, and then click the "Add" button.</para>
+ <para>Basic information -</para>
+ <itemizedlist>
+ <listitem>
+ <para><emphasis role="italic">Name</emphasis>: The name of the program</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="italic">Description</emphasis>: Descriptions, meanings, explanation, etc. of/about the program.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="italic">Type</emphasis>: There are three type of program: multi events with registration, single event with registration and single event without registration.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="italic">Show provided elsewhere</emphasis>: Set show/hide status of provided elsewhere column in data entry form.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="italic">Description of enrollment date</emphasis>: The date in which a person is registered to the system.
+For example: the date in which a person enrolls to the system.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="italic">Description of incident date</emphasis>: The date when the person got the disease or he/she has just been committed to an equivalent program for being followed-up. E.g. In the Immunization program for child under 1yr old, the incident date is the birthday; in the maternal program, the incident date is the date of last menstrual period (LMP).</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="italic">Duration in days</emphasis>: System gets the days to calculate the activity plan of each person in mobile project ( refer mobile chapter ).</para>
+ </listitem>
+ </itemizedlist>
+ </section>
+ <section>
+ <title>Program stage</title>
+ <para>To define a program stage, click the <emphasis role="italic">Program Stage Management</emphasis> icon and then <emphasis role="italic">Add new</emphasis> button. Fill in the Name and Description fields and then select the data elements that should belong to the group from the left panel. Click the Move selected button to add the selected data elements to the right panel. Click the Remove selected button to remove data elements that have been selected in the right panel. Finally, click the Add button to save changes, or the Cancel button to discard any changes.</para>
+ <para>Basic information -</para>
+ <itemizedlist>
+ <listitem>
+ <para><emphasis role="italic">Name</emphasis>: Name of the program stage</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="italic">Description</emphasis>: The description of the program stage</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="italic">Scheduled days from start</emphasis>: The minimum number of days to wait for starting the program stage.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="italic">Repeatable</emphasis>: specify the program stage as repeatable or not.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="italic">Standard interval days</emphasis>: specify the number of days to repeat the repeatable program stage.</para>
+ </listitem>
+ </itemizedlist>
+ </section>
+ </section>
+ <section id="patient_aggregation_query_builder">
+ <title>Person aggregation query builder management</title>
<para>This is the core functionality for linking data between tracker module and aggregate management module by defining the linking/aggregating rules.</para>
<para>This provides two functions - </para>
<itemizedlist>
@@ -431,20 +304,12 @@
<para><emphasis role="italic">Person aggregation query builder management</emphasis> is a tool for defining formulas, expressions, rules for aggregation data from tracker to aggregation module.</para>
</listitem>
<listitem>
- <para><emphasis role="italic">Person aggregation</emphasis> is used for generating routine data values from individual data by period and organization unit.</para>
+ <para><emphasis role="italic">Person aggregation</emphasis> is used for generating routine data values from individual data by period and organization unit. Please refer the Service module to see this part.</para>
</listitem>
</itemizedlist>
<section>
- <title>Person aggregation query builder management</title>
+ <title>Person Aggregation Query Builder</title>
<para>To access <emphasis role="italic">Aggregation Query Builder</emphasis> module, from the <emphasis role="italic">Maintenance</emphasis> menu, go to the <emphasis role="italic">Persons and Programs</emphasis> option. Select <emphasis role="italic">Aggregation Query Builder</emphasis> option on left menu to proceed.</para>
- <screenshot>
- <screeninfo>Figure 2.5.4.2</screeninfo>
- <mediaobject>
- <imageobject>
- <imagedata width="70%" fileref="resources/images/patients_programs/Fig. 2.5.4.2.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </screenshot>
<para>After click the <emphasis role="italic">Add new</emphasis> button, the following will appear:</para>
<screenshot>
<screeninfo>Figure 2.5.4.3</screeninfo>
@@ -454,23 +319,30 @@
</imageobject>
</mediaobject>
</screenshot>
- <para><emphasis role="bold">
- <emphasis role="underline">Name:</emphasis>
- </emphasis> Provide name of query, this name is usually same with the name of aggregate data element. For example Number of mothers got VAT, Number of children got BCG vaccine,...</para>
- <para><emphasis role="bold">
- <emphasis role="underline">
- <emphasis role="underline">Dataset:</emphasis>
- </emphasis>
- </emphasis> Select dataset contains data elements which will be used to link with individual data.</para>
- <para><emphasis role="bold">
- <emphasis role="underline">Data element: </emphasis>
- </emphasis>Select aggregate data element which will be used to link with individual data.</para>
- <para><emphasis role="bold"><emphasis role="underline">Operator</emphasis>:</emphasis> Select Number of persons if aggregate based on persons, or Number of visits if aggregate data based on times that persons received services.</para>
- <para><emphasis role="bold"><emphasis role="underline">Program</emphasis>: </emphasis>Select program needed for aggregation.</para>
- <para><emphasis role="bold"><emphasis role="underline">Program Stage</emphasis>: </emphasis>Select program stage from the selected program above.</para>
+ <para>Basic information -</para>
+ <itemizedlist>
+ <listitem>
+ <para><emphasis role="italic">Name</emphasis>: Provide name of query, this name is usually same with the name of aggregate data element. For example Number of mothers got VAT, Number of children got BCG vaccine,...</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="italic">Dataset</emphasis>: Select dataset contains data elements which will be used to link with individual data.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="italic">Data element</emphasis>: Select aggregate data element which will be used to link with individual data.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="italic">Operator</emphasis>: Select <emphasis role="italic">Number of persons</emphasis> if aggregate based on persons, or <emphasis role="italic">Number of visits</emphasis> if aggregate data based on times that persons received services.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="italic">Program</emphasis>: Select program needed for aggregation.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="italic">Program Stage</emphasis>: Select program stage from the selected program above.</para>
+ </listitem>
+ </itemizedlist>
<para>Next section included 3 tabs: <emphasis role="italic">Data elements</emphasis>, <emphasis role="italic">Person attributes</emphasis> and <emphasis role="italic">Program</emphasis>. Depend on the requirement of data aggregation, data element, person attributes, and number of programs are selected. </para>
<para><emphasis role="bold">
- <emphasis role="underline">Data elements tab:</emphasis>
+ <emphasis role="underline"><emphasis role="italic">Data elements tab</emphasis>:</emphasis>
</emphasis> List all available data elements from selected program stage. To create a formula related to each data element, double click on the data element. The formula of the data element is filled on the condition field, like [DE:1.2.3], in with: </para>
<para><itemizedlist>
<listitem>
@@ -487,10 +359,10 @@
<para>The formula can be create without any program stage, like [DE:1.*.3]</para>
</note>
<para><emphasis role="bold">
- <emphasis role="underline">Person attribute tab: </emphasis>
+ <emphasis role="underline"><emphasis role="italic">Person attribute tab</emphasis>: </emphasis>
</emphasis>List all available fixed attributes, such as gender, DOB type, Age(days), .. and user-defined attributes. Besides, provide a formula for calculating number of persons who registered in system. However, if a program without registration is selected, person attributes aren't shown.</para>
<para><emphasis role="bold">
- <emphasis role="underline">Program tab:</emphasis>
+ <emphasis role="underline"><emphasis role="italic">Program tab</emphasis>:</emphasis>
</emphasis> Provide formulas for calculating data value related to the selected program and program stage - </para>
<para><itemizedlist>
<listitem>
@@ -572,7 +444,6 @@
<listitem>
<para>From <emphasis role="italic">Services</emphasis> menu, go to <emphasis role="italic">Individual Records</emphasis> option and click on it. Select <emphasis role="italic">Person aggregation</emphasis> option to run<emphasis role="italic"> Number of children - BCG Builder</emphasis> to get data value and save it into database.</para>
<screenshot>
- <screeninfo>Figure 2.5.3.5</screeninfo>
<mediaobject>
<imageobject>
<imagedata width="70%" fileref="resources/images/patients_programs/example person aggregation.png" format="PNG"/>
@@ -580,7 +451,7 @@
</mediaobject>
</screenshot>
<screenshot>
- <screeninfo>Figure 2.5.4.6 - Result after running the query builder</screeninfo>
+ <screeninfo>- Result after running the query builder</screeninfo>
<mediaobject>
<imageobject>
<imagedata width="70%" fileref="resources/images/patients_programs/example_person_aggregation_result.png" format="PNG"/>
@@ -591,60 +462,50 @@
</orderedlist></para>
</section>
</section>
- <section>
- <title>Define validation criteria</title>
- <para>Validation criteria section provide a mechanism for defining criteria for beneficiaries when enrolling a program.
-
-</para>
- <para>To access the validation criteria maintenance module, from <emphasis role="italic">Maintenance</emphasis> menu, go to <emphasis role="italic">Beneficiaries and Programs</emphasis> option and click on it. Select <emphasis role="italic">Validation Criteria</emphasis> option to create a new program</para>
- <para>To create a new validation criterion, click the <emphasis role="italic">Add new</emphasis> button. Fill all fields with read asterisk, and click <emphasis role="italic">Add</emphasis> button.
-
-</para>
- <screenshot>
- <screeninfo/>
- <mediaobject>
- <imageobject>
- <imagedata width="80%" fileref="resources/images/patients_programs/Fig. 2.6.6.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </screenshot>
+ <section id="validation_criteria">
+ <title>Validation criteria</title>
+ <para>Validation criteria section provide a mechanism for defining criteria for persons when enrolling a program.</para>
+ <para>To access the validation criteria maintenance module, from <emphasis role="italic">Maintenance</emphasis> menu, go to <emphasis role="italic">Persons and Programs</emphasis> option and click on it. Select <emphasis role="italic">Validation Criteria</emphasis> option to create a new program</para>
+ <para>To create a new validation criterion, click the <emphasis role="italic">Add new</emphasis> button. Fill all fields with read asterisk, and click <emphasis role="italic">Add</emphasis> button.</para>
<para>You can assign facilities to a validation criterion in the <emphasis role="italic">Validation Criteria Management </emphasis>(list of available validation criteria are shown) by clicking the blue folder icon, the first icon under Operations, corresponding to the validation criterion you would like to assign. Click the <emphasis role="italic">Move selected</emphasis> button to add the selected programs to the validation criterion. Click the <emphasis role="italic">Remove selected</emphasis> button to remove programs from the group that have been selected in the right panel. Finally, click the <emphasis role="italic">Save</emphasis> button to save changes, or the <emphasis role="italic">Cancel</emphasis> button to discard any changes.</para>
</section>
</section>
<section>
<title>Individual records module</title>
- <section>
- <title>Functionalities</title>
- <para>There are two additions in the module in both maintenance and services module. <emphasis role="italic">Maintenance</emphasis> module has one additional sub module for defining meta data and <emphasis role="italic">Services</emphasis> module has one additional sub-module for individual data entry and reports.</para>
- <para>The modules provide three main functionalities -</para>
- <orderedlist>
- <listitem>
- <para>Definition meta data, include person attributes, person attribute groups, identifier types, relationships, program and program-stages, validation for program and formula to generate aggregate data value.</para>
- </listitem>
- <listitem>
- <para>Person registration and Tracking information.</para>
- </listitem>
- <listitem>
- <para>Reports</para>
- </listitem>
- </orderedlist>
- <para>When the ‘<emphasis role="italic">Persons and Programs</emphasis>’ options is chosen from the main <emphasis role="italic">Maintenance</emphasis> menu, the following screen appears -</para>
- <screenshot>
- <mediaobject>
- <imageobject>
- <imagedata width="70%" fileref="resources/images/patients_programs/persons_and_programs_main_page.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </screenshot>
- <para>When the ‘<emphasis role="italic">Individual Records</emphasis>’ options is chosen from the main <emphasis role="italic">Services</emphasis> menu, the following screen appears -</para>
- <screenshot>
- <mediaobject>
- <imageobject>
- <imagedata width="70%" fileref="resources/images/patients_programs/individual_records_main_page.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </screenshot>
- </section>
+ <para>The content in this part is for the expert users or administrative users who are capable and responsible for development and change.</para>
+ <para>Each of the options for the maintenance will be described in the following section.</para>
+ <itemizedlist>
+ <listitem>
+ <para>Person</para>
+ <para>Create, modify and search for persons. Any type of data can be registered for a person by including attributes.
+ </para>
+ </listitem>
+ <listitem>
+ <para>Multiple Individual records</para>
+ <para>Enter data for multiple program stages and persons for a program. The entry screen gives an overview of the stage status.
+ </para>
+ </listitem>
+ <listitem>
+ <para>Single event with registration </para>
+ <para>Register Single events without registration. The data to register is defined by a single event without registration program.
+ </para>
+ </listitem>
+ <listitem>
+ <para>Program summary</para>
+ <para>View the summary report to get an overview of the services provided for a program.
+ </para>
+ </listitem>
+ <listitem>
+ <para>Tabular report</para>
+ <para>Use an interactive reporting tool for tracker-data using tabular presentation with dynamic filters for each person attribute/data element.
+ </para>
+ </listitem>
+ <listitem>
+ <para>Person aggregation</para>
+ <para>Generate routine data values from patient data by month (or other intervals if desired) and organisation unit.
+</para>
+ </listitem>
+ </itemizedlist>
<section id="patient">
<title>Person registration</title>
<para>The first step in the tracking is the registration of person/case in the application. In the registration process, the details - which are related to the personal information, identification, contract and location details & health provider details, are entered in the application. In the registration itself, person is provided with the unique identification number. This number will be unique and will not match with the identification number of any person in the state jurisdiction. The issue of identification number will be the responsibility of facility where person is registered first time.</para>
@@ -759,7 +620,6 @@
</section>
<section>
<title>Data entry</title>
- <para/>
<section id="multiple_individual_records">
<title>Multiple individual records</title>
<para>The multiple individual records function is where individual data is manually registered in the DHIS database. A list events for each person who enrolled into the selected program after clicking a multi events with registration.</para>
@@ -855,8 +715,8 @@
<title>Tabular report</title>
</section>
</section>
- <section>
- <title>Person Aggregation</title>
+ <section id="run_case_aggregation">
+ <title>Person aggregation</title>
<para><emphasis role="italic">Person Aggregation</emphasis> module is used for aggregating individual data and import into aggregated data element. To open <emphasis>Person Aggregation</emphasis> module, from the <emphasis role="italic">Services</emphasis> menu, go to the <emphasis role="italic">Individual Records</emphasis> option. Select <emphasis role="italic">Person Aggregation</emphasis> option on left menu. <emphasis>Person Aggregation form</emphasis> is opened as below -</para>
<screenshot>
<screeninfo>Figure 2.5.4.4</screeninfo>
@@ -867,24 +727,24 @@
</mediaobject>
</screenshot>
<para>In the <emphasis>Person aggregation form</emphasis> above</para>
- <para><itemizedlist>
- <listitem>
- <para>Select <emphasis role="italic">dataset</emphasis> from Dataset List to get aggregate values. Note that only datasets which were assigned to at least one organisation unit will be shown in this list.</para>
- </listitem>
- <listitem>
- <para>Depend on frequency of the selected dataset, select <emphasis role="italic">period</emphasis> to get aggregate data. For example, if frequency of dataset is quarterly, then select begin quarter and end quarter. To select a particular quarter, then begin quarter and end quarter is the same particular quarter name.</para>
- </listitem>
- <listitem>
- <para>Select <emphasis role="italic">organisation unit level</emphasis> where person data will be select to aggregate. There are 3 options - </para>
- <para>- <emphasis role="italic">Children only</emphasis>: Individual data from the children of the selected organisation unit will be aggregated.</para>
- <para>- <emphasis role="italic"> Selected</emphasis>: Individual data from the selected organisation unit will be aggregated. </para>
- <para>- <emphasis role="italic">All</emphasis>: Individual data from both selected organisation unit and its children will be aggregated.</para>
- </listitem>
- <listitem>
- <para>Click on the
+ <orderedlist>
+ <listitem>
+ <para>Select <emphasis role="italic">dataset</emphasis> from Dataset List to get aggregate values. Note that only datasets which were assigned to at least one organisation unit will be shown in this list.</para>
+ </listitem>
+ <listitem>
+ <para>Depend on frequency of the selected dataset, select <emphasis role="italic">period</emphasis> to get aggregate data. For example, if frequency of dataset is quarterly, then select begin quarter and end quarter. To select a particular quarter, then begin quarter and end quarter is the same particular quarter name.</para>
+ </listitem>
+ <listitem>
+ <para>Select <emphasis role="italic">organisation unit level</emphasis> where person data will be select to aggregate. There are 3 options - </para>
+ <para>- <emphasis role="italic">Children only</emphasis>: Individual data from the children of the selected organisation unit will be aggregated.</para>
+ <para>- <emphasis role="italic"> Selected</emphasis>: Individual data from the selected organisation unit will be aggregated. </para>
+ <para>- <emphasis role="italic">All</emphasis>: Individual data from both selected organisation unit and its children will be aggregated.</para>
+ </listitem>
+ <listitem>
+ <para>Click on the
<emphasis role="italic">Aggregate</emphasis> button to execute aggregate function. The <emphasis>Person aggregation result</emphasis>page is opened as below figure -</para>
- </listitem>
- </itemizedlist></para>
+ </listitem>
+ </orderedlist>
<screenshot>
<screeninfo>Figure - Person aggregation result</screeninfo>
<mediaobject>
@@ -893,17 +753,18 @@
</imageobject>
</mediaobject>
</screenshot>
- <para>In <emphasis>Person aggregation result</emphasis> page -<itemizedlist>
- <listitem>
- <para>Click <emphasis role="italic">Save all values</emphasis> button to save all aggregated data values .</para>
- </listitem>
- <listitem>
- <para>Click<emphasis role="italic"> orange arrow</emphasis> next to period name for showing list of aggregated data values at this period. Select only necessary data values and click <emphasis role="italic">Save</emphasis> selected values to save them</para>
- </listitem>
- <listitem>
- <para>Click <emphasis>Show details</emphasis> icon to view detail information which aggregated.</para>
- </listitem>
- </itemizedlist></para>
+ <para>In <emphasis>Person aggregation result</emphasis> page -</para>
+ <itemizedlist>
+ <listitem>
+ <para>Click <emphasis role="italic">Save all values</emphasis> button to save all aggregated data values .</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="italic"><emphasis role="italic">Click</emphasis> Orange arrow</emphasis> next to period name for showing list of aggregated data values at this period. Select only necessary data values and click <emphasis role="italic">Save</emphasis> selected values to save them</para>
+ </listitem>
+ <listitem>
+ <para><emphasis><emphasis role="italic">Click </emphasis>Show details</emphasis> icon to view detail information which aggregated.</para>
+ </listitem>
+ </itemizedlist>
</section>
</section>
</section>
