WHO Anti-Tuberculosis Drugs Resistance Survey (DRS) - Tracker Installation Guide¶

Verze balíčku 1.0.1

Výchozí jazyk systému: angličtina

Dostupné překlady: francouzština, španělština, portugalština

Přehled¶

Soubory json metadat balíčku obsahují komponentu „balíček“, která poskytuje technické podrobnosti o verzi a obsahu balíčku. Níže jsou uvedeny soubory dostupné v aktuální verzi balíčku.

DHIS2.35¶

"package": {
    "DHIS2Build": "35d663a",
    "DHIS2Version": "2.35.11",
    "code": "TBDR00",
    "description": "Anti-Tuberculosis Drug Resistance Survey (DRS)",
    "lastUpdated": "20220124T083253",
    "locale": "en",
    "name": "TB_DRS_TKR_1.0.1_DHIS2.35.11-en",
    "type": "TKR",
    "version": "1.0.1"
}

DHIS2.36¶

"package": {
    "DHIS2Build": "5d136cb",
    "DHIS2Version": "2.36.6",
    "code": "TBDR00",
    "description": "Anti-Tuberculosis Drug Resistance Survey (DRS)",
    "lastUpdated": "20220124T073407",
    "locale": "en",
    "name": "TB_DRS_TKR_1.0.1_DHIS2.36.6-en",
    "type": "TKR",
    "version": "1.0.1"
}

When importing this package into a new/blank instance, please refer to the DHIS2 installation guide.

Instalace¶

Instalace modulu se skládá z několika kroků:

1. Příprava souboru metadat.
2. Import souboru metadat do DHIS2.
3. Konfigurace importovaná metadata.
4. Adaptace programu po importu

Před zahájením procesu instalace a konfigurace v DHIS2 se doporučuje nejprve si přečíst každou část. Byly identifikovány oddíly, které nelze použít, v závislosti na tom, zda importujete do nové instance DHIS2 nebo instance DHIS2 s již existujícími metadaty. Postup popsaný v tomto dokumentu by měl být testován v testovacím / fázovacím prostředí před opakováním nebo přenesením do produkční instance DHIS2.

Požadavky¶

K instalaci modulu je vyžadován uživatelský účet správce na DHIS2. Postup popsaný v tomto dokumentu by měl být testován v testovacím / fázovém prostředí před provedením na produkční instanci DHIS2.

Je třeba věnovat velkou pozornost tomu, aby byl samotný server a aplikace DHIS2 dobře zabezpečené, aby se omezil přístup ke shromažďovaným datům. Podrobnosti o zabezpečení systému DHIS2 jsou mimo rozsah tohoto dokumentu a odkazujeme na dokumentaci DHIS2.

Příprava souboru metadat¶

POZNÁMKA: Pokud instalujete balíček na novou instanci DHIS2, můžete přeskočit část „Příprava souboru metadat“ a okamžitě přejít do sekce Import souboru metadat do DHIS2

I když to není vždy nutné, může být často výhodné provést určité úpravy souboru metadat před jeho importem do DHIS2.

Výchozí dimenze dat¶

V dřívějších verzích DHIS2 byla UID výchozích datových dimenzí automaticky generována. I když tedy všechny instance DHIS2 mají výchozí volbu kategorie, kategorii datových prvků, kombinaci kategorií a kombinaci možností kategorie, UID těchto výchozích hodnot se mohou lišit. Novější verze DHIS2 mají pevně zakódovaná UID pro výchozí dimenzi a tato UID se používají v konfiguračních balíčcích.

Aby se předešlo konfliktům při importu metadat, je vhodné vyhledat a nahradit celý soubor .json pro všechny výskyty těchto výchozích objektů a nahradit UID souboru .json UID z instance, do které bude soubor importován. Tabulka 1 ukazuje UID, která by měla být nahrazena, a také koncové body API pro identifikaci stávajících UID

Identifikujte UID výchozích dimenzí ve vaší instanci pomocí uvedených požadavků API a nahraďte UID v souboru json UID z instance.

POZNÁMKA

Pamatujte, že tato operace hledání a nahrazování musí být provedena pomocí editoru prostého textu, nikoli textového procesoru, jako je Microsoft Word.

Typy indikátorů¶

Typ indikátoru je dalším typem objektu, který může způsobit konflikt importu, protože určitá jména se používají v různých databázích DHIS2 (např. "Procento"). Vzhledem k tomu, že typy indikátorů jsou definovány svým faktorem (včetně 1 pro indikátory „pouze čitatel“), jsou jednoznačné a lze je nahradit vyhledáváním a nahrazováním UID. Tato metoda pomáhá vyhnout se potenciálním konfliktům při importu a zabraňuje implementátoru ve vytváření duplicitních typů indikátorů. Níže uvedená tabulka obsahuje UID, která lze nahradit, a také koncové body API pro identifikaci stávajících UID:

TrackedEntityType¶

Stejně jako typy indikátorů můžete mít ve své databázi DHIS2 již existující typy trasovaných entit. Odkazy na typ trasované entity by se měly změnit tak, aby odrážely to, co je ve vašem systému, abyste nevytvářeli duplikáty. Níže uvedená tabulka obsahuje UID, která lze nahradit, a také koncové body API pro identifikaci stávajících UID:

Sort order for options¶

Zkontrolujte, zda pořadí řazení sortOrder možností ve vašem systému odpovídá pořadí řazení možností obsažených v balíčku metadat. To platí pouze v případě, že soubor json a cílová instance obsahují volby a sady voleb se stejným UID.

Po importu se ujistěte, že pořadí řazení možností v sadě možností začíná na 1. V hodnotách pořadí řazení by neměly být žádné mezery (např. 1,2,3,5,6).

Pořadí řazení lze upravit v aplikaci Údržba.

1. Přejděte na příslušnou sadu možností
2. Otevřete sekci „Možnosti“.
3. Použijte alternativy "ŘADIT PODLE JMÉNA", "ŘADIT PODLE KÓDU/HODNOTY" nebo "ŘADIT RUČNĚ".

Dashboards and visualizations¶

Ovládací panely a vizualizace na každém ovládacím panelu nelze skrývat / odkrývat pomocí konstant. Proto je třeba při instalaci balíčku na základě výběru testů / léků ručně odebrat nepoužitelné ovládací panely / vizualizace.

Visualizations in the metadata file may contain a placeholder . This placeholder in the metadata.json file has to be replaced by the Root Organisation unit UID from the target instance before the package can be imported.

Některé vizualizace a mapy mohou obsahovat odkazy na úrovně organizačních jednotek. Mapy, které se skládají z několika mapových pohledů, mohou obsahovat různé odkazy na úrovni organizační jednotky založené na konfiguraci mapové vrstvy. Níže uvedená tabulka poskytuje přehled takových položek obsažených v balení. Před importem souboru metadat upravte odkazy na úrovni organizační jednotky v souboru json metadat tak, aby odpovídaly struktuře organizační jednotky v cílové instanci.

Příklad:

Import metadat¶

K importu balíčků metadat použijte aplikaci Import/Export DHIS2. Před pokusem o skutečný import metadat je vhodné použít funkci „suchého běhu“ k identifikaci problémů. Pokud "suchý běh" nahlásí nějaké problémy nebo konflikty, podívejte se do sekce konflikty importu níže. Pokud import „suché spuštění“/„ověření“ funguje bez chyby, pokuste se importovat metadata. Pokud import proběhne bez chyb, můžete přistoupit ke konfiguraci modulu. V některých případech se konflikty nebo problémy při importu nezobrazí během „suchého běhu“, ale objeví se při pokusu o vlastní import. V tomto případě budou v souhrnu importu uvedeny všechny chyby, které je třeba vyřešit.

Řešení konfliktů importu¶

POZNÁMKA

Pokud importujete balíček do nové instance DHIS2, nezaznamenáte konflikty importu, protože v cílové databázi nejsou žádná metadata. Po importu metadat přejděte k části „Konfigurace“.

Může dojít k řadě různých konfliktů, i když nejběžnějším je, že v konfiguračním balíčku jsou objekty metadat s názvem, zkratkou a/nebo kódem, které již v cílové databázi existují. Existuje několik alternativních řešení těchto problémů s různými výhodami a nevýhodami. Který z nich je vhodnější, bude záviset například na typu objektu, u kterého ke konfliktu dojde.

Alternativa 1¶

Přejmenujte existující objekt v databázi DHIS2, u kterého existuje konflikt. Výhodou tohoto přístupu je, že není potřeba upravovat soubor .json, protože změny se místo toho provádějí prostřednictvím uživatelského rozhraní DHIS2. To bude pravděpodobně méně náchylné k chybám. To také znamená, že konfigurační balíček zůstane tak, jak je, což může být výhodou například při vydání aktualizací balíčku. Na původní objekty balíčku se také často odkazuje ve školicích materiálech a dokumentaci.

Alternativa 2¶

Přejmenujte objekt, u kterého došlo ke konfliktu v souboru .json. Výhodou tohoto přístupu je, že stávající metadata DHIS2 jsou ponechána tak, jak jsou. To může být faktor, když existuje školicí materiál nebo dokumentace, jako jsou SOP datových slovníků propojených s daným objektem, a to nezahrnuje žádné riziko záměny uživatelů úpravou metadat, se kterými jsou obeznámeni.

Všimněte si, že pro alternativu 1 i 2 může být modifikace stejně jednoduchá jako přidání malého pre / post-fix k názvu, aby se minimalizovalo riziko záměny.

Alternativa 3¶

Třetím a komplikovanějším přístupem je úprava souboru .json pro opětovné použití existujících metadat. Například v případech, kdy pro určitý koncept již existuje sada možností (např. „Pohlaví“), by tato sada možností mohla být odstraněna ze souboru .json a všechny odkazy na jeho UID nahrazeny odpovídající sadou možností již v databázi. Velkou výhodou tohoto (která se neomezuje na případy přímého konfliktu importu) je vyhnout se vytváření duplicitních metadat v databázi. Při provádění tohoto typu modifikace je třeba provést několik klíčových úvah:

• vyžaduje odborné znalosti podrobné struktury metadat DHIS2
• přístup nefunguje u všech typů objektů. Zejména určité typy objektů mají závislosti, které se tímto způsobem komplikovaně řeší, například v souvislosti s rozčleněními.
• budoucí aktualizace konfiguračního balíčku budou komplikované.

Další konfigurace¶

Po úspěšném importu všech metadat existuje několik kroků, které je třeba provést, než bude modul funkční.

Sdílení¶

Nejprve budete muset pomocí funkce Sharing DHIS2 nakonfigurovat, kteří uživatelé (skupiny uživatelů) by měli vidět metadata a data spojená s programem a kdo může registrovat / zadávat data do programu. Ve výchozím nastavení bylo sdílení nakonfigurováno pro následující:

• Typ trasované entity
• Program
• Fáze programu
• Ovládací panely

Balíček obsahuje čtyři skupiny uživatelů:

• DRS - admin
• DRS - přístup
• DRS - sběr dat

Ve výchozím nastavení je těmto skupinám uživatelů přiřazeno následující

Budete chtít přiřadit své uživatele k příslušné skupině uživatelů na základě jejich role v systému. V závislosti na vašem nastavení můžete chtít povolit sdílení pro jiné objekty v balíčku. Další informace o konfiguraci sdílení najdete v dokumentaci DHIS2.

User roles¶

Uživatelé budou potřebovat uživatelské role, aby mohli pracovat s různými aplikacemi v rámci DHIS2. Doporučují se následující minimální role:

1. Analýza dat trasovače: Může zobrazit analytiku událostí a přistupovat k ovládacím panelům, zprávám o událostech, vizualizátorům událostí, vizualizátorům dat, kontingenčním tabulkám, zprávám a mapám.
2. Zachycování dat Trasovače: Může přidávat datové hodnoty, aktualizovat trasované entity, prohledávat trasované entity napříč organizačními jednotkami a přistupovat k zachycení trasovačů

Další informace o konfiguraci rolí uživatelů najdete v dokumentaci DHIS2.

Organisation units¶

Program a datové sady musí být přiřazeny organizačním jednotkám v rámci stávající hierarchie, aby byly přístupné prostřednictvím aplikací pro sledování / zachycování.

Duplikovaná metadata¶

NOTE

This section only applies if you are importing into a DHIS2 database in which there is already meta-data present. If you are working with a new DHIS2 instance, please skip this section and go to Adapting the tracker program. If you are using any third party applications that rely on the current metadata, please take into account that this update could break them.

I když byla metadata úspěšně importována bez jakýchkoli konfliktů při importu, v metadatech mohou existovat duplikáty - datové prvky, trasované atributy entit nebo sady voleb, které již existují. Jak bylo uvedeno v části výše o řešení konfliktů, je třeba mít na paměti důležitý problém, že rozhodnutí o provádění změn metadat v DHIS2 musí také zohledňovat další dokumenty a zdroje, které jsou různými způsoby spojeny s existujícími metadaty a metadata, která byla importována prostřednictvím konfiguračního balíčku. Vyřešení duplikátů tedy není jen otázkou „vyčištění databáze“, ale také zajištěním toho, aby se tak dělo například bez narušení potenciálu integrace s jinými systémy, možnosti použít školicí materiál, rozbití SOP atd. To bude velmi záviset na kontextu.

Jedna důležitá věc, kterou je třeba mít na paměti, je, že DHIS2 má nástroje, které mohou skrýt některé složitosti potenciálních duplikací v metadatech. Například tam, kde existují duplicitní sady možností, mohou být skryty pro skupiny uživatelů pomocí sharing.

Konstanty¶

Balíček WHO Anti-Tuberculosis Drugs Resistance Survey (DRS) Tracker obsahuje sadu testů a seznam léků, které může implementující země upravit podle národního kontextu (např. Jaké léky a testy se v dané zemi používají/jsou k dispozici). Použití konstant a odpovídajících pravidel programu umožňuje správci systému v implementující zemi snadno „zapnout“ nebo „vypnout“ typy léků a testů v závislosti na dostupnosti. Když je do instance DHIS2 nainstalován kompletní balíček, jsou do systému zahrnuty všechny datové prvky pro všechny testy a léky zahrnuté v tomto balíčku. Všechny konstantní hodnoty jsou zpočátku nastaveny na 1 (umožňující související datové prvky pro zadávání dat) a mohou být nastaveny na 0 implementátorem nebo správcem systému podle kontextu země, pokud není potřeba (deaktivace souvisejících dat prvky pro zadávání dat). Pokud bude později k dispozici test nebo lék, může správce jednoduše znovu povolit datové prvky změnou konstanty z hodnoty 0 na hodnotu 1.

Cluster Sampling / Exhaustive Sampling of all Health Facilities¶

Nakonfigurujte, zda země používá klastrový odběr nebo vyčerpávající odběr všech zdravotnických zařízení

Number of DRS Samples sent to NRL¶

Konfigurujte počet vzorků odesílaných do zpracování NRL

Initial Screening Tests¶

Konfigurujte, které počáteční screeningové testy se používají pro bakteriologické potvrzení TBC: Sputum Smear Microscopy, Xpert MTB/RIF nebo oba.

SRL Sample Processing¶

Konfigurujte, zda má země možnost zasílání vzorků do SRL (nadnárodní laboratoř).

Tests at NRL¶

List of Available Drugs¶

Please note, that the constants help to hide certain sections and data element from the data entry without the need to delete them from the system/metadata.json file. However, the elements are still assigned to the program and will be included when exporting all data into eg. csv files.

Konfigurace rozhraní pro snímání trasovače, widgetů a horní lišty¶

Po instalaci balíčku musíte nakonfigurovat ovládací panel pro trasovač zachycení. Tato konfigurace zahrnuje formuláře pro zadávání dat, widgety a horní lištu.

Formuláře pro zadávání údajů¶

• Po registraci prvního (testovacího) případu přejděte do nabídky Nastavení ve formuláři pro zachycení trasovače a vyberte Zobrazit / Skrýt widgety
• Přepnout z Zadávání dat na časové ose na Tabulkové zadávání dat
• Ujistěte se, že jsou vybrány widgety Zápis, Zpětná vazba a Profil. Klikněte na Zavřít.
• Upravte widgety na obrazovce.

Horní lišta¶

• Otevřete nabídku Nastavení a vyberte Nastavení horní lišty
• Vyberte Aktivovat horní lištu
• Vyberte požadovaná informační pole a přiřaďte jejich pořadí řazení

• Klikněte na Uložit
• Vraťte se do nabídky Nastavení. Klikněte na Uložené rozložení ovládacího panelu jako výchozí. Uzamknout rozložení pro všechny uživatele.

Přizpůsobení trasovacího programu¶

Po importu programu můžete provést určité úpravy programu. Mezi příklady místních úprav, které by se mohly provést, patří:

• Přidání dalších proměnných do formuláře.
• Přizpůsobení názvů datových prvků / možností podle národních konvencí.
• Přidávání překladů do proměnných nebo do formuláře pro zadávání údajů.
• Úprava indikátorů programu na základě místních definic případů.

Důrazně se však doporučuje věnovat velkou pozornost, pokud se rozhodnete změnit nebo odebrat některý ze zahrnutých formulářů / metadat. Existuje nebezpečí, že by úpravy mohly narušit funkčnost, například pravidla programu a indikátory programu.