=== added file 'src/docbkx/en/dhis2_user_man_using_event_capture.xml' --- src/docbkx/en/dhis2_user_man_using_event_capture.xml 1970-01-01 00:00:00 +0000 +++ src/docbkx/en/dhis2_user_man_using_event_capture.xml 2014-04-09 13:50:50 +0000 @@ -0,0 +1,133 @@ + + + + Using Event Capture +
+ Overview + The event capture module allows users to register events that occurred at a particular + time and place. In DHIS2,time and place correspond, respectively, to period and organisation + units. However, since events are treated as random occurrences there is no such thing as + period for them, rather a date the event has occurred. + +
+
+ Program definition + In order to capture events, it is mandatory for users to first define the nature of the + event using the Program/Attribute module. Below is a guiding step for this: + + Go to Programs/Attributes module + + + Select Program + + + Click Add new and fill in the necessary details. Under Program + details make sure Type is "Single event without + registration". Below is a snapshot to depict this. + + + + Example single event program creation + + + + + + Once a single event program is created, the system automatically creates a single + program stage. The stage can be accessed from the context menu of the program created. + Clicking "Edit" from the context menu of the program stage + takes to the detail view of the program stage, similar to the one shown below. + + Example single event program stage creation + + + + + + As can be seen from the program stage screen shot above, users have the chance to + define what to collect during event capture. This is possible by selecting a list of data + elements from "Available data elements" to "Selected data elements". Under selected data elements, please pay + attention for the following check boxes: + + Compulsory: whether it is mandatory or not to + collect the element during event capture + + + Allow provided elsewhere: this is to define if + the data element can be collected by the selected organisation unit while it has + occurred elsewhere. For example, from the figure, it is possible for "mnch Blood + pressure" to be measured in another facility but reported in the selected facility where + these is no blood pressure measuring device. + + + Display in reports: this decides if the data + element can appear in reports or not. If there are many data elements to be collected + during event capture, it makes more sense to prioritize which ones to show in report by + default. + + + Date in future: this is only for those date type + data elements and to decide if it is possible to allow collect future dates or + not. + + + In addition to defining program and program stage, another important step to complete + before event capturing is associating programs with organization units. This can be done + through "Assign program to organisation units" button from + the context menu of the selected program. +
+
+ Operations + Event capturing is possible by selecting an organisation unit and a program. The moment a + program is selected the system displays existing events. Events are displayed in a tabular + fashion as shown in the figure below. From the figure, each row corresponds to an event and + the columns are event details (data elements). + + Example event list + + + + + + + All event related operations are accessible from the screen shown above. The operations + currently available are: + + Capturing - this available by clicking the "Register New Event" button. + + + Column show/hide - this is to allow users decide which columns to show/hide. This + feature is especially important when we have a long list of data elements assigned to a + program stage. + + + Editing - the rows in the table are clickable. Clicking them shows three menus - + Edit, Edit in grid + and Remove. The difference between edit and edit in + grid is that, Edit takes to a new page with an opportunity to edit all the data elements + of the selected event. However, edit in grid allows to edit the selected event within + the table but only those columns (data elements) visible in the grid. If more columns + are required, it is possible to add using the "Show/Hide columns" button. + + + Sorting - this is possible by clicking the text of each column header. + + + Filtering - this is possible by clicking the small search icon shown to the right of + each column header. Clicking them provides an input field to type a filtering criteria. + The moment a user types a filter, the system starts applying. During filtering it is + possible to define start and end dates for date type data elements and lower and upper + limits for number types. For the rest, it is just a text. + + + Paging - using the links at the bottom of the table, it is possible to have some + paging interactions. + + +
+
=== modified file 'src/docbkx/en/dhis2_user_manual_en.xml' --- src/docbkx/en/dhis2_user_manual_en.xml 2014-02-24 14:34:59 +0000 +++ src/docbkx/en/dhis2_user_manual_en.xml 2014-04-09 13:50:50 +0000 @@ -32,6 +32,7 @@ + === added directory 'src/docbkx/en/resources/images/event_capture' === added file 'src/docbkx/en/resources/images/event_capture/create_program.png' Binary files src/docbkx/en/resources/images/event_capture/create_program.png 1970-01-01 00:00:00 +0000 and src/docbkx/en/resources/images/event_capture/create_program.png 2014-04-09 13:50:50 +0000 differ === added file 'src/docbkx/en/resources/images/event_capture/edit_program_stage.png' Binary files src/docbkx/en/resources/images/event_capture/edit_program_stage.png 1970-01-01 00:00:00 +0000 and src/docbkx/en/resources/images/event_capture/edit_program_stage.png 2014-04-09 13:50:50 +0000 differ === added file 'src/docbkx/en/resources/images/event_capture/event_list.png' Binary files src/docbkx/en/resources/images/event_capture/event_list.png 1970-01-01 00:00:00 +0000 and src/docbkx/en/resources/images/event_capture/event_list.png 2014-04-09 13:50:50 +0000 differ