Rehabilitation - Aggregate Installation Guide¶

Tento dokument obsahuje instalační příručku pro souhrnný balíček Rehabilitace.

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

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

Instalace¶

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

1. Preparing the metadata file with DHIS2 metadata
2. Importing the metadata file into DHIS2
3. Configuring the imported metadata
4. Přizpůsobení programu po importu

Před zahájením procesu instalace a konfigurace v DHIS2 se doporučuje nejprve přečíst každou část instalační příručky. Identifikujte příslušné sekce v závislosti na typu vašeho importu:

1. importovat do prázdné instance DHIS2
2. importovat do instance DHIS2 s existujícími metadaty.

Kroky popsané v tomto dokumentu by měly být otestovány v testovací instanci DHIS2 a teprve poté aplikovány na produkční prostředí.

Požadavky¶

Pro instalaci modulu je vyžadován uživatelský účet správce na DHIS2.

Velkou péči je třeba věnovat tomu, aby byl server samotný i aplikace DHIS2 dobře zabezpečeny, měla by být definována přístupová práva ke shromážděným datům. Podrobnosti o zabezpečení systému DHIS2 jsou mimo rozsah tohoto dokumentu a odkazujeme na dokumentaci DHIS2.

Metadata files¶

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.

Preparing the Metadata File¶

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:

Visualizations using root organisation unit UID¶

Vizualizace, sestavy událostí, tabulky sestav a mapy, které jsou přiřazeny konkrétní úrovni organizační jednotky nebo skupině organizačních jednotek, mají odkaz na kořenovou organizační jednotku (úroveň 1). Takové objekty, pokud jsou v souboru metadat přítomny, obsahují zástupný symbol <OU_ROOT_UID>. Použijte funkci vyhledávání v editoru souborů .json k případné identifikaci tohoto zástupného symbolu a jeho nahrazení UID organizační jednotky úrovně 1 v cílové instanci.

Option codes¶

According to the DHIS2 naming conventions, the metadata codes use capital letters, underscores and no spaces. Some exceptions that may occur are specified in the corresponding package documentation. All codes included in the metadata objects in the current package match the naming conventions. It may occur that the codes of existing metadata objects used in the target database use lower case characters. In this case, it is important to update those values directly in the database.

Important

During the import, the existing option codes will be overwritten with the updated upper case codes. In order to update the data values for existing data in the database, it is necessary to update the values stored in the database using database commands. Make sure to map existing old option codes and new option codes before replacing the values. Use staging instance first, before making adjustments on the production server.

Pro hodnoty datových prvků použijte:

UPDATE programstageinstance
SET eventdatavalues = jsonb_set(eventdatavalues, '{"<affected data element uid>","value"}', '"<new value>"')
WHERE eventdatavalues @> '{"<affected data element uid>":{"value": "<old value>"}}'::jsonb
AND programstageid=<database_programsatgeid>;

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Ě".

Balíček Rehabilitace obsahuje jednu sadu možností a dvě možnosti:

{
    "optionSets": [
        {
            "name": "YES/NO (numeric)",
            "id": "TdDqpX1kdd2",
            "code": "YES_NO_NUM",
            "valueType": "INTEGER_ZERO_OR_POSITIVE",
            "options": [
                {
                    "id": "VavIEUmBv8j"
                },
                {
                    "id": "Xu8ieCbS7jH"
                }
            ]
        }
    ],
    "options": [
        {
            "name": "Yes",
            "id": "VavIEUmBv8j",
            "code": "1",
            "sortOrder": 1,
            "optionSet": {
                "id": "TdDqpX1kdd2"
            }
        },
        {
            "name": "No",
            "id": "Xu8ieCbS7jH",
            "code": "0",
            "sortOrder": 2,
            "optionSet": {
                "id": "TdDqpX1kdd2"
            }
        }
    ]
}

Tato sada možností Ano/Ne je založena na hodnotách možností „INTEGER_ZERO_OR_POSITIVE“, které jsou vyhodnoceny v prediktorech, aby se určila Dostupnost nezbytných balíčků rehabilitace na úrovni primární péče a počet zařízení nabízejících nezbytné balíčky.

Skupiny organizačních jednotek a sady skupin¶

Balíček obsahuje následující skupiny organizačních jednotek:

Depending on the the country context, further disaggregations might be required.

Example

If data collected for PHC facilities needs to be further disaggregated by district hospitals and health centres, you will need to create and maintain organisation groups REHAB PHC hospitals and REHAB PHC health centres as part of the REHAB PHC organisation unit group set.

The package includes the following Organisation Unit Group Sets:

Tyto objekty metadat je třeba nakonfigurovat.

1. Pokud cílová instance neobsahuje žádné skupiny organizačních jednotek, které odpovídají popisu skupin obsažených v balíčku, postupujte během konfigurace a importu podle následujících kroků:

   1. Importujte balíček spolu se zahrnutými skupinami organizačních jednotek.
   2. Přiřaďte příslušná zařízení novým skupinám organizačních jednotek v aplikaci Údržba.

2. Pokud cílová instance již obsahuje skupiny organizačních jednotek, které odpovídají popisu pro dané objekty metadat, postupujte při konfiguraci a importu podle následujících kroků:

   1. Poznamenejte si UID odpovídajících skupin organizačních jednotek v cílové instanci.
   2. Nahraďte všechny výskyty UID organizaceUnitGrop v souboru json metadat odpovídajícími UID uvedenými v kroku 1.
   3. Před importem odstraňte objekty metadat OrganizationUnitGroup ze souboru json metadat. Tento krok je velmi důležitý, jinak dojde k přepsání aktuálního přiřazení organizačních jednotek ke stávajícím skupinám v cílové instanci.
   4. Pokud není vyžadována žádná další předkonfigurace / úprava, pokračujte k importu balíčku.

3. Pokud cílová instance neobsahuje sady skupin organizačních jednotek, které odpovídají poskytnutému popisu, je třeba tyto skupiny organizačních jednotek importovat do cílové instance. Příslušné skupiny organizačních jednotek je třeba přidat do sad skupin organizačních jednotek v uživatelském rozhraní nebo pomocí rozhraní API.

4. Pokud cílová instance již obsahuje sady skupin organizačních jednotek, které odpovídají poskytnutému popisu, postupujte během konfigurace a importu podle následujících kroků:

   1. Nahraďte UID odpovídajících sad skupin organizačních jednotek v souboru metadat odpovídajícími UID sad skupin organizačních jednotek z cílové instance.
   2. Před importem odstraňte objekty sady skupin organizačních jednotek ze souboru metadat. Tento krok je velmi důležitý, jinak dojde k přepsání aktuálního přiřazení skupin organizačních jednotek k existujícím sadám skupin v cílové instanci.
   3. Přidejte nově importované skupiny organizačních jednotek do sad skupin organizačních jednotek. (Viz tabulky výše).

Example

The target instance may already contain the PHC organisation unit group. In this case, replace the UID aT5pkgRLbw5 of the group and all its occurences in the json file with the corresponding UID from the target instance before import. Then, remove the orgUnitGroup "PHC" metadata object from the json file. You will find it under "organisationUnitGroups".

Population, incidence and personnel density data¶

Balíček Rehabilitace obsahuje datové prvky, indikátory a další metadatové objekty, které se používají na datech populace, incidence a hustota personálu.

Úrovně organizačních jednotek, na kterých se zadávají údaje o populaci v cílové instanci, se mohou lišit.

V generickém balíčku Rehabilitace jsou tato metadata přidána do datových sad na úrovni zařízení uvedených v tabulce níže.

Pokud cílová instance již má infrastrukturu metadat, která se používá pro shromažďování údajů o populaci, personálu nebo incidenci, postupujte podle kroků uvedených níže:

1. Zvolte strategii pro zarovnání metadat populace v cílové instanci a v souboru .json.
2. Alternativa 1: Nahraďte UID datových prvků a všechny jejich výskyty v souboru json UID z cílového systému

3. Alternativa 2: Zvažte nahrazení UID těchto datových prvků v cílovém systému UID ze souboru json. Datové prvky GEN jsou součástí základní knihovny metadat DHIS2 a používají se v jiných balíčcích metadat.

4. Ukazatele, které používají data o populaci, zaměstnancích nebo incidenci, budou agregovat data na úrovni/úrovních, kde jsou data zadána.

5. Po importu balíčku může být vyžadováno další mapování a konfigurace. Viz sekce konfigurace datové sady

POZNÁMKA

Při aktualizaci UID prvku metadat ve stávající instamce DHIS2 budete muset spustit příkaz SQL v databázi a dodatečně nahradit všechny výskyty a odkazy jeho UID v jiných objektech metadat: prediktor, indikátor, výrazy ověřovacích pravidel atd. .

Predikce¶

The Rehabilitation package uses predictors to calculate:

1. the availability of essential rehabilitation packages at health facilities
2. the availability of personnel based for specific occupational groups
3. the availability of a specific occupational group at a reporting facility.
4. The number of facilities reporting on rehabilitation at a specific administrative level each year.

IMPORTANT

The rehabilitation package includes indicators that report on the percentage of facilities at a specific administrative level that report on rehabilitation (Rehab PHC, Rehab SHC, Rehab THC) with minimum number of occupational groups (at least 1, 2 or 3). The denominator for these indicators is the total number of facilities within a specific adminstrative level of care (PHC with a mandate to allocate rehabilitation workers, SHC, THC). There are several ways to obtain data for this denominator.

1. Organisation Unit Group counts. It is possible to use organisation unit group counts OUG{<UID>} to find the number of facilities that belong to a specific group. However, it is not possible to use this approach when tracking the changes over time.
2. Data elements in a yearly data set, where the number of facilities for a specific administrative level may be entered manually.
3. Data elements that receive yearly values from predictors that run on a yearly basis and generate the number of facilities based on the actual organisation unit group counts each year. This solution is implemented in the current generic package. Please keep in mind the risk of overwriting the generated data for a period of time in the past once the number of facilities within a specific administrative level has changed.

Metadata prediktoru zahrnují úrovně organizačních jednotek používané pro agregaci hodnot dat. Soubor metadat balíčku obsahuje zástupné symboly, které je třeba nahradit UID odpovídajících úrovní organizačních jednotek v cílové databázi.

Kroky k přípravě prediktorů pro import jsou popsány níže:

1. Identifikujte UID organizaceUnitLevel úrovně zařízení, na které budou data pro prediktory agregována. K identifikaci požadovaného UID použijte následující koncový bod API: ../api/organisationUnitLevels.json?fields=id,name
2. Najděte následující zástupné symboly OrganizationUnitLevel v souboru json: <OU_LEVEL_FACILITY_UID>
3. Nahraďte zástupné symboly UID identifikované úrovně zařízení v cílové instanci.
4. Identifikujte číslo úrovně zařízení v cílové instanci.
5. Najděte vlastnosti prvků výstupních dat v souboru json pomocí UID uvedených ve sloupci "Prvek výstupních dat - UID".
6. Hledejte vlastnost: "aggregationLevels": [4]
7. Pokud úroveň odpovídá úrovni v cílové instanci, ponechte číslo tak, jak je. Pokud se číslo úrovně zařízení v cílové nstanci liší, upravte číslo podle toho.

Pravidla ověření¶

Ověřovací pravidla obsažená v balíčku jsou seskupena podle datových sad, pro které byla nakonfigurována.

Všechny skupiny ověřovacích pravidel a odpovídající ověřovací pravidla jsou uvedeny v dodatku k této instalační příručce:

Rehabilitace – pravidla validace

Skupiny organizačních jednotek pro všechna pravidla ověřování jsou nastaveny na úroveň zařízení. Hodnota úrovně zařízení se nachází ve vlastnosti "organisationUnitLevels" každého ověřovacího pravidla. Ve výchozím nastavení je nastavena na 4. Upravte tyto úrovně v souboru metadat tak, aby odpovídaly úrovni zařízení v cílové instanci před importem balíčku.

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

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í¶

First, you will have to use the Sharing functionality of DHIS2 to configure which users (user groups) should see the metadata and data associated with the program as well as who can register/enter data into the program. By default, sharing has been configured for the following:

• Ovládací panely
• Vizualizace, mapy, zprávy o událostech a tabulky zpráv
• Datové sady
• Možnosti kategorie

Další informace o sdílení naleznete v dokumentaci DHIS2.

Balíček obsahuje tři základní skupiny uživatelů:

• Rehabilitační přístup (zobrazit metadata/zobrazit data)
• Rehab admin (zobrazit a upravit metadata / žádný přístup k datům)
• Rehabilitace – (zobrazení metadat/zachycení a zobrazení dat)

Uživatelé jsou přiřazeni do příslušné skupiny uživatelů na základě jejich role v systému. Sdílení pro další objekty v balíčku může být upraveno v závislosti na nastavení. Další informace naleznete v dokumentaci DHIS2 o sdílení.

Uživatelské role¶

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 unit assignment¶

Sady dat musí být přiřazeny organizačním jednotkám v rámci existující hierarchie, aby byly přístupné prostřednictvím aplikace pro zachycení. Níže uvedená tabulka poskytuje informace o přiřazení organizační jednotky pro datové sady Rehabilitace:

Organisation unit group assignment¶

Organizační jednotky v cílovém systému musí být přiřazeny skupinám organizačních jednotek Rehab na základě přehledu v sekci Skupiny organizačních jednotek.

Soubory dat¶

Následující soubory dat vyžadují po importu další konfiguraci:

Bed density¶

Pokud jsou roční údaje o celkovém počtu rehabilitačních lůžek již shromažďovány ve stávajícím HMIS, není soubor údajů o hustotě rehabilitačních lůžek potřeba. Ujistěte se, že jste nahradili všechny výskyty datového prvku "Dostupná rehabilitační lůžka (celkem)" K0Y94lADtGw existujícím datovým prvkem UID ve všech metadatových objektech, kde se na tento datový prvek odkazuje:

Personnel density¶

If the annual population data is already collected in the existing HMIS, the "GEN - Population" data element DkmMEcubiPv may be removed from the data set Sm2fALTZROS. Make sure to replace all occurences of the "GEN - Population"* data element with the existing data element UID in all metadata objects, where this data element is referenced:

Úroveň sběru údajů pro údaje o incidenci musí být stejná nebo nižší než úroveň shromažďování údajů pro údaje o populaci.

Přiřazení souboru dat organizační jednotky Personální hustota by mělo zůstat na úrovni zařízení pro účely analytických výstupů.

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.

Adapting the program¶

Once the program has been imported, you might want to make certain modifications to the program. Examples of local adaptations that could be made include:

• 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ů.
• Modifikace ukazatelů na základě definic místních 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.

Indicator mapping¶

Částečnou implementaci balíčku Rehabilitace, tj. implementaci přizpůsobené sady klíčových indikátorů WHO, naleznete v tabulce mapování indikátorů WHO na DHIS2.

Při přizpůsobování metadat se ujistěte, že identifikujete vizualizace a ovládací panely, kde se používají příslušné indikátory, a také datové prvky a kombinace kategorií použité v odpovídajících souborech dat.

Removing metadata¶

In order to keep your instance clean and avoid errors, it is recommended that you remove the unnecessary metadata from your instance. Removing unnecessary metadata requires advanced knowledge of DHIS2 and various dependenies.