Metadata integrity and quality¶

Zatímco kvalita metadat může být do jisté míry subjektivní, existuje řada klíčových principů, které lze objektivně posoudit a měly by být univerzálně dodržovány během implementací DHIS2. Za účelem posouzení kvality metadat lze provést posouzení metadat. V tomto kontextu můžeme metadatové hodnocení definovat jako kontrolu kvality konfigurace konkrétní implementace. I když jde o široký rozsah, naším cílem je rozdělit proces hodnocení na zvládnutelné části, které lze v průběhu času kontrolovat, stanovovat priority a opravovat. Pravidelné hodnocení metadat a průběžná údržba je důležitou součástí dlouhodobé konfigurace a údržby DHIS2. Zatímco konfigurační úlohy lze často provádět rychle pomocí řady různých mechanismů, bez řádné koordinace může nastat řada problémů, kterým může konfigurace systému DHIS2 v průběhu času čelit. Některé příklady účinků těchto konfiguračních problémů zahrnují:

• Neschopnost najít správné položky při vytváření datových výstupů
• Neschopnost správně rozčlenit data při vytváření datových výstupů
• Nemožnost přístupu ke správným položkám při zadávání dat nebo vytváření datových výstupů
• Problémy s kvalitou dat (některé příklady: významné nepřesnosti v dlouhodobých trendech údajů a četnosti vykazování, schopnost ukládat neplatné hodnoty dat, více proměnných představujících stejný koncept ukládající různé hodnoty dat)
• Difficulty identifying the correct items to use when configuring data exchange mechanisms
• Chyby při upgradu verzí DHIS2
• Spravovat obrovské množství neplatných metadat

Účelem této příručky je poskytnout nástroje a postupy k identifikaci problémů s metadaty. Vyvíjí se samostatná příručka o údržbě metadat, která pojednává o konfiguračních postupech, které mohou vést k problémům s kvalitou metadat, a pojednává o tom, jak se jim lze vyhnout, např. tím, že se vyhnete konfigurační práci v produkčních systémech a zavedete SoP pro modifikace metadat. A konečně, budoucí část Práce s metadaty poskytne návod, jak řešit problémy s metadaty, jako je odstranění objektů, které se již nepoužívají.

Údržba metadat a hodnocení metadat by měly být chápány jako související procesy, které se vzájemně doplňují.

1. Reaktivní proces: V důsledku problémů s konfigurací bude nutné systém DHIS2 odpovídajícím způsobem zkontrolovat a vyčistit.
2. Proaktivní proces: Aby se předešlo problémům s konfigurací, lze zavést procesy tak, aby konfigurace DHIS2 zůstala v průběhu času robustní.

Posouzení integrity a kvality metadat¶

Reaktivní procesy jsou o hodnocení metadat za účelem identifikace potenciálních problémů a řešení těchto problémů. Může se jednat o náročný proces, který je třeba řádně naplánovat a věnovat čas a zdroje k identifikaci a řešení problémů. Zatímco plánování a provádění hodnocení metadat je stručně diskutováno [níže] (#metadata_assessment_planning), tato příručka se zaměřuje na praktičtější a techničtější aspekty hodnocení metadat a řešení běžných problémů.

This guide focuses primarily on two approaches to assessing metadata:

1. prostřednictvím ruční kontroly metadat
2. prostřednictvím nástroje pro hodnocení metadat, který lze připojit přímo k DHIS2 a provádět kontroly metadat

Oba tyto přístupy jsou popsány níže.

Plánování a provádění posouzení metadat¶

Chcete-li provést hodnocení, možná budete chtít začít tím, že získáte vstup od široké škály zainteresovaných stran. Přitom může být užitečné zdokumentovat rozsah problémů diskutovaných v této příručce vytvořením souhrnných statistik o problémech, které byly identifikovány. To může být velmi užitečné pro prezentaci širokému publiku a může být použito k podpoře buy-in poskytnutím stručných vysvětlení problémů, které byly identifikovány. V Referenční příručce pro hodnocení metadat najdete nástroje, které vám pomohou vytvořit rychlé souhrnné počty problémů, které najdete ve své vlastní implementaci, a také nástroje, které generují podrobnější zprávy o každé konkrétní položce, která vyžaduje pozornost. Doporučujeme, aby hodnocení zahrnovalo následující součásti:

1. Definujte rozsah hodnocení a sdílejte jej s příslušnými zúčastněnými stranami
2. Identifikace rozsahu problémů v rámci implementace prostřednictvím generování a dokumentování souhrnných statistik toho, co bylo nalezeno
3. Prezentace těchto zjištění zpět skupině zainteresovaných stran
4. Identifikovat jednotlivé položky, které jsou problematické, a navrhnout strategie, jak je podle potřeby zmírnit nebo opravit
5. Upřesnění a stanovení priorit oprav
6. Implementace těchto oprav ve vývoji následovaná produkčními systémy

Manuální kontrola metadat¶

Použití nástroje pro hodnocení metadat a vestavěné kontroly integrity dat je účinný způsob identifikace mnoha problémů s metadaty v DHIS2, některé procesy kontroly nelze automatizovat. To zahrnuje přezkoumání:

• Konvence pojmenování
• Vzorec indikátoru
• Duplicitní objekty metadat
• Duplicitní zdroje dat
• Konfigurace položky ovládacího panelu
• Přiřazení organizační jednotky programu a datové sady
• Sdílení programů a datových sad

Documenting issues¶

Kontrola metadat k identifikaci potenciálních problémů by měla být vždy prováděna s cílem tyto problémy řešit. Opravy lze někdy provést okamžitě, ale v mnoha případech to není možné. Například může být nutné konzultovat s různými zúčastněnými stranami, aby se identifikoval vhodný zdroj dat nebo definice metadat, nebo je řešení problémů technicky komplikované a vyžaduje řádné testování a přezkoumání. Je proto důležité vytvořit mechanismus pro zachycení zjištěných problémů, aby bylo možné je sledovat a vytvořit plán na jejich řešení.

Naming Conventions¶

Úplný rozpis principů dobrých konvencí pojmenování naleznete v tomto zdroji. Pokud je to možné, měli byste zvážit jejich implementaci do systému (systémů), který kontrolujete.

Chcete-li názvy svých metadat aktualizovat hromadně, zvažte použití editoru metadat DHIS2. To vám umožní upravit všechna vaše metadata v tabulce Google a synchronizovat vaše informace zpět na server. Úplného průvodce editorem metadat si můžete prohlédnout zde.

Indicator Formula¶

K určení, zda je vzorec ukazatele správný, může být zapotřebí ruční revize vzorce indikátoru. Revize vzorce indikátoru, i když je potenciálně problémem konfigurace, má potenciál ovlivnit kvalitu dat a datové výstupy, pokud se o vzorci vytvoří nesprávné předpoklady. Příklady problémů, které budete chtít zkontrolovat při kontrole vzorce indikátoru, zahrnují:

1. Zajištění toho, že součástí čitatele a jmenovatele jsou správné datové prvky porovnáním datových prvků s popisy čitatele a jmenovatele
2. Zajištění, že byl pro kontrolovaný indikátor vybrán správný typ indikátoru
3. Je-li to možné, kontrola, zda je jmenovatel správně definován (nicméně; může se jednat spíše o problém s kvalitou dat a je ponecháno na podrobnější kontrolu kvality dat)

Můžete použít editor metadat DHIS2 ke kontrole některých vzorců, pokud víte, jak se to nastavuje, ale tradičnější způsob indikátorů procházení přes uživatelské rozhraní lze provést pomocí aplikace prohlížeče metadat WHO.

Duplicate Data Sources¶

Duplicitní zdroje dat vznikají, když máte v systému DHIS2 více proměnných, které vykazují stejný koncept. Obvykle existují 3 typy duplicitních zdrojů dat, které můžete vidět v DHIS2:

• Duplicitní proměnné ve stejném formuláři sběru dat
• Duplicitní proměnné mezi různými programy (obvykle na různých formulářích)
• Duplicitní proměnné v programech (buď ve stejných nebo různých formulářích)

Duplicate variables within the same data collection form¶

K tomu dochází, když jeden nebo více datových prvků poskytuje součet, který je duplikován jedním nebo více jinými datovými prvky ve stejném formuláři. Jako příklad si můžeme prohlédnout formuláře dostupné na obrázku 1.

Když k tomu dojde, je obtížné určit, jaká je správná hodnota.

Duplicate variables between different programs¶

K tomu dochází, když máte dva nebo více programů v integrovaném systému, které shromažďují stejné informace (obrázek 2). V některých případech se programy nemohou dohodnout na hodnotě a může být nutné ji zachovat tak, jak je. To se stane problematickým při pokusu o stanovení dohodnuté národní hodnoty, avšak hodnoty se mohou mezi různými programy lišit a nedoporučuje se to udržovat tak, jak je.

Duplicate variables within programs (either on the same or different forms)¶

K tomu dochází, když jsou stejné informace shromažďovány ve stejném programu (obrázek 3). To může být problematické, protože pokud je to možné, měla by existovat shoda mezi hodnotami (a nemusí tomu tak být, když je tento problém zjištěn)

Resolving duplicate data sources¶

Podobně jako u problémů s definováním jmenovatelů může být nutné toto ponechat pro podrobnější kontrolu kvality dat. Vzhledem k tomu, že tato zjištění budou často vyžadovat kontrolu/revizi formuláře napříč různými programy, aby bylo možné racionalizovat tyto duplicitní zdroje dat, tento problém pravděpodobně nevyřeší okamžitá změna konfigurace. Je však důležité tyto problémy identifikovat a pracovat s programy na jejich vyřešení na základě místních postupů.

Dashboard Item Configuration¶

Při kontrole položek ovládacího panelu je třeba vzít v úvahu dvě věci:

1. Musí být položka ovládacího panelu sdílena, aby ji mohly zobrazit skupiny uživatelů, se kterými je řídicí panel sdílen?
2. Potřebuje položka ovládacího panelu relativní organizační jednotky nebo období, aby ji bylo možné pravidelně znovu používat / aktualizovat

V případě, že položka ovládacího panelu potřebuje zobrazit údaje za pevně stanovené období nebo organizační jednotku, není třeba na položku aplikovat žádnou relativitu. Pokud by položka měla být rutinně aktualizována novými údaji nebo uživatelé, kterým je dashboard sdílen, nemají přístup k pevným organizačním jednotkám vybraným v rámci položky, pak by tyto položky měly být zkontrolovány a případně aktualizovány správným výběrem relativního období a organizační jednotky.

Program and data set organisation unit assignment¶

Zkontrolujte, zda jsou programy a datové sady přiřazeny pouze organizačním jednotkám, u kterých se očekává, že o nich budou podávat zprávy. U datových sad to může způsobit problémy s úplností hlášení (počet očekávaných hlášení může být vyšší, než by měl být) a potenciálně vkládání dat tam, kde by nemělo být; zatímco v případě programů byste mohli mít sledované subjekty a/nebo události registrované v organizačních jednotkách, neměly by být.

Program and data set sharing¶

Zkontrolujte, zda byla nastavení metadat a sdílení dat správně použita pro programy i soubory dat. Zejména pokud existují uživatelé nebo skupiny uživatelů, kteří nemohou provádět operace s programy nebo datovými sadami, které by měli umět, může být nutné tato nastavení sdílení upravit.

Podrobnější rozpis použití nastavení sdílení na programy a soubory dat lze nalézt jak v dokumentaci, tak v řadě videí na YouTube.

Category-related checks¶

Duplicate category options¶

Možnosti kategorií mohou a měly by být znovu použity ve více kategoriích, aby reprezentovaly stejný koncept (např. věková skupina). Kromě snížení nepořádku a potenciálního matoucího množství možností pro stejný koncept umožňuje tato analýza datovou analýzu, protože datové prvky používající stejnou možnost kategorie mohou být prezentovány společně se stejnou dezagregací ve vizualizačních nástrojích.

If duplicate category options are identified and these are included in categories that are part of category combinations already associated with data, you should not attempt to de-duplicate these. However, if one of the category options have not yet been used, this could be removed and the other options used.

Category disaggregations¶

Možnosti kategorií v kategorii datových prvků by se obecně měly sčítat do smysluplného součtu, jak je popsáno v [části návrhu souhrnného systému] (#categories-and-custom-dimensions). Je to součet kategorie, která se standardně zobrazuje, když se podíváte na hodnotu pro datový prvek rozčleněný tímto datovým prvkem. Příkladem tohoto špatného postupu je vytvoření kategorie pro „ambulantní pacienty“ s možnostmi „Případy“ a „Úmrtí“, která se použije na datové prvky pro různé diagnózy, jako je „Malárie“. Ve výchozím nastavení uživatel při pohledu na datový prvek „Malárie“ získá součet „Případů malárie“ a „Úmrtí na malárii“, což je číslo, které nedává smysl.

There are certain cases where it may make sense to diverge from this general rule, in particular when the use of such a category can substantially reduce the number of data elements required. In these cases, the option to "Skip category total in reports" should be enabled for the category combination that category is part of.

Použití nástroje pro hodnocení metadat¶

Zatímco pro řadu problémů jsou nutné ruční kontroly, byl také vyvinut nástroj pro hodnocení metadat, který automatizuje řadu kontrol kvality dat. To zahrnuje možnost získat souhrnné výsledky (počet porušení) vestavěných kontrol integrity dat. Nástroj pro hodnocení metadat není v současné době integrován do samotného DHIS2, ale jedná se o samostatný nástroj založený na R. Tato část se bude zabývat tím, jak interpretovat a používat výstup nástroje pro hodnocení, zatímco postup stažení, instalace a spuštění nástroje je popsán v úložišti GitHub nástroj. Seznam s popisy kontrol metadat zahrnutých v nástroji je popsán v příloze A.

Nástroj pro hodnocení metadat je založen především na pohledech DHIS2 SQL: nástroj importuje sadu pohledů SQL do hodnocené databáze DHIS2 (dva pro každou metriku kvality dat) a přistupuje k výstupům těchto pohledů SQL prostřednictvím webového rozhraní API a prezentuje uživatelům. Kromě toho tento nástroj předkládá určité výstupy přímo na základě dotazů webového rozhraní API (týkajících se uživatelů) a může také zobrazovat výsledky vestavěných kontrol integrity dat.

Warning The tool should not be used directly in production databases. While the only change the tool does to a database is to import SQL views, certain checks can be long-running and resource-intensive and may affect users interacting with the system. A parameter is available to disable slow queries.

The report¶

Samotná zpráva je uspořádána do čtyř částí.

Summary table¶

Souhrnná tabulka „Problémy s metadaty“ poskytuje přehled všech různých metrik kvality metadat a umožňuje řazení a filtrování. To je užitečné pro získání rychlého přehledu o výsledcích (například pokud existují nějaké "kritické" nebo "závažné" problémy) nebo pokud hledáte konkrétní problémy (například pokud existují nějaké problémy týkající se organizačních jednotek).

Uživatelé¶

Sekce „Uživatelé“ poskytuje klíčové metriky související s uživateli v systému. Kromě základních informací o celkovém počtu uživatelů a počtu přihlášených uživatelů za určité období obsahuje také informace, které mohou být základem pro změny v postupech správy uživatelů:

• Users who have never logged in: large numbers of users account which have never been used indicate problems with the account invitation/creation process. If these accounts have been created with a default password, they may also pose a security issue.
• Percentage of users that are disabled: Taken together with the total number of users and the users who have logged in recently, this may give an indication of whether user accounts are disabled when users for different reasons no longer need or should have access to the system (e.g. because they leave their position).
• Number/percentage of users that are superusers: Only a handful of users should at most have superuser rights (the "ALL" authority).

Kromě toho mohou být užitečné dva grafy zobrazující rozložení v čase, kdy se uživatelé naposledy přihlásili, a rozložení uživatelů v hierarchii organizační jednotky, abyste pochopili, zda je přiřazení a správa uživatelů správně zpracována.

Guidance¶

Sekce s pokyny uvádí stejné metriky jako souhrnná tabulka (a opakuje se v příloze A), ale spolu s vysvětlením a doporučeným postupem. Je uspořádána do sekcí podle tématu.

Interpreting the results¶

When interpreting the results of the report, it's important to keep in mind that not all the issues listed in the report are necessarily actual issues. The Severity of the different checks are important to keep in mind in this regards:

• Info indicates that the check is included primarily to provide useful contextual information, e.g. indicating the total number of a certain type of object.
• Warning apply to checks that either point to issues that may be problematic or indicate that the metadata is not well managed, but will generally not lead to problems with the functioning of the system.
• Severe issues can lead to serious problems, for example analytical outputs showing wrong numbers or no data at all.
• Critical issues are those that will almost certainly create various problems, for example potentially causing the analytic table generation process to fail.

I když každá z různých metrik kvality dat zahrnuje doporučení, jak by se měl konkrétní problém řešit, obecně nezachází do podrobností, technických kroků, které by měly být podniknuty k vyřešení problému. Není možné poskytnout jasné vodítko pro všechny problémy a problémy se liší od zcela základních (jako je seskupování datových prvků) až po velmi složité (například duplicitní kombinace možností kategorií v rámci kombinace kategorií). Obecně se doporučuje, pokud je to možné, řešit problémy prostřednictvím uživatelského rozhraní DHIS2 nebo webového rozhraní API, protože to poskytuje určité ověření provedených změn. Pouze jako poslední možnost by měly být problémy v databázi správně opraveny. Všechny změny kromě nejzákladnějších (jako je seskupování datových prvků) by měly být důkladně otestovány v neprodukčním systému.

Připravuje se samostatná část v implementační příručce, která poskytne další příklady a pokyny k řešení běžných problémů s metadaty, jako jsou dávkové úpravy, mazání datových prvků s daty atd.

PŘÍLOHA A – metriky nástroje pro hodnocení metadat¶

Updated 14.02.2022.

Categories¶

Categories with no category options.¶

Kategorie by vždy měly mít alespoň jednu možnost kategorie.

Závažnost: Varování

Doporučení: Jakékoli kategorie bez možností kategorií by měly být ze systému odstraněny, pokud se nepoužívají. V opačném případě by měly být do kategorie přidány vhodné možnosti kategorie.

Additional default category option combos based on category option.¶

V systému by měla být pouze jedna kombinace možností kategorie „výchozí“. Použití více výchozích kombinací možností kategorií může vést k nesrovnalostem jak v zadávání dat, tak v analytických výstupech.

Závažnost: Kritická

Doporučení: Všechny odkazy na další výchozí kombinaci možností kategorie by měly být nahrazeny požadovanou výchozí kombinací možností kategorie.

Category options with no categories.¶

Všechny možnosti kategorií by měly patřit alespoň do jedné kategorie.

Závažnost: Varování

Doporučení: Možnosti kategorií, které nejsou součástí žádné kategorie, by měly být odstraněny nebo případně přidány do příslušné kategorie.

Category option combinations with disjoint associations.¶

Za určitých okolností mohou v systému existovat kombinace možností kategorií, ale nemají žádnou přímou souvislost s možnostmi kategorií, které jsou spojeny s kombinacemi kategorií. K této situaci obvykle dochází, když byly do kategorie přidány možnosti kategorie a poté je kategorie přidána do kombinace kategorií. V tomto okamžiku jsou v systému vytvořeny nové kombinace možností kategorií. Pokud je potom některá z možností kategorie odstraněna v jedné ze základních kategorií, může dojít k tzv. kombinaci možností disjunktní kategorie. Toto je kombinace možností kategorie, která nemá přímou souvislost s možnostmi kategorie v žádné z kategorií.

Závažnost: Těžká

Doporučení: Kombinace možností nesouvislých kategorií by měly být ze systému odstraněny, pokud je to možné. Pokud jsou však s kombinací možností kategorie spojena nějaká data, bude nutné rozhodnout, jak s těmito daty naložit.

Category option combinations with incorrect cardinality.¶

Všechny kombinace možností kategorií by měly mít přesně stejný počet přidružení možností kategorií jako počet kategorií v kombinaci kategorií. Pokud jsou v kombinaci kategorií dvě kategorie, pak by každá kombinace možností kategorie měla mít přesně dvě možnosti kategorií.

Závažnost: Těžká

Doporučení: Kombinace možností kategorií, které mají nesprávnou mohutnost, budou analytickým systémem DHIS2 ignorovány a měly by být odstraněny.

Category options with more than one membership for a category.¶

Nulla vitae feugiat blandit natoque placerat elementum pharetra senectus et aenean faucibus pellentesque. Quam, donec auctor in et mi penatibus penatibus. Mauris massa mauris sem vehicula eu hac fermentum odio mattis sed. Habitant convallis, pellentesque aenean, a nunc vitae non sapien eu suspendisse. Amet nisi sed quam hac.

Závažnost: Těžká

Recommendation: Bibendum pellentesque nibh nisl vitae rutrum quis vestibulum feugiat porta et netus parturient mauris. Nec nascetur libero lacinia id vel mauris pulvinar at augue pharetra. Elementum urna eget mauris magnis proin. Risus sed sapien ante himenaeos. Hac vitae vestibulum vestibulum nulla vestibulum ut non consectetur vel lectus ultricies euismod. Suscipit sed sed orci.

Category combinations with no categories.¶

Všechny kombinace kategorií by měly být spojeny s jednou nebo více kategoriemi.

Závažnost: Varování

Doporučení: Kombinace kategorií bez kategorií nejsou v DHIS2 použitelné. Měly by být buď odstraněny, nebo by měly být do seznamu kategorií přidány správné kategorie.

Category options combinations with no category combination.¶

Všechny kombinace možností kategorie by měly být spojeny s kombinací kategorií. V určitých případech, kdy jsou odstraněny kombinace kategorií, může dojít k poškození propojení mezi kombinací možností kategorie a kombinací kategorií.

Závažnost: Varování

Doporučení: Zkontrolujte, zda jsou s dotyčnými kombinacemi kategorií spojena nějaká data. Data by měla být pravděpodobně odstraněna nebo migrována na platnou kombinaci možností kategorie. Jakákoli data, která jsou spojena s některou z těchto kombinací možností kategorií, nebudou dostupná ani prostřednictvím modulů pro zadávání dat, ani prostřednictvím žádné z analytických aplikací.

Duplicated category option combinations within a category combination.¶

V rámci každé kombinace kategorií by měla existovat jedinečná sada kombinací možností kategorií. Za určitých okolností mohou v systému existovat duplicitní kombinace možností kategorií. To obvykle vyplývá ze změn kombinací kategorií poté, co byly vytvořeny, nebo přímou manipulací s různými tabulkami kategorií v databázi. To může mít za následek, že se určité kombinace datových prvků / kategorií nezobrazí nebo nebudou dostupné na obrazovkách pro zadávání dat a / nebo v analytických aplikacích.

Závažnost: Těžká

Doporučení: Duplicitní kombinace možností kategorií v rámci kombinace kategorií budou vyžadovat sloučení kombinací možností kategorií dohromady. To bude vyžadovat přímou manipulaci s databází a mělo by být vždy provedeno nejprve v testovacím prostředí. Teprve poté, co důkladně otestujete svůj postup a budete mít jistotu, že funguje, byste měli provést postup ve svém produkčním prostředí. Implementační tým DHIS2 vytvořil řadu funkcí SQL, které vám pomohou odstranit tyto duplicitní COC z vašeho systému.

Categories with the same category options¶

Kategorie s přesně stejnými možnostmi kategorií by měly být považovány za sloučené. Categorie s přesně stejnými možnostmi kategorií mohou uživatelé při analýze snadno zaměnit.

Závažnost: Varování

Recommendation: If category combinations have already been created with duplicative categories, it is recommended that you do not take any action, but rather ensure that users understand that there may be two categories which are duplicative.

If one of the categories is not in use in any category combination, it should consider to be removed from the system.

Grafy¶

Charts which have not been viewed in the past 12 months¶

Grafy by měly být pravidelně prohlíženy v systému. V mnoha případech mohou uživatelé vytvářet grafy pro dočasné účely a pak je nikdy nesmazat. To může nakonec vést k nedostatku pořádku v systému. To může vést k tomu, že v aplikaci vizualizace bude obtížné najít grafy.

Závažnost: Varování

Doporučení: Nepoužívané grafy může uživatel s dostatečným oprávněním odstranit přímo pomocí aplikace pro vizualizaci dat. Pokud jsou však grafy součástí jakéhokoli ovládacího panelu, bude nutné je také z ovládacího panelu odstranit.

Ovládací panely¶

Total number of dashboards in the system¶

Total number of dashboards in the system. Severity: Info

Doporučení: DHIS2 by měl obsahovat užitečné ovládací panely pro uživatele.

Dashboards with 1 or fewer views over the past three years¶

Dashboards that are not viewed by users can indicate limited data use, that the dashboards have not been designed with an intention of reuse (for example as part of a training exersice or one-off data analysis), or that the user owning the dashboard is not longer active.

Závažnost: Varování

Recommendation: If the dashboards are relevant and useful but not view, efforts should be made to increase data use (e.g. review sharing settings, communicate with users, plan training exercises etc). In other cases, users with superuser permission should be able to delete dashboards by looking up the name or in batches. You should also confirm that the dashboard is not in use by any push analysis before removing it from the system.

Dashboards not viewed in the past one year.¶

Dashboards that are not viewed by users can indicate limited data use, that the dashboards have not been designed with an intention of reuse (for example as part of a training exersice or one-off data analysis), or that the user owning the dashboard is not longer active.

Závažnost: Varování

Recommendation: If the dashboards are relevant and useful but not view, efforts should be made to increase data use (e.g. review sharing settings, communicate with users, plan training exercises etc). In other cases, users with superuser permission should be able to delete dashboards by looking up the name or in batches. You should also confirm that the dashboard is not in use by any push analysis before removing it from the system.

Total number of dashboards with no items.¶

All dashboards should have content on them. Dashboards without any content do not serve any purpose, and can make it more difficult to find relevant dashboard with content.

Závažnost: Informace

Doporučení: Ovládací panely bez obsahu, který nebyl upraven v posledních, např. Na smazání je třeba zvážit 14 dní.

Data elements (aggregate)¶

Total count of aggregate data elements¶

Overview of the number of aggregate data elements in the system. Severity: Info

Doporučení: DHIS2 by měl obsahovat užitečné datové prvky pro uživatele.

Aggregate data elements not used in any favourites (directly or through indicators)¶

All aggregatge data elements that are captured in DHIS2 should be used to produce some type of analysis output (charts, maps, tables). This can be by using them directly in an output, or by having them contribute to an indicator calculation that is used an output.

Závažnost: Varování

Doporučení: Datové prvky, které nejsou běžně v analýze přezkoumávány, ať už přímo nebo nepřímo prostřednictvím indikátorů, by měly být přezkoumány, aby se zjistilo, zda je stále třeba shromažďovat. Pokud mají být použity při rutinní kontrole, pak by měly být pomocí nich vytvořeny související výstupy. Pokud tyto datové prvky nebudou použity pro žádný typ kontroly informací, je třeba zvážit jejich archivaci nebo vymazání.

Aggregate data elements assigned to 1 or less orgunit (through data sets).¶

Datové prvky, které jsou součástí souhrnné datové sady, by měly být přiřazeny alespoň jedné organizační jednotce.

Závažnost: Varování

Doporučení: Pokud je datová sada aktivní, zkontrolujte přiřazení organizačních jednotek. Pokud datová sada není aktivní, měla by být datová sada a její související datové prvky odstraněny ze systému.

Aggregate data elements not in any data element groups.¶

All data elements should be in a data element group. This allows users to find the data elements more easily in analysis apps and also contributes to having more complete data element group sets. Maintenance operations can also be made more efficient by applying bulk settings (ex. sharing) to all data elements within a data element group.

Závažnost: Varování

Doporučení: Datové prvky, které nejsou ve skupině datových prvků, by měly být přidány do příslušné skupiny datových prvků. Pokud datové prvky nejsou potřeba, měly by být vymazány.

Aggregate data elements that have not been changed in last 100 days and do not have any data values.¶

"Opuštěné" datové prvky. Jedná se o datové prvky, které nebyly změněny po dobu alespoň 100 dnů a nejsou s nimi spojeny žádné datové hodnoty. Často jsou výsledkem nových nebo změněných konfigurací, které byly v určitém okamžiku opuštěny.

Závažnost: Varování

Doporučení: Datové prvky, ke kterým nejsou přidružena žádná data a které se neplánuje začít používat pro sběr dat, by měly být smazány.

Aggregate data elements with NO data values.¶

Datové prvky by měly být obecně vždy spojeny s hodnotami dat. Pokud datové prvky existují v datovém souboru, který je aktivní, ale nejsou k nim přiřazeny žádné datové hodnoty, nemusí být součástí obrazovek pro zadávání dat.

Závažnost: Varování

Doporučení: Zvažte odstranění datových prvků bez datových hodnot.

Aggregate data elements with no data values in the last 3 periods (based on data set period type).¶

Datové prvky bez aktuálních datových hodnot pravděpodobně spadají do jedné ze dvou kategorií: 1) byly použity dříve a obsahují užitečná / relevantní data, 2) nebyly použity žádným smysluplným způsobem (např. hodnoty dat pocházejí z testování během konfigurace nebo malého pilotního projektu) a data nejsou užitečná / relevantní.

Závažnost: Varování

Recommendation: If the data elements hold useful historical data, they should be kept. Consider renaming the data elements and/or data sets to make it clear they are not used for data collection any more. Data elements which are not actively used and have no valueable data associated.

Data elements (tracker)¶

Total count of tracker data elements¶

Overview of the number of tracker data elements in the system. Severity: Info

Doporučení: DHIS2 by měl obsahovat užitečné datové prvky pro uživatele.

Tracker data elements not in any data element groups.¶

All data elements should be in a data element group. This allows users to find the data elements more easily in analysis apps and also contributes to having more complete data element group sets. Maintenance operations can also be made more efficient by applying bulk settings (ex. sharing) to all data elements within a data element group.

Závažnost: Varování

Doporučení: Datové prvky, které nejsou ve skupině datových prvků, by měly být přidány do příslušné skupiny datových prvků. Pokud datové prvky nejsou potřeba, měly by být vymazány.

Datové sady¶

Total number of data sets.¶

Total number of datasets in the system. Severity: Info

Doporučení: DHIS2 by měl obsahovat datové sady, které jsou užitečné pro zadávání dat.

Data sets that have not been changed in last 100 days and are assigned to 1 or less orgunits.¶

Datasets should generally be assigned to multiple organisation units if they are used, or be modified recently (e.g. last 100 days) if they are under development. Unused datasets represent unnecessary clutter in the database and may confuse users and administrators. The exception is data sets which are associated with historical data, for example reporting forms from previous years which are no longer used, and datasets that is designed to be used in only on organisation unit (e.g. at national level).

Závažnost: Varování

Recommendation: Datasets which are not activly used or in development should be removed from the system to decrease system clutter and metadata size. Before removing the data sets, verify that the data set is not associated with historical data and kept for that reason.

Data sets with no data values in the last 3 periods (based on data set period type).¶

Soubory dat, k nimž nejsou přiřazeny žádné nedávné hodnoty dat, pravděpodobně spadají do jedné ze dvou kategorií: 1) byly použity dříve a obsahují užitečná / relevantní data, 2) nebyly použity žádným smysluplným způsobem (např. kmen datových hodnot z testování během konfigurace nebo malého pilotního projektu) a data nejsou užitečná / relevantní.

Závažnost: Varování

Doporučení: Pokud datové prvky obsahují užitečná historická data, měly by být uchovány. Zvažte přejmenování datových prvků a/nebo datových sad, aby bylo jasné, že se již nepoužívají ke sběru dat. Datové prvky, které se aktivně nepoužívají a nemají přidružená žádná cenná data

Data set sections with incorrect sort order¶

Sekce datové sady se používají k seskupení určitých souvisejících sekcí ve formuláři pro zadávání dat sekce. Lze je také objednat. Pořadí sekcí se může poškodit, pokud sekce přidáte nebo odstraníte.

Závažnost: Varování

Doporučení: Je možné opravit pořadí řazení sekcí datové sady pomocí funkce SQL fixSortOrder, která je dostupná v úložišti dhis2-utils Github (https://github.com/dhis2/dhis2-utils/tree/master/resources/sql). Pomocí tohoto skriptu můžete opravit pořadí řazení pro každou dotčenou sekci datové sady.

General¶

Names of identifiable objects which have leading spaces.¶

Identifikovatelné objekty s názvy by neměly obsahovat úvodní mezery.

Závažnost: Varování

Doporučení: Tyto objekty může být možné opravit prostřednictvím uživatelského rozhraní DHIS2. Případně je lze opravit přímo v databázi pomocí SQL. Následující SQL můžete použít jako vzor, který vám pomůže vytvořit přesný dotaz, který potřebujete:

UPDATE chart as a  SET name = b.name_new from ( SELECT chartid,REGEXP_REPLACE(name,'^\s+','') as
name_new from chart where name ~ '^\s+') b where a.chartid = b.chartid;

Names of identifiable objects which have trailing spaces.¶

Identifikovatelné objekty s názvy by neměly obsahovat koncové mezery.

Závažnost: Varování

Recommendation: These objects may be able to be corrected through the user interface of DHIS2. Alternatively, they can be corrected directly in the database using SQL. You can use the following SQL as a pattern to help you create the exact query which you need:

UPDATE chart as a  SET name = b.name_new from ( SELECT chartid,REGEXP_REPLACE(name,'\s+$','') as name_new from chart where name ~ '\s+$') b where a.chartid = b.chartid;

Names of identifiable objects which have multiple spaces.¶

Identifikovatelné objekty s názvy by neměly obsahovat úvodní mezery.

Závažnost: Varování

Recommendation: These objects may be able to be corrected through the user interface of DHIS2. Alternatively, they can be corrected directly in the database using SQL. You can use the following SQL as a pattern to help you create the exact query which you need:

UPDATE categorycombo as a  SET name = b.name_new from ( SELECT categorycomboid,REGEXP_REPLACE(name,'\s{2,}',' ') as
name_new from categorycombo where name ~ '\s{2,}') b where a.categorycomboid = b.categorycomboid;

Indikátory¶

Total count of indicators.¶

Overview of the number of indicators in the system. Severity: Info

Doporučení: DHIS2 by měl obsahovat užitečné indikátory pro uživatele.

Indicators not in any groups.¶

All indicators should be in an indicator group. This allows users to find the indicators more easily in analysis apps and also contributes to having more complete indicators group sets. Maintenance operations can also be made more efficient by applying bulk settings (ex. sharing, filtering) to all indicators within an indicator group.

Závažnost: Varování

Doporučení: Ukazatele, které nejsou ve skupině ukazatelů, by měly být přidány do příslušné skupiny ukazatelů. Pokud indikátory nejsou potřeba, měly by být vymazány.

Indicators not used in analytical objects OR data sets.¶

All indicators that are calculated should be used to produce some type of analysis output (charts, maps, tables), alternatively to provide feedback during data entry by being part of a data set.

Závažnost: Varování

Recommendation: Indicators that are not routinely being reviewed in analysis, either in an output or data set, should be reviewed to determine if they still need to be calculated. If these are meant to be used for routine review, then associated outputs should be created using them. If these indicators are not going to be used for any type of information review, consideration should be made to either archive them or delete them.

Indicators not used in analytical objects.¶

Indikátory by měly být použity k vytvoření určitého typu výstupu analýzy (grafy, mapy, tabulky). Poznámka: Indikátory používané v souborech dat k poskytování zpětné vazby při zadávání dat se nepočítají jako indikátory používané v analytických objektech.

Závažnost: Varování

Recommendation: Indicators that are not routinely being reviewed in analysis should be reviewed to determine if they are useful and needed. If these are meant to be used for routine review, then associated outputs should be created using them. If these indicators are not going to be used for any type of information review, and are not used in data sets for feedback during data entry, consideration should be made to either delete them.

Sady možností¶

Ununsed option sets.¶

Sady možností by měly být použity pro určitý účel buď s atributy, datovými prvky nebo komentáři.

Závažnost: Varování

Doporučení: Zvažte smazání nepoužívaných sad možností, případně se ujistěte, že byly správně přiřazeny.

Empty option sets¶

Všechny sady možností by obecně měly obsahovat alespoň dvě položky. Prázdné sady možností neslouží žádnému účelu.

Závažnost: Varování

Doporučení: Možnosti by měly být buď přidány do sady možností, nebo by měla být sada možností odstraněna.

Option sets with possibly wrong sort order.¶

Sady doplňků obsahují doplňky, které lze objednat. Vlastnost sort_order by měla vždy začínat 1 a mít postupnou sekvenci. Pokud jsou v sadě možností tři možnosti, pořadí řazení by mělo být 1,2,3. Za určitých okolností mohou být možnosti ze sady možností odstraněny a pořadí řazení se může poškodit. To může vést k situaci, kdy nebude možné aktualizovat sadu možností z aplikace pro údržbu, a může to vést k problémům při pokusu o použití sady možností v aplikaci pro zadávání dat.

Závažnost: Těžká

Doporučení: Pokud je možné otevřít sadu možností v aplikaci pro údržbu, můžete použít sadu možností, která by měla problém vyřešit. Dalším možným řešením je přímo aktualizovat vlastnost sort_order v tabulce optionset v databázi, čímž se zajistí, že pro všechny volby v sadě voleb bude přítomna platná sekvence.

Organisation units¶

Orgunits that are not in all compulsory orgunit group sets¶

Všechny skupiny organizačních jednotek, které byly označeny jako povinné, by měly obsahovat všechny organizační jednotky v systému. Pokud jsou některé organizační jednotky vynechány ze skupin v sadě skupin, může to způsobit nesrovnalosti v analytických výstupech, například vynechání dat.

Závažnost: Těžká

Doporučení: Přidejte všechny organizační jednotky přesně do jedné skupiny v rámci povinné skupiny organizačních jednotek.

Organisation units which have an opening date later than the closed date.¶

Pokud bylo pro organizační jednotku definováno datum uzavření, mělo by být vždy po datu otevření (pokud bylo definováno).

Závažnost: Těžká

Doporučení: Změňte datum otevření nebo uzavření všech dotčených organizačních jednotek tak, aby datum uzavření bylo po datu otevření.

Organisation units should not have trailing spaces.¶

Koncové prostory v organizačních jednotkách jsou nadbytečné.

Závažnost: Varování

Doporučení: Pokud je počet dotčených organizačních jednotek malý, je nejjednodušší nápravou je opravit přímo z uživatelského rozhraní. Další možnou možností by bylo nahrazení všech více mezer pomocí SQL.

Organisation units with point coordinates should be contained by their parent.¶

Zařízení jsou často reprezentována jako body v hierarchii DHIS2. Geometrie jejich nadřazených organizačních jednotek by měla obsahovat všechna zařízení, která s nimi byla spojena.

Závažnost: Varování

Recommendation: Often boundary files are simplified when they are uploaded into DHIS2. This process may result in facilities which are located close to the border of a given district to fall outside of the district when the boundary is simplified. This is considered to be more of a cosmetic problem for most DHIS2 installations, but could become an issue if any geospatial analysis is attempted using the boundaries and point coordinates.

In cases where the facility falls outside of its parent's boundary you should confirm that the coordinates are correct. If the location is close to the boundary, you may want to reconsider how the boundary files have been simplified. Otherwise, if the location of the facility is completely incorrect, it should be rectified.

Organisation units located within 100 km of Null Island (0,0).¶

Častým problémem při importu souřadnic je zahrnutí souřadnic umístěných kolem bodu Nulového ostrova. Toto je bod na zemském povrchu, kde se nultý poledník a rovník protínají se zeměpisnou šířkou 0 a nulovou délkou. Bod se také nachází v současné době uprostřed oceánu. Tento dotaz identifikuje všechny body umístěné do 100 km od bodu, jejichž zeměpisná šířka a délka se rovna nule.

Závažnost: Těžká

Doporučení: Aktualizujte souřadnice dotčené organizační jednotky na správné místo.

Organisation units should not have multiple spaces in their names.¶

Názvy organizačních jednotek by neměly obsahovat více mezer. Jsou nadbytečné a mohou zkomplikovat umístění organizačních jednotek při jejich prohledávání.

Závažnost: Varování

Doporučení: Pokud je počet dotčených organizačních jednotek malý, je nejjednodušší nápravou je opravit přímo z uživatelského rozhraní. Další možnou možností by bylo nahrazení všech více mezer pomocí SQL.

Organisation units with invalid geometry.¶

DHIS2 využívá rozšíření databáze PostGIS pro správu geografických informací spojených s organizačními jednotkami. Existují různé důvody, proč mohou být geometrie považovány za neplatné, včetně samozačlenění, průniků a mnohoúhelníků. Podrobnější diskusi na toto téma naleznete v dokumentaci PostGIS.

Závažnost: Kritická

Doporučení: Aktualizujte geometrii dotčených organizačních jednotek na platnou geometrii. K automatickému vyřešení problému může být možné použít funkci PostGIS ST_MakeValid. V jiných případech však může být nutné geometrii upravit v nástroji GIS a poté znovu aktualizovat v DHIS2.

The organisation unit hierarchy should have a single root.¶

Každý systém DHIS2 by měl mít jednu kořenovou organizační jednotku. To znamená jednu organizační jednotku, z níž jsou potomky všechny ostatní větve hierarchie.

Závažnost: Kritická

Doporučení: Jakmile se rozhodnete, která organizační jednotka by měla být skutečným kořenem hierarchie organizačních jednotek, měli byste aktualizovat nadřazenou organizační jednotku. To lze provést pomocí DHIS2 API nebo mou aktualizací hodnoty přímo v tabulce organisationunit.

Organisation units with no coordinates.¶

Ideally, all organisation units contained in the DHIS2 hierarchy should have a valid set of coordinates. Usually for all organisation units above the facility level, these coordinates should be a polygon which provides the boundary of the organisation unit. For facilities, these are usually represented as point coordinates.

There can obviously be exceptions to this rule. Mobile health facilities may not have a fixed location. Community health workers or wards below the facility level may also not have a defined or definable coordinate.

This check is intended to allow you to review all organisation units which do not have any coordinates and make a determination as to whether they should be updated.

Závažnost: Varování

Recommendation: Where appropriate, update the geometry of each organisation unit with a valid geometry. You may need to contact the appropriate local government office to obtain a copy of district boundaries, commonly referred to as "shape files". Another possibility is to use freely available boundary files from GADM (https://gadm.org)

If facilities are missing coordinates, it may be possible to obtain these from the facility staff using their smart phone to get the coordinates. Images from Google Maps can also often be used to estimate the position of a facility, assuming that you have good enough resolution and local knowledge of where it is located.

Orphaned organisation units.¶

Osiřelé organizační jednotky jsou takové, které nemají rodiče ani žádné děti. To znamená, že nemají žádný vztah k hierarchii hlavní organizační jednotky. Ty mohou být vytvořeny chybným importem metadat nebo přímou manipulací s databází.

Závažnost: Kritická

Doporučení: Osiřelé organizační jednotky by měly být přiřazeny nadřazené nebo odstraněny ze systému. Pokud je to možné, doporučuje se pro tento úkol použít DHIS2 API. Pokud to není možné, může být nutné je odstranit pomocí přímého SQL v databázi DHIS2.

Organisation units which belong to multiple groups in a group set.¶

Organizační jednotky by měly patřit přesně do jedné skupiny v rámci každé sady skupin organizačních jednotek, jejímž jsou členem. Pokud organizační jednotka patří do více skupin, povede to v analýze k nepředvídatelným výsledkům.

Závažnost: Těžká

Doporučení: Pomocí aplikace pro údržbu přiřaďte organizační jednotky v seznamu podrobností přesně jedné skupině v rámci členství v každé sadě skupin.

Období¶

Periods with the same start and end dates¶

Různá období by neměla mít přesně stejné datum začátku a konce.

Závažnost: Kritická

Doporučení: Všechny odkazy na duplicitní období by měly být ze systému odstraněny a přiřazeny znovu. Doporučuje se použít období se spodní periodou.

Periods which are more than three years in the future.¶

Periods in DHIS2 are automatically generated by the system. As new data is entered into the system, new periods are automatically created. In some cases, periods may mistakenly be created when data is sent to DHIS2 for periods which are in the far future. Different data entry clients may not properly validate for periods which are in the future, and thus any periods in the future should be reviewed. In some cases, data may be valid for future dates, e.g. targets which are set for the next fiscal year.

Závažnost: Varování

Recommendation: If any periods exist in the system in the future, you should review the raw data either directly in the datavalue table, or alternatively though the pivot tables to ensure that this data is correct.

In many cases, clients may mean to transmit data for January 2021, but due to data entry errors, January 2031 is selected. Thus, any data in the far future should be investigated to ensure it does not result from data entry errors.

Periods which are in the distant past.¶

Periods in DHIS2 are automatically generated by the system. As new data is entered into the system, new periods are automatically created. In some cases, periods may mistakenly be created when data is sent to DHIS2 for periods which are in the distant past. Different data entry clients may not properly validate for periods which are in the distant past, and thus these periods should be triaged to ensure that data has not been entered against them by mistake.

Závažnost: Varování

Recommendation: If any periods exist in the system in the distant past, you should review the raw data either directly in the datavalue table, or alternatively though the pivot tables to ensure that this data is correct.

In many cases, clients may mean to transmit data for January 2021, but due to data entry errors, January 2031 is selected. Thus, any data in the far future should be investigated to ensure it does not result from data entry errors.

Program rules¶

Program rules with no action.¶

Všechna pravidla programu by měla mít akci.

Závažnost: Těžká

Doporučení: Pomocí uživatelského rozhraní DHIS2 přiřaďte akci každému pravidlu programu, kterému jedno chybí. Případně, pokud se programové pravidlo nepoužívá, zvažte jeho odstranění.

Program rules with no priority.¶

Všem pravidlům programu by měla být přiřazena priorita.

Závažnost: Těžká

Doporučení: Pomocí uživatelského rozhraní DHIS2 přiřaďte prioritu každému pravidlu programu, kterému jedno chybí.

Program rules actions which should send or schedule a message without a message template.¶

Akce programových pravidel typu „Odeslat zprávu“ nebo „Naplánovat zprávu“ by měly mít přidruženou šablonu zprávy.

Závažnost: Těžká

Doporučení: Pomocí uživatelského rozhraní DHIS2 přiřaďte šablonu zprávy každé z akcí programových pravidel, které odesílají nebo plánují zprávy, ale nemají přidružení k šabloně zprávy.

Uživatelé¶

Number of users in the system¶

Celkový počet uživatelů v systému.

Závažnost: Informace

Doporučení: Pouze informace.

Users who have not logged in during the past 30 days¶

Všichni uživatelé by se měli pravidelně přihlašovat, ať už za účelem zadávání dat nebo prohlížení analýz. Tato metrika měří počet uživatelů, kteří jsou povoleni, ale během posledních 30 dnů se nepřihlásili.

Závažnost: Varování

Recommendation: Review if these users should be active, otherwise consider disabling the accounts.

Users who have not logged in over the past year¶

Aktivní uživatelské účty by měli mít pouze uživatelé, kteří běžně přistupují do systému. Uživatelé, kteří se v posledním roce nepřihlásili, nemusí používat nebo potřebovat přístup do systému, mohli opustit svou pozici a měli by, nebo může být účet výsledkem výzvy k registraci účtu, který nebyl použit.

Závažnost: Varování

Doporučení: Uživatelské účty, které nejsou spojeny se skutečnými, aktivními uživateli, by měly být minimálně deaktivovány, případně smazány.

Pravidla ověřování¶

All validation rule expressions should have a missing value strategy.¶

Ověřovací pravidla se skládají z výrazu na levé a pravé straně. V některých systémech nemusí být strategie chybějící hodnoty definována. To může vést k výjimce během analýzy ověřovacích pravidel. Dotčená ověřovací pravidla by měla být opravena vhodnou strategií chybějících hodnot.

Závažnost: Těžká

Doporučení: Pomocí výsledků zobrazení podrobností SQL identifikujte dotčená ověřovací pravidla a na které straně pravidla nebyla specifikována strategie chybějících hodnot. Pomocí aplikace pro údržbu proveďte příslušné opravy a uložte pravidlo.