Trainer’s Guide to Event Visualizer¶

What is this guide?¶

This guide is a support document for DHIS2 Academy trainers for the session “Event Visualizer.” 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.

Tato příručka pomůže školiteli připravit se na živou ukázku. Sekce „Živá ukázka krok za krokem“ obsahuje podrobný návod všech kroků, které je třeba předvést, s vysvětleními a snímky obrazovky, které by měly být snadno sledovatelné. Použijte to při přípravě na živé ukázkové sezení.

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¶

1. Popište funkce aplikace vizualizace událostí
2. Popište rozhraní vizualizéru událostí
3. Vytvářejte vizualizace pomocí dat sledovače
4. Popište omezení vizualizéru událostí při práci s daty sledovače

Time Requirements¶

• Live Demo: 3 demos, ~15 minutes each
• Hands-on Exercises: 3 exercises, ~10 minutes each

Pozadí¶

This session is more or less a review of what the participants have learned during the event fundamentals course. This is because event visualizer does not introduce any new concepts around the management of tracker data and does not have any enrollment type outputs built in. This session will therefore discuss this constraint as it is applied to tracker data and review some of the features available in event reports quickly.

Preparations¶

This session will see you creating a number of visualizations. Ensure that you have run analytics in the demo database you are using and that all the data is being populated correctly. If you find that data is not present for the correct period or year, please contact the training content team so we can advise how to move the data correctly.

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. Review the event visualizer interface

2. Review and create a bar chart showing EIR - BCG 0.05 ml dose by Location using the Electronic Immunization Registry program.

3. Program : Electronic Immunization Registry, Stage: Immunization

4. Data Element: BCG 0.05 ml
5. Období: Tento rok
6. Org Unit : All level 3 OUs

Discuss how this data is being pulled from all the events within the stage, meaning repeated event data will be included. This is not really a concern when using data from a non-repeatable stage.

• Review saving and downloading the chart if needed

STOP - Exercise 1

1. Create a chart using option sets.

2. Open the chart "MAL CS - Case Outcome by location."

3. Program : Malaria case notification, investigation and response
4. Stage: Case outcome
5. Data items : MAL-CS - Outcome of illness
6. Periods : This Year
7. Org units : user sub-units

Discuss how this chart is quickly seperating options in an option set.

STOP - Exercise 2

1. Review the chart "CBS - Measles Virus Detection - PCR" and discuss the difference between the output type options "Event" and "Tracked entity instance"

STOP - Exercise 3

1. Review the recap slide

2. Have them perform the assignment

Live Demo step by step¶

Review the event visualizer interface¶

Periods in Event Visualizer¶

In event visualizer, similar to 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.

Review and create the chart "EIR - BCG 0.05 ml dose by Location" (a chart using yes/no data elements)¶

Open the chart "EIR - BCG 0.05 ml dose by Location" within event visualizer.

Vizualizér událostí je zvláště zběhlý v podpoře výstupů v rámci programů událostí i sledovacích programů, protože souvisí s vizualizací datových prvků pomocí sad možností. Můžeme poměrně snadno kombinovat různé filtry napříč různými datovými prvky a sadami možností, abychom viděli souhrnnou reprezentaci průřezu těchto filtrů, jak je aplikován na naše data.

Toto je scénář, který vidíme u grafu, který kontrolujeme.

Prohlédněte si zejména datový panel.

We see here there is "Yes" output type selection here, just the program and the program stage. We are able to actually output a count of TEIs by using the options and this will be shown. We can not however combine data from multiple stages in event visualizer; charts using data from multiple program stages must be handled through the use of program indicators and data visualizer.

Jako recenzi můžete tento graf znovu vytvořit. Má následující vstupy:

• Typ grafu: sloupcový
• Program : Electronic Immunization registry, Stage:Immunization
• Data : Data Element : BCG 0.05 mL
• Období: Tento rok

• Org Unit : All level 3 OUs

• Oblíbené -> Nové

• Select the program (Electronic Immunization Registry) and stage (Immunization)
• Všimněte si, že zde opět není žádný typ výstupu pro zápis, vizualizér událostí standardně používá typ výstupu "event"; což znamená, že všechny události ve všech fázích se započítávají do zobrazených součtů
• Select the data (Data Element : BCG 0.05 mL)
• Select "Yes" only.

1. Vyberte období (tento rok)

1. Select the org unit (All provinces, or user sub-2units)

1. Upravte rozložení

1. Go to options and Hide all empty categories

Aktualizujte graf, abyste mohli zkontrolovat svůj výstup.

Graf není seřazený a nemá název, jako je tomu v případě dříve recenzovaného uloženého grafu. Můžete otevřít panel možností a přidat tyto podrobnosti.

Poté pokračujte v aktualizaci grafu, abyste viděli konečný výstup.

Other features as a refresher¶

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

a stáhněte si graf

STOP! Have them perform Exercise 1 in the learner's guide.¶

Create a chart using option sets¶

Open the chart "MAL CS - Case Outcome by location." This chart is showing malaria case outcomes as a stacked bar chart. While some functions of the event visualizer are not as useful as they could be, the event visualizer is very good at visualizing event data from option sets.

Let us quickly make this chart.

1. Chart Type : Stacked bar chart
2. Program : Malaria case notification, investigation and response
3. Stage: Case outcome
4. Data items : MAL-CS - Outcome of illness
5. Periods : This Year
6. Org units : user sub-units

Layout :

After updating, this should be your final output:

You can quickly modify which options appear on the chart by filtering the data element in the data selection window

You can modify these options and update the chart to see how it affects what data is shown.

STOP! Have them perform Exercise 2 in the learner's guide.¶

Review and modify the chart "CBS - Measles Virus Detection - PCR"¶

Open the chart "CBS - Measles Virus Detection - PCR" Nothing so unique about this chart; however we can note that it using data from Stage 4 - Lab Results in the surveillance program. This stage is repeatable, and by default we are seeing all of the events in this program stage being displayed on the chart.

Spíše než počítání celkového počtu testů s těmito výsledky, co kdybychom chtěli počet jedinečných lidí s těmito výsledky? Ve zprávách o událostech jsme mohli použít výstup typu zápisu jak k počítání zápisů, tak ke spojení dat z více fází do jednoho seznamu. Tu možnost zde nemáme, ale můžeme spočítat počet sledovaných entit.

Otevřete možnosti grafu a zkontrolujte typ výstupu

Můžeme vidět, že jsou 3 možnosti: 1. událost 2. Zápis 3. Instance trasované entity

NB: Enrollment does not work as we can not pull data from multiple stages in event visualizer. It seems to be there incorrectly. Please ask the participant's to ignore this option.

Vyberte možnost "Instance trasované entity" a aktualizujte graf. Měli byste vidět několik méně pozitivních případů identifikovaných v této organizační jednotce ve srovnání s předchozím grafem, protože počítá jednoznačně počet TEI, spíše než počet událostí odpovídajících kritériím vašeho filtru (filtrů).

Note: Why the different language between event reports and event visualizer regarding the output type? The Enrollment output type in event reports allows you to display information unique to an enrollment, as well as obtain data across an entire enrollment (meaning you can review data from multiple program stages together in the line list; and obtain unique counts via the pivot table). The "Tracked entity instance" output type in event visualizer is much more limiting. It does not allow you to pull data from multiple program stages; it just let's you count the number of unique tracked entities (in this case individual people) that meet the criteria you have set via your filters within a program stage 1 or more times. This can be useful but it is important to identify this distinction.

In explaining the concept above to the participant's, you can refer back to slide 4 in the presentation.

STOP! Have them perform Exercise 3 in the learner's guide.¶

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.