Trainer’s Guide to Event Reports¶

What is this guide?¶

This guide is a support document for DHIS2 Academy trainers for the session “Event Reports.” This session follows the standard Academy training approach with

1. a live demo session where the trainer demonstrate and explain the features, and

2. praktické sezení se cvičeními, kde si účastníci procvičí stejné funkce.

This guide will help the trainer​ prepare​​ for the live demo session. The “Live Demo step by step” section has a detailed walkthrough of all the steps to demonstrate with explanations and screenshots that should be easy to follow. Use that when preparing for the live demo session.

There is also a Quick Guide which lists the steps very briefly and this is meant as a lookup guide or “cheatsheet” WHILE doing the demo, to help the trainer remember all the steps and the flow of the demo.

Learning objectives for this session¶

The overall objective of this session is to use the DHIS2 event reports app to review tracker data. Detailed objectives include:

1. Popište funkce aplikace hlášení událostí
2. Vysvětlete rozdíl mezi přehledy typu události a registrace
3. Navrhujte zprávy o událostech pomocí dat sledování
4. Popište rozdíly mezi tím, jak se zobrazují opakovaná a neopakovaná data fáze
5. Navrhněte zprávy událostí zobrazující data z několika fází programu sledování

Time Requirements¶

Live Demo: 4 demos, 10 minutes each Hands-on Exercises: 4 exercises, 10 minutes each Assignment:

Pozadí¶

Tato lekce staví na konceptech představených během kurzu základů akce. V kurzu Základy událostí si student zopakuje, jak vytvořit zprávy o události pro jednu událost, a to vytvořením řádkových seznamů i agregovaných zpráv. I když to bude rychle zopakováno v rámci tohoto sezení, bude zahrnuto také množství dalších pojmů, o kterých se nediskutovalo (jak je uvedeno ve výukových cílech). Z tohoto důvodu je úvodní část příručky stručná a předpokládá se, že student je s těmito pojmy obeznámen. Pokud tomu tak není, budete muset zpomalit ve vysvětlování rozhraní a vytvořit nějaké počáteční sestavy společně.

Preparations¶

V této relaci vytvoříte řadu přehledů. Ujistěte se, že jste spustili analýzu v demo databázi, kterou používáte, a že všechna data jsou správně vyplněna. Pokud zjistíte, že data nejsou k dispozici pro správné období nebo rok, kontaktujte tým pro obsah školení, abychom vám mohli poradit, jak data správně přesunout.

Před prezentací byste měli zvážit, jak si celé demo projít. Poté byste si měli vzít stručnou příručku a doplnit ji o další poznámky, které jste si udělali během procházení ukázky. Pokud zjistíte jakékoli změny, které mohou být vyžadovány, nebo dodatečné vysvětlení, které by mohlo být užitečné v rámci relace, uveďte prosím obsah týmu školení, abychom mohli vyhodnotit, jak nejlépe začlenit tuto zpětnou vazbu do materiálu.

Každá vizualizace, o jejíž vytvoření budete požádáni, byla uložena a měla by být sdílena pro veřejné zobrazení. Pokud si nejste jisti obsahem některého z vizualizací, můžete si každou otevřít a zkontrolovat, jak byla vytvořena.

Hlavním materiálem, který bude studentovi poskytnut s podrobnými kroky pro neklasifikovaná cvičení, a také s klíčovými sděleními ze sezení, jsou také příručka pro studenta a shrnutí relace. Projděte si je také, abyste se ujistili, že tyto klíčové body během své demonstrace dokážete probrat.

Best Practices¶

Před zahájením demonstrace mějte prosím na paměti, že nejdůležitější je, aby je publikum sledovalo, takže nezapomeňte publiku položit otázky, abyste si ověřili, že je sledují. Pokud je něco nejasné, vraťte se a projděte si to pomalu. Pokud nemáte čas na všechny kroky, je lepší některé kroky zkrátit, než jít rychle, zatímco nikdo nerozumí.

V online prostředí budete pravidelně dělat přestávky, abyste jim umožnili provádět různá neklasifikovaná cvičení, abyste udrželi pozornost.

In an in-person setting, the participants may be doing the demo with you at the same time. In this scenario, it is ideal if there are other trainer's moving around the room to support participant's as it will be difficult for the trainer leading the session to answer many individual questions during the demonstrations.

Quick Guide¶

1. Zkontrolujte rozhraní zpráv o událostech
2. Pomocí sledování COVID-19 vytvořte souhrnnou zprávu/přehled událostí kontingenční tabulky obsahující následující podrobnosti:
3. Styl tabulky: Kontingenční, Typ výstupu: Událost
4. Program: COVID-19 Case Based Surveillance
5. Fáze : Fáze 3 - Laboratorní výsledky
6. Data : Výsledek laboratorního testu (vyberte jako filtr Pozitivní), Věk (použijte legendu o věku COVID-19), Pohlaví
7. Období: Tento rok
8. Organizační jednotka: Země
9. Vytvořte řádkový seznam událostí pomocí očkování proti COVID-19
10. Styl tabulky: Řádek, Typ výstupu: Událost
11. Program : COVAC - Registr očkování proti COVID-19
12. Fáze: Očkování
13. Data
14. Jméno, příjmení, občanský průkaz, pohlaví
15. Název vakcíny
16. Číslo dávky (filtrovat podle 1. dávky)
17. Období: Tento rok
18. Organizační jednotka: Země

STOP! Nechte je provést cvičení 1

1. Vytvořte zprávu o události seznamu pro opakovatelnou fázi pomocí programu sledování COVID-19
2. Otevřete tento záznam v zachycování sledovače a prohlédněte si opakované události ve fázi 2 – laboratorní požadavek
   • Organizační jednotka: CHW Mahosot
   • Program: Sledování případů COVID-19
   • ID místního případu: ID-5353942, křestní jméno: Angela, příjmení: Campbell, pohlaví: žena
3. Vytvořte zprávu o události s následujícími vstupy:
   • Styl tabulky: Seznam řádků
   • Typ výstupu: Event
   • Program: COVID-19 Case-based Surveillance, Fáze: Lab Request
   • Data :
     • Local Case ID : ID-5353942
     • Jméno
     • Příjmení
     • Důvod laboratorního testu
     • Typ testu
     • Typ exempláře
     • Období: Minulý rok
     • Organizační jednotka: CHW Mahosot
4. Vysvětlete, jak fungují sestavy událostí s opakovanými daty

5. Přidejte více opakovaných dat odstraněním filtru pro místní ID případu a změňte období na tento rok

6. Vytvořte stejnou sestavu pomocí registrace jako typu výstupu

7. Styl tabulky: Seznam řádků

8. Typ výstupu: Zápis
9. Program: COVID-19 Case-based Surveillance, Fáze: Lab Request
10. Data :
    • Local Case ID
    • Jméno
    • Příjmení
    • Důvod laboratorního testu
    • Typ testu
    • Typ exempláře
11. Období: Tento rok
12. Organizační jednotka: CHW Mahosot

STOP! Have them perform Exercise 2

1. Create an aggregate/pivot table event report using a repeatable stage

2. Create a report with the following details:

   • Styl tabulky: Kontingenční, Typ výstupu: Událost
   • Program : COVAC - COVID-19 Vaccination Registration
   • Fáze: Očkování
   • Data : Sex, Vaccine Name
   • Období: Tento rok
   • Organizační jednotka: Země
3. Duplicate your tab and open the event report "COVAC - Registrations by sex."
4. Compare these two outputs

STOP! Have them perform Exercise 3

1. Create a line list enrollment type event report using multiple stages from the COVID-19 surveillance program

   • Styl tabulky: Seznam řádků
   • Typ výstupu: Zápis
   • Program : COVID-19 Case-based Surveillance
   • Atributy
   • First Name, Surname, Sex
   • Stage 1 - Clinical Exam
   • Underlying condition
   • Signs/symptoms present
   • Stage 3 - Lab Results
   • Type of Test
   • Lab Result
   • Stage 4 - Health Outcome
   • Health Outcome
   • Období: Tento rok
   • Organizační jednotka: Země

2. Review the recap slide

3. Have them perform the assignment

STOP! Have them perform exercise 4

Once they have completed all of the ungraded exercises, they should then complete the graded assignment

Live Demo step by step¶

Review the events reports interface¶

Access the event reports app and review the interface

Periods in Event Reports¶

In event reports, Periods can be selected as either Fixed or relative periods (same as aggregate) or with specific start/end dates (specific to event/tracker data)

If choosing the start/end dates than you can select exact dates to filter events based on the report date that was entered during event or tracker capture.

Create an aggregate/pivot table using Malaria Case notification in Event Report App¶

Open the table "MALARIA_CS - Final Malaria Classification by Age & Sex." This is the table that you will create. You can explain the layout to the participants - including the table style, output type, data, periods and org units, before proceeding.

Event reports is currently the only app where you can make on the fly pivot tables using event/tracker data. This is not yet available in the line listing app, so the event reports and the line listing app need to be used in parrallel currently for the best results.

Clear your inputs by going to Favorites -> New.

Create an aggregate event report. You can use the following data items as an example:

• Styl tabulky: Kontingenční, Typ výstupu: Událost
• Program : Malaria Case Notification program
• Stage : Stage - Case Outcome
• Data : Malaria Final Classification (select Indigenious (local) as the filter), Age , Sex
• Období: Tento rok
• Organizační jednotka: Země

The table should look like this after updating:

This is not exactly the table we want. We can make some adjustments to modify it.

Start with the layout. The layout can should like this

Next, hide any empty rows using the table options.

Now you should see the the table following the layout we've intended.

Note that you can modify the way data that is collected through tracker (and event) programs is aggregated. You can demonstrate this by changing the legend for the Age attribute to Age (COVAC) and updating the table.

You will see all the totals are the same; however the disaggregation of the data is different as the data has been seperated by new categorizations.

This should be a review of concepts from the event fundamentals course; however if there are questions you can explain this concept a bit more by referring to the examples you will have on screen.

STOP! Perform Exercise 1¶

Create a list type event report for a repeatable stage using Electronic Immunization registry program¶

In this exercise we will create a line list using an Electronic Immunization Registry.

Open the table "EPI - BCG Dose by Sex (List)" in the Event Report App in order to review the final output.

Create a new report by going to Favorites -> New and select the following details

• Table Style : Line list,
• Typ výstupu: Event
• Program : Electronic Immunization Registry
• Fáze: Očkování
• Data
• Given Name,
• Family Name,
• Unique System Identifier,
• Pohlaví
• Vaccine Name - BCG 0.05 mL
• Sex - Filter (Male)
• Období: Tento rok
• Organizační jednotka: Země

Before updating the table, open the layout and move the items around in a logical order, noting how this will affect the output of the table.

Proceed to update the table and discuss what is being shown.

The table should look like this after updating

Modify the filters to see how the line list is updated

You will only see the data which meets this criteria

Other features as a refresher¶

You can also show them how to save the report using the favorites menu

and download the list

STOP! Perform Exercise 2

Create a list type event report for a repeatable stage using the Electronic¶

Before you create this report, open up a record from tracker capture that has repeated event data. The example used here has the following details that you can use to search for the person's record:

• Org Unit : 0001 CH Mahosot (Lao PDR - Vientiane Capital - 0101 Chanthabouli)
• Program : Electronic Immunization Registry
• Unique System Identifier (EPI) : EPI_12581
• First Name :Brent,
• Last Name : Hicks,
• Sex : Male

Open up this record and navigate to the "Immunization" stage within this program. Here you will see that there is more then one event within this program stage. Over the next several demonstrations, we will discuss the difference of event vs. enrollment report types and how repeated stage data is affected by this selection.

Open up the different events within this stage and review the data that is there. The data will not be the same for each of these events making them easy to compare.

Keep tracker capture open on this record and open line listing in a new tab in case you need to refer to this record again.

We will now proceed to explain the how event and enrollment type reports handle this repeatable stage data.

Open the table "EIR - HIV Summary" This the table that you will create. You can explain the layout to the participants before continuing.

Clear your inputs by going to Favorites -> New.

Vytvořte zprávu o události s následujícími vstupy:

• Table style: Line List
• Output Type: Event
• Program : Electronic Immunization registry, Stage : Immunization
• Program Dimension :
• EPI Number : EPI_12581
• Křestní jméno
• Příjmení
• Diagnosed with HIV and severe immunodeficiency
• Období: Tento rok
• Org Unit : 0001 CH Mahosot

This should pull up the respective information for the two events that we saw when we reviewed this record in tracker capture

Now you can explain how the event type report selection affects our output. When we are creating reports and use "event" as the input type, ALL of the events from within a program stage will be output on our report. There is a limitation here in that we can only pull all of our event data from within one program stage, and as a result they are not really "linked" together as they are separate lines within our report.

We can further demonstrate this concept by showing more repeated event data. Modify the output so you are not filtering by any EPI ID and update the report. Try sorting the data by surname. Scroll through the report; you should see several repeated events displayed on this report.

In summary, when running an event report with repeatable data using "event" as the output type, all of the event data from a single program stage will be used in the report!

Update the report using enrollment as the output type¶

As a reminder, here are the selections to make

• Table style: Line List
• Output Type: Enrollment
• Program : Electronic Immunization registry,
• Stage : Immunization
• Program Dimension :
• EPI Number : EPI_12581
• Křestní jméno
• Příjmení
• Diagnosed with HIV and severe immunodeficiency
• Období: Tento rok
• Org Unit : 0001 CH Mahosot

This is saved as "EIR - HIV Summary (Enrollment)" in DHIS2 for reference

When we make this update, the number of records shown changes. This occurs because enrollment type reports only use the most recent event within a program stage for their output.

Note: In summary, when running an event report with repeatable data using "enrollment" as the output type, you will only see the most recent event data.

STOP! Perform Exercise 3

Recap¶

Před provedením úkolu si s nimi na konci sezení prohlédněte rekapitulační snímek

Assignment¶

After you have completed all demos and they have finished the exercises, have them complete the graded assignment for this session. If you find you are running out of time, assign the graded assignment to them and ask them to complete it outside of the live scheduled session.