dhis2-devs team mailing list archive

Thread
Date

[Branch ~dhis2-devs-core/dhis2/trunk] Rev 4266: Edit help content for Patient module.

To: DHIS 2 developers <dhis2-devs@xxxxxxxxxxxxxxxxxxx>
From: noreply@xxxxxxxxxxxxx
Date: Tue, 09 Aug 2011 07:16:20 -0000
Reply-to: noreply@xxxxxxxxxxxxx
Sender: bounces@xxxxxxxxxxxxx

------------------------------------------------------------
revno: 4266
committer: Tran Chau <tran.hispvietnam@xxxxxxxxx>
branch nick: dhis2
timestamp: Tue 2011-08-09 14:10:33 +0700
message:
  Edit help content for Patient module.
modified:
  dhis-2/dhis-services/dhis-service-options/src/main/resources/help_content.xml


--
lp:dhis2
https://code.launchpad.net/~dhis2-devs-core/dhis2/trunk

Your team DHIS 2 developers is subscribed to branch lp:dhis2.
To unsubscribe from this branch go to https://code.launchpad.net/~dhis2-devs-core/dhis2/trunk/+edit-subscription

=== modified file 'dhis-2/dhis-services/dhis-service-options/src/main/resources/help_content.xml'
--- dhis-2/dhis-services/dhis-service-options/src/main/resources/help_content.xml	2011-08-04 06:25:28 +0000
+++ dhis-2/dhis-services/dhis-service-options/src/main/resources/help_content.xml	2011-08-09 07:10:33 +0000
@@ -2488,36 +2488,36 @@
 		<para>After beneficiary registration, the new-created beneficiary needs to be enrolled in at least one of the programs available by specifying a date of enrollment and a date of incident. A date of enrollment is the date of registration of the beneficiary with a facility. A date of incidence is the date when the beneficiary got the disease or he/she has just been committed to an equivalent program for being followed-up.</para>
 		<para>For instance, when a person comes for a treatment, i.e. pregnant woman. Then the system should automatically generate visit dates for the subsequent ANC visits. But to generate these visit schedules, we need to ask the mother when was the date she got pregnant. The day she came for a treatment at a facility/clinic might not be much necessary but the day she figured out her pregnancy by her self or by a nurse/mid-wife, therefore for a better treatment ( by having appropriate visit dates ), we need to know the information about the last date she got menstruation  - that is what the Date of Incidence all about.</para>
 		<para>To open the relationship list of a beneficiary, click the "Relationship Management" icon which is the fourth icon under Operations.</para>
-		<para>To add new a person who has a relationship with the beneficiary, click the "Add dependent" icon.</para>
+		<para>To registry new a person who has a relationship with the beneficiary, click the "Add dependent" icon.</para>
 		<para>To show details of a beneficiary, click the "Show details" icon.</para>
 	</section>
 	<section id="patient_attribute">
 		<title>Beneficiary attribute</title>
         <para>Beneficiary attribute section provides a mechanism for defining a beneficiary attribute. The defined attributes will be used for registering a beneficiary.</para>
         <para>To access the beneficiary attribute maintenance module, choose Maintenance->Beneficiaries and Programs->Beneficiary Attribute.</para>
-		<para>To add a new beneficiary attribute, click the "Add new" button. Fill all fields with red asterisk, and click "Add" button.</para>
+		<para>To define a new beneficiary attribute, click the "Add new" button. Fill all fields with red asterisk, and click "Add" button.</para>
 	</section>
 	<section id="patient_attribute_group">
 		<title>Beneficiary Attribute Group</title>
         <para>Beneficiary attribute group section provides a mechanism for classifying beneficiary attributes. For instance, two attributes "Register person Phone number" and "Register person Address" might be grouped together into a beneficiary attribute group "Details of Registered person".</para>
         <para>To access the beneficiary attribute group maintenance module, choose Maintenance->Beneficiaries and Programs->Beneficiary Attribute Group.</para>
-		<para>To add a new attribute group, click the "Add new" button. Fill in the "Name" and "Description" fields and then select attributes that should belong to the group from the left panel. Click the "Move selected items" button to add the selected attributes to the attribute group. Click the "Remove selected items" button to remove attributes from the group 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>To define a new attribute group, click the "Add new" button. Fill in the "Name" and "Description" fields and then select attributes that should belong to the group from the left panel. Click the "Move selected items" button to add the selected attributes to the attribute group. Click the "Remove selected items" button to remove attributes from the group 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>
 	</section>
 	<section id="patient_identifier_type">
 		<title>Beneficiary Identifier Type</title>
         <para>Beneficiary identifier type section provides a mechanism for defining identifiers associated with the registration of a beneficiary, such as Passport number, PAN, driving license, driving license, health identifier and so on.</para>
 		<para>To access the beneficiary identifier type maintenance module, choose Maintenance->Beneficiaries and Programs->Beneficiary Identifier Type.</para>
-		<para>To add a new identifier type, click the "Add new" button. Fill all fields with red asterisk, and click "Add" button.</para>
+		<para>To define a new identifier type, click the "Add new" button. Fill all fields with red asterisk, and click "Add" button.</para>
 	</section>
 	<section id="relationship_type">
 		<title>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, choose Maintenance->Beneficiaries and Programs->Relationship Type.</para>
-		<para>To add a new relationship type, click the "Add new" button. Fill all fields in "Add new Relationship Type" form, and click "Add" button.</para>
+		<para>To define a new relationship type, click the "Add new" button. Fill all fields in "Add new Relationship Type" form, and click "Add" button.</para>
 	</section>
 	<section id="patient_registration">
 		<title>Beneficiary Registration </title>
-        <para>Beneficiary registration section provides a mechanism for managing facilities which allow to registry new benificiaries or not.</para> 
+        <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, choose Maintenance->Beneficiaries and Programs->Beneficiary Registration.</para>
 		<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>
 	</section>
@@ -2526,21 +2526,20 @@
         <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, choose Maintenance->Beneficiaries and Programs->Program.</para>
 		<para>A health program includes some specific stages because of having multiple encounters for a given program. E.g. once a pregnant woman enrolls to the "ANC Program", she will get examination and treatments for the first trimester, the second trimester and/or the third trimester. These encounters in most cases are mandatory, and there will be dropouts in some cases, in which a pregnant woman should go through after she enrolled in the "ANC Program". So the specific stages of the health program are defined when a health program is created/specified.</para> 
-		<para>To add a new program, click the "Add new" button. Fill all fields with read asterisk, and then click the "Add" button.</para>
+		<para>To define a new program, click the "Add new" button. Fill all fields with read asterisk, and then click the "Add" button.</para>
 		<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 "Define Program Validation" is designed for defining validations of a program in which you would like to modify after entering patient data values for program stages. </para>
 		<para>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.</para>
 		<para>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>
-		<para>To define a program stage, click the "Program Stage Management" icon.</para>
-		<para>To add a new program stage, into "Program Stage Management" form, click the "Add new" 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>Your program will then be ready to be used to enroll beneficiaries (which are modified/created under Maintenance->Beneficiaries and Programs->Beneficiaries) and enter data under the data-entry function session: Services->Name Based Data Records->Data Entry or Multiple Data.</para>
-		<para>Entry for the facilities that you have assigned.</para>
+		<para>To open Program stage management form, click the "Program Stage Management" icon.</para>
+		<para>To define a new program stage, into "Program Stage Management" form, click the "Add new" 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>Your program will then be ready to be used to enroll beneficiaries (which are modified/created under Maintenance->Beneficiaries and Programs->Beneficiaries) and enter data under the data-entry function Services->Name Based Data Records->Data Entry or Multiple Data.</para>
 	</section>
 	<section id="program_attribute">
 		<title>Program Attribute</title>
-        <para>Program attribute section provides a mechanism for defining a program attribute. The defined program attributes will be used when a beneficiary unenroll from a program. You can add and edit program attributes in Maintenance->Beneficiaries and Programs->Progam Attribute.</para> 
+        <para>Program attribute section provides a mechanism for defining a program attribute. The defined program attributes will be used when a beneficiary unenroll from a program. You can create/edit program attributes in Maintenance->Beneficiaries and Programs->Progam Attribute.</para> 
 		<para>To access the program attribute maintenance module, choose Maintenance->Beneficiaries and Programs->Program Attribute.</para>
-		<para>To add a new program, click the "Add new" button. Fill all fields with read asterisk, and click "Add" button.</para>
+		<para>To create a new program, click the "Add new" button. Fill all fields with read asterisk, and click "Add" button.</para>
 		<para>NOTE: There are two program attributes are created for all programs as default to track up program un-enrollment when a beneficiary is announced to un-enrol the program or to be dead. And these two attributes are: Dead (with Yes/No value type) and Closed Date (with Date value type). Moreover, when a beneficiary un-enrolls from a program, the un-enrolled date is required.</para>
 	</section>
 	<section id="beneficiary_aggregation_query_builder">
@@ -2548,7 +2547,7 @@
         <para>Beneficiary aggregation query builder section is the core functionality for linking data between name-based information tracking system â€“ NBITS ( beneficiaries, programs, etc ) and aggregate management system ( dataset, report, charts, etc.) by defining the linking/aggregating rules.</para> 
         <para>This provides two functions. The first is the "Beneficiaries Aggregation Query Builder", a tool to define a formula, an expression, a rule for aggregation data from the tracking (name-based) system to the aggregation system. The second is the  "Beneficiary Aggregation" used for generating routine data values from patient data value by periods ( or other interval if desired ) and by a facility.</para>
         <para>To access "Beneficiaries Aggregation Query Builder" module, choose Maintenance->Beneficiaries and Programs->Beneficiary Aggregation Query Builder.</para>
-        <para>To add a new beneficiaries aggregation query builder, click the "Add new" button. Fill in "Description" field and select an aggregation "Data Element" from a data element group.</para>
+        <para>To create a new beneficiaries aggregation query builder, click the "Add new" button. Fill in "Description" field and select an aggregation "Data Element" from a data element group.</para>
         <para>Then select a program and a corresponding program stage, double click the patient data element you need to create a condition, the equivalent code of it will be showed in the condition box. In addition, you can click the operator buttons to create operators for a condition.</para>
         <para>To access "Beneficiary Aggregation" module, choose Services->Name Based Data Records->Beneficiary Aggregation.</para>
         <para>For instance, find the number of the children vaccinated BCG by defining a linking rule between the data elements of aggregate dataset named "Number of children - BCG" and the data element of a program stage named "BCG dose given date".</para>
@@ -2583,7 +2582,7 @@
 		<title>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, choose Maintenance->Beneficiaries and Programs->Validation Criteria.</para>
-		<para>To add a new validation criterion, click the "Add new" button. Fill all fields with read asterisk, and click "Add" button.</para>
+		<para>To create a new validation criterion, click the "Add new" button. Fill all fields with read asterisk, and click "Add" button.</para>
 		<para>You can assign facilities to a validation criterion in the Validation Criteria Management ( list of available validation criteria are shown ) by clicking on the blue folder icon, the first icon under Operations, corresponding to the validation criterion you would like to assign. Click the "Move selected" button to add the selected programs to the validation criterion. Click the "Remove selected" button to remove programs from the group that have been selected in the right panel. Finally, click the "Save" button to save changes, or the "Cancel" button to discard any changes.</para>
 	</section>
 	<section id="patient_mobile_setting">
@@ -2621,9 +2620,9 @@
     </para>
     <section id="single_patient_entry_form">
 		<title>Beneficiary Data entry</title>
-        <para>Beneficiary data entry section provides a mechanism for inputting data for treatment stages of a beneficiary.</para>
+        <para>Beneficiary data entry section provides a mechanism for inputting data in treatment stages for each beneficiary.</para>
 		<para>To access the beneficiary data entry module, choose Services->Name-Based Data Records->Data Entry.</para>
-		<para>To enter data, you will first have to select a facility for which beneficiaries belong to in order to enter data. Simply clicking on the concerned facility from the facilities hierarchy displayed on the left side of the data entry screen.</para>
+		<para>To enter data, you will first have to select a facility for which beneficiaries belong to in order to enter data. Simply clicking the concerned facility from the facilities hierarchy displayed on the left side of the data entry screen.</para>
 		<para>To open data entry form for a beneficiary, please do the steps as follows:</para>
 		<para>1. Search beneficiaries: click the List All Beneficiaries button to show all beneficiaries by the selected facility; or select an attribute on the attribute box and enter a key to search beneficiaries. The result list is shown below.</para>
 		<para>2. To open treatment form, click the Data Entry icon, the first icon under Operations, corresponding to the beneficiary you would like to input data.</para>
@@ -2633,19 +2632,19 @@
 		<para>You will now enter data for the data entry form. The disabled data fields in data entry form are corresponding to these data elements belong to other stages.</para>
 	</section>
 	<section id="multi_patient_entry_form">
-		<title>Multi beneficiary data entry</title>
-        <para>Multi beneficiary data entry section provides a mechanism for inputting data for treatment stages of beneficiaries.</para>
-		<para>To access the multi beneficiary data entry module, choose Services->Name-Based Data Records->Multiple Data Entry.</para>
-		<para>To enter data, you will first have to select the facility for which beneficiaries belong to in order to enter data. Simply clicking on the concerned facility from the facilities hierarchy displayed on the left side of the data entry screen.</para>
+		<title>Multiple beneficiary data entry</title>
+        <para>Multiple beneficiary data entry section provides a mechanism for inputting data for treatment stages of beneficiaries. The benefits of this advanced function is to optimize the time-transition consuming when entering data for a long list beneficiaries by not switching the main window/interface.</para>
+		<para>To access the multiple beneficiary data entry module, choose Services->Name-Based Data Records->Multiple Data Entry.</para>
+		<para>To enter data, you will first have to select the facility for which beneficiaries belong to in order to enter data. Simply clicking the concerned facility from the facilities hierarchy displayed on the left side of the data entry screen.</para>
 		<para>To open data entry form for a beneficiary with Multiple Data Entry function, please do the steps as follows:</para>
-		<para>1. Select a program in Program list. The beneficiary list by the selected facility is shown. Each beneficiary in the list is shown with each corresponded stages.</para>
+		<para>1. Select a program in Program list. The beneficiary list by the selected facility and program is shown. Each beneficiary in the list is shown with each corresponded stages.</para>
 		<para>2. To open treatment form, click the date of a program stage corresponding to the beneficiary you would like to input data. A form is shown.</para>
 		<para>3. Enter a report data in the form. The data entry form is shown.</para>
 		<para>You will now enter data for the data entry form. The disabled data fields in data entry form are corresponding to these data elements belong to other stages.</para>
 	</section>
 	<section id="patient_summary_report">
 		<title>Report Management</title>
-        <para>Report Management section provides a mechanism for reporting in cases according to a facility and a program by the time.</para>
+        <para>Report Management section provides a mechanism for getting an overview of the services provided for a program.</para>
 		<para>To access the report Management module, choose Services->Name-Based Data Records->Summary Report.</para>
 		<para>The first, you have to select the facility where you want to report. Simply clicking on the concerned organisation unit from the facilities hierarchy displayed on the left side of the data entry screen.</para>
 		<para>The second, select a program to report. Then enter a start date and an end date for which cases with report data should be included. The date picker widget may be used to select dates.</para>
@@ -2653,7 +2652,7 @@
 	</section>
 	<section id="patient_visit_plan">
 		<title>Visit Plans</title>
-        <para>Visit plans section provides a mechanism for creating visit plans for beneficiaries enroling a program.</para>
+        <para>Visit plans section provides feedbacks report to the facilities to help them in planning activities. This is also called as activity plan or visit plan. Basically, view the visit plan to get an overview of outstanding, pending, and completed visits.</para>
 		<para>To access the report Management module, choose Services->Name-Based Data Records->Visit Plans.</para>
 		<para>The first, you have to select the facility where you want to report. Simply clicking on the concerned organisation unit from the facilities hierarchy displayed on the left side of the data entry screen.</para>
 		<para>Then select an attribute in the Sort By box. The visit plan list is shown.</para>