9.3 Manage event layers

The event layer displays 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 Org Unit under which the events are recorded.

Event layers are represented by layer cards in the layer panel such as:

Along the top of the event card from left to right are:

In the middle of the event card is a legend indicating the styling of the layer.

Along the bottom of the event card from left to right are:

9.3.1 Create an event layer

To create an event layer, choose Events on the Add layer selection. This opens the Events layer configuration dialog.

  1. In the DATA tab:

    • Select a program and then select a program stage. The Stage field is only shown once a program is selected.

      If there is only one stage available for the selected program, the stage is automatically selected.

    • Select a value from the Coordinate field for the positions shown on the map. By default, “Event location” is selected. Depending on the data elements or attributes that belong to a program, other coordinates such as “Household position” are available.

  2. In the PERIOD tab

    • 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 .

  3. In the FILTER tab:

    • Click ADD FILTER and select an available data item to add a new filter to the data set.

      • For data item 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 item 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.

      Multiple filters may be added. Click the X on the far right of the filter to remove it.

  4. In the ORG UNITS tab:

    • Select the organisation units you want to include in the layer. It is possible to select either

      • One or more specific organisation units, or

      • A relative level in the organisation unit hierarchy, with respect to the user. By selecting a User organisation unit the map data will appear differently for users at different levels in the organisation unit hierarchy.

  5. In the STYLE tab:

    • Select Group events to group nearby events, or View all events to display events individually.

    • Select a color for the event or cluster points.

    • Select the radius (between 1 and 20) for grouped events; also known as clusters .

  6. Click ADD LAYER .

9.3.2 Modify an event layer

  1. In the layer panel, click the edit (pencil) icon on the event layer card.

  2. Modify the setting on the DATA, PERIOD, FILTER, ORG UNIT and STYLE tabs as desired.

  3. Click UPDATE LAYER .

9.3.3 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.

  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 .

9.3.4 Clear event layer

To clear all event layer data in a map:

  1. In the layer panel, click the delete (trash can) icon on the event layer card.

    The layer is removed from the current map.