...

Dátová interoperabilita

Tento dokument definuje spôsob, akým je potrebné implementovať API informačných systémov verejnej správy v súlade s dátovou interoperabilitou.

Slovník pojmov

1. Slovník pojmov

interoperabilita - rôzne systémy, stroje či zariadení spolu môžu spolupracovať, spoločne fungovať alebo si rozumieť.

ISVS - informačný systém verejnej správy

referenčné údaje - povinne používané údaje ISVS , ktoré je nutné používať (synchronizovať, resp. stotožňovať) v agendových systémoch verejnej správy(z referenčných registrov)

jednotný referencovateľný identifikátor - nový typ identifikátora pre údaje a metaúdaje ISVS vytváraného podľa Pravidiel tvorby referencovateľných identifikátorov,

štrukturálne metadáta - metadáta definujúce dátové štruktúry pre reprezentáciu údajov a číselníkov v ISVS 

referenčné štrukturálne metadáta: povinne používané štrukturálne metadáta ako Centrálny model údajov verejnej správy, základné číselníky, hierarchie a tezauri

...

. URI sú  5★.

lokálne štrukturálne metadáta: špecifické štrukturálne metadáta ISVS nepatriace medzi referenčné štrukturálne metadáta. URI sú 4★.

2. Dátová interoperabilita API ISVS

1. V prípade že vyhlásený referenčný register ISVS poskytuje údaje cez API, tak toto API je v súlade s princípmi dátovej interoperability ak
   1. vo vrátených údajoch sú objekty evidencie identifikované prostredníctvom schválených Jednotných referencovateľných identifikátorov (5★), vytváraných podľa Pravidiel tvorby referencovateľných identifikátorov,, 
   2. vo vrátených údajov sú všetky referenčné štrukturálne metadáta (Centrálny model údajov, základné číselníky) identifikované tiež prostredníctvom schválených Jednotných referencovateľných identifikátorov,
   3. vo vrátených údajoch musí byť obsiahnutá informácia, z ktorého ISVS dané údaje pochádzajú. ISVS musí byť identifikované prostredníctvom Jednotného referencovateľného identifikátora.
   4. v prípade, že referenčný register ISVS používa vlastné rozdielne štrukturálne metadáta, ktoré je možné ztotožniť s referenčnými štrukturálnymi metadátami, je API povinné použiť  tieto údaje použiť referenčné štrukturálne metadáta podľa bodu 1.b.,
   5. v prípade, že referenčný register ISVS používa štrukturálne metadáta nepatriace do referenčných štrukturálnych metadát, je nutné ich identifikovať a reprezentovať do formy nereferenčných lokálnych štrukturálnych metadát, kde sa používajú lokálne (5★) URI identifikátory. 
2. Ak referenčný register obsahuje údaje objektu evidencie, ktoré nie sú referencované z iného referenčného registra, tak API je nutné tieto údaje zreferencovať a používať Jednotné referencovateľné identifikátory objektov evidencie z daných referenčných údajovsú vyhlásené iným referenčným registrom, tak API referenčného registra musí vracať jednotný referencovateľný identifikátor daného externého objektu evidencie. 
3. Ak referenčný register používa hodnoty číselníkov mimo Centrálneho modelu údajov, alebo je vhodné daný údaj reprezentovať ako položku číselníka napr. pre budúce použitie, na identifikáciu je nutné použiť lokálny referencovateľný identifikátor.

3.Dátová interoperabilita otvorených údajov

1. V prípade že ISVS poskytuje otvorené údaje prostredníctvom API, tak toto API je v súlade s princípmi dátovej interoperability ak
   1. splňuje požiadavky na dátovú interoperabilitu API podľa bodu 2.
2. V prípade že ISVS sprístupňuje referenčné otvorené údaje, alebo referenčné štrukturálne metadúdaje, tak tieto musia byť v súlade s dátovou interoperabilitou.

• Príklady: MIRRI Kontaktné miesta, MIRRI Organizačná štruktúra, MIRRI Úradné hodiny, ....