Přehled
Tento dokument je sdílenou specifikací pro kontakty pro použití v otevřeých formálních normách ve smyslu § 3a odst. 3 zákona č. 106/1999 Sb., o svobodném přístupu k informacím. Specifikace je ilustrována příklady dat ve formátech JSON-LD [[json-ld11]] a tedy i JSON [[ECMA-404]], XML [[xml]] a CSV [[rfc4180]]. Ukazuje, jak reprezentovat informace o telefonních číslech, e-mailových adresách a odkazech na webové stránky.
V této sekci jsou definovány vlastnosti kontaktu. Pro každou vlastnost je uveden její identifikátor, který je pro její reprezentaci použit ve všech datových formátech, její název, datový typ, popis a příklad. Všechny třídy, které nejsou specifikovány jinou otevřenou formální normou nebo číselníkem, dědí vlastnosti a vazby třídy Věc.
Kontakt na člověka či společnost. Kromě níže specifikovaných vlastností a vazeb je možné u této třídy použít také vlastnosti a vazby třídy Věc, která je specifikována otevřenou formální normou Věc.
druh
Oficiální, Neformální, apod.
Neformální
email
mailto:otevrenadata@dia.gov.cz
facebook
MinisterstvoobranyCeskerepubliky
idds
abcdef
instagram
ceskystatistickyurad
url
https://data.gov.cz/
mobil
tel:+420123456789
telefon
tel:+420123456789
twitter
vnitro
umístění
V této sekci jsou uvedeny příklady reprezentace kontaktů ve formátech JSON-LD [[!json-ld11]] a tedy i JSON [[!ECMA-404]], XML [[!xml]] a CSV [[!rfc4180]] a v různých úrovních detailu. Datová schémata, která jsou použita v příkladech, lze přímo použít a zahrnout do publikačních plánů. Pro formáty JSON a XML jsou k dispozici příslušná schémata, tedy Schéma pro formát JSON v jazyce JSON Schema [[!json-schema]] a Schéma pro formát XML v jazyce XML Schema [[!xmlschema11-1]]. Pro formát JSON-LD [[!json-ld11]] je k dispozici kontext. Lze také použít zápis v CSV. Soubor v CSV je nutné doplnit schématem dle specifikace CSV on the Web [[!tabular-data-primer]].
Pokud je kontakt použit v rámci jiného datového standardu, tak se jména sloupců v CSV tabulce tvoří názvy atributů.
Zanořování je řešeno spojením názvu entity z jiného standardu, například kontaktní_osoba a z názvu atributu kontaktu jejich spojením pomocí znaku podtržítka _, například kontaktní_osoba_email.
V XML musí být atributy seřazeny dle specifikace. V případě kontaktu je to dle abecedy:
K souboru CSV je třeba připojit metadata dle standardu CSV on the Web [[tabular-data-primer]].
Například pokud se CSV soubor jmenuje kontakt.csv, je s ním publikován i metadatový soubor kontakt.csv-metadata.json:
Do schématu si lze v případě potřeby přidávat další atributy.
V následujících příkladech jsou nad rámec standardu přidán atribut telegram.
V XML se vlastní atributy přidávají na závěr kontaktu, do vlastního XML jmenného prostoru (XML namespace [[!xml-names]]).
V tomto příkladu jsou nové atributy přidány do XML jmenného prostoru x.
Alternativně je možné si nadefinovat celé nové XML schéma, které by vycházelo ze zde uvedeného základního XML schématu.
K souboru CSV je opět potřeba připojit metadatový popsiek dle standardu CSV on the Web [[!tabular-data-primer]]:
Kontakty mohou obsahovat různé množství informací. Některé mohou být detailní.