Lock exceptions

Lock exceptions Lock exceptions provide fine-grained control over exemption from a locked data set. After the expiry of the data set, data entry will be denied by default, unless an exception has been granted through the Lock exception interface. To enable a lock exception, select the desired organization units, data sets, and time period and press "Add". By granting a lock exception, data entry will be enabled even after the expiry period of the data set has passed. @@ -306,7 +306,7 @@ Organisation unit pruning If you need to prune out branches of the organisational unit hierarchy, you can use the organisational unit pruning function. Keep in mind that the only selected organisational (and its children) will be kept. All other orgunits (and any data associated with them) will be deleted from the database.

Min-Max Value Generation This administrative function can be used to generate min-max values, which are used as part of the data quality and validation process for specific organization units and data sets. Simply select the dataset from the left hand frame, and then select the required orgunits to generate the min-max values for from the organisational units selector on the right. Press the "Generate" button to generate or regenerate all min-max values. Press "Remove" to remove all min-max values which are currently stored in the database. @@ -317,7 +317,7 @@

Constant Constants are static values which can be made available to users for use in data elements and indicators. Some indicators, such as "Couple year protection rate" depend on constants which usually do not change over time. Simply press "Add" and provide a name in the "Name" field and define it's value in the "Value" field. Press "Add" . The constant will now be available to users for use in their expressions. @@ -328,10 +328,9 @@

Option sets - Option sets can be associated with data -elements in the add / update data element interface for name-based data elements. You can define any kind of options, for instance an option set + Option sets can be associated with data elements in the add / update data element interface for name-based data elements. You can define any kind of options, for instance an option set called "Delivery type" where "Normal", "Breach", "Caesarian" and "Assisted" would be the options. This option set can later be associated with any number of data elements. When doing data entry in @@ -343,7 +342,7 @@ Cache Statistics This option is for system administrators only to use. The cache statistics shows the status of the application level cache. The application level cache refers to the objects and query results that the application is caching in order to speed up performance. If the database has been modified directly the application cache needs to be cleared for it to take effect.

Dynamic attributes Dynamic attributes can be used to add additional information to certain objects (namely data elements, indicators, organisation units and users). In addition to the standard attributes each of these objects have, it may be required in certain installations to have additional attributes, such as a fax number which is associated with an organisation unit. To add a new dynamic attribute to an object, select "Maintenance->Data administration" from the main menue, then "Attribute" from the left side panel, and press the "Add new" button. @@ -356,7 +355,7 @@ To create a new attribute, assign it a name. Each attribute should have a unique name. Check the tick-box "Mandatory" if the object should always have the dynamic attribute. Next, select which object (or objects) the attribute should be assigned to. Lastly, select the value type. You can choose from "Text", "Yes/No", "Date", "Number", "Integer", "Positive integer" and "Negative integer". If the value supplied for the attribute does not match the value type, an error will result. Finally, click "Save" to save the attribute. The dynamic attribute will now be present in the object which you assigned it to in the respective "Edit" screen of each the object.

Scheduling Data mart jobs can be automatically scheduled to run on regular intervals. Simply select the aggregation period types, organisation unit group set aggregation level, and strategy to configure how the scheduled job should run. Pressing "Start" will enable the scheduled job to run at a pre-determined time or can be run immediately by pressing "Execute now" === modified file 'src/docbkx/en/dhis2_user_man_datasets_forms.xml' --- src/docbkx/en/dhis2_user_man_datasets_forms.xml 2011-09-14 05:12:06 +0000 +++ src/docbkx/en/dhis2_user_man_datasets_forms.xml 2012-04-16 13:42:40 +0000 @@ -5,12 +5,10 @@

Datasets All data entry in DHIS2 is organised through the use of datasets. You can add and edit datasets in Maintenance->Datasets. A dataset is a collection of data elements grouped together for data collection and data export between instances of DHIS2 (e.g. from a district office local installation to a national server). . - A dataset also has a frequency which controls the data collection frequency, which can be daily, weekly, monthly, quarterly, six-monthly, or yearly. Both which data elements to include in the dataset and the frequency is set in the Add/Edit Dataset window, together with a name, short name, and code. - -In order to use a dataset to collect data for a specific orgunit you must assign the orgunit to the dataset, and this mechanism controls which orgunits that can use which datasets. + A dataset also has a frequency which controls the data collection frequency, which can be daily, weekly, monthly, quarterly, six-monthly, or yearly. Both which data elements to include in the dataset and the frequency is set in the Add/Edit Dataset window, together with a name, short name, and code. In order to use a dataset to collect data for a specific orgunit you must assign the orgunit to the dataset, and this mechanism controls which orgunits that can use which datasets. Datasets also are assigned to specific organisation units which will be allowed to enter data for all data elements in a given dataset. You can assign orgunits to a dataset in the Dataset Management (list of available datasets are shown) by clicking on the blue folder icon, the first icon under Operations, corresponding to the dataset you would like to modify. Alternatively you can manage orgunit assignments for all datasets together in the Dataset Assignment Editor (available in the right-side menu for Datasets). Your dataset will then be ready to be used in Services->Data Entry for the orgunits that you have assigned and for periods according to your selected frequency (period type). -

Dataset management The dataset management function allows you to create new datasets and manage existing ones. The dialog can be reached by choosing Maintenance->Datasets->Dataset. A sample dialog is displayed below. @@ -58,18 +56,15 @@

Data Entry Forms Once you have assigned a dataset to an orgunit that dataset will be made available in Data Entry (under Services) for the orgunits you have assigned it to. A default data entry form will then be shown, which is simply a list of the data elements you belonging to the dataset together with a column for inputting the values. If your dataset contains data elements with a non-default categorycombination, such as age groups or gender then additional columns will be automatically generated in the default form based on the different options/dimensions. - If you use more than one dataelement category combination you will get multiple columns in the data entry form with different column headings for the options. - -In addition to the default list-based data entry form there are two more alternatives, the section-based form and the custom form. + If you use more than one dataelement category combination you will get multiple columns in the data entry form with different column headings for the options. In addition to the default list-based data entry form there are two more alternatives, the section-based form and the custom form.

Section forms Section forms allow for a bit more flexibility when it comes to using tabular forms and are quick and simple to design. Often your data entry form will need multiple tables with subheadings, and sometimes you need to disable (grey out) a few fields in the table, both of these functions are supported in section forms. This function can be access by choosing Maintenance->Dataset Section.

Adding a new section form Section forms are separated automatically by data element category combinations, which produce a spreadsheet like data entry form for each section. - When designing a section form the procedure is as follows: - + When designing a section form the procedure is as follows: Set up your dataset as described in @@ -80,8 +75,7 @@ - You may need to control how the data element sections are displayed on the final form. In Dataset Section management, select the dataset from the "Dataset" drop-down box, then leave [All] in the "Select Category Combo" drop-down. Click on "Sort section" to sort the order of appearance of your sections in the data entry form. - + You may need to control how the data element sections are displayed on the final form. In Dataset Section management, select the dataset from the "Dataset" drop-down box, then leave [All] in the "Select Category Combo" drop-down. Click on "Sort section" to sort the order of appearance of your sections in the data entry form. In Data Entry you can now start using the Section form (should appear automatically when sections are available for the selected dataset). Datasets which have section forms will automatically display the section form. @@ -107,16 +101,15 @@

- Custom Forms +

+ Custom Forms When the form you want to design is to complicated for the default or section forms then your last option is to use a custom form. This takes more time, but gives you full flexibility in term of the design. DHIS2 uses a built-in HTML editor (FcK Editor) for the form designer and you can either design the form in the UI or paste in your HTML directly (using the Source window in the editor). A complete reference for use of the editor can be found here. One of the big advantages of custom forms, is that they can be created to mimic existing paper aggregation forms. This makes data entry much easier for users, and should reduce the number of data elements which are incorrectly entered, as they are more easily identifiable when entering data from a paper form. Once a custom form has been added to a dataset it will be available in data entry and used automatically. Custom forms are preferentially displayed over section forms. If a dataset has both a section form and a custom form, the custom form will be displayed during data entry. Users will not be able to select which method they wish to input data, so be sure that your custom form contains all data elements which may be required. - To add a custom form design to a dataset then first locate your dataset in the Dataset Management window and click on the Design data entry form icon under Operations (the fifth icon), see the mouse-over text to be sure. - + To add a custom form design to a dataset then first locate your dataset in the Dataset Management window and click on the Design data entry form icon under Operations (the fifth icon), see the mouse-over text to be sure. First provide a Name for the form. There are a few important buttons in the Editor that you must pay special attention to. The blue monitor icon is the full screen mode on/off button, which can be very useful. The there is a Source button that shows the HTML code for your form. If you already have the HTML for your form then you should start by pasting it in here. Click on Source again to go back to preview/non-HTML mode. Then there is an icon in the top right corner with a + sign on it, this will open a list of available data elements to add to your form, the Data Element Selector window. All the input fields need to have a link to a data element or indicator. To add new data elements to the form, double-click them from the data element/indicator box as shown below. You can also select a data element/indicator and press the "+Insert" button. You can switch between either data elements or indicators by pressing the respective buttons. @@ -128,8 +121,12 @@ You can to intermediary saving by clicking on the Save button, and this will not close the window. It is recommended to save often to ensure you do not loose your work. - When you are done or want to test your form in data entry click on <Save and close>. - + When you are done or want to test your form in data entry click on <Save and close>. +

+ Data set assignment editor + The data set assignment editor is a tool for adding and removing many data sets to organisation units in batch style. Start by selecting an organisation unit from the selection tree. In the area below the tree a grid will be displayed showing all data sets as columns and the child organisation units as rows. + From the grid you can now assign or unassign data sets simply by clicking on of the corresponding icons in the grid. If you want to assign or unassign an organisation unit to all data sets you can check or uncheck the checkbox next to the organisation unit. Your changes will automatically be saved.

=== modified file 'src/docbkx/en/dhis2_user_man_settings.xml' --- src/docbkx/en/dhis2_user_man_settings.xml 2011-12-09 12:31:10 +0000 +++ src/docbkx/en/dhis2_user_man_settings.xml 2012-04-16 13:42:40 +0000 @@ -6,7 +6,7 @@

User settings The user settings section provides general configuration options and options specifically for email. -

User general settings @@ -29,8 +29,8 @@

- User email settings +

+ User message settings Message email notification: Decides whether you want to receive email notifications. Currently the system offers email notifications of messages received in the dashboard. This requires that you have entered your email address in your personal account details - you can access it under "Help" - "User account". @@ -41,7 +41,7 @@

System settings The system settings section provides general configuration options and options specifically for appearance and email. -

System general settings @@ -75,7 +75,7 @@

System appearance settings @@ -92,7 +92,7 @@

System email settings === modified file 'src/docbkx/en/dhis2_workbook.xml' --- src/docbkx/en/dhis2_workbook.xml 2012-04-13 14:43:25 +0000 +++ src/docbkx/en/dhis2_workbook.xml 2012-04-16 13:42:40 +0000 @@ -10,10 +10,10 @@ Data Visualizer - Explain briefly the various panels of the data visualizer module + Overview - Explain briefly the various panels of the data visualizer - Left bar: Selection of chart type, input parameters and options for your visualization + Left bar: Selection of chart type, input parameters and options for your visualization. Top bar: Buttons for updating your visualization, saving as favorite, downloading and viewing data table. @@ -58,10 +58,10 @@ Open Organisation Units panel in the left bar. - Righ-click on the top organisation unit and click Select all children, then click update. + Right-click on the top organisation unit and click Select all children, then click update. - Observe how the the visaulization is comparing the organisation units. + Observe how the the visualization is comparing the organisation units. @@ -95,7 +95,7 @@ Select Last 4 quarters, and click update. - Observe all the available relative periods and how they are renderd in the chart. + Observe all the available relative periods and how they are rendered in the chart.