Common metadata library - Installation Guide¶

Tento dokument obsahuje instalační příručku pro společnou knihovnu metadat.

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

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

Instalace¶

Níže uvedená tabulka vám pomůže určit, které soubory metadat jsou relevantní pro vaši implementaci:

Další informace naleznete v Průvodce návrhem společné knihovny metadat

Před importem souborů metadat do vaší instance DHIS2 si pečlivě přečtěte každou část instalační příručky!

Importing common metadata into a blank DHIS2 instance¶

Oblast použití instance DHIS2 vám pomůže určit, který soubor / soubory metadat chcete importovat. Metadata lze importovat bez dalších úprav.

Importing common metadata into a working DHIS2 instance¶

Přepsání metadat v cílové instanci může změnit konfiguraci existujících programů a může vést k chybám. Když importujete knihovnu společných metadat do funkčního prostředí DHIS2, musíte se ujistit, že neztratíte žádné existující konfigurace (tj. nastavení sdílení, pořadí řazení atd.).

Pokud objekty metadat ve společné knihovně metadat a v cílové instanci sdílejí stejné UID, ale nejsou totožné (např. jiný typ agregace, jiná přiřazená sada možností, jiný počet možností), zvažte přiřazení nových UID objektům metadat v cílové instance, před importem společné knihovny metadat.

UIDs¶

Replacing UIDs for metadata elements in the target system to match the source metadata file can be a complex task, as the uid maybe referenced in other metadata objects, such as program rules, indicators, predictors, validation rules, etc. Make sure to replace all occurances of the old uid with the new uid in the system before importing the metadata object.

PŘÍKLAD

Chcete-li aktualizovat uid možnosti kategorie, použijte následující příkaz:

UPDATE dataelementcategoryoption SET uid = '<new-uid>' WHERE uid = '<old-uid>';

Tracked entity attributes, data elements, option sets and options¶

For option set based data elements and attributes, make sure that these option sets are identical in the source file and in the target instance. Check that the matching option sets contain the same options.

Zkontrolujte agregaci a typy hodnot datových prvků a atributů ve zdrojovém souboru a cílové instanci.

Option codes¶

Podle konvencí pojmenování DHIS2 používají kódy metadat velká písmena, podtržítka a žádné mezery. Některé výjimky, které se mohou vyskytnout, jsou uvedeny v dokumentaci příslušného balíčku. Pokud hodnoty dat v cílové instanci obsahují malá písmena, je důležité tyto hodnoty aktualizovat přímo v databázi.

Níže uvedená tabulka obsahuje všechny sady možností, kde byly kódy v balíčku metadat změněny na velká písmena. Před importem metadat do instance zkontrolujte, zda se sady možností ve stávajícím systému shodují se sadami v balíčku .json a použijte stejné kódy možností velkými písmeny.

Important

During the import, the existing option codes will be overwritten with the updated upper case codes. In order to update the existing data values, 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>;

Pro hodnoty atributu trasované entity použijte:

UPDATE trackedentityattributevalue
SET value = <new-value>
WHERE trackedentityattributeid=<affected trackedentityattribute database_id> AND value=<old-value>;

Tracked entity type¶

Pokud se typy trasovaných entit ve společné knihovně metadat a cílové instance shodují, před importem společné knihovny metadat revidujte nastavení sdílení, přiřazené atributy typu trasované entity a jejich nastavení.