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.

1. Slovník pojmov

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

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

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 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 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.
   2. vo vrátených údajoch sú objekty evidencie identifikované prostredníctvom schválených Jednotných referencovateľných identifikátorov, 
   3. 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,
   4. v prípade, že ISVS používa rozdielne štrukturálne metadáta, ktoré je možné ztotožniť s referenčnými štrukturálnymi metadátami, je API povinné použiť referenčné štrukturálne metadáta podľa bodu 1.b.,
   5. v prípade, že ISVS používa štrukturálne metadáta nepatriace do referenčných štrukturálnych metadát, je nutné ich identifikovať a reprezentovať do formy lokálnych štrukturálnych metadát. 
2. Ak referenčný register obsahuje údaje objektu evidencie, ktoré sú 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. Tento bod platí pre všetky nové projekty začaté po 1.6.2022.
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.

B.Dátová interoperabilita API centrálnych agendových systémov ISVS

1. V prípade že vyhlásený centrálny agendový systém poskytuje údaje cez API, tak toto API je v súlade s princípmi dátovej interoperability ak
   1. 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.
2. (???) Ak pre bežiace projekty predstavuje splnenie bodu 2. neplánované neúmerné časové úsilie, je pre identifikáciu externého objektu evidencie nutné použiť lokálny referencovateľný identifikátor, ktorý bude v budúcnosti možné stotožniť s jednotným referencovateľným identifikátorom externého objektu evidencie. (???)
3. Anotácie referenčných štrukturálnych metadát v API odpovediach sú nepovinné, nakoľko je ich možné získať strojovým spôsobom s portálu znalosti.gov.sk. Pre anotovanie dátových prvkov je nutné použiť dátový prvok rdfs:label, pre položku číselníka skos:prefLabel, pre názov celého číselníka je to dct:title. Ostatné objekty (indivídua) sa anotujú podľa ontológie, kde sú definované. 
4. Ak hodnota niektorého údaje je neznáma, resp. nie je definovaná, tak sa v API referenčného registra vôbec nevyskytuje. 

• Príklady: rfo-osoba.jsonld, rfo-osoba.ttl