Skip to content

Latest commit

 

History

History
174 lines (147 loc) · 16.1 KB

používateľská príručka.md

File metadata and controls

174 lines (147 loc) · 16.1 KB

Uživatelská příručka - Národní katalog otevřených dat

1. ROZSAH PLATNOSTI A ÚČEL

Tato uživatelská příručka slouží k popisu uživatelské částí Národního katalogu otevřených dat (NKOD), části projektu OD2.0.

2. DEFINÍCIA POJMOV A SKRATIEK

DCAT-AP-SK 2.0
Specifikace pro metadatový záznam datasetu otevřených dat
LKOD
Lokální katalog otevřených dat
NKOD
Národní katalog otevřených dat
POD
Portál otevřených dat
RDF
Resource Description Framework - datový model využívaný NKOD
SPARQL
Dotazovací jazyk nad daty v RDF

3. POPIS IS

NKOD slouží jako backend budoucího Portálu otevřených dat (POD). Uživatelské prostředí NKOD je tedy nyní minimalistické a tvoří ho jediná webová stránka.

Webová stránka NKOD

Na webové stránce lze přepínat mezi 5 jazyky, vybírat předpřipravené SPARQL dotazy a SPARQL dotazy spouštět a vidět výsledky.

Editor SPARQL dotazu je realizován nástrojem Yasgui, jehož uživatelská dokumentace je dostupná online.

Data v NKOD se řídí specifikací DCAT-AP-SK 2.0. Data o výsledcích měření jsou pak založena na specifikaci Data Quality Vocabulary.

Aktualizace NKOD probíhá zpravidla denně, v noci.

3.1 URL s výstupními daty

Kromě webové stránky samotné jsou vystavena i následující URL. Pro produkční prostředí je prefixem všech URL https://opendata.mirri.tech. Na toto prostředí existuje i redirect z https://data.gov.sk/sparql. Pro testovací prostředí je prefixem všech URL https://opendata-test.mirri.tech.

SPARQL endpoint NKOD

Soubory s obsahem NKOD v RDF

Soubory s výsledky z měření kvality a dostupnosti

Dostupnost registrovaných zdrojů

Dostupnost CORS na registrovaných zdrojích

Kvalita metadatových záznamů

Kombinované indikátory

Soubory s CSV reporty výsledků měření kvality a dostupnosti

Tyto soubory jsou v cestě /subor/kvalita/indikátory/.

3.2 Registrační záznamy

V současnosti uživatelsky nelze spravovat registrační záznamy datových sad a lokálních katalogů. Tuto fukncionalitu přidá až Portál otevřených dat. Registrační záznamy tak spravuje Administrátor NKOD ručně v GitHub repozitáři. Registrační záznam datové sady se řídí DCAT-AP-SK 2.0. Registrační záznam LKOD typu DCAT-AP Dokumenty vypadá například takto:

@prefix dct: <http://purl.org/dc/terms/> .
@prefix dcat: <http://www.w3.org/ns/dcat#> .
@prefix foaf: <http://xmlns.com/foaf/0.1/> .
@prefix vcard: <http://www.w3.org/2006/vcard/ns#> .

@prefix lkod: <https://data.gov.sk/def/local-catalog-type/> .

<https://data.gov.sk/set/catalog/0144444444> a dcat:Catalog, lkod:1 ;
    dct:title "DCAT-AP-SK 2.0 DCAT-AP Dokumenty LKOD 1"@sk, "DCAT-AP-SK 2.0 DCAT-AP Documents LKOD 1"@en ;
    dcat:contactPoint [
        a vcard:Organization ;
        vcard:fn "Jakub Klímek"@sk ;
        vcard:hasEmail <mailto:[email protected]>
    ];
    dct:publisher <https://data.gov.sk/id/legal-subject/00681156> ;
    dcat:endpointURL <https://raw.githubusercontent.com/jakubklimek/sk-lkod-1/main/catalog.ttl> ;
    foaf:homepage <https://github.com/jakubklimek/sk-lkod-1> .

kde lkod:1 indikuje typ LKOD dle číselníku typů LKOD.

Pro přidání registračního záznamu doporučujeme zkopírovat nějaký existující a upravit IRI a obsažená metadata.

4. NÁROKY NA POUŽÍVATEĽA

Uživatelé NKOD jsou 3 druhů.

Návštěvník bez znalosti SPARQL
Tento si vystačí s předpřipravenými SPARQL dotazy a tedy nemusí mít žádné zvláštní dovednosti.
Návštěvník se znalostí SPARQL
Pokud chce návštěvník psát vlastní SPARQL dotaz, musí ovládat SPARQL a RDF, znát specifikaci DCAT-AP-SK 2.0, a pro zpracovávání údajů z měření kvality pak ještě Data Quality Vocabulary.
Externí IS
Externí IS bude přistupovat k webové službě SPARQL endpointu. Potřebuje knihovnu pro práci se SPARQLem, znát RDF, znát specifikaci DCAT-AP-SK 2.0, a pro zpracovávání údajů z měření kvality pak ještě Data Quality Vocabulary.