Aplikace slouží ke stahování aktuálně platných číselníkových datových souborů.
Nalezení požadovaných číselníků - filtr
Ve výchozím stavu je zobrazen seznam všech číselníků (ve všech platných verzích)
Výsledný seznam
Výsledný seznam se zobrazuje ve formě tabulky se sloupci:
Identifikátor - jednoznačný název číselníku
Verze - verze struktury číselníku
Stav - stav číselníku: A - aktivní, T - testovací
Popis - popis číselníku
Struktura platí od - datum začátku platnosti struktury číselníku
Do - datum ukončení platnosti struktury číselníku
Ve výsledném seznamu sloupec Identifikátor je HyperLink na tento číselnikový záznam, po jeho stisknutí se dá přejít na přislušnou verzi číselníku.
Číselníkový záznam
Číselníkovým záznamem se rozumí číselník dané verze.
V levé části obsahuje fitrační okno, v pravé části základní metadata číselníku a dole se zobrazuje seznam rozbalených dat číselníkového záznamu.
Vysvětlíme každou část.
Vyhledávací část a seznam rozbalených dat.
V horním menu najdete výběr mezi verzemi daného číselníku a přechod do jiného číselníkového záznamu.
V připadě obecné filtrace (políčko Hledani) filtr prochází všechny sloupce seznamu a hledá výsledek podle obsahu políčka.
Je zde k dispozici i rozšiřující filtr, který prochází sloupce seznamu a vybírá podle kontextu ke každému sloupci.
Ke spuštění filtru dojde stiknutím tlačítka Aplikovat filtr. K výchozímu filtru se lze vrátit stiknutím tlačítka Výchozí filtr
Počet záznamů výsledného seznamu je k dispozici v hranatých závorkách.
Seznam se nezobrazuje celý, ale po stránkách s 10 záznamy (implicitně), přičemž existuje možnost výběru počtu záznamů na stránce.
Na zvolenou stránku se lze posunout výběrem čísla stránky.
Základní metadata číselníku.
(Identifikátor, Verze, Stav, ...) - popsáno výše - viz. Výsledný seznam
Popisné soubory ke stažení.
Xml schéma - schéma datového souboru xml (formát .xsd)
Popis struktury - webová stránka popisující daný číselník - základní metadata číselníku a atributy (sloupečky) daného číselníku
Datové soubory ke stažení. Lze stáhnout jak v běžné podobě, tak v komprimované podobě - formát .zip. V pravé části se uvádí datum a čas poslední aktualizace datového souboru.
xml - datový soubor ve formátu xml. Struktura . viz. Xml schéma (xsd) - vlevo .
txt - datový soubor ve formátu txt. Sloupce odděleny znakem |. Popis sloupců - viz Popis struktury vlevo
dbf - datový soubor ve formátu dbf.
Číselníkové záznamy s přechodem na jiný číselníkový záznam podle vazby.
V číselniku může být jeden nebo několik sloupců směrovaných podle vazby na jiný číselník. Pomocí HyperLinku lze poznat, který sloupec vazbě odpovídá. Po stisknuti se přesunete na vazební číselník.
Poznámka:
Při velkém počtu sloupců ořezáváme názvy sloupců (kvůli šetrnému zacházení s místem).
V připadě potřeby stači navést kurzor na tři tečky v názvu sloupce, stisknout a text se rozbali.
Číselníková webová služba se nachází na adrese:
https://app.celnisprava.gov.cz/ciselniky/servicedata.asmxPopis rozhraní Číselníkové webové služby:
Testovací aplikace (zdrojové kódy i spustitelný program):