V této sekci jsou uvedeny příklady reprezentace lidí a osob 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 člověka jejich spojením pomocí znaku podtržítka _, například kontaktní_osoba_příjmení.
Člověk
Úplný příklad jména člověka.
JSON-LD soubor , JSON Schema , JSON-LD kontext
{
"@context": "https://ofn.gov.cz/lidé-a-osoby/2020-07-01/kontexty/člověk-či-osoba.jsonld",
"typ": "Člověk",
"jméno": {
"cs": "Jakub"
},
"příjmení": {
"cs": "Novák"
},
"tituly_před": {
"cs": "RNDr."
},
"tituly_za": {
"cs": "Ph.D."
},
"text": {
"cs": "RNDr. Jakub Novák, Ph.D."
},
"pohlaví": "https://data.mvcr.gov.cz/zdroj/číselníky/pohlaví/položky/mužské"
}
XML soubor
<?xml version="1.0" encoding="UTF-8"?>
<člověk:člověk xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:člověk="https://ofn.gov.cz/lidé-a-osoby/2020-07-01"
xmlns:xml="http://www.w3.org/XML/1998/namespace"
xsi:schemaLocation="https://ofn.gov.cz/lidé-a-osoby/2020-07-01 https://ofn.gov.cz/lid%C3%A9-a-osoby/2020-07-01/sch%C3%A9mata/%C4%8Dlov%C4%9Bk-%C4%8Di-osoba.xsd">
<člověk:jméno xml:lang="cs">Jakub</člověk:jméno>
<člověk:příjmení xml:lang="cs">Novák</člověk:příjmení>
<člověk:tituly_před xml:lang="cs">RNDr.</člověk:tituly_před>
<člověk:tituly_za xml:lang="cs">Ph.D.</člověk:tituly_za>
<člověk:pohlaví>https://data.mvcr.gov.cz/zdroj/číselníky/pohlaví/položky/mužské</člověk:pohlaví>
<člověk:text xml:lang="cs">RNDr. Jakub Novák, Ph.D.</člověk:text>
</člověk:člověk>
CSV soubor
jméno_cs,příjmení_cs,tituly_před_cs,tituly_za_cs,text_cs
Jakub,Novák,RNDr.,Ph.D.,"RNDr. Jakub Novák, Ph.D."
K souboru CSV je potřeba připojit metadatový popisek dle standardu CSV on the Web [[!tabular-data-primer]]:
Deskriptor
{
"@id": "https://ofn.gov.cz/lidé-a-osoby/2020-07-01/příklady/3.csv-metadata.json",
"@context": [
"http://www.w3.org/ns/csvw",
{"@language": "cs"}
],
"@type": "Table",
"url": "3.csv",
"tableSchema": {
"@type": "Schema",
"columns": [
{
"@type": "Column",
"name": "jmeno_cs",
"titles": "jméno_cs",
"propertyUrl": "http://schema.org/givenName",
"dc:description": "Křestní jméno",
"datatype": "string",
"lang": "cs"
}, {
"@type": "Column",
"name": "prijmeni_cs",
"titles": "příjmení_cs",
"propertyUrl": "http://schema.org/familyName",
"dc:description": "Příjmení",
"datatype": "string",
"lang": "cs"
}, {
"@type": "Column",
"name": "tituly_pred_cs",
"titles": "tituly_před_cs",
"propertyUrl": "http://schema.org/honorificPrefix",
"dc:description": "Tituly před jménem",
"datatype": "string",
"lang": "cs"
}, {
"@type": "Column",
"name": "tituly_za_cs",
"titles": "tituly_za_cs",
"propertyUrl": "http://schema.org/honorificSuffix",
"dc:description": "Tituly za jménem",
"datatype": "string",
"lang": "cs"
}, {
"@type": "Column",
"name": "text_cs",
"titles": "text_cs",
"propertyUrl": "http://schema.org/name",
"dc:description": "Celé jméno jako jeden řetězec. Použít pokud nelze jméno strukturovat.",
"datatype": "string",
"lang": "cs"
}, {
"@type": "Column",
"virtual": true,
"propertyUrl": "rdf:type",
"valueUrl": "http://schema.org/Person"
}
]
}
}
Člověk s přidaným vlastním atributem
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 poznámka.
JSON-LD soubor , JSON Schema , JSON-LD kontext
{
"@context": "https://ofn.gov.cz/lidé-a-osoby/2020-07-01/kontexty/člověk-či-osoba.jsonld", "typ": "Člověk",
"typ": "Člověk",
"jméno": {
"cs": "Jakub"
},
"příjmení": {
"cs": "Novák"
},
"tituly_před": {
"cs": "RNDr."
},
"tituly_za": {
"cs": "Ph.D."
},
"text": {
"cs": "RNDr. Jakub Novák, Ph.D."
},
"poznámka": "kamarád"
}
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.
XML soubor :
<?xml version="1.0" encoding="UTF-8"?>
<člověk:člověk xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:x="http://příklad.cz"
xmlns:xml="http://www.w3.org/XML/1998/namespace"
xmlns:člověk="https://ofn.gov.cz/lidé-a-osoby/2020-07-01"
xmlns:základ="https://ofn.gov.cz/základní-datové-typy/2020-07-01"
xsi:schemaLocation="https://ofn.gov.cz/lidé-a-osoby/2020-07-01 https://ofn.gov.cz/lid%C3%A9-a-osoby/2020-07-01/sch%C3%A9mata/%C4%8Dlov%C4%9Bk-%C4%8Di-osoba.xsd">
<základ:rozšiřující_položky>
<x:poznámka>Kamarád</x:poznámka>
</základ:rozšiřující_položky>
<člověk:jméno xml:lang="cs">Jakub</člověk:jméno>
<člověk:příjmení xml:lang="cs">Novák</člověk:příjmení>
<člověk:tituly_před xml:lang="cs">RNDr.</člověk:tituly_před>
<člověk:tituly_za xml:lang="cs">Ph.D.</člověk:tituly_za>
<člověk:text xml:lang="cs">RNDr. Jakub Novák, Ph.D.</člověk:text>
</člověk:člověk>
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 .
CSV soubor
jméno_cs,příjmení_cs,tituly_před_cs,tituly_za_cs,text_cs,poznámka
Jakub,Novák,RNDr.,Ph.D.,"RNDr. Jakub Novák, Ph.D.","Kamarád"
K souboru CSV je opět potřeba připojit metadatový popsiek dle standardu CSV on the Web [[!tabular-data-primer]]:
Deskriptor
{
"@id": "https://ofn.gov.cz/lidé-a-osoby/2020-07-01/příklady/4.csv-metadata.json",
"@context": [
"http://www.w3.org/ns/csvw",
{"@language": "cs"}
],
"@type": "Table",
"url": "4.csv",
"tableSchema": {
"@type": "Schema",
"columns": [
{
"@type": "Column",
"name": "jmeno_cs",
"titles": "jméno_cs",
"propertyUrl": "http://schema.org/givenName",
"dc:description": "Křestní jméno",
"datatype": "string",
"lang": "cs"
}, {
"@type": "Column",
"name": "prijmeni_cs",
"titles": "příjmení_cs",
"propertyUrl": "http://schema.org/familyName",
"dc:description": "Příjmení",
"datatype": "string",
"lang": "cs"
}, {
"@type": "Column",
"name": "tituly_pred_cs",
"titles": "tituly_před_cs",
"propertyUrl": "http://schema.org/honorificPrefix",
"dc:description": "Tituly před jménem",
"datatype": "string",
"lang": "cs"
}, {
"@type": "Column",
"name": "tituly_za_cs",
"titles": "tituly_za_cs",
"propertyUrl": "http://schema.org/honorificSuffix",
"dc:description": "Tituly za jménem",
"datatype": "string",
"lang": "cs"
}, {
"@type": "Column",
"name": "text_cs",
"titles": "text_cs",
"propertyUrl": "http://schema.org/name",
"dc:description": "Celé jméno jako jeden řetězec. Použít pokud nelze jméno strukturovat.",
"datatype": "string",
"lang": "cs"
}, {
"@type": "Column",
"name": "poznamka",
"titles": "poznámka",
"propertyUrl": "http://www.w3.org/2004/02/skos/core#note",
"dc:description": "Interní poznámka.",
"datatype": "string"
}, {
"@type": "Column",
"virtual": true,
"propertyUrl": "rdf:type",
"valueUrl": "http://schema.org/Person"
}
]
}
}
Osoba
Příklad identifikace tuzemské právnické osoby.
JSON-LD soubor , JSON Schema , JSON-LD kontext
{
"@context": "https://ofn.gov.cz/lidé-a-osoby/2020-07-01/kontexty/člověk-či-osoba.jsonld",
"typ": "Osoba",
"ičo": "00112233",
"název": {
"cs": "MojeFirma s.r.o.",
"en": "MojeFirma s.r.o."
}
}
XML soubor
<?xml version="1.0" encoding="UTF-8"?>
<osoba:osoba xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xml="http://www.w3.org/XML/1998/namespace"
xmlns:věc="https://ofn.gov.cz/věc/2020-07-01"
xmlns:osoba="https://ofn.gov.cz/lidé-a-osoby/2020-07-01"
xsi:schemaLocation="https://ofn.gov.cz/lidé-a-osoby/2020-07-01 https://ofn.gov.cz/lid%C3%A9-a-osoby/2020-07-01/sch%C3%A9mata/%C4%8Dlov%C4%9Bk-%C4%8Di-osoba.xsd">
<věc:název xml:lang="cs">MojeFirma s.r.o.</věc:název>
<věc:název xml:lang="en">MojeFirma s.r.o.</věc:název>
<osoba:ičo>00112233</osoba:ičo>
</osoba:osoba>
CSV soubor
ičo,název_cs,název_en
00112233,"MojeFirma s.r.o.","MojeFirma s.r.o."
K souboru CSV je potřeba připojit metadatový popisek dle standardu CSV on the Web [[!tabular-data-primer]]:
Deskriptor
{
"@id": "https://ofn.gov.cz/lidé-a-osoby/2020-07-01/příklady/1.csv-metadata.json",
"@context": [
"http://www.w3.org/ns/csvw",
{"@language": "cs"}
],
"@type": "Table",
"url": "1.csv",
"tableSchema": {
"@type": "Schema",
"columns": [
{
"@type": "Column",
"name": "ico",
"titles": "ičo",
"propertyUrl": "http://www.w3.org/2004/02/skos/core#notation",
"dc:description": "IČO",
"datatype": "string"
}, {
"@type": "Column",
"name": "nazev_cs",
"titles": "název_cs",
"propertyUrl": "http://www.w3.org/ns/regorg#legalName",
"dc:description": "Název právnické osoby.",
"lang": "cs",
"datatype": "string"
}, {
"@type": "Column",
"name": "nazev_en",
"titles": "název_en",
"propertyUrl": "http://www.w3.org/ns/regorg#legalName",
"dc:description": "Název právnické osoby v angličtině.",
"lang": "en",
"datatype": "string"
}, {
"@type": "Column",
"virtual": true,
"propertyUrl": "rdf:type",
"valueUrl": "http://www.w3.org/ns/regorg#RegisteredOrganization"
}
]
}
}
Zahraniční osoba s přidaným vlastním atributem
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 poznámka.
Také je ukázán příklad identifikace právnické osoby z jiné země.
JSON-LD soubor , JSON Schema , JSON-LD kontext
{
"@context": "https://ofn.gov.cz/lidé-a-osoby/2020-07-01/kontexty/člověk-či-osoba.jsonld",
"typ": "Zahraniční osoba",
"název": {
"cs": "MojeFirma s.r.o.",
"en": "MojeFirma s.r.o."
},
"stát_registrace": "http://publications.europa.eu/resource/authority/country/SVK",
"dič": "SK00112233",
"poznámka": "Dodavatel"
}
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.
XML soubor :
<?xml version="1.0" encoding="UTF-8"?>
<osoba:osoba xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xml="http://www.w3.org/XML/1998/namespace"
xmlns:věc="https://ofn.gov.cz/věc/2020-07-01"
xmlns:x="https://příklad.cz"
xmlns:osoba="https://ofn.gov.cz/lidé-a-osoby/2020-07-01"
xmlns:základ="https://ofn.gov.cz/základní-datové-typy/2020-07-01"
xsi:schemaLocation="https://ofn.gov.cz/lidé-a-osoby/2020-07-01 https://ofn.gov.cz/lidé-a-osoby/2020-07-01/schémata/člověk-či-osoba.xsd">
<základ:rozšiřující_položky>
<x:poznámka>Dodavatel</x:poznámka>
</základ:rozšiřující_položky>
<věc:název xml:lang="cs">MojeFirma s.r.o.</věc:název>
<věc:název xml:lang="en">MojeFirma s.r.o.</věc:název>
<osoba:stát_registrace>http://publications.europa.eu/resource/authority/country/SVK</osoba:stát_registrace>
<osoba:dič>SK00112233</osoba:dič>
</osoba:osoba>
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 .
CSV soubor
ičo,dič,název_cs,název_en,poznámka
00112233,SK00112233,"MojeFirma s.r.o.","MojeFirma s.r.o.",Dodavatel
K souboru CSV je opět potřeba připojit metadatový popsiek dle standardu CSV on the Web [[!tabular-data-primer]]:
Deskriptor
{
"@id": "https://ofn.gov.cz/lidé-a-osoby/2020-07-01/příklady/2.csv-metadata.json",
"@context": [
"http://www.w3.org/ns/csvw",
{"@language": "cs"}
],
"@type": "Table",
"url": "2.csv",
"tableSchema": {
"@type": "Schema",
"columns": [
{
"@type": "Column",
"name": "ico",
"titles": "ičo",
"propertyUrl": "http://www.w3.org/2004/02/skos/core#notation",
"dc:description": "IČO",
"datatype": "string"
}, {
"@type": "Column",
"name": "dic",
"titles": "dič",
"propertyUrl": "http://schema.org/vatID",
"dc:description": "DIČ",
"datatype": "string"
}, {
"@type": "Column",
"name": "nazev_cs",
"titles": "název_cs",
"propertyUrl": "http://www.w3.org/ns/regorg#legalName",
"dc:description": "Název právnické osoby.",
"lang": "cs",
"datatype": "string"
}, {
"@type": "Column",
"name": "nazev_en",
"titles": "název_en",
"propertyUrl": "http://www.w3.org/ns/regorg#legalName",
"dc:description": "Název právnické osoby v angličtině.",
"lang": "en",
"datatype": "string"
}, {
"@type": "Column",
"name": "poznamka",
"titles": "poznámka",
"propertyUrl": "http://www.w3.org/2004/02/skos/core#note",
"dc:description": "Poznámka",
"datatype": "string"
}, {
"@type": "Column",
"virtual": true,
"propertyUrl": "rdf:type",
"valueUrl": "http://www.w3.org/ns/regorg#RegisteredOrganization"
}
]
}
}
Člověk či osoba
Příklad identifikace člověka tam, kde se může vyskytnout i právnická osoba.
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]].
JSON-LD soubor , JSON Schema , JSON-LD kontext
{
"@context": "https://ofn.gov.cz/lidé-a-osoby/2020-07-01/kontexty/člověk-či-osoba.jsonld",
"typ": "Člověk",
"jméno": {
"cs": "Jakub"
},
"příjmení": {
"cs": "Novák"
},
"tituly_před": {
"cs": "RNDr."
},
"tituly_za": {
"cs": "Ph.D."
},
"text": {
"cs": "RNDr. Jakub Novák, Ph.D."
}
}
XML soubor
<?xml version="1.0" encoding="UTF-8"?>
<člověk:člověk_či_osoba xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:člověk="https://ofn.gov.cz/lidé-a-osoby/2020-07-01"
xmlns:xml="http://www.w3.org/XML/1998/namespace"
xsi:schemaLocation="https://ofn.gov.cz/lidé-a-osoby/2020-07-01 https://ofn.gov.cz/lid%C3%A9-a-osoby/2020-07-01/sch%C3%A9mata/%C4%8Dlov%C4%9Bk-%C4%8Di-osoba.xsd">
<člověk:člověk>
<člověk:jméno xml:lang="cs">Jakub</člověk:jméno>
<člověk:příjmení xml:lang="cs">Novák</člověk:příjmení>
<člověk:tituly_před xml:lang="cs">RNDr.</člověk:tituly_před>
<člověk:tituly_za xml:lang="cs">Ph.D.</člověk:tituly_za>
<člověk:text xml:lang="cs">RNDr. Jakub Novák, Ph.D.</člověk:text>
</člověk:člověk>
</člověk:člověk_či_osoba>
CSV soubor
člověk_jméno_cs,člověk_příjmení_cs,člověk_tituly_před_cs,člověk_tituly_za_cs,člověk_text_cs
Jakub,Novák,RNDr.,Ph.D.,"RNDr. Jakub Novák, Ph.D."
K souboru CSV je potřeba připojit metadatový popisek dle standardu CSV on the Web [[!tabular-data-primer]]:
Deskriptor
{
"@id": "https://ofn.gov.cz/lidé-a-osoby/2020-07-01/příklady/5.csv-metadata.json",
"@context": [
"http://www.w3.org/ns/csvw",
{"@language": "cs"}
],
"@type": "Table",
"url": "5.csv",
"tableSchema": {
"@type": "Schema",
"columns": [
{
"@type": "Column",
"name": "clovek_jmeno_cs",
"titles": "člověk_jméno_cs",
"propertyUrl": "http://schema.org/givenName",
"dc:description": "Křestní jméno",
"datatype": "string",
"lang": "cs"
}, {
"@type": "Column",
"name": "clovek_prijmeni_cs",
"titles": "člověk_příjmení_cs",
"propertyUrl": "http://schema.org/familyName",
"dc:description": "Příjmení",
"datatype": "string",
"lang": "cs"
}, {
"@type": "Column",
"name": "clovek_tituly_pred_cs",
"titles": "člověk_tituly_před_cs",
"propertyUrl": "http://schema.org/honorificPrefix",
"dc:description": "Tituly před jménem",
"datatype": "string",
"lang": "cs"
}, {
"@type": "Column",
"name": "clovek_tituly_za_cs",
"titles": "člověk_tituly_za_cs",
"propertyUrl": "http://schema.org/honorificSuffix",
"dc:description": "Tituly za jménem",
"datatype": "string",
"lang": "cs"
}, {
"@type": "Column",
"name": "clovek_text_cs",
"titles": "člověk_text_cs",
"propertyUrl": "http://schema.org/name",
"dc:description": "Celé jméno jako jeden řetězec. Použít pokud nelze jméno strukturovat.",
"datatype": "string",
"lang": "cs"
}, {
"@type": "Column",
"virtual": true,
"propertyUrl": "rdf:type",
"valueUrl": "http://schema.org/Person"
}
]
}
}
Orgán veřejné moci
Příklad identifikace orgánu veřejné moci.
JSON-LD soubor , JSON Schema , JSON-LD kontext
{
"@context": "https://ofn.gov.cz/lidé-a-osoby/2020-07-01/kontexty/člověk-či-osoba.jsonld",
"typ": "Orgán veřejné moci",
"identifikátor_ovm": "06216111",
"název": {
"cs": "Městský obvod Ústí nad Labem-Střekov",
"en": "Městský obvod Ústí nad Labem-Střekov"
}
}
XML soubor
<?xml version="1.0" encoding="UTF-8"?>
<osoba:orgán_veřejné_moci xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xml="http://www.w3.org/XML/1998/namespace"
xmlns:věc="https://ofn.gov.cz/věc/2020-07-01"
xmlns:osoba="https://ofn.gov.cz/lidé-a-osoby/2020-07-01"
xsi:schemaLocation="https://ofn.gov.cz/lidé-a-osoby/2020-07-01 https://ofn.gov.cz/lidé-a-osoby/2020-07-01/schémata/člověk-či-osoba.xsd">
<věc:název xml:lang="cs">Městský obvod Ústí nad Labem-Střekov</věc:název>
<věc:název xml:lang="en">Městský obvod Ústí nad Labem-Střekov</věc:název>
<osoba:identifikátor_ovm>06216111</osoba:identifikátor_ovm>
</osoba:orgán_veřejné_moci>
CSV soubor
identifikátor_ovm,název_cs,název_en
06216111,"Městský obvod Ústí nad Labem-Střekov","Městský obvod Ústí nad Labem-Střekov"
K souboru CSV je potřeba připojit metadatový popisek dle standardu CSV on the Web [[!tabular-data-primer]]:
Deskriptor
{
"@id": "https://ofn.gov.cz/lidé-a-osoby/2020-07-01/příklady/6.csv-metadata.json",
"@context": [
"http://www.w3.org/ns/csvw",
{"@language": "cs"}
],
"@type": "Table",
"url": "6.csv",
"tableSchema": {
"@type": "Schema",
"columns": [
{
"@type": "Column",
"name": "identifikator_ovm",
"titles": "identifikátor_ovm",
"propertyUrl": "http://www.w3.org/2004/02/skos/core#notation",
"dc:description": "Identifikátor OVM",
"datatype": "string"
}, {
"@type": "Column",
"name": "nazev_cs",
"titles": "název_cs",
"propertyUrl": "http://www.w3.org/ns/regorg#legalName",
"dc:description": "Název orgánu veřejné moci.",
"lang": "cs",
"datatype": "string"
}, {
"@type": "Column",
"name": "nazev_en",
"titles": "název_en",
"propertyUrl": "http://www.w3.org/ns/regorg#legalName",
"dc:description": "Název orgánu veřejné moci v angličtině.",
"lang": "en",
"datatype": "string"
}, {
"@type": "Column",
"virtual": true,
"propertyUrl": "rdf:type",
"valueUrl": "http://www.w3.org/ns/regorg#RegisteredOrganization"
}
]
}
}
