=== modified file 'dhis-2/dhis-services/dhis-service-core/src/main/resources/help_content.xml' --- dhis-2/dhis-services/dhis-service-core/src/main/resources/help_content.xml 2012-07-27 08:07:10 +0000 +++ dhis-2/dhis-services/dhis-service-core/src/main/resources/help_content.xml 2012-07-27 09:14:50 +0000 @@ -5479,415 +5479,288 @@ Translations can be enabled by selecting the desired locale under Database Language under User General Settings in the Settings module. - + -Name-Based Information Tracking Module -
-Introduction -
-Quick Background -The DHIS Community Module ( also known as DHIS patient module or NBITS) is an integrated module in DHIS2, built to support community health systems and facilitate a smooth integration between the community health data and aggregated data management ( e.g. HMIS ). -The module deals with person-level data as opposed to aggregated data which is the main focus of the core DHIS2 modules. The module supports management of community health programs such as: child immunization, maternal health and e.g. allows for tracking of individuals enrolled in various programs and activity planning for community health workers. -The following are the major things: - - -Administrating a person - registering a new person, setting relationships, enrolling a person into a program. - - -Administrating meta data, includes person attributes, person attribute groups, identifier type; program, program attribute, program stage, validations. - - -Linking data between name-based information tracking system – NBITS and aggregate management system. - - -Data Entry for inputting data for treatment stages of an person. - - -Activity plans. - - -
-
-Context and Concept -Conventionally, Public Health Systems have been recording and reporting aggregated data of the services provided across various health programmes. Though this is crucial in monitoring "reach" and "availability" of public health services, but it lacks tracing the persons being provided these services and quality of service. -For example, the aggregate report will show that 300 pregnant women registered for ANC and 120 women given IFA tablets or 90 women given TT injection. In an aggregate system, it is not possible to ascertain that if a particular pregnant woman registered for ANC, has also been given IFA and TT, as data only shows aggregate numbers. To understand the quality of services given to each pregnant woman registered for ANC, immunization cycle of each child or treatment of each leprosy person, etc. it is important that treatment information of each person is maintained as an individual case. -
-
-Objectives of Name Based Information Tracking -Objectives of Name Based Information Tracking: - - -Track (follow-up) a person through the entire treatment period. - - -Facilitate the service provider (health worker or doctor) in person's treatment follow-up; by recording all treatment related information in one place (makes it comprehensive for the service-provider). - - -Help the person in recording treatment history in one place, which could be used later in case of referral. - - -Advantages of Name Based Information Tracking : - - -Facilitate in recording entire treatment information of each person. - - -Facilitate health-workers in organizing out-reach. - - -Facilitate service-provider in treatment follow-up. - - -Facilitate in effective monitoring of different health services and drill down to individual person information. - - -Help strengthen the quality and fidelity of data. - - -Though at sub-center level, the data in primary registers is recorded and maintained by individuals (name based), but is sent up-wards as aggregate reports. Now with HMIS reforms implemented and district on-wards data available on-line, the thrust has been on ensuring data quality implemented completeness. To-wards this one important initiative has been starting name based reporting - from sub-center to national level. -
-
-Working of Name Based Information Tracking -NBITS registers cases and tracks these cases over time through different forms that are filled for the treatment of a person. - - -Registration and Identification for a person - - -Programme enrolment - - -Treatment plan - - -Case encounters - - -
-Registration and Identification for a person -The system has a function to manage facilities which allow to registry new persons or not. To start creating a patient, we need to select a facility which allows to registry a new person. -The process of creating a new person in the system is through the registration process. The person is first registered in the system (or checked if person already exists in system). Searching a person can be done through identifiers, name, location or person's attributes (address, phone number, e.g.). If the person already exists in the system, the encounter details can be opened and filled and the programme process can continue. If the person does not exist in the system, then new registration takes place. -When a person is registered in the system, multiple identifiers can be associated with the registration, such as Passport number, PAN, driving license, health identifier, UID. Internally, a location unique identifier is used to track the person. -The process of identification is location independent, this implies that irrespective of location where person registered for service the service/medical record can be searched and pulled-up in any other facility provided the same is in the database. For facilities, which are not in the database, for e.g. a private facility, it will just be noted that "Service is provided at other facility". In such case, the person should be encouraged, to provide these details of services taken from other facility to the ANM. The health worker is first identified through any of the identifiers or username in the system and the person is identified through identifiers for receiving a health service. After identification, the person's case history can be viewed or case can be updated with the new care that they have received. -
-
-Programme Enrollment and Treatment Plan -When a person is enrolled into any health programme, a record of treatment is created for the person. Various services provided to the person through the treatment are recorded for the person. This recording results in creation of a treatment plan for the person. -
-
-Case Encounters -Each interaction with the person related to the case is considered to be an encounter and these encounters are recorded into the person case. Person case is updated with the identification of both the health worker and the person who is receiving the service. -
-
-
-
-NBITS Application User Guide -
-Starting the application -To use the online NBITS application, in client computer which is connected to Internet, launch web browser ( use of Mozilla Firefox browser is recommended ). - -Once you have started NBITS online, the displayed screen will prompt you to enter your registered "Username" and "Password". After entering the required information, click Login button to log into the application. - -Figure 2.1.1 - - - - - - -After clicking the Login button, you will be directed to the Welcome screen of the NBITS: - -Figure 2.1.2 - - - - - - -
-
-Modules in NBITS -The NBITS application is an online application and developed as open source application. The application is platform independent and can be easily linked with other open source application. The application is developed on the similar DHIS framework and it has three basic modules as follows - - - -Maintenance module - - -Services module - - -Help module - - -There are some additions in the NBITS in both maintenance and services module. Maintenance module has one additional sub module for the person registration and Services module has one additional sub-module for name-based data entry and recording. -The modules provide three main functionalities - - - -Processes of case tracking in NBITS. - - -Reports. - - -Person Aggregation Query Builder. - - -
-
-Processes of case tracking in NBITS -The NBITS application is developed with the objective of tracking cases of any disease or condition by using this application. The process of tracking starts with the registration of cases in the application. Application can provide information for only those cases which are available in the database, so the first process is the registration of person in the NBITS application. Once the person is registered, she/he can be enrolled in the program for which registered. The application will guide the health provider for the services required by the person through activity plan and the services received by the person from time to time can be updated into his/her profile. The working process of the application can be understood in steps depicted in picture below - - -Figure 2.3.1 - - - - - - -
-Person registration -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. - -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. - - - -Person registration process - - -For the registration process, the details - which are related to the personal information, identification, contact and location details, and health provider details, are entered. - - -To register a person, go to the Services menu, select option Individual Records. - - - - -Now click the Person option to go to Person Registration window. - - - -Select a facility from the facilities hierarchy displayed on the left side of the screen. Then click the Add new button on the right side. - - - -Start process of registration by providing name, location details, identification details, contact details and other details like child contact name and child contact type. The click the Add button to complete to process of registration or click the Back to registration to navigate to previous page. - -To check the duplicates or to avoid double registration, after providing name and demographic details, click the Check duplicate button. Checking process bases on full name, gender and birthday of the registering person to look for the available persons with the similar information in the database. The result list will be displayed if the system finds out the same persons. Now health providers can cancel the registration process and update the existing person or continue the process of registration. - - -
-Person enrollment -After the registration, the person needs to be enrolled in any available program. To enroll: - - -Click the Program management icon, the first icon under Operations, corresponding to the person you would like to enroll. - - - -Select a program from the list ( i.e., Death, Child Health Program... ) - -This task can be executed after registration successfully, a form like the form above is showed up for enrollment. - - - - -After the selection of program, you need to provide two dates: -1) Date of enrollment: The date when person enrolls into the selected program. -2) Date of incident: The date when the person got the disease or he/she has just been committed to an equivalent program for being followed-up. - - -The date of incident are very important to generate the activity plan for each person. Health provider needs to ensure recording and reporting date of incidence with each case of multi events with registration. However, the date is ignored with single event programs. - - - -Click the Enroll button to complete the enrollment process. - - - - -The system will automatically calculate due-date for each the program stage and will show same the below enrollment. In health programme, a person registered and enrolled, needs to be checked from time to time by health providers. -The case update is designed in the same manner so that services which are received by the persons can be updated from time to time when they visit the facility or whenever the health providers need to track. - - - - - - -
-
-
-STEP 3 – Inputting data in treatment stages for each person -We have two functionalities which support to input data in treatment stages for each person. - - -Name-based data entry. - - -Multiple data entry. - - -
-Name-based Data Entry - - -From the Services option, go to the Name Based Data Records option and click it. Select Name-based option on left menu to proceed. - -Figure 2.3.12 - - - - - - - -Figure 3.3.14 - - - - - - - - -Selection of a person and individual case -In order to enter data, you first have to select the facility for which persons 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. -The next step is searching persons. Select a program in program list. The person list by the selected facility is shown. Each person in the list is shown with each corresponded stages. - -Figure 2.3.14 - - - - - - - - -Entering data for treatment case -To open treatment form, click the Data Entry icon, the first icon under Operations, corresponding to the person you would like to enter data. - -Figure 2.3.15` - - - - - - - - -Selection of the Program and Program Stage -What is program stage ? - This is to handle specific stages of a health program because of having multiple encounters for a given health 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. -Select the program and the program stage which you want to enter data for the selected person, then provide the Report Date to open the data entry form. - -Figure 2.3.16 - - - - - - -After filling data into the data entry form, click on the Complete data entry button to complete the data filling process for this stage. - -During each stage, the section related to that particular stage will be enabled for data entry form, rest of the sections will remain disabled in that particular stage. E.g. if data entry form of ANC registration stage is selected, then only data elements of ANC registration stage will be enabled and the rest of the data elements of other stages will remain disabled. - - - -
-
-Multiple individual records -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. -To access the multiple individual records function, from the Services menu, go to the Individual Records option and click on it. Select Multiple individual records option on left menu to proceed. -To start enter data, the first step is to open a list events of person who enrolled a certain program by clicking a program in the list on the main page. Follow these steps: - - -Locate the organisation unit you want to register data for in the tree menu to the left. Expand and close branches by clicking on the +/- symbols. A quick way to find an orgunit is to use the search box just above the tree (the green symbol), but you need to write in the full name to get a match. -The system loads multi events with registration which belong to the selected organisation unit. - - -Select a program in the list. A list events of persons who enrolled into the selected program is shown. - - -Click an event to open data entry form. - - -
-
-Single event without registration -The data to register is defined by a single event without registration program. -In order to register an event, from the Services option, go to the Name Based Data Records option and click it. Select Single event without registration option on left menu to proceed. -In order to list all events in the selected facility, click List All Events button. -In order to remove empty events of the selected program, click Remove empty events button. -In order to add new event, click Add new button. -To update an event: - - -Click Advanced search button. Then enter criterion for searching events. The list events are displayed below. - - -Click on the first icon to update value for the event. - - -
-
-Single event with registration -The data to register is defined by a single event with registration program. The functionality supports health providers to register person information and input data values for a program into one form. -In order to register an event, from the Services option, go to the Name Based Data Records option and click it. Select Single event with registration option on left menu to proceed. -In order to list all persons in the selected facility, click List All Persons button. -In order to add new event, select a program in the combo box. And then click Add new button. -To update event of a registered person: - - -Click Advanced search button. Then enter criterion for searching available persons. The seach result is displayed below. - - -Click on the first icon to update value for the event. - - -
-
-
-
-Program summary -Program summary provides a tool for generating summary list of individual information with color shown on program stages to identify status of receiving services in each stage. -To access the program summary report, choose Services -> Name-based Data Records > Program summary. -Select a organisation unit which provides services on the left menu. Then on the main page, select Program, Start date, End date to get period. Finally, click Generate button. -The result is get based on the date of enrollment of each person who registered the selected organisation unit and enrolled in the selected program in the interval from start-date and end-date what health provider entered. - - - - - - - -The color highlight the status of the stages - - - -PURPLE: Data entered and uncompleted stages. - - -RED: Stages open but no data entered while the date estimated for closing/completing is over. - - -YELLOW: Coming stages. - - -GREEN: Compete stages. - - -
-
-Person Aggregation Query Builder -This is the core functionality for linking data between name-based information tracking system – NBITS ( persons, programs, etc ) and aggregate management system ( dataset, report, charts, etc.) by defining the linking/aggregating rules. -This provides two functions - - - -Person Aggregation Query Builder is a tool for defining formula, expression, rules for aggregation data from name-based to aggregation system. - - -Person Aggregation to used for generating routine data values from patient-data by month (or other interval if desired) and organization unit. - - -
+ DHIS Tracker Module +
+ Introduction +
+ Quick Background + Conventionally, Public Health Systems have been recording and reporting aggregated data of the services provided across various health programmes. Though this is crucial in monitoring "reach" and "availability" of public health services, but it lacks tracing the persons being provided these services and quality of these ones. + For example, the aggregate report will show that 300 pregnant women registered for ANC and 120 women given IFA tablets or 90 women given TT injection. In an aggregate system, it is not possible to ascertain that if a particular pregnant woman registered for ANC, has also been given IFA and TT, as data only shows aggregate numbers. To understand the quality of services given to each pregnant woman registered for ANC, immunization cycle of each child or treatment of each leprosy person, etc. it is important that treatment information of each person is maintained as an individual case. + The DHIS tracker module ( also known as DHIS Community Module ) is an integrated module in DHIS2, built to support community health systems and facilitate a smooth integration between the community health data and aggregated data management. + The module supports management of community health programs, such as child immunization, maternal health and e.g. allows tracking of individuals enrolled in various programs and activity planning for community health workers. + The following are the major things: + + + 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. + + + Administrating person registration - registering a new person, setting relationships, enrolling a person into a program and management of person location + + + Data entry for inputting individual data for treatment of each person. + + + Reports for individual cases. + + + Linking data between tracker system and aggregate management system. + + + Advantages of tracker module - + + + 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. + + + Help the person in recording treatment history in one place, which could be used later in case of referral. + + + Facilitate in recording entire treatment information of each person. + + + Help strengthen the quality and fidelity of data. + + + The data in primary registers at sub-center level is recorded and maintained by individual data or treatment cases, and sent up-wards as aggregate reports. +
+
+ Processes in the system + The module supports health providers for registering treatment cases and tracks these cases over time through different forms that are filled for the treatment of each person. + + + Person registration + + + Program enrollment + + + Treatment case + + + Reports + + +
+ Information tracking process + The process starts with the person registration. Then she/he can be enrolled in the program for which registered. The application will guide the health provider the services required for her/him through activity plan and the services from time to time can be updated into his/her profile. The working process is described in steps depicted in picture below - + + Figure 2.3.1 + + + + + + +
+
+ Person registration + The process of creating a new person in the system is through the registration process. The person is first registered in the system (or checked if the person already exists in system). Searching a person can be done through name, identifiers, location or user-defined person's attributes (address, phone number, e.g.). If the person already exists in the system, the program enrollment process can continue. If the person is not available, new registration takes place. + The system supports for creating identifier type for the registration, such as Passport number, PAN, driving license, health identifier, UID. However, a system unique identifier is created automatically after registration and used to track the person. + For identification a person, the health worker is first identified through any of the identifiers or name of patient in the system and the person is identified through identifiers for receiving a health service. After identification, the individual case history can be viewed or a treatment case can be updated for the new visit that they have received. +
+
+ Program enrollment + When a person is enrolled into any health programme, the person is provided various services through the treatment are recorded. Based on the services of the program by the time, the system creates an activity plan for person. +
+
+ Treatment case + Each interaction with the person related to the case is considered to be an treatment case and these cases are recorded into the individual case. Individual case is updated with the identification of both the health worker and the person who is receiving the service. +
+
+ Reports + The module provides two functions for viewing the reports to get an overview of the services provided for a program or a program stage. +
+
+
+
+ User guide + There are two additions in the module in both maintenance and services module - + + + Persons and Programs maintenance module - 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. + When the ‘Persons and Programs’ options is chosen from the main Maintenance menu, the following screen appears - + + + + + + + + + + Individual records module - Support main functions for person registration, tracking information and individual reports. + When the ‘Individual Records’ options is chosen from the main Services menu, the following screen appears - + + + + + + + + + +
+ Persons and Programs maintenance + The content in this part is for the expert users or administrative users who are capable and responsible for development and change. + Each of the options for the maintenance will be described in the following sectionThe options for the maintenance will be described in the following section - + + + Person Attribute + Create, modify and view Person attributes. An attribute can be used to register extra information for a Person. + + + Person Attribute Group + Create, modify and view Person attribute groups. Groups makes it more convenient to add attributes to a Person. + + + Person Identifier Type + Create, modify and view Person identifier types. Any type and multiple identifiers can be registered. + + + Relationship Type + Create, modify and view relationship types. A relationship is typically wife and husband or mother and child. + + + Program + Create, modify and view programs. A program has program stages and defines which actions should be taken at each stage. + + + Person Aggregation Query Builder + Define formulas, expressions, rules for aggregation data from tracker to aggregation module + + + Validation Criteria + Create, modify and view validation criteria. A criteria is used for validation of Person data. + + +
+ Person attribute + Create, modify and view person attributes. An attribute can be used to register extra information for a person. + From Maintenance menu, go to Persons and Programs option and click on it. Select Person Attribute option to create a new attribute for persons. + After, click on Add button into Person Attribute Management window to go to Add New Person Attribute Management window. + Basic information + + + Name: Name of person attribute. + + + Description: Description of person attribute. + + + Mandatory: Entering value for this attribute is required or not. + + + Inheritable + + + Value Type: Data type of value inputed. + + + Program: Specify a program which this attribute belongs to. + + +
+
+ Person attribute group + To access the person attribute group maintenance module, from Maintenance menu, go to Persons and Programs option and click on it. Select Person Attribute Group option to create a new an attribute group. + To create a new attribute group, click the Add button into Person Attribute Group window to go to Add New Person Attribute Group window , 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.. +
+
+ Person identifier type + To access the person identifier type maintenance module, from Maintenance menu, go to Persons and Programs option and click on it. Select Person Identifier Type option to create a new identifier type. + To creating a new identifier type, click the Add button into Person Identifier Type Management window to go to Add New Person Identifier Type window. + Basic information - + + + Name: Name of identifier type. + + + Description: Description of identifier type. + + + Mandatory: Entering value for the identifier is required or not. + + + Related + + + Number of characters: Maximum number of characters for value inputed. + + + Type: Data type of value inputted. + + + Program: specify a program which the identyfier type belongs to. + + +
+
+ Relationship type + Relationship type section provides a mechanism for defining any relationship types and link persons through these relationship types by creating specific relationships. + To access the relationship type maintenance module, from Maintenance menu, go to Persons and Programs option and click on it. Select Relationship Type option to create a new relationship type. + To define a new relationship type, click Add button into Relationship Type Management window to go to Add new Relationship Type window. +
+
+ Program and Program stage +
+ Program + Program section provides a mechanism for defining a health programme. + To access the program maintenance module, from Maintenance menu, go to Persons and Programs option and click on it. Select Program option. + To define a new program, click the Add new button on the main page. Fill all fields with read asterisk, and then click the "Add" button. + Basic information - + + + Name: The name of the program + + + Description: Descriptions, meanings, explanation, etc. of/about the program. + + + Type: There are three type of program: multi events with registration, single event with registration and single event without registration. + + + Show provided elsewhere: Set show/hide status of provided elsewhere column in data entry form. + + + Description of enrollment date: The date in which a person is registered to the system. +For example: the date in which a person enrolls to the system. + + + Description of incident date: 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). + + + Duration in days: System gets the days to calculate the activity plan of each person in mobile project ( refer mobile chapter ). + + +
+
+ Program stage + To define a program stage, click the Program Stage Management icon and then 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. + Basic information - + + + Name: Name of the program stage + + + Description: The description of the program stage + + + Scheduled days from start: The minimum number of days to wait for starting the program stage. + + + Repeatable: specify the program stage as repeatable or not. + + + Standard interval days: specify the number of days to repeat the repeatable program stage. + + +
+
+
Person aggregation query builder management This is the core functionality for linking data between tracker module and aggregate management module by defining the linking/aggregating rules. This provides two functions - @@ -5934,42 +5807,42 @@ Next section included 3 tabs: Data elements, Person attributes and Program. Depend on the requirement of data aggregation, data element, person attributes, and number of programs are selected. - Data elements tab: + Data elements tab: 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: - - - 1 - id of the selected program. - - - 2 - id of the selected program stage. - - - 3 - id of the selected data element. - - + + + 1 - id of the selected program. + + + 2 - id of the selected program stage. + + + 3 - id of the selected data element. + + The formula can be create without any program stage, like [DE:1.*.3] - Person attribute tab: + Person attribute tab: 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. - Program tab: + Program tab: Provide formulas for calculating data value related to the selected program and program stage - - - - The number of persons who enrolled the selected program. - - - The number of persons / times that ( Date of enrollment - Date of incident ) is greater then a certain number. - - - The number of persons who visited the selected program stage OR the number of visits what are registered in the system. - - - The number of persons by age at the report-time. - - + + + The number of persons who enrolled the selected program. + + + The number of persons / times that ( Date of enrollment - Date of incident ) is greater then a certain number. + + + The number of persons who visited the selected program stage OR the number of visits what are registered in the system. + + + The number of persons by age at the report-time. + + Condition: This section contains comparing operations (<, <=, >, >=, =, != ), calculation operation (+), priority operation ( ( ) ), boolean values (Yes, No), status operations (=NULL, != NULL), relation operations (AND, OR). These operations are used for supporting in setting condition for query. @@ -5988,74 +5861,318 @@
Sample of person aggregation - E.g. 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. - - From Maintenance menu, go to Data Element and Indicators option and click on it. Select Data Element option to define two new data elements - - - - Define a new data element named Number of children - BCG with Aggregate option for Domain Type. - - - Define a new data element named BCG dose give date with Patient option for Domain Type. - - - - - From Maintenance menu, go to Datasets option and click on it. Select Dataset option to create a new dataset named BCG Report and add Number of children - BCG data element into the dataset. - - - From Maintenance menu, go to Persons and Programs option and click on it. Select Program option to create a program named Child Health Program with a stage named Birth Details and add the BCG dose given data element into this stage. - - - Create a new person aggregation query builder named Number of children - BCG Builder to linking between the data elements. - - - - - - - - - - From Services menu, go to Individual Records option and click on it. Select Person option below Registration header in the left menu to register three persons named Micheal, Alice and Tom in Ngelehun CHC and enroll them into Child Health Program. - - - For Micheal, open the Birth Details stage into Child Health Program. Enter value for BCG dose give date data element as "2012-01-18" - - - For Alice, open the Birth Details stage into Child Health Program. Enter Enter value for BCG dose give date data element as "2012-01-18" - - - For Tom, no enter any data value for Birth Details stage. - - Before entering data value for the stage, choose Report Date as "2012-01-18" - - - - - - From Services menu, go to Individual Records option and click on it. Select Person aggregation option to run Number of children - BCG Builder to get data value and save it into database. - - Figure 2.5.3.5 - - - - - - - - Figure 2.5.4.6 - Result after running the query builder - - - - - - - - -
-
-
+ E.g. 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. + + + From Maintenance menu, go to Data Element and Indicators option and click on it. Select Data Element option to define two new data elements - + + + From Maintenance menu, go to Datasets option and click on it. Select Dataset option to create a new dataset named BCG Report and add Number of children - BCG data element into the dataset. + + + From Maintenance menu, go to Persons and Programs option and click on it. Select Program option to create a program named Child Health Program with a stage named Birth Details and add the BCG dose given data element into this stage. + + + Create a new person aggregation query builder named Number of children - BCG Builder to linking between the data elements. + + + + + + + + + + From Services menu, go to Individual Records option and click on it. Select Person option below Registration header in the left menu to register three persons named Micheal, Alice and Tom in Ngelehun CHC and enroll them into Child Health Program. + 1) For Micheal, open the Birth Details stage into Child Health Program. Enter value for BCG dose give date data element as "2012-01-18" + 2) For Alice, open the Birth Details stage into Child Health Program. Enter Enter value for BCG dose give date data element as "2012-01-18" + 3) For Tom, no enter any data value for Birth Details stage. + + Before entering data value for the stage, choose Report Date as "2012-01-18" + + + + From Services menu, go to Individual Records option and click on it. Select Person aggregation option to run Number of children - BCG Builder to get data value and save it into database. + + + + + + + + + - Result after running the query builder + + + + + + + 1) Define a new data element named Number of children - BCG with Aggregate option for Domain Type. + 2) Define a new data element named BCG dose give date with Patient option for Domain Type. + + +
+
+
+ Validation criteria + Validation criteria section provides a mechanism for defining criteria for persons when enrolling a program. + To access the validation criteria maintenance module, from Maintenance menu, go to Persons and Programs option and click on it. Select Validation Criteria option to create a new program + To create a new validation criterion, click the Add new button. Fill all fields with read asterisk, and click Add button. + You can assign facilities to a validation criterion in the Validation Criteria Management (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 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. +
+
+
+ Individual records module + Each of the options for the services will be described in the following section - + + + Person + Create, modify and search for persons. Any type of data can be registered for a person by including attributes. + + + + Multiple Individual records + Enter data for multiple program stages and persons for a program. The entry screen gives an overview of the stage status. + + + + Single event with registration + The data to register is defined by a single event with registration program. + + + Single event without registration + Register Single events without registration. The data to register is defined by a single event without registration program. + + + Program summary + View the summary report to get an overview of the services provided for a program. + + + + Tabular report + Use an interactive reporting tool for tracker-data using tabular presentation with dynamic filters for each person attribute/data element. + + + + Person aggregation + Generate routine data values from patient data by month (or other intervals if desired) and organisation unit. + + + +
+ Person registration + 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. + + 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. + + + + Person registration process + + + For the registration process, the details - which are related to the personal information, identification, contact and location details, and health provider details, are entered. + + + To register a person, go to the Services menu, select option Individual Records. + + + Click the Person option below Registration header to go to Person Registration window. + + + Select a facility from the facilities hierarchy displayed on the left side of the screen. Then click the Add new button on the right side. + + + + Start process of registration by providing name, location details, identification details, contact details and other details like child contact name and child contact type. The click the Add button to complete to process of registration or click the Back to registration to navigate to previous page. + + To check the duplicates or to avoid double registration, after providing name and demographic details, click the Check duplicate button. Checking process bases on full name, gender and birthday of the registering person to look for the available persons with the similar information in the database. The result list will be displayed if the system finds out the same persons. Now health providers can cancel the registration process and update the existing person or continue the process of registration. + + +
+ Person enrollment + After the registration, the person needs to be enrolled in any available program. To enroll: + + + Click the Program management icon, the first icon under Operations, corresponding to the person you would like to enroll. + + + Select a program from the list ( i.e., Death, Child Health Program... ) + + + + + + + + + This task can be executed after registration successfully, a form like the form above is showed up for enrollment. + + + + + After the selection of program, you need to provide two dates: + 1) Date of enrollment: The date when person enrolls into the selected program. + 2) Date of incident: The date when the person got the disease or he/she has just been committed to an equivalent program for being followed-up. + + The date of incident are very important to generate the activity plan for each person. Health provider needs to ensure recording and reporting date of incidence with each case of multi events with registration. However, the date is ignored with single event programs. + + + + Click the Enroll button to complete the enrollment process. + The system will automatically calculate due-date for each the program stage and will show same the below enrollment. In health programme, a person registered and enrolled, needs to be checked from time to time by health providers. +The case update is designed in the same manner so that services which are received by the persons can be updated from time to time when they visit the facility or whenever the health providers need to track. + The system will automatically calculate due-date for each the program stage and will show same the below enrollment. In health program, a person registered and enrolled, needs to be checked from time to time by health providers. +The case update is designed in the same manner so that services which are received by the persons can be updated from time to time when they visit the facility or whenever the health providers need to track. + + + + + + + + + +
+
+ Editing person profile + After enrolling a person to any program, you can edit profile for that person. + + + Click the Edit profile icon, the second icon under Operations, corresponding to the person you would like to edit. + + + When you click on Edit profile icon, a dialog box may appear to require you verify the date of birth if it is not verified. You just simply click OK to go to the edit page. + + +
+
+ Adding relationship + Now you can add relationship for person. To do that, you have to click on the Relationship management icon under Operations. Then, the management page appears... + + + + + + + + To add relationship for a person, you have to click on Search available person button to navigate to adding relationship page. + To register a new person and create relationship with the selected person, click Register new person button. +
+
+ Change person location and View person details and history + You can change person location by clicking the Change person location icon under Operations. In addition, you can view all person details and history by click on Person details and history icon under Operations. + Furthermore, you can download all person details and history in the format of XLS or PDF by clicking Download as Excel or Download as PDF button. + + + + + + + +
+
+
+ Data entry +
+ Multiple individual records + 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. + To access the multiple individual records function, from the Services menu, go to the Individual Records option and click on it. Select Multiple individual records option on left menu to proceed. + To start enter data, the first step is to open a list events of person who enrolled a certain program by clicking a program in the list on the main page. Follow these steps: + + + Locate the organisation unit you want to register data for in the tree menu to the left. Expand and close branches by clicking on the +/- symbols. A quick way to find an organisation unit is to use the search box just above the tree (the green symbol), but you need to write in the full name to get a match. + The system loads multi events with registration which belong to the selected organisation unit. + + + Select a program in the list. A list events of persons who enrolled into the selected program is shown. + + + Click an event to open data entry form. + + +
+
+ Single event with registration + The data to register is defined by a single event with registration program. The functionality supports health providers to register person information and input data values for a program into one form. + In order to register an event, from the Services option, go to the Name Based Data Records option and click it. Select Single event with registration option on left menu to proceed. + In order to list all persons in the selected facility, click List All Persons button. + In order to add new event, select a program in the combo box. And then click Add new button. + To update event of a registered person: + + + Click Advanced search button. Then enter criterion for searching available persons. The seach result is displayed below. + + + Click on the first icon to update value for the event. + + +
+
+ Single event without registration + The data to register is defined by a single event without registration program. + To register an event, from the Services option, go to the Name Based Data Records option and click it. Select Single event without registration option on left menu to proceed. + To list all events in the selected facility, click List All Events button. + To remove empty events of the selected program, click Remove empty events button. + To add new event, click Add new button. + To update an event: + + + Click Advanced search button. Then enter criterion for searching events. The list events are displayed below. + + + Click on the first icon to update value for the event. + + +
+
+
+ Reports + The sub module provides two functions for individual reports - + + Program summary - view the summary report to get an overview of the services provided for a program. + + + Tabular report - an interactive reporting tool for tracker-data using tabular presentation with dynamic filters for each person attribute and data element. + + +
+ Program summary + Program summary provides a tool for generating summary list of individual information with color shown on program stages to identify status of receiving services in each stage. + To access the program summary report, choose Services -> Name-based Data Records > Program summary. + Select a organisation unit which provides services on the left menu. Then on the main page, select Program, Start date, End date to get period. Finally, click Generate button. + The result is get based on the date of enrollment of each person who registered the selected organisation unit and enrolled in the selected program in the interval from start-date and end-date what health provider entered. + + + + + + + + The color highlight the status of the stages - + + + PURPLE: Data entered and uncompleted stages. + + + RED: Stages open but no data entered while the date estimated for closing/completing is over. + + + YELLOW: Coming stages. + + + GREEN: Compete stages. + + +
+
+ Tabular report + This is an interactive reporting tool for tracker-data using tabular presentation with dynamic filters for each person attribute/data element. + To access the tabular report function, from the Services menu, go to the Individual Records option and click on it. Select Tabular report option below Reports header on left menu to proceed. + To start, the first step is to select a program in the list. Follow these steps: +
+
+
Person aggregation Person Aggregation module is used for aggregating individual data and import into aggregated data element. To open Person Aggregation module, from the Services menu, go to the Individual Records option. Select Person Aggregation option on left menu. Person Aggregation form is opened as below - @@ -6106,8 +6223,8 @@
-
-
+
+
Setting up report functionality