=== modified file 'src/docbkx/en/dhis2_user_man_using_event_capture.xml'
--- src/docbkx/en/dhis2_user_man_using_event_capture.xml 2014-04-09 13:50:50 +0000
+++ src/docbkx/en/dhis2_user_man_using_event_capture.xml 2014-04-22 14:44:31 +0000
@@ -4,88 +4,22 @@
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.
-
+ The event capture app allows users to register events that occurred at a particular time
+ and place. An event can happen at any given point in time. This stands in contrast to routine
+ data, which can be captured for predefined, regular intervals. Events in DHIS 2 are linked to
+ program. Hence, the event capture app lets you select the organisation unit, program and point
+ in time when an event (also known as case or record) happened, before entering information for
+ that event.
- 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).
+ Capturing events
+ To capture an event, the first step is to select an organisation unit from the left-side
+ organisation unit tree. After selecting an org unit, the list of programs will display the
+ programs which have been associated with the selected organisation unit and which have been
+ given access to the current user through user roles. Events are displayed in a tabular fashion
+ as shown in the figure below. As seen in the screenshot, each row corresponds to an event. The
+ columns display information about the events, more specifically they display data for data
+ elements which are part of the program.
Example event list
@@ -98,36 +32,45 @@
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.
+ Capturing data: 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.
+ Showing/hiding colums: this is to allow users decide which columns to show/hide in
+ the table of events. 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.
+ and Remove. The edit function takes you to a new page
+ where information for the selected event can be updated. The edit in grid function
+ allows you 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 to speficy which columns should be displayed in the
+ list.
+
+
+ Sorting: this can be done by clicking the text of each column header.
+
+
+ Filtering: this is done 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
+ system starts applying the filter the moment a user starts to type. During filtering it
+ is possible to define start and end dates for date type data elements and lower and
+ upper limits for number types.
+
+
+ Paging: The list of events can be paged by using the paging section at the bootom of
+ the list. Paging allows you to quickly move between pages of events and to change the
+ page size, i.e. the number of events per page.
+ The event capture module works offline, in the sense that if Internet connectivity drops
+ during your working session, you can continue to capture events which will be stored locally
+ in your web browser (client). When connectivity has returned the system will ask you to upload
+ your locally stored data, which sends the data to the Web server where it is stored. Note that
+ if you close your Web browser while being disconnected from the Internet, you cannot return to
+ your working session; however your data will still be saved locally and can be uploaded to the
+ Web server the next time your are online and log into the system.
=== removed file 'src/docbkx/en/resources/images/event_capture/create_program.png'
Binary files src/docbkx/en/resources/images/event_capture/create_program.png 2014-04-09 13:50:50 +0000 and src/docbkx/en/resources/images/event_capture/create_program.png 1970-01-01 00:00:00 +0000 differ
=== removed 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 2014-04-09 13:50:50 +0000 and src/docbkx/en/resources/images/event_capture/edit_program_stage.png 1970-01-01 00:00:00 +0000 differ