14.3. Manage event layers

The purpose of the event layer is to display the geographical location of events registered in the DHIS2 tracker. Provided that events have associated GPS coordinates, you can use this layer to drill down from the aggregated data displayed in the thematic layers to the underlying individual events or cases.

You can also display aggregated events at the facility or at the boundary level. You do this through a thematic layer using event data items. This is useful when you only have the coordinates for the OrgUnit under which the events are recorded.

Event layer

14.3.1. Create or modify event layer

  1. In the top menu, click the event layer icon.

  2. Click Edit layer.

  3. Select a program and then select a program stage.

    If there is only one stage available for the selected program, the stage is automatically selected. A list of data elements and attributes will appear in the Available data items panel.

  4. Select any data element or attribute from this list as part of your query.

    • To select you can either double-click a data element or (multi) select and use the single-arrow downward button. The double-arrow button will select all data elements in the list. All selected data elements will get their own row in the Selected data items.

    • For data elements of type text you will get two choices: Contains implies that the query will match all values which contains your search value, and Is exact implies that only values which is completely identical to your search query will be returned.

    • For data elements of type option set, you can select any of the options from the drop down box by using the down-wards arrow or by start typing directly in the box to filter for options.

  5. In the Periods section, select the time span for when the events took place. You can select either a fixed period or a relative period.

    • Fixed period: In the Period field, select Start/end dates and fill in a start date and an end date.

    • Relative period: In the Period field, select one of the relative periods, for example This month or Last year.

  6. In the Organisation units section, select the organisation units you want to include in the query.

  7. In the Options section, select if you want group nearby events and change style of the cluster points.

  8. Click Update.

14.3.2. Turn off cluster

By default events are clustered in a map. You can turn off this function to display all events separately.

  1. In the top menu, click the event layer icon.

  2. Click Edit layer.

  3. Click Options.

  4. Clear Group nearby events check box.

  5. Click Update.

14.3.3. Modify cluster style

  1. In the top menu, click the event layer icon.

  2. Click Edit layer.

  3. In the Options section, change the Point color and Point radius.

  4. Click Update.

14.3.4. Modify information in event pop-up windows

For events in a cluster map, you can modify the information displayed in the event pop-up window.

Pop-up window with event information

  1. Open the Programs / Attributes app.

  2. Click Program.

  3. Click the program you want to modify and select View program stages.

  4. Click the program stage name and select Edit.

  5. Scroll down to the Selected data elements section.

  6. For every data element you want to display in the pop-up window, select corresponding Display in reports.

  7. Click Update.

14.3.5. Clear event layer

To clear all data in a map:

  1. In the top menu, click the event layer icon.

  2. Click Clear.