Aktuality

Abstrakt

Tento dokument je otevřenou formální normou ve smyslu § 3a odst. 3 zákona č. 106/1999 Sb., o svobodném přístupu k informacím, pro zveřejňování aktualit. Norma je ilustrována příklady dat ve formátu JSON-LD [[json-ld11]], a tedy i JSON [[ECMA-404]].

Specifikace

V této sekci jsou definovány jednotlivé třídy a jejich vlastnosti potřebné pro popis aktualit. 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.

Aktualita

Tato třída reprezentuje samotnou zveřejněnou aktualitu. 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.

Informuje o

Vlastnost: informuje_o
Typ: IRI
Jméno: Informuje o
Popis: IRI datové entity, vytvořené dle jiné Otevřené formální normy (OFN), na kterou se aktualita váže. Typicky se jedná například o akci, o které aktualita informuje, která byla ale zároveň vytvořená dle OFN Události.
Příklady: https://data.brno.cz/zdroj/akce/2019/vinobraní

Vazba: Související geografické území

Vazba: geografické_území
Typ: Umístění
Jméno: Související geografické území
Popis: Tato vlastnost odkazuje na geografickou oblast pokrytou aktualitou. Aktualita může být popsána více geografickými oblastmi.

Vazba: Téma

Vazba: téma
Typ: Téma událostí
Jméno: Téma události
Popis: Hodnoty této vlastnosti jsou z Číselníku pro témata událostí publikovaného jako číselník v Národním katalogu otevřených dat. Téma události nabývá několika hodnot. V příkladu je uvedena prezentace dopravy.
Příklad: https://data.mvcr.gov.cz/zdroj/číselníky/témata-událostí/položky/doprava

Vazba: Oznamovatel

Vazba: oznamovatel
Typ: Člověk či osoba
Jméno: Oznamovatel
Popis: Fyzická nebo právnická osoba, která aktualitu publikuje.

Příklady

V této sekci jsou uvedeny příklady reprezantace aktualit v různých úrovních detailu, ve formátu JSON-LD [[!json-ld11]], a tedy i JSON [[!ECMA-404]].

Jednoduchá aktualita

Příklad ukazuje, jak lze prezentovat aktualitu s minimálními položkami k publikaci.

JSON-LD soubor, JSON Schema, JSON Schema seznamu aktualit, JSON-LD kontext

{
"@context": "https://ofn.gov.cz/aktuality/2020-07-01/kontexty/aktualita.jsonld",
"typ": "Aktualita",
"iri": "https://www.trebic.cz/zdroj/aktuality/2019/diky-kamerovemu-systemu-byl-vinik-ihned-dopaden/d-43329",
"název": {
"cs": "Díky kamerovému systému byl viník ihned dopaden.",
"en": "Culprit was immediately caught, thanks to the camera system."
},
"popis": {
"cs": "Ve čtvrtek 26. září večer poničilo projíždějící nákladní auto čtyři sloupky zábradlí na Masarykově náměstí. Nákladní auto pokračovalo v jízdě po ulici Bráfova. Obsluha městského kamerového systému incident zaznamenala, strážníci městské policie zastavili auto ve Sportovní ulici a přivolali policisty z oddělení dopravních nehod. Ti záležitost převzali k dořešení. Během pátečního dopoledne byly následky odstraněny a chodník byl provizorně zabezpečen. Oprava proběhne během následujících týdnů.",
"en": "On Thursday, September 26th, a passing truck damaged four pads on Masaryk Square. The truck continued to drive along Bráfova Street. The CCTV operator noticed the incident, City Police officers stopped a car on Sports Street and summoned police from the Traffic Accident Department. This took over the matter. The consequences were removed on Friday morning and the pavement was provisionally secured. Repairing will take place in the coming weeks."
},
"vytvořeno": {
"typ": "Časový okamžik",
"datum_a_čas": "2019-01-01T09:30:00+02:00"
},
"relevantní_do": {
"typ": "Časový okamžik",
"datum_a_čas": "2019-10-27T09:00:00+02:00"
},
"oznamovatel": {
"typ": "Osoba",
"ičo": "44992785",
"název": {
"cs": "Město Třebíč"
}
}
}

Komplexní aktualita

V komplexním příkladu jsou uvedeny položky, které je vhodné vyplnit, aby měl uživatel k dispozici co nejvíce informací o dané aktualitě. Další položky lze přidávat dle potřeby.