dhis2-devs team mailing list archive
-
dhis2-devs team
-
Mailing list archive
-
Message #21041
[Branch ~dhis2-documenters/dhis2/dhis2-docbook-docs] Rev 648: Update tracker document (WIP).
------------------------------------------------------------
revno: 648
committer: Tran Chau <tran.hispvietnam@xxxxxxxxx>
branch nick: dhis2-docbook-docs
timestamp: Thu 2013-02-21 12:06:12 +0700
message:
Update tracker document (WIP).
removed:
src/docbkx/en/resources/images/patients_programs/example_agg_query_builder.png
src/docbkx/en/resources/images/patients_programs/scheduling_aggregation_query_builder.png
modified:
src/docbkx/en/dhis2_user_man_persons_and_programs.xml
src/docbkx/en/resources/images/patients_programs/example_query.png
src/docbkx/en/resources/images/patients_programs/individual_records_main_page.png
src/docbkx/en/resources/images/patients_programs/person_dashboard.png
src/docbkx/en/resources/images/patients_programs/persons_and_programs_main_page.png
--
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_persons_and_programs.xml'
--- src/docbkx/en/dhis2_user_man_persons_and_programs.xml 2012-11-02 16:15:51 +0000
+++ src/docbkx/en/dhis2_user_man_persons_and_programs.xml 2013-02-21 05:06:12 +0000
@@ -13,7 +13,7 @@
<para>The following are the major things:</para>
<orderedlist>
<listitem>
- <para>Administrating meta data - includes person attributes, person attribute groups, identifier types; relationship types, health programs, program stages corresponding to the program, validations and formulas for aggregating data value from individual cases.</para>
+ <para>Administrating meta data - includes person attributes, person attribute groups, identifier types; relationship types, person registration form, health programs, program stages corresponding to the program, validations and formulas for aggregating data value from individual cases.</para>
</listitem>
<listitem>
<para>Administrating person registration - registering a new person, setting relationships, enrolling a person into a program and management of person location</para>
@@ -28,7 +28,7 @@
<para>Linking data between tracker system and aggregate management system.</para>
</listitem>
<listitem>
- <para>Provides a list of upcoming visits to better plan for daily/weekly activities at a facility or in an area. </para>
+ <para>Provide a list of upcoming visits to better plan for daily/weekly/monthly activities at a facility or in an area. </para>
</listitem>
<listitem>
<para>Support the work practices around tracking persons within a health program.</para>
@@ -137,6 +137,10 @@
<para>Create, modify and view relationship types. A relationship is typically wife and husband or mother and child.</para>
</listitem>
<listitem>
+ <para>Person Registration Form</para>
+ <para>Define custom person registration form.</para>
+ </listitem>
+ <listitem>
<para>Program</para>
<para>Create, modify and view programs. A program has program stages and defines which actions should be taken at each stage.</para>
</listitem>
@@ -178,13 +182,14 @@
</para>
</listitem>
<listitem>
- <para><emphasis role="italic">Value Type</emphasis> - Data type of value inputed. In addition to supporting basic data such as <emphasis role="italic">Number</emphasis>, <emphasis role="italic">Text</emphasis>, <emphasis role="italic">Yes/No</emphasis>, <emphasis role="italic">Date</emphasis>, the system support a value type as <emphasis role="italic">Predefined value</emphasis> for defining attribute values. Users only can select on value in the defined list for each person registered. E.g code values which record the information on access to HIV prevention services can be pre-defined, include <emphasis role="italic">T</emphasis>, <emphasis role="italic">TR</emphasis>, <emphasis role="italic">TRR</emphasis>, <emphasis role="italic">TRRD</emphasis>, <emphasis role="italic">TRRDm</emphasis>, <emphasis role="italic">TRRDmDb</emphasis> as <emphasis role="italic">PMTCT Code</emphasis> attribute.</para>
+ <para><emphasis role="italic">Value Type</emphasis> - Data type of value inputed. In addition to supporting basic data such as <emphasis role="italic">Number</emphasis>, <emphasis role="italic">Text</emphasis>, <emphasis role="italic">Yes/No</emphasis>, <emphasis role="italic">Date</emphasis>, the system supports a value type as <emphasis role="italic">Predefined value</emphasis> for defining attribute values. Users only can select on value in the defined list for each person registered. E.g code values which record the information on access to HIV prevention services can be pre-defined, include <emphasis role="italic">T</emphasis>, <emphasis role="italic">TR</emphasis>, <emphasis role="italic">TRR</emphasis>, <emphasis role="italic">TRRD</emphasis>, <emphasis role="italic">TRRDm</emphasis>, <emphasis role="italic">TRRDmDb</emphasis> as <emphasis role="italic">PMTCT Code</emphasis> attribute.</para>
+ <para>The system also supports a value type as <emphasis role="italic">Calculated</emphasis> for calculating a number based on other attribute values, e,g. caculate gestational age, EDD, ... in Mother care program.</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 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 and select <emphasis role="italic">Person Attribute Group</emphasis> option.</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.The created attribute members will be displayed by the attribute groups into person registration form.</para>
@@ -219,9 +224,16 @@
<section id="relationship_type">
<title>Relationship type</title>
<para>Relationship type section provides a mechanism for defining 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>
+ <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 and select <emphasis role="italic">Relationship Type</emphasis> option.</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>
</section>
+ <section id="person_registration_form">
+ <title>Person Registration Form</title>
+ <para>Person registration form section provides a mechanism for defining custom registration form for each available program in system or for normal registration form.</para>
+ <para>To access the person registration form maintenance module, from <emphasis role="italic">Maintenance</emphasis> menu, go to <emphasis role="italic">Persons and Programs</emphasis> option and click on it and select <emphasis role="italic">Person Registration Form</emphasis> option.</para>
+ <para>To define a custom program registration form, please select a program in list and click <emphasis role="italic">Add</emphasis> button.</para>
+ <para>To define a normal registration form, please don't select any program in list and click <emphasis role="italic">Add</emphasis> button.</para>
+ </section>
<section id="program">
<title>Program and Program stage</title>
<para>The section provides a mechanism for defining health programmes and action for each stage of the programme. </para>
@@ -230,6 +242,7 @@
<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 <emphasis role="italic">Add</emphasis> button.</para>
<para>Basic information -</para>
+ <para><emphasis role="italic">Program details<emphasis role="italic"> section</emphasis></emphasis> - </para>
<itemizedlist>
<listitem>
<para><emphasis role="italic">Name</emphasis> - The name of the program</para>
@@ -240,13 +253,25 @@
<listitem>
<para><emphasis role="italic">Type</emphasis> - There are three types of program: multi events with registration, single event with registration and single event without registration.</para>
</listitem>
- <listitem>
- <para><emphasis role="italic">Events generated by enrollment date</emphasis> - Check on it for auto-generating due dates of events from program-stages of this program based on the enrollment date. If it is not checked, the due dates are generated based on incident date.</para>
- </listitem>
+ </itemizedlist>
+ <para><emphasis role="italic">Form details </emphasis>section - </para>
+ <itemizedlist>
<listitem>
<para><emphasis role="italic">Show provided elsewhere</emphasis> - Set show/hide provided elsewhere column in data entry form.</para>
</listitem>
<listitem>
+ <para><emphasis role="italic">Block entry form after completed</emphasis> - Check on it for blocking entry form after completed. The data values in the entry form cannot be changed until the status of the event is reset as incomplete.</para>
+ </listitem>
+ </itemizedlist>
+ <para><emphasis role="italic">Enrollment details</emphasis> section - </para>
+ <itemizedlist>
+ <listitem>
+ <para><emphasis role="italic">Generate events by enrollment date</emphasis> - Check on it for auto-generating due dates of events from program-stages of this program based on the enrollment date. If it is not checked, the due dates are generated based on incident date.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="italic">Ignore to generate overdue events</emphasis> - When a person enrolls into the program, the events corresponding to the program-stages are created. If this field is checked, the system will ignore to generate overdue events. </para>
+ </listitem>
+ <listitem>
<para><emphasis role="italic">Show incident date</emphasis> - Set show/hide incident date field when a person enroll in this program.</para>
</listitem>
<listitem>
@@ -261,90 +286,28 @@
</listitem>
</itemizedlist>
<para>To assign a program for organisation units, click<emphasis role="italic"> Assign program to organisation units</emphasis> icon, the first icon under Operations, corresponding to the program you would like and select organisation units where provide the program.</para>
- <para>To create validation rules for programs, click <emphasis role="italic">Program validation rule management</emphasis> icon, the second icon under Operations, corresponding to the program you would like. There are two types of validation rules - </para>
+ <para>To set authority for sharing the program, click Sharing Settings icon, the second icon under Operations, corresponding to the program you would like. You can see a default authority and <emphasis role="italic">Public Access</emphasis> in the form with three authorities as follows -</para>
<itemizedlist>
<listitem>
- <para><emphasis role="italic">Single validation rule</emphasis> is used for defining validation for only one condition. E.g Weight must be greater then zero, or the date of admission is before the date of discharge. To define a validation, click <emphasis role="italic">Add single rule</emphasis> button and enter values for the fields in form.</para>
- <orderedlist>
- <listitem>
- <para>Enter <emphasis role="italic">description</emphasis> of program validation rule. </para>
- </listitem>
- <listitem>
- <para><emphasis role="italic"><emphasis role="italic">In</emphasis> Validation</emphasis> section, select an program stage in list to load data elements belong to the selected stage the field below. </para>
- </listitem>
- <listitem>
- <para>Double-click on a data element in list, a formula text of the selected data element is created and displayed into the condition area. </para>
- </listitem>
- <listitem>
- <para>Click the comparing operations (+, <, <=, >, >=, =, !=, !=NULL ) below to set operation for the formula.</para>
- </listitem>
- <listitem>
- <para>Click <emphasis role="italic">Add</emphasis> button to add the new validation rule.</para>
- </listitem>
- </orderedlist>
- <screenshot>
- <mediaobject>
- <imageobject>
- <imagedata width="50%" fileref="resources/images/patients_programs/single_program_validation.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </screenshot>
- </listitem>
- <listitem>
- <para><emphasis role="italic">Multiple validation rule </emphasis>is used for defining validation for two conditions. E.g in PMTCT program, if the blood test result of a pregnant is HIV positive, the pregnant must test WHO Stage/CD4. To define a validation, click <emphasis role="italic">Add multi rule</emphasis> button. The form is have two part - left side and right side. Fill values for the fields in each part is the same <emphasis role="italic">Single validation rule</emphasis> function.</para>
- <screenshot>
- <mediaobject>
- <imageobject>
- <imagedata width="70%" fileref="resources/images/patients_programs/multi_program_validation.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </screenshot>
+ <para><emphasis role="italic">None</emphasis> - The program is private one. Just the user who created it can see and use it.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="italic">Read Only </emphasis>- The user who are not owner of this program only can see it, not edit and delete it. </para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="italic">Read and Write</emphasis> - All users can edit and delete it.</para>
</listitem>
</itemizedlist>
- <note>
- <para>Validation rules for DATE date elements are created for a program automatically. It's used for defining formulas related the DATE data elements of each program stage. To define this validation rule, click <emphasis role="italic">Edit</emphasis> icon of <emphasis role="italic">Validation for date date elements</emphasis>. Select a program stage, the DATE data elements will be shown with corresponding conditions as follows -</para>
- <itemizedlist>
- <listitem>
- <para>Before current date</para>
- </listitem>
- <listitem>
- <para>After current date</para>
- </listitem>
- <listitem>
- <para>Before or equals to current date</para>
- </listitem>
- <listitem>
- <para>After or equals to current date</para>
- </listitem>
- <listitem>
- <para>Before due-date</para>
- </listitem>
- <listitem>
- <para>After due-date</para>
- </listitem>
- <listitem>
- <para>Before or equals to due-date</para>
- </listitem>
- <listitem>
- <para>After or equals to due-date</para>
- </listitem>
- <listitem>
- <para>In range due date</para>
- </listitem>
- </itemizedlist>
- </note>
- <screenshot>
- <mediaobject>
- <imageobject>
- <imagedata width="70%" fileref="resources/images/patients_programs/program_validation_for_date.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </screenshot>
+ <para>Besides, you can search user groups by typing a key in text field to set authorities. The result will loaded and you can select the group you want. Then click (+) button and the selected one will be displayed in below.</para>
+ <para>To assign a program for user roles, click <emphasis role="italic">Assign program to userroles</emphasis> icon, the third icon under Operations, corresponding to the program you would like. Please select user role which you want in <emphasis role="italic">Available</emphasis> section and click <emphasis role="italic">Move selected items</emphasis> button or double click on the user role to move to <emphasis role="italic">Selected</emphasis> section. Finally, click <emphasis role="italic">Ok</emphasis> to finish.</para>
+ <para>To create validation rules for programs, click <emphasis role="italic">Program validation rule management</emphasis> icon, the forth icon under Operations, corresponding to the program you would like. Then click <emphasis role="italic">Add</emphasis> button and enter values for the fields in form to create a new one. A validation rule is based on an expression which defines a relationship between data element values. The expression has a left side and a right side and an operator which defines whether the former must be less than, equal to or greater than the latter. The expression forms a condition which should assert that certain logical criteria are met. For instance, a validation rule could assert that an admitted date given is before the discharged date. </para>
+ <para>To translate the name of a program, click <emphasis role="italic">Translation</emphasis> icon, the sixth icon under Operations, corresponding to the program you would like.</para>
</section>
<section>
<title>Program stage</title>
- <para>To define a program stage, click the <emphasis role="italic">Program Stage Management</emphasis> icon, the forth icon under Operations, corresponding to the program you would like and then <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 the data elements that should belong to the group from the left panel. Click the <emphasis role="italic">Move</emphasis> 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 <emphasis role="italic">Add</emphasis> button to save changes, or the <emphasis role="italic">Cancel</emphasis> button to discard any changes.</para>
+ <para>To define a program stage, click the <emphasis role="italic">Program Stage Management</emphasis> icon, the seventh icon under Operations, corresponding to the program you would like and then <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 the data elements that should belong to the group from the left panel. Click the <emphasis role="italic">Move</emphasis> 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 <emphasis role="italic">Add</emphasis> button to save changes, or the <emphasis role="italic">Cancel</emphasis> button to discard any changes.</para>
<para>Basic information -</para>
+ <para><emphasis role="italic">Program stage details</emphasis> section - </para>
<itemizedlist>
<listitem>
<para><emphasis role="italic">Name</emphasis> - Name of the program stage</para>
@@ -353,34 +316,44 @@
<para><emphasis role="italic">Description</emphasis> - The description of the program stage</para>
</listitem>
<listitem>
- <para><emphasis role="italic">Description of report date</emphasis> - The description for report date which is displayed in case entry form.</para>
+ <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">Auto-generate event</emphasis> - Un-check this to prevent for creating an event of this program stage automatically when a person enroll into the program.</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>
+ </itemizedlist>
+ <para><emphasis role="italic">Repeatable program stage details</emphasis> section - </para>
+ <itemizedlist>
<listitem>
<para><emphasis role="italic">Repeatable</emphasis> - specify the program stage as repeatable or not.</para>
</listitem>
<listitem>
+ <para><emphasis role="italic">Display generate event box after completed</emphasis> - Un-check on it if you don't want to display <emphasis role="italic">Create new event box </emphasis>to create new event for a repeatable stage after clicking <emphasis role="italic">Complete</emphasis> button for an event of the stage in data entry form. This field is checked as default.</para>
+ </listitem>
+ <listitem>
<para><emphasis role="italic">Standard interval days</emphasis> - Specify the number of days to repeat the repeatable program stage.</para>
</listitem>
- <listitem>
- <para><emphasis role="italic">Data elements <emphasis role="italic">section</emphasis></emphasis> - Select person data elements which belong to the program stage</para>
- </listitem>
- <listitem>
- <para><emphasis role="italic">Template reminder message<emphasis role="italic"> section</emphasis></emphasis> - Define template reminder messages which are used for sending messages for person automatically. There are two params -</para>
- <para><emphasis role="italic">1) Days before/after due date</emphasis> - Enter a positive number of days if sending process happens after due-date of events which are generated from this program stage. Enter a negative number of days if sending process happens before due-date of events.</para>
- <para><emphasis role="italic">2) Parameters</emphasis> - Provide parameters which are used for generating a message for each person. The parameters include person's first name, program's name, program stage's name, due date of event, interval between current date and due date and organisation unit's name. </para>
- <para>Double-click on an option to insert it into template message field below.</para>
- <para><emphasis role="italic">3) Message</emphasis> - Content of template message. E.g Dear {patient-name}, please come to your appointment at {due-date}.</para>
- <note>
- <para>Click <emphasis role="italic">Add more... </emphasis>button to add more template reminder messages.</para>
- </note>
- </listitem>
- </itemizedlist>
+ </itemizedlist>
+ <para><emphasis role="italic">Form details</emphasis> section - </para>
+ <itemizedlist>
+ <listitem>
+ <para><emphasis role="italic">Complete allowed only if validation passes</emphasis> - The event created by this program stage is completed if all validation rules are passed.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="italic">Description of report date</emphasis> - The description for report date which is displayed in case entry form.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="italic">Data elements <emphasis role="italic">section</emphasis></emphasis> - Select person data elements which belong to the program stage. We have three options for each selected data element. The first one is <emphasis role="italic">Compulsory</emphasis> option. Please check it if the data value of the selected one is compulsory. The second one is <emphasis role="italic">Allow provided elsewhere</emphasis> option, please check it if the data value of this one can be provided by other facilities. The last one is<emphasis role="italic"> Display in reports</emphasis> option. Please check it of you want to display the data value of this one in event list of single event without registration into data entry form.</para>
+ </listitem>
+ </itemizedlist>
+ <para><emphasis role="italic">Template reminder message<emphasis role="italic"> section</emphasis></emphasis> - Define template reminder messages which are used for sending messages for person automatically. There are two params -</para>
+ <para><emphasis role="italic">1) Days before/after due date</emphasis> - Enter a positive number of days if sending process happens after due-date of events which are generated from this program stage. Enter a negative number of days if sending process happens before due-date of events.</para>
+ <para><emphasis role="italic">2) Parameters</emphasis> - Provide parameters which are used for generating a message for each person. The parameters include person's first name, program's name, program stage's name, due date of event, interval between current date and due date and organisation unit's name. </para>
+ <para>Double-click on an option to insert it into template message field below.</para>
+ <para><emphasis role="italic">3) Message</emphasis> - Content of template message. E.g Dear {patient-name}, please come to your appointment at {due-date}.</para>
+ <note>
+ <para>Click <emphasis role="italic">Add more... </emphasis>button to add more template reminder messages.</para>
+ </note>
<para>A program stage has three types of data entry form - </para>
<orderedlist>
<listitem>
@@ -395,7 +368,7 @@
<para><emphasis role="italic">Default data entry form</emphasis> - List all data elements which belong to the program stage.</para>
</listitem>
</orderedlist>
- <para>To search program stages by scheduled days, click <emphasis role="italic">Sort by scheduled</emphasis> days button.</para>
+ <para>To sort program stages by scheduled days, click <emphasis role="italic">Sort by scheduled</emphasis> days button.</para>
</section>
</section>
<section id="patient_aggregation_query_builder">
@@ -433,7 +406,13 @@
<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>
+ <para><emphasis role="italic">Operator</emphasis> - There are six operators</para>
+ <para>1) Select <emphasis role="italic">Number of persons</emphasis> if aggregate based on persons;</para>
+ <para>2) Select <emphasis role="italic">Number of visits</emphasis> if aggregate data based on times that persons received services.</para>
+ <para>3) Select <emphasis role="italic">Sum of data element values </emphasis>to get sum of data values of data element in <emphasis role="italic">Data element for sum/average</emphasis> field with the criteria in the condition field.</para>
+ <para>4) Select <emphasis role="italic">Average of data element values </emphasis>to get average of data values of data element in <emphasis role="italic">Data element for sum/average</emphasis> field with the criteria in the condition field.</para>
+ <para>5) Select <emphasis role="italic">Minimum of data element values </emphasis>to get min of data values of data element in <emphasis role="italic">Data element for sum/average</emphasis> field with the criteria in the condition field.</para>
+ <para>6) Select <emphasis role="italic">Maximum of data element values </emphasis>to get max of data values of data element in <emphasis role="italic">Data element for sum/average</emphasis> field with the criteria in the condition field.</para>
</listitem>
<listitem>
<para><emphasis role="italic">Program</emphasis> - Select program needed for aggregation.</para>
@@ -441,6 +420,9 @@
<listitem>
<para><emphasis role="italic">Program Stage</emphasis> - Select program stage from the selected program above.</para>
</listitem>
+ <listitem>
+ <para><emphasis role="italic">Data element for sum/average/min/max</emphasis> - Select an data element for operator as Sum / Average / Min / Max.</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">
@@ -515,13 +497,6 @@
</listitem>
<listitem>
<para>Create a new aggregation query builder named <emphasis role="italic">Number of children - BCG Builder </emphasis>to linking between the data elements.</para>
- <screenshot>
- <mediaobject>
- <imageobject>
- <imagedata width="70%" fileref="resources/images/patients_programs/example_agg_query_builder.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </screenshot>
</listitem>
<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</emphasis> option below <emphasis role="italic">Registration</emphasis> header in the left menu to register three persons named <emphasis role="italic">Micheal</emphasis>, <emphasis role="italic">Alice</emphasis> and <emphasis role="italic">Tom</emphasis> in <emphasis role="italic">Ngelehun CHC</emphasis> and enroll them into <emphasis role="italic">Child Health Program</emphasis>.</para>
@@ -559,22 +534,18 @@
<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 change.</para>
+ <para>To translate the name of a program, click <emphasis role="italic">Translation</emphasis> icon, the third icon under Operations, corresponding to the validation criteria you would like.</para>
</section>
<section id="schedule_sending_message">
<title>Schedule automated message reminder</title>
- <para>This function is used for scheduling message reminders to be automatically sent to enrolled persons XX days before scheduled appointments and/or XX days after a missed visit. When the schedule is started, messages for each person are generated based on templates defined in each stage at midnight. On the time, the scheduled messages are sent.</para>
+ <para>This function is used for scheduling message reminders to be automatically sent to enrolled persons XX days before scheduled appointments and/or XX days after a missed visit. When the schedule is started, messages for each person are generated based on templates defined in each stage at midnight (Ref.<emphasis role="italic"> Add program stage </emphasis>section for defining a template message). On the time, the scheduled messages are sent.</para>
+ <para>Click <emphasis role="italic">Start</emphasis> button will enable the scheduled job to run the task. Messages are generated based on templates defined in each stages at mid-night and sent at a pre-determined time or can be run immediately by pressing <emphasis role="italic">Execute</emphasis> button.</para>
<para>Click <emphasis role="italic">Execute</emphasis> button to generate and send each message for each person at the time the button clicked.</para>
- <para>Message reminders can be automatically scheduled to run on regular intervals. Click <emphasis role="italic">Start</emphasis> button will enable the scheduled job to run the task. Messages are generated based on templates defined in each stages at mid-night and sent at a pre-determined time or can be run immediately by pressing <emphasis role="italic">Execute</emphasis> button.</para>
</section>
<section id="scheduling_aggregation_query_builder">
<title>Schedule Automated Aggregation</title>
- <para>The aggregation query builder jobs can be automatically scheduled to run on regular intervals. Simply select organisation unit group set aggregation level, and strategy to configure how the scheduled job should run. Click <emphasis role="italic">Start</emphasis> button will enable the scheduled job to run at mid-night or can be run immediately by pressing <emphasis role="italic">Execute</emphasis> button.<screenshot>
- <mediaobject>
- <imageobject>
- <imagedata width="70%" fileref="resources/images/patients_programs/scheduling_aggregation_query_builder.png"/>
- </imageobject>
- </mediaobject>
- </screenshot></para>
+ <para>The aggregation query builder jobs can be automatically scheduled to run on regular intervals. At midnight, this job runs and get all datasets which have data elements defined into Aggregate Query Builder formulas. Based on the period types of datasets, the system runs formulas at the end of end-date of current period. E.g if today is on 1A.M. in 2013-02-01, the system gets a monthly dataset and other period-type datasets with aggregate formulas, then system will only run aggregate formulas of the monthly dataset with period as Jan 2013.</para>
+ <para><emphasis role="italic"><emphasis role="italic">Click</emphasis> Start</emphasis> button will enable the scheduled job to run at mid-night or can be run immediately by pressing <emphasis role="italic">Execute</emphasis> button.</para>
</section>
</section>
<section>
@@ -583,7 +554,7 @@
<itemizedlist>
<listitem>
<para>Find/Add Person</para>
- <para>Create, modify and search for persons. Any type of data can be registered for a person by including attributes.
+ <para>Register, edit and search private information of persons. Support person dashboard for managing relationships, program enrollment, entering case entry form, ....
</para>
</listitem>
<listitem>
@@ -618,13 +589,17 @@
</para>
</listitem>
<listitem>
- <para>Person aggregation</para>
+ <para>Statistical Program</para>
+ <para>Statistical reports on program performance, e.g. drop-out rates, how many completed every month/year - counts/percentages etc </para>
+ </listitem>
+ <listitem>
+ <para>Manual 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>
+ <title>Find/Add Person</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>
<warning>
<para>No matter what program persons need to enroll, they must register into the system first. Then health providers will enroll the persons into relevant programs. E.g. every pregnant women and the child need to be registered first as a person, then they will be enrolled in Mother Care program or Child Health program.</para>
@@ -648,9 +623,13 @@
</listitem>
<listitem>
<para>Select a facility from the facilities hierarchy displayed on the left side of the screen. Then click the <emphasis role="italic">Add new</emphasis> button on the right side.</para>
+ <note>
+ <para>To register new person and enroll him/her into a certain program, please select a program in list and click <emphasis role="italic">Add new</emphasis> button.</para>
+ </note>
</listitem>
<listitem>
- <para>Start process of registration by providing name, location details, identification details, contact details and other details like <emphasis role="italic">child contact name</emphasis> and <emphasis role="italic">child contact type</emphasis>. The click the <emphasis role="italic">Add</emphasis> button to complete to process of registration or click the <emphasis role="italic">Person management</emphasis> to navigate to previous page.</para>
+ <para>Start process of registration by providing name, location details, identification details, contact details and other details like <emphasis role="italic">child contact name</emphasis> and <emphasis role="italic">child contact type</emphasis>. Then click the <emphasis role="italic">Add</emphasis> button to complete to process of registration or click the <emphasis role="italic">Person management</emphasis> to navigate to previous page. </para>
+ <para>To continue to register other new person, click the <emphasis role="italic">Add && Register new </emphasis>button.</para>
<screenshot>
<mediaobject>
<imageobject>
@@ -679,8 +658,8 @@
</orderedlist>
<section>
<title>Person dashboard</title>
- <para>The function is intended to provide quick access to individual data of person. Dashboards consist of several sections, some of which provide links to activity programs or relationships of the person . Other sections of the dashboard allow users to enter data values for data entry form, reschedule and set status for each events of activity plan; show messages and report of the program.</para>
- <para>The dashboard of the person is opened after register successfully or click the <emphasis role="italic">first icon</emphasis> under <emphasis role="italic">Operations</emphasis>, corresponding to the person who you would like.</para>
+ <para>The function provides quick access to individual data of a person. Dashboards consist of several sections, some of which provide links to activity programs or relationships of the person . Other sections of the dashboard allow users to enter data values into case entry form, reschedule and set status for each events of activity plan and show messages and report of the program.</para>
+ <para>The dashboard of a person is opened after register successfully or click the <emphasis role="italic">first icon</emphasis> under <emphasis role="italic">Operations</emphasis>, corresponding to the person who you would like.</para>
<screenshot>
<mediaobject>
<imageobject>
@@ -689,9 +668,7 @@
</mediaobject>
</screenshot>
<para>The <emphasis role="italic">Demographics</emphasis> section provides links for editing profile and changing other location of the person. Click on <emphasis role="italic">Edit profile</emphasis> link to update individual information of person. Click on <emphasis role="italic">Change location</emphasis> link to change other location for the person</para>
- <para>The <emphasis role="italic">Active programs</emphasis> section provides links for activity program and the next visit of person for this program. </para>
- <para>Click on <emphasis role="italic">Enroll into program </emphasis>link to open the Enrollment form.</para>
- <para>Click on a program link to open the data entry form for the next visit of the selected program. A form is open below with five tab - </para>
+ <para>Click on a program link in <emphasis role="italic">Active programs</emphasis> section to open the data entry form for the next visit of the selected program. A form is open below with five tab - </para>
<orderedlist>
<listitem>
<para><emphasis role="italic">Data entry screen </emphasis>tab - Where data is manually registered for each person. Click on a event box in tab. Then fill a report date to open data entry form of the selected event. </para>
@@ -724,7 +701,10 @@
<para>The <emphasis role="italic">Active programs</emphasis> section consists of active programs of the person. Click on a program to show detail information below. Besides, there are two link in this tab - </para>
<orderedlist>
<listitem>
- <para>To display completed program list of the person, click <emphasis role="italic">Completed programs</emphasis> link. Select a program to show detail information below.</para>
+ <para>The <emphasis role="italic">Active programs</emphasis> section provides links for activity program and the next visit of person for this program. </para>
+ </listitem>
+ <listitem>
+ <para>The <emphasis role="italic">Completed programs</emphasis> section provides a completed program list with links to load events flow of the program.</para>
</listitem>
<listitem>
<para>To enroll the person into a program, click <emphasis role="italic">Enroll</emphasis> link.</para>
@@ -838,6 +818,9 @@
</imageobject>
</mediaobject>
</screenshot>
+ <note>
+ <para>Please check <emphasis role="italic">Seach in all facilities</emphasis> checkbox for searching whole organisation hierachy tree.</para>
+ </note>
</section>
</section>
<section>
=== removed file 'src/docbkx/en/resources/images/patients_programs/example_agg_query_builder.png'
Binary files src/docbkx/en/resources/images/patients_programs/example_agg_query_builder.png 2012-10-15 09:47:34 +0000 and src/docbkx/en/resources/images/patients_programs/example_agg_query_builder.png 1970-01-01 00:00:00 +0000 differ
=== modified file 'src/docbkx/en/resources/images/patients_programs/example_query.png'
Binary files src/docbkx/en/resources/images/patients_programs/example_query.png 2012-10-30 09:33:33 +0000 and src/docbkx/en/resources/images/patients_programs/example_query.png 2013-02-21 05:06:12 +0000 differ
=== modified file 'src/docbkx/en/resources/images/patients_programs/individual_records_main_page.png'
Binary files src/docbkx/en/resources/images/patients_programs/individual_records_main_page.png 2012-10-29 07:29:52 +0000 and src/docbkx/en/resources/images/patients_programs/individual_records_main_page.png 2013-02-21 05:06:12 +0000 differ
=== modified file 'src/docbkx/en/resources/images/patients_programs/person_dashboard.png'
Binary files src/docbkx/en/resources/images/patients_programs/person_dashboard.png 2012-10-09 15:40:52 +0000 and src/docbkx/en/resources/images/patients_programs/person_dashboard.png 2013-02-21 05:06:12 +0000 differ
=== modified file 'src/docbkx/en/resources/images/patients_programs/persons_and_programs_main_page.png'
Binary files src/docbkx/en/resources/images/patients_programs/persons_and_programs_main_page.png 2012-11-02 16:15:51 +0000 and src/docbkx/en/resources/images/patients_programs/persons_and_programs_main_page.png 2013-02-21 05:06:12 +0000 differ
=== removed file 'src/docbkx/en/resources/images/patients_programs/scheduling_aggregation_query_builder.png'
Binary files src/docbkx/en/resources/images/patients_programs/scheduling_aggregation_query_builder.png 2012-11-02 16:15:51 +0000 and src/docbkx/en/resources/images/patients_programs/scheduling_aggregation_query_builder.png 1970-01-01 00:00:00 +0000 differ
