dhis2-devs team mailing list archive
-
dhis2-devs team
-
Mailing list archive
-
Message #19750
[Branch ~dhis2-documenters/dhis2/dhis2-docbook-docs] Rev 603: Update patient module.
------------------------------------------------------------
revno: 603
committer: Tran Chau <tran.hispvietnam@xxxxxxxxx>
branch nick: dhis2-docbook-docs
timestamp: Mon 2012-10-29 14:29:52 +0700
message:
Update patient module.
removed:
src/docbkx/en/resources/images/patients_programs/person_aggregation_result.png
added:
src/docbkx/en/resources/images/patients_programs/program_tracking_search_function.png
modified:
src/docbkx/en/dhis2_user_man_persons_and_programs.xml
src/docbkx/en/resources/images/patients_programs/example_person_aggregation.png
src/docbkx/en/resources/images/patients_programs/example_person_aggregation_result.png
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_aggregation_form.png
src/docbkx/en/resources/images/patients_programs/persons_and_programs_main_page.png
src/docbkx/en/resources/images/patients_programs/scheduling_aggregation_query_builder.png
src/docbkx/en/resources/images/patients_programs/search_guide.PNG
src/docbkx/en/resources/images/patients_programs/search_result.PNG
src/docbkx/en/resources/images/patients_programs/visit_schedule.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-10-24 07:44:45 +0000
+++ src/docbkx/en/dhis2_user_man_persons_and_programs.xml 2012-10-29 07:29:52 +0000
@@ -149,11 +149,11 @@
<para>Create, modify and view validation criteria. A criteria is used for validation of Person data. </para>
</listitem>
<listitem>
- <para>Scheduling Message </para>
+ <para>Schedule Message </para>
<para>Scheduled automatic messages to be sent in order to notify persons about upcoming or overdue visits.</para>
</listitem>
<listitem>
- <para>Scheduling Aggregation Query Builder</para>
+ <para>Schedul Automated Aggregation</para>
<para>Schedule for running aggregate builder formulas automatically. </para>
</listitem>
</itemizedlist>
@@ -399,15 +399,15 @@
</section>
</section>
<section id="patient_aggregation_query_builder">
- <title>Person aggregation query builder management</title>
+ <title>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. The purpose is to produce aggregated data / statistics based on the low-level case based data. It is based around flexible aggregation query definitions which maps the data elements used for case based data management to data elements used for aggregate data.</para>
<para>This provides two functions - </para>
<itemizedlist>
<listitem>
- <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>
+ <para><emphasis role="italic">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. Please refer the Service module to see this part.</para>
+ <para><emphasis role="italic">Manual person aggregation</emphasis> is used for generating routine data values from individual data by period and organization unit. Please refer the <emphasis role="italic">Service</emphasis> module to see this part.</para>
</listitem>
</itemizedlist>
<section>
@@ -494,6 +494,8 @@
<orderedlist>
<listitem>
<para>From <emphasis role="italic">Maintenance</emphasis> menu, go to <emphasis role="italic">Data Element and Indicators</emphasis> option and click on it. Select <emphasis role="italic">Data Element</emphasis> option to define two new data elements -</para>
+ <para>1) Define a new data element named <emphasis role="italic">Number of children - BCG</emphasis> with <emphasis role="italic">Aggregate</emphasis> option for Domain Type.</para>
+ <para>2) Define a new data element named <emphasis role="italic">BCG dose give date</emphasis> with <emphasis role="italic">Patient</emphasis> option for Domain Type.</para>
</listitem>
<listitem>
<para>From <emphasis role="italic">Maintenance</emphasis> menu, go to <emphasis role="italic">Datasets</emphasis> option and click on it. Select <emphasis role="italic">Dataset</emphasis> option to create a new dataset named <emphasis role="italic">BCG Report</emphasis> and add <emphasis role="italic">Number of children - BCG</emphasis> data element into the dataset.</para>
@@ -502,7 +504,7 @@
<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">Program</emphasis> option to create a program named <emphasis role="italic">Child Health Program</emphasis> with a stage named <emphasis role="italic">Birth Details</emphasis> and add the <emphasis role="italic">BCG dose given</emphasis> data element into this stage.</para>
</listitem>
<listitem>
- <para>Create a new person aggregation query builder named <emphasis role="italic">Number of children - BCG Builder </emphasis>to linking between the data elements.</para>
+ <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>
@@ -521,11 +523,11 @@
</warning>
</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 aggregation</emphasis> option to run<emphasis role="italic"> Number of children - BCG Builder</emphasis> to get data value and save it into database.</para>
+ <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">Manual 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>
<mediaobject>
<imageobject>
- <imagedata width="70%" fileref="resources/images/patients_programs/example_person_aggregation.png" format="PNG"/>
+ <imagedata width="70%" fileref="resources/images/patients_programs/person_aggregation_form.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot>
@@ -537,8 +539,6 @@
</imageobject>
</mediaobject>
</screenshot>
- <para>1) Define a new data element named <emphasis role="italic">Number of children - BCG</emphasis> with <emphasis role="italic">Aggregate</emphasis> option for Domain Type.</para>
- <para>2) Define a new data element named <emphasis role="italic">BCG dose give date</emphasis> with <emphasis role="italic">Patient</emphasis> option for Domain Type.</para>
</listitem>
</orderedlist>
</section>
@@ -551,14 +551,14 @@
<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>
</section>
<section id="schedule_sending_message">
- <title>Scheduling message</title>
+ <title>Schedule message</title>
<para>This function is used for scheduling auto-send messages on the time defined. 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>Click <emphasis role="italic">Execute</emphasis> button to generate and send each message for each person at the time the button clicked.</para>
- <para>Reminder messages 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 now</emphasis> button.</para>
+ <para>Reminder messages 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>Scheduling Aggregation Query Builder</title>
- <para>The aggregation query builder jobs can be automatically scheduled to run on regular intervals. Simply select the aggregation period types, 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 now</emphasis> button.<screenshot>
+ <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"/>
@@ -835,7 +835,7 @@
<title>Visit Schedule</title>
<para>This will be used to provide the user at a facility or in an area with a list of upcoming visits to better plan for daily/weekly activities. This can also be used as quick navigation to the data entry screen when using the system as a live/real-time data entry system.
</para>
- <para> Clicking on an event to open the data entry screen, and plan is updated when closing data entry form.
+ <para>Clicking on an event to open the data entry screen, and plan is updated when closing data entry form.
The plan (expected visits for the upcoming period) will typically be a mix of recently overdue stages and stages that are non-completed and scheduled for the coming days/week.</para>
<para>After selecting organisation unit on the left panel, select a program in list. Then status which you would like. Select show events since ( if any) and Show events up to ( if any ). Finally, click Show Event List button to get events which are satisfied with searching criteria.</para>
@@ -860,6 +860,14 @@
</imageobject>
</mediaobject>
</screenshot></para>
+ <para>To search events by status and some criteria such as name, identifiers or attributes, click on <emphasis role="italic">Search</emphasis> button next to <emphasis role="italic">List All Persons</emphasis>. A advanced search criteria is shown. After to fill search key values, click on <emphasis role="italic">Search</emphasis> button on this form to display result or click on <emphasis role="italic">Send message</emphasis> button to send a reminder message for person in result.</para>
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="resources/images/patients_programs/program_tracking_search_function.png" width="70%" format="PNG"/>
+ </imageobject>
+ </mediaobject>
+ </screenshot>
</section>
</section>
<section>
@@ -1038,8 +1046,8 @@
</section>
</section>
<section id="run_case_aggregation">
- <title>Person aggregation</title>
- <para>The <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>
+ <title>Manual person aggregation</title>
+ <para>The <emphasis role="italic">Manual person Aggregation</emphasis> module is used for aggregating individual data and import into aggregated data element. To open <emphasis>Manual 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">Manual Person Aggregation</emphasis> option on left menu. <emphasis>Manual person aggregation form</emphasis> is opened as below -</para>
<screenshot>
<mediaobject>
<imageobject>
@@ -1053,7 +1061,7 @@
<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>
+ <para>Select a date range from <emphasis role="italic">From</emphasis> and <emphasis role="italic">To</emphasis> fields.</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>
@@ -1070,11 +1078,11 @@
<screeninfo>Figure - Person aggregation result</screeninfo>
<mediaobject>
<imageobject>
- <imagedata width="70%" fileref="resources/images/patients_programs/person_aggregation_result.png" format="PNG"/>
+ <imagedata width="70%" fileref="resources/images/patients_programs/example_person_aggregation_result.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot>
- <para>In <emphasis>Person aggregation result</emphasis> page -</para>
+ <para>In <emphasis>Manual 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>
=== modified file 'src/docbkx/en/resources/images/patients_programs/example_person_aggregation.png'
Binary files src/docbkx/en/resources/images/patients_programs/example_person_aggregation.png 2012-07-30 04:27:23 +0000 and src/docbkx/en/resources/images/patients_programs/example_person_aggregation.png 2012-10-29 07:29:52 +0000 differ
=== modified file 'src/docbkx/en/resources/images/patients_programs/example_person_aggregation_result.png'
Binary files src/docbkx/en/resources/images/patients_programs/example_person_aggregation_result.png 2012-10-23 07:49:47 +0000 and src/docbkx/en/resources/images/patients_programs/example_person_aggregation_result.png 2012-10-29 07:29:52 +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-23 07:49:47 +0000 and src/docbkx/en/resources/images/patients_programs/example_query.png 2012-10-29 07:29:52 +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-23 07:49:47 +0000 and src/docbkx/en/resources/images/patients_programs/individual_records_main_page.png 2012-10-29 07:29:52 +0000 differ
=== modified file 'src/docbkx/en/resources/images/patients_programs/person_aggregation_form.png'
Binary files src/docbkx/en/resources/images/patients_programs/person_aggregation_form.png 2012-10-23 07:49:47 +0000 and src/docbkx/en/resources/images/patients_programs/person_aggregation_form.png 2012-10-29 07:29:52 +0000 differ
=== removed file 'src/docbkx/en/resources/images/patients_programs/person_aggregation_result.png'
Binary files src/docbkx/en/resources/images/patients_programs/person_aggregation_result.png 2012-10-23 07:49:47 +0000 and src/docbkx/en/resources/images/patients_programs/person_aggregation_result.png 1970-01-01 00:00:00 +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-10-15 09:47:34 +0000 and src/docbkx/en/resources/images/patients_programs/persons_and_programs_main_page.png 2012-10-29 07:29:52 +0000 differ
=== added file 'src/docbkx/en/resources/images/patients_programs/program_tracking_search_function.png'
Binary files src/docbkx/en/resources/images/patients_programs/program_tracking_search_function.png 1970-01-01 00:00:00 +0000 and src/docbkx/en/resources/images/patients_programs/program_tracking_search_function.png 2012-10-29 07:29:52 +0000 differ
=== modified 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-10-15 09:47:34 +0000 and src/docbkx/en/resources/images/patients_programs/scheduling_aggregation_query_builder.png 2012-10-29 07:29:52 +0000 differ
=== modified file 'src/docbkx/en/resources/images/patients_programs/search_guide.PNG'
Binary files src/docbkx/en/resources/images/patients_programs/search_guide.PNG 2012-07-31 15:04:17 +0000 and src/docbkx/en/resources/images/patients_programs/search_guide.PNG 2012-10-29 07:29:52 +0000 differ
=== modified file 'src/docbkx/en/resources/images/patients_programs/search_result.PNG'
Binary files src/docbkx/en/resources/images/patients_programs/search_result.PNG 2012-10-09 15:40:52 +0000 and src/docbkx/en/resources/images/patients_programs/search_result.PNG 2012-10-29 07:29:52 +0000 differ
=== modified file 'src/docbkx/en/resources/images/patients_programs/visit_schedule.png'
Binary files src/docbkx/en/resources/images/patients_programs/visit_schedule.png 2012-10-09 15:40:52 +0000 and src/docbkx/en/resources/images/patients_programs/visit_schedule.png 2012-10-29 07:29:52 +0000 differ
