=== modified file 'src/docbkx/en/dhis2_user_man_tracker.xml' --- src/docbkx/en/dhis2_user_man_tracker.xml 2014-05-27 14:17:42 +0000 +++ src/docbkx/en/dhis2_user_man_tracker.xml 2014-05-30 02:58:58 +0000 @@ -138,63 +138,68 @@ Schedule an automated tracked entity aggregation process, e.g. to run all pre-defined aggregation queries every midnight. -
- Attribute +
+ Attribute Create, modify and view entity attributes. An attribute can be used to register extra private information for a entity or information when that entity enrolled into a certain program. + After, click on Add new button into Tracked entity attribute management window to go to Create new tracked entity attribute window. From App menu, go to Programs / Attributes option and click on it. Select Attribute option to create a new attribute for entities. - After, click on Add new button into Tracked entity attribute management window to go to Create new tracked entity attribute window. - Basic information - - - Name - Name of attribute. - - - Short name - Short name of attribute. - - - Code - Code of attribute. - - - Description - Description of attribute. - - - Unique - Specify the values of this attribute is unique. There are four options for unique property: - - - “Whole system” : The values of this attribute can duplicate with values which belong to other attributes. But the values in this attribute must not duplicate. - - “Organisation unit” : The values of this attribute must not duplicate in the same orgunit. - - “Program” : The values of this attribute must not duplicate in the same program. - - - “Program within Organisation unit” : The values of this attribute must not duplicate in the same program in the same orgunit. +
+ Basic information + + + Name - Name of attribute. + + + Short name - Short name of attribute. + + + Code - Code of attribute. + + + Description - Description of attribute. + + + Unique - Specify the values of this attribute is unique. There are four options for unique property: + + - “Whole system” : The values of this attribute can duplicate with values which belong to other attributes. But the values in this attribute must not duplicate. + - “Organisation unit” : The values of this attribute must not duplicate in the same orgunit. + - “Program” : The values of this attribute must not duplicate in the same program. + + - “Program within Organisation unit” : The values of this attribute must not duplicate in the same program in the same orgunit. - - - Inherit - When to registry a new entity for relationship with an available entity, all inherit entity attribute values of the entity will be pre-filled in the registration form. - - - Value Type - There are value types as follows : - - “Date” - - - “String” - - - “Number” - - - “Letter” - Just accept values with alphabet only ( a-z ) - - “Yes/No” - There are three options, include null, false, true. - - “Yes Only” - There are only one true value. - - - “Option Set” - Link to a optionset. The options of the optionset will be displayed on registration form. User can select only one option in option-set list as attribute value. - - - “Phone number” + + + Inherit - When to registry a new entity for relationship with an available entity, all inherit entity attribute values of the entity will be pre-filled in the registration form. + + + Value Type - There are value types as follows : + - “Date” + + - “String” + + - “Number” + + - “Letter” - Just accept values with alphabet only ( a-z ) + - “Yes/No” - There are three options, include null, false, true. + - “Yes Only” - There are only one true value. + + - “Option Set” - Link to a optionset. The options of the optionset will be displayed on registration form. User can select only one option in option-set list as attribute value. + + - “Phone number” - To make it more flexible to define new recipients to reminders and other messages in Tracker we will add a new Attribute Type called "Phone Number". Here the user can put any recipient name (attribute name) and collect the phone number (the value). All attributes of this type "phone number" will be available in the recipient lists for reminder templates or manual reminders/messages in Tracker. - - “Tracker associate”- A checkbox will be displayed on data entry form. When user checks this chekcbox, a form will be shown, user can seach an TEI existed or add new TEI. The id of TEI searched/added will be saved as value of this attribute. - + - “Tracker associate”- A checkbox will be displayed on data entry form. When user checks this chekcbox, a form will be shown, user can seach an TEI existed or add new TEI. The id of TEI searched/added will be saved as value of this attribute. + - ”Users” : In theTEI registration form,this attribute is rendered as a dropdown box with option as user-list who belongs to the selected orgunit. The id of user selected will be saved into database as value of this attribue. - - - An attribute can be set to display values of its in entity list search result by configuring in Manage attributes with no program function. - The Manage attributes for visit schedule supports configuration for entity attributes that are added to the visit schedule.This is very useful when the list is printed and used for tracking in the community. - Select patient attributes on the left section and move them to the right section and click Save button. + + +
+
+ Some configuration + An attribute can be set to display values of its in entity list search result by configuring in Manage attributes with no program function. + The Manage attributes for visit schedule supports configuration for entity attributes that are added to the visit schedule.This is very useful when the list is printed and used for tracking in the community. + Select patient attributes on the left section and move them to the right section and click Save button. +
Attribute group @@ -221,7 +226,7 @@ A program must have one tracked entity. And the entity registered must be specified an tracked entity. To enrol an entity into a program, the tracked entity of an entity and tracked entity of program must be the same. To access the tracked entity maintenance module, from Apps menu, go to Programs / Attributes option and click on it and select Tracked Entity menu.
-
+
Tracked entity form The tracked entity form section provides a mechanism for defining custom registration form for each available program in system or for normal registration form which is used to register any entity without having program information and this entity can enroll into a certain program after that. To access the entity registration form maintenance module, from Apps menu, go to Programs / Attributes option and click on it and select Tracked Entity Form option. @@ -234,7 +239,7 @@ Program and Program stage The section provides a mechanism for defining health programmes and action for each stage of the programme.
- Program + Program A program must be specified with only one tracked entity. And just entities what/who have the tracked entity as same as the tracked entity of program can enroll into that program. There are three type of program, include - @@ -251,304 +256,356 @@ To access the program maintenance module, from Apps menu, go to Programs / Attributes option and click on it. Select Program menu. 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 - - Program details section - - - - Name - The name of the program - - - Description - Descriptions, meanings, explanation, etc. of/about the program. - - - Type - There are three types of program: multi events with registration, single event with registration and single event without registration. - - - Data entry method - Used for displaying option-set data elements in case entry form as drop down list or radio buttons. If this option is selected as radio buttons, just option-set data elements which the number of option values is less then 8 are displayed as radio buttons. Others are displayed as drop down lists - - - Tracked Entity - Specify an tracked entity for the program. - - - Enrollment details section - - - - Allow future enrollment dates - - - Allow future incidence dates - - - Only enroll once (per tracked entity instance lifetime) - Check on it if a entity only can enroll the program one time. For example, Child Vaccination Program, Post-mortem examination, PSI's IPC process. This will avoid a entity enrolling more than one into a program when it doesn't make sense. - - - Show incident date - Set show/hide incident date field when a entity enroll in this program. - - - Description of incident date - The date when the entity 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). - - - Description of enrollment date - The date in which a entity is registered to the system. +
+ Basic information + Program details section - + + + Name - The name of the program + + + Description - Descriptions, meanings, explanation, etc. of/about the program. + + + Type - There are three types of program: multi events with registration, single event with registration and single event without registration. + + + Data entry method - Used for displaying option-set data elements in case entry form as drop down list or radio buttons. If this option is selected as radio buttons, just option-set data elements which the number of option values is less then 8 are displayed as radio buttons. Others are displayed as drop down lists + + + Tracked Entity - Specify an tracked entity for the program. + + + Enrollment details section - + + + Allow future enrollment dates + + + Allow future incidence dates + + + Only enroll once (per tracked entity instance lifetime) - Check on it if a entity only can enroll the program one time. For example, Child Vaccination Program, Post-mortem examination, PSI's IPC process. This will avoid a entity enrolling more than one into a program when it doesn't make sense. + + + Show incident date - Set show/hide incident date field when a entity enroll in this program. + + + Description of incident date - The date when the entity 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). + + + Description of enrollment date - The date in which a entity is registered to the system. For example: the date in which a entity enrolls to the system. - - - Allow enrollment at all orgunits - Check on it if user want to use the program on all organisation units no mater what the program is assigned to the organisation unit or not. Unchecnk if the program is only used on organisation units assigned. - - - Dashboard shortcut to add relative section - Define a program and a relationship type which has related to the program. It's used for registering a new entity, enroll into an other program and create relationship between entity who user is working on and the new entity. E.g after delivery, a baby is born, then in the Delivery event of the mother, user can register this baby and enroll him/her into the Child program. After that, create a relationship as Mother/Child for this mother and her baby. - - - Shortcut link label (e.g. Add Child) - The label for this shortcut link which is displayed in Relation tab of entity dashboard. - - - Relationship - Select a relationship type defined, e.g Mother/Child, ... - - - Who is the new relative to the existing entity? - - - Program for new relative to be enrolled in - Specify a program that new relatives of the entity who was enrolled in the program will be enrolled into this program when this relative registers the information. - - - Scheduling of events section - - - - Skip generation of events that are overdue (before enrollment date) - When a entity enrolls into the program, the events corresponding to the program-stages are created. If this field is checked, the system will ignore to generate overdue events. - - - Attributes section - Specify the dynamic attributes need for the program. + + + Allow enrollment at all orgunits - Check on it if user want to use the program on all organisation units no mater what the program is assigned to the organisation unit or not. Unchecnk if the program is only used on organisation units assigned. + + + Dashboard shortcut to add relative section - Define a program and a relationship type which has related to the program. It's used for registering a new entity, enroll into an other program and create relationship between entity who user is working on and the new entity. E.g after delivery, a baby is born, then in the Delivery event of the mother, user can register this baby and enroll him/her into the Child program. After that, create a relationship as Mother/Child for this mother and her baby. + + + Shortcut link label (e.g. Add Child) - The label for this shortcut link which is displayed in Relation tab of entity dashboard. + + + Relationship - Select a relationship type defined, e.g Mother/Child, ... + + + Who is the new relative to the existing entity? + + + Program for new relative to be enrolled in - Specify a program that new relatives of the entity who was enrolled in the program will be enrolled into this program when this relative registers the information. + + + Scheduling of events section - + + + Skip generation of events that are overdue (before enrollment date) - When a entity enrolls into the program, the events corresponding to the program-stages are created. If this field is checked, the system will ignore to generate overdue events. + + + Attributes section - Specify the dynamic attributes need for the program. There is a column in Select attribute section called Display in list. This is the required field. So please make sure that at least one attribute is set this property. For the attributes set Display in list, the values of these attributes are displayed in entity list in functionalities of Individual records module ( such as Find/Add Instance, Visit Schedule, Lost to follow up, … ). - This module also supports to define template message reminders which are sent to users/entities. To access to this function, click on the program which you would like to define template message reminder and select View template reminder message link. - - - Name - Name of description - - - Send base on - There are three options, include : - 1) Days scheduled - The message is sent in day ( datesToCompare + daysAllowedSendMessage ). - - 2) Complete program - The message is sent when the program of TEI is completed. - - 3) Program enrollment - The message is sent when TEI enrols into the program. - - - - Date to compare - This is the date used for calculating the date to send the message. There are 2 options, include - - 1) Enrollment Date - 2) Incident Date - - - Send message X days before/after scheduled date - The number of days needs to calculate the date for sending the message by scheduled. Just enter a number for this field in the case Send base on with value as Days schedule. - - - Recipients - Specify the kind of persons who will receive the message. There are 5 options, include + To assign a program for organisation units, click on the program which you would like and select Assign program to organisation units menu. Then select organisation units where provide the program. + To assign a program for user roles, click on the program which you would like and select Assign program to userroles menu. Then select user roles which you want in Available section and click Move selected items button or double click on the user role to move to Selected section. Finally, click OK to finish. + Besides, you can search user groups by typing a key in text field to set authorities. The result will loaded and you can select the group you want. Then click (+) button and the selected one will be displayed in below. + To translate the name of a program, click Translation icon, the seventh icon under Operations, corresponding to the program you would like. +
+
+ Program validation rule + To create validation rules for programs, click on the program which you would like and select Program validation rule management menu. Then click Add button and enter values for the fields in form to create a new one. A validation rule is based on an expression which defines a relationship between data element values. The expression has a left side and a right side and an operator which defines whether the former must be less than, equal to or greater than the latter. The expression forms a condition which should assert that certain logical criteria are met. For instance, a validation rule could assert that an admitted date given is before the discharged date. +
+
+ Program Indicator + To define a program indicator, click on the program which you would like and select Program Indicator management menu. + Basic information- + + + Name - Name of program indicator + + + Short name - Short name of program indicator + + + Code - Code of program indicator + + + Description - Description of program indicator + + + Value Type - The value type of indicator. It specifies the value of the indicator as a Number or Date. + + + Program Stage - Select an program stage to load the data elements which belong to the program selected. These data elements are used to define an indicator formula. + + + Data element tab - The data elements which belongs to the selected program. They are used to define an formula. By double clicking on the data element you want in the box, the formula of the selected data element will be displayed into Expression field. + + + Program tab - Includes three parameters for the program: + 1) Incident date - The incident date of an entity ( the entity registered this date when this entity enrols into the program ). + 2) Date of enrollment - The enrollment date of an entity ( the entity registered this date when this entity enrols into the program ). + 3) Current date - The system date when this indicator is run. + + +
+
+ Program template reminder + This module also supports to define template message reminders which are sent to users/entities for multi events registration and single event with registration programs. To access to this function, click on the program which you would like to define template message reminder and select View template reminder message link. + + + Name - Name of description + + + Send base on - There are three options, include : + 1) Days scheduled - The message is sent in day. + + 2) Complete program - The message is sent when the program of TEI is completed. + + 3) Program enrollment - The message is sent when TEI enrols into the program. + + + + Date to compare - This is the date used for calculating the date to send the message. There are 2 options, include - + 1) Enrollment Date + 2) Incident Date + + + Send message X days before/after scheduled date - The number of days needs to calculate the date for sending the message by scheduled. Just enter a number for this field in the case Send base on with value as Days schedule. + + + Recipients - Specify the kind of persons who will receive the message. There are 5 options, include - - 1) Tracked entity instance (SMS only) - 2) Attribute users - 3) Organisation unit phone number (SMS only) - 4) All users in organisation unit - 5) User group - - - User group - Select one user group if Recipients field is selected as User group. - - - Message type - This is the types of message. There are 3 options, include - - 1) Direct SMS - This kind of SMS message is linked to the program of an entity after sending to recipients. - 2) Message - 3) Both - - - Parameters - Provide parameters which are used for generating a message for each entity. The parameters include entity name, program name, incident date, days since incident date, enrollment date, days since enrollment date, organisation unit name. Double-click on an option to insert it into template message field below. + 1) Tracked entity instance (SMS only) + 2) Attribute users + 3) Organisation unit phone number (SMS only) + 4) All users in organisation unit + 5) User group + + + User group - Select one user group if Recipients field is selected as User group. + + + Message type - This is the types of message. There are 3 options, include - + 1) Direct SMS - This kind of SMS message is linked to the program of an entity after sending to recipients. + 2) Message + 3) Both + + + Parameters - Provide parameters which are used for generating a message for each entity. The parameters include entity name, program name, incident date, days since incident date, enrollment date, days since enrollment date, organisation unit name. Double-click on an option to insert it into template message field below. - - - Message - Content of template message. E.g. + + + Message - Content of template message. E.g. Dear {patient-name}, please come to your appointment at {due-date}. - - - To assign a program for organisation units, click on the program which you would like and select Assign program to organisation units menu. Then select organisation units where provide the program. - To assign a program for user roles, click on the program which you would like and select Assign program to userroles menu. Then select user roles which you want in Available section and click Move selected items button or double click on the user role to move to Selected section. Finally, click OK to finish. - To create validation rules for programs, click on the program which you would like and select Program validation rule management menu. Then click Add button and enter values for the fields in form to create a new one. A validation rule is based on an expression which defines a relationship between data element values. The expression has a left side and a right side and an operator which defines whether the former must be less than, equal to or greater than the latter. The expression forms a condition which should assert that certain logical criteria are met. For instance, a validation rule could assert that an admitted date given is before the discharged date. - To define a program indicator, click on the program which you would like and select Program Indicator management menu. - To set authority for sharing the program, click on the program which you would like and select Sharing Settings menu. You can see two parametters for authority, include External access (without login) and Public Access in the form with three authorities. There are three options for the public access as follows - - - - None - The program is private one. Just the user who created it can see and use it. - - - Read Only - The user who are not owner of this program only can see it, not edit and delete it. - - - Read and Write - All users can edit and delete it. - - - Besides, you can search user groups by typing a key in text field to set authorities. The result will loaded and you can select the group you want. Then click (+) button and the selected one will be displayed in below. - To translate the name of a program, click Translation icon, the seventh icon under Operations, corresponding to the program you would like. + + +
+
+ Program sharing + To set authority for sharing the program, click on the program which you would like and select Sharing Settings menu. You can see two parameters for authority, include External access (without login) and Public Access in the form with three authorities. There are three options for the public access as follows - + + + None - The program is private one. Just the user who created it can see and use it. + + + Read Only - The user who are not owner of this program only can see it, not edit and delete it. + + + Read and Write - All users can edit and delete it. + + +
+
+ Validation criteria + Validation criteria section provides a mechanism for defining criteria which validate if an entity can enrol into the program. + To access the validation criteria maintenance module, click on the program which you would like and select View validation criteria link on context menu to open Validation criteria management form. + To create a new validation criterion, click the Add new button. Fill all fields with read asterisk, and click Add button. + To translate the name of a validate criteria, click on the program stage which you would like and select Translation link. +
Program stage To define a program stage, click the row corresponding to the program you would like, then View program stages link in context menu. In Program stage management form, click Add new button. - Basic information - - Program stage details section - - - - 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 program stage details section - - - - Repeatable - specify the program stage as repeatable or not. - - - Display generate event box after completed - + To sort program stages by scheduled days, click Sort by scheduled days button. +
+ Base information + Program stage details section - + + + 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 program stage details section - + + + Repeatable - specify the program stage as repeatable or not. + + + Display generate event box after completed - Uncheck on it if you don't want to display Create new event box to create new event for a repeatable stage after clicking Complete button for an event of the stage in data entry form. This field is checked as default. - - - Standard interval days - Specify the number of days to repeat the repeatable program stage. - - - Form details section - - - - Auto-generate event - Uncheck this to prevent + + + Standard interval days - Specify the number of days to repeat the repeatable program stage. + + + Form details section - + + + Auto-generate event - Uncheck this to prevent for creating an event of this program stage automatically when a entity enroll into the program. - - - Open data entry form after enrollment - Automatically open the event of this stage as soon as the entity has enrolled into the program. - - - Report Date to use - The date is used for report date of the event opened automatically. There are two options , include Incident date or Enrollment date. - If the Report date to use is selected as one of those two('incident date'/'enrollment date'), in Dashboard, the 'Report date' of the event will be set as one of those two. - - - - Block entry form after completed - Check on it for blocking entry form after completed the event of this stage. The data values in the entry form cannot be changed until the status of the event is reset as incomplete. - - - Ask user to complete program when stage is completed - If this property is set, a popup will come up to ask if user wants to create the event of next stage. - - - Ask user to create new event when stage is complete - If this property is set, a popup will come up to ask if user wants to create a new event of this stage when an event of this stage completed. This property is active only when Repeatable field is set. - - - Generate events by enrollment date - Check on it for auto-generating due dates of events from program-stages of this program based on the enrollment date. If it is not checked, the due dates are generated based on incident date. - - - Capture coordinates - Many types of events may be recorded at a facility or be owned-by a health worker at a facility, but actually take place somewhere in the community. This field is checked to get coordinates of the place. - - - Complete allowed only if validation passes - The event created by this program stage is completed only when all validation rules are passed. - - - Description of report date - The description for report date which is displayed in case entry form. - - - Data elements section - Select entity data elements which belong to the program stage. There are four properties for each data element selected- - - - Compulsory - The value of this data element must be filled into data entry form before completing the event. - - - - Allow provided elsewhere - Specify if the value of this data element comes from other facility, not in the facility where this data is entered. - - - - Display in reports - Display the value of this data element into the SEWoR data entry function. - - - - Date in future - Allow to select a date in future for date data elements. - - - This module also supports to define template message reminders which are sent to users/entities. To access to this function, click on the program stage which you would like to define template message reminder and select View template reminder message link. - - - Name - Name of description - - - Send base on - There are two options, include : - 1) Days scheduled - The message is sent in day ( datesToCompare + daysAllowedSendMessage ). - - 2) Complete event - The message is sent when the event of an entity is completed. - - - Date to compare - This is the date used for calculating the date to send the message. There are 2 options, include: - 1) Enrollment Date - 2) Incident Date - - - Send message X days before/after scheduled date - The number of days needs to calculate the date for sending the message by scheduled. Just enter a number for this field in the case Send base on with value as Days schedule. - - - Recipients - Specify the kind of persons who will receive the message. There are 5 options, include + + + Open data entry form after enrollment - Automatically open the event of this stage as soon as the entity has enrolled into the program. + + + Report Date to use - The date is used for report date of the event opened automatically. There are two options , include Incident date or Enrollment date. + If the Report date to use is selected as one of those two('incident date'/'enrollment date'), in Dashboard, the 'Report date' of the event will be set as one of those two. + + + + Block entry form after completed - Check on it for blocking entry form after completed the event of this stage. The data values in the entry form cannot be changed until the status of the event is reset as incomplete. + + + Ask user to complete program when stage is completed - If this property is set, a popup will come up to ask if user wants to create the event of next stage. + + + Ask user to create new event when stage is complete - If this property is set, a popup will come up to ask if user wants to create a new event of this stage when an event of this stage completed. This property is active only when Repeatable field is set. + + + Generate events by enrollment date - Check on it for auto-generating due dates of events from program-stages of this program based on the enrollment date. If it is not checked, the due dates are generated based on incident date. + + + Capture coordinates - Many types of events may be recorded at a facility or be owned-by a health worker at a facility, but actually take place somewhere in the community. This field is checked to get coordinates of the place. + + + Complete allowed only if validation passes - The event created by this program stage is completed only when all validation rules are passed. + + + Description of report date - The description for report date which is displayed in case entry form. + + + Data elements section - Select entity data elements which belong to the program stage. There are four properties for each data element selected- + + + Compulsory - The value of this data element must be filled into data entry form before completing the event. + + + + Allow provided elsewhere - Specify if the value of this data element comes from other facility, not in the facility where this data is entered. + + + + Display in reports - Display the value of this data element into the SEWoR data entry function. + + + + Date in future - Allow to select a date in future for date data elements. + + +
+
+ Program stage entry form + A program stage has three types of data entry form - + + + Custom data entry form - Define a data entry form as HTML page. click on the program stage which you would like and select to define custom data entry form. The system supports to define a custom entry form with multi stages. So this form can be re-used in other stages of the same program. + + + Section data entry form - Group some data elements which belong to the program stage as sections and display data elements by each section. Click on the program stage which you would like and select Section management link to define section data entry form. + + + Default data entry form - List all data elements which belong to the program stage. + + +
+
+ Program stage template reminder + This module also supports to define template message reminders which are sent to users/entities. To access to this function, click on the program stage which you would like to define template message reminder and select View template reminder message link. + + + Name - Name of description + + + Send base on - There are two options, include : + 1) Days scheduled - The message is sent in day. + + 2) Complete event - The message is sent when the event of an entity is completed. + + + Date to compare - This is the date used for calculating the date to send the message. There are 2 options, include: + 1) Enrollment Date + 2) Incident Date + + + Send message X days before/after scheduled date - The number of days needs to calculate the date for sending the message by scheduled. Just enter a number for this field in the case Send base on with value as Days schedule. + + + Recipients - Specify the kind of persons who will receive the message. There are 5 options, include - - 1) Tracked entity instance (SMS only) - 2) Attribute users - 3) Organisation unit phone number (SMS only) - 4) All users in organisation unit - 5) User group - - - User group - Select one user group if Recipients field is selected as User group. - - - Message type - This is the types of message. There are 3 options, include - - 1) Direct SMS - This kind of SMS message is linked to the program of an entity after sending to recipients. - 2) Message - 3) Both - - - Parameters - Provide parameters which are used for generating a message for each entity. The parameters include entity name, program name, incident date, days since incident date, enrollment date, days since enrollment date, organisation unit name. Double-click on an option to insert it into template message field below. + 1) Tracked entity instance (SMS only) + 2) Attribute users + 3) Organisation unit phone number (SMS only) + 4) All users in organisation unit + 5) User group + + + User group - Select one user group if Recipients field is selected as User group. + + + Message type - This is the types of message. There are 3 options, include - + 1) Direct SMS - This kind of SMS message is linked to the program of an entity after sending to recipients. + 2) Message + 3) Both + + + Parameters - Provide parameters which are used for generating a message for each entity. The parameters include entity name, program name, incident date, days since incident date, enrollment date, days since enrollment date, organisation unit name. Double-click on an option to insert it into template message field below. - - - Message - Content of template message. E.g. + + + Message - Content of template message. E.g. Dear {patient-name}, please come to your appointment at {due-date}. - - - A program stage has three types of data entry form - - - - Custom data entry form - Define a data entry form as HTML page. click on the program stage which you would like and select to define custom data entry form. The system supports to define a custom entry form with multi stages. So this form can be re-used in other stages of the same program. - - - Section data entry form - Group some data elements which belong to the program stage as sections and display data elements by each section. Click on the program stage which you would like and select Section management link to define section data entry form. - - - Default data entry form - List all data elements which belong to the program stage. - - - - A custom data entry form can have data elements which belong to other stages of the program. This form can be reused for the stages of program. When the form is opened to enter data, the data values which belong to other events will be displayed if any, but user can not modify them. Just only data values with data elements which belong to the stage selected are editable. - - To sort program stages by scheduled days, click Sort by scheduled days button. -
-
- Validation criteria - Validation criteria section provides a mechanism for defining criteria which validate if an entity can enrol into the program. - To access the validation criteria maintenance module, click on the program which you would like and select View validation criteria link on context menu to open Validation criteria management form. - To create a new validation criterion, click the Add new button. Fill all fields with read asterisk, and click Add button. - To translate the name of a validate criteria, click on the program stage which you would like and select Translation link. + + + + A custom data entry form can have data elements which belong to other stages of the program. This form can be reused for the stages of program. When the form is opened to enter data, the data values which belong to other events will be displayed if any, but user can not modify them. Just only data values with data elements which belong to the stage selected are editable. + +
-
+
Aggregation query builder 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. This provides two functions - @@ -560,8 +617,8 @@ Apps > Individual Records > Manual Aggregation is used for generating routine data values from individual data by period and organization unit. -
- Aggregation Query Builder +
+ Basic information To access Aggregation Query Builder module, from the Apps menu, go to the Programs / Attributes option. Select Aggregation Query Builder option on left menu to proceed. To define a formula, click the Add new button.