PRO INTERNÍ POTŘEBU
Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR
vypracovala společnost
ASD Software, s.r.o.
dokument ze dne 20.09.2007, verze 1.07
Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR
Počet stran v dokumentu celkem
:
35
Rozdělovník : Číslo 1.
Počet výtisků Předáno 1x MF, odbor 38
Převzal Ing. Hana Domínová
Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.09.2007 Copyright © ASD Software, s.r.o., 2002-2007
Obsah Obsah
2
1.
Úvod
5
2.
Use-case studie
6
2.1 3.
Požadavek na vygenerování číselníků a odpověď
6
Technické řešení 3.1
7
Přenosový formát
7
3.2 Validace a popis XML dokumentů 3.2.1 XML Schema 3.2.2 Doplňková validace XSLT šablonami 3.2.3 Jmenné prostory 3.2.4 RDDL
7 7 7 7 7
3.3 Transportní protokoly 3.3.1 Základní transportní protokol 3.3.2 Adresa služby 3.3.3 SOAP protokol 3.3.4 Použití protokolu BizTalk
7 7 8 8 8
3.4
Model přenosu zpráv
8
3.5
Popis služby ve formátu WSDL
8
3.6 Řešení bezpečnosti 3.6.1 Integrita přenosu dat 3.6.2 Požadavek o zaslání číselníků
9 9 9
3.7
9
Pojmenovávací konvence
3.8 Zpracování chyb 3.8.1 Chyby na úrovni přenosového protokolu SMTP 3.8.2 Chyby při načtení zprávy SOAP 3.8.3 Chyby vzniklé exspirací zprávy 3.8.4 Chyba neoprávněného přístupu 3.8.5 Chyby na úrovni ověření digitálního podpisu 3.8.6 Chyby na úrovni validace pomocí XML Schema 3.8.7 Chyby na úrovni validace XSLT šablonou 3.8.8 Chyby na aplikační úrovni 4.
9 9 9 10 10 10 10 10 10
Popis předávaných dat 4.1
11
Ustanovení pro definici platnosti elementů
11
4.2 Služba na vygenerování číselníků 4.2.1 Požadavek na vygenerování číselníků 4.2.1.1 Datové typy 4.2.1.2 Popis schémat 4.2.1.3 Zpráva s požadavkem na generování číselníků z IS CEDR III 4.2.1.4 Obsah Požadavku na generování číselníků Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 Copyright © ASD Software, s.r.o., 2002-2007
11 11 11 11 11 12
2
4.2.1.5 Validace 4.2.1.5.1 Kontroly XSLT 4.2.1.5.2 Kontroly aplikační 4.2.2 Odpověď na požadavek o vygenerování číselníků 4.2.2.1 Datové typy 4.2.2.2 Popis schémat 4.2.2.3 Zpráva s číselníky z IS CEDR III 4.2.2.4 Dávka dat s číselníky 4.2.2.4.1 Struktura číselníku právních forem 4.2.2.4.2 Struktura číselníku kapitol SR 4.2.2.4.3 Struktura číselníku ukazatelů SR 4.2.2.4.4 Struktura číselníku paragrafů rozpočtové skladby 4.2.2.4.5 Struktura číselníku položek rozpočtové skladby 4.2.2.4.6 Struktura číselníku dotačních titulů 4.2.2.4.7 Struktura číselníku zemí 4.2.2.4.8 Struktura číselníku bank 4.2.2.4.9 Struktura číselníku zdrojů finančních prostředků. 4.2.2.4.10 Struktura číselníku agentur 4.2.2.4.11 Struktura číselníku poskytovatelů 4.2.2.4.12 Struktura číselníku členění finančních prostředků 4.2.2.4.13 Struktura číselníku vybraných měrných jednotek 4.2.2.4.14 Struktura číselníku grantových schémat 4.2.2.4.15 Struktura číselníku operačních programů
12 12 12 13 13 13 13 13 15 15 16 16 16 17 18 18 19 19 20 20 21 21 21
5.
Podrobný popis životního cyklu zprávy
22
6.
Seznam změn v dokumentu od poslední verze
26
7.
Přílohy
27
7.1 Adresa služby 7.1.1 Verze 1.1.1
27 27
7.2 WSDL 7.2.1 Verze 1.1.1 7.2.1.1 Umístění
27 27 27
7.3 Schémata 7.3.1 ciselnikyPozadavek.xsd 7.3.1.1 Verze 1.1.1 7.3.1.1.1 Umístění 7.3.2 ciselniky.xsd 7.3.2.1 Verze 1.1.0 7.3.2.1.1 Umístění 7.3.3 ciselnikyDataTypes.xsd 7.3.3.1 Verze 1.0.1 7.3.3.1.1 Umístění 7.3.4 error_list.xsd 7.3.4.1 Verze 1.0.0 7.3.4.1.1 Umístění
27 27 27 27 27 27 27 27 27 27 27 28 28
7.4 XSLT validační šablony 7.4.1 xsltValidationCiselnikyPozadavek.xsl 7.4.1.1 Verze 1.1.1 7.4.1.1.1 Umístění
28 28 28 28
7.5
28
Příklady zpráv
Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 Copyright © ASD Software, s.r.o., 2002-2007
3
7.5.1 7.5.2
Požadavek na vygenerování číselníků Odpověď na požadavek
28 30
8.
Reference
33
9.
Seznam použitých zkratek a pojmů
34
Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 Copyright © ASD Software, s.r.o., 2002-2007
4
1. Úvod Tento materiál popisuje automatickou SMTP službu, která na základě předaných požadavků vrací zpět uživateli požadované informace, v našem případě obsah žádaných číselníků. Služba je poskytována zdrojům dat informačního systému CEDR III a slouží k aktualizaci číselníků informačních systémů poskytovatelů dat do IS CEDR III
Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 Copyright © ASD Software, s.r.o., 2002-2007
5
2. Use-case studie Proces žádosti o vygenerování číselníků a vytvoření odpovědi na žádost je popsán v následující kapitole.
2.1 Požadavek na vygenerování číselníků a odpověď Oprávněné osoby si mohou zažádat o zaslání číselníků z IS CEDR III tak, jak je uvedeno na Obr. 1: Zpracování požadavku IS CEDR III
Osoba žádající o číselníky
Požadavek na číselníky
Osoby v seznamu o doručení požadavku
Zpráva o doručení
Osoby v seznamu požadující číselnkíky
Zpráva o zpracování
Obr. 1 Proces žádosti a odpovědi na vygenerování číselníků.
Uvedené schéma lze slovně popsat následujícím způsobem : 1. Na straně klienta je vygenerována žádost o potřebné číselníky, která je opatřena náležitostmi popsanými v tomto dokumentu. 2. Požadavek je zaslán do IS CEDR III, kde je vygenerována zpráva o doručení požadavku o číselníky. Tato zpráva je zaslána osobám uvedeným v hlavičce zprávy dle kap. 3.3.4 3. Požadavek je zařazen do fronty požadavků, které jsou odbavovány metodou FIFO. Může dojít ke zpoždění odpovědi. 4. Po zpracování požadavku o číselníky je vygenerována odpověď, která je zaslána na osobám uvedeným v hlavičce zprávy dle kap. 3.3.4
Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 Copyright © ASD Software, s.r.o., 2002-2007
6
3. Technické řešení Pokud není explicitně uvedeno jinak, specifikace této služby přebírá zásady technického řešení, uváděné v dokumentu [3].
3.1 Přenosový formát Jako formát pro přenos dat bude použit standard XML 1.0, Second Edition [4]. Přenášené XML dokumenty musejí splňovat všechny požadavky standardu.
3.2 Validace a popis XML dokumentů 3.2.1 XML Schema Veškeré přenášené XML dokumenty budou mít pro účely validace vytvořen popis formátu dokumentu dle standardu XML Schema [5]. Validace XML dokumentů bude prováděna vždy při převzetí zprávy službou. Také veškeré odchozí zprávy služby musejí být před odesláním validovány. Všechny předávané zprávy XML musejí mít v kořenovém elementu dokumentu deklarován jmenný prostor schématu daného dokumentu. Pomocí atributu xsi:schemaLocation musí být také uvedena fyzická lokalizace schématu. Chybějící jmenný prostor nebo lokalizace schématu ve zprávě je důvodem k odmítnutí zprávy, i když bude jinak vyhovovat schématu. Všechna schémata budou obsahovat dokumentaci schématu. Formát RDF dokumentace bude odpovídat dle [3], kap. 4.1.6. Všechna schémata budou verzována v souladu se zásadami, uvedenými v [3], kap. 5.1.1.1. Cílové jmenné prostory všech schémat budou podporovat specifikaci RDDL dle [3], kap. 4.4.1. a 5.1.3.2.
3.2.2 Doplňková validace XSLT šablonami Bude-li pro daný typ XML dokumentu nutná procesní validace (viz [3], kap. 5.2.), bude prováděna pomocí XSLT validačních šablon v souladu s metodou, uvedenou v [3], kap. 5.2. Informace o lokalizaci validační šablony je nesena (opět dle [3], kap. 5.2) v atributu validation_XSLT kořenového elementu příslušného dokumentu.Výstupní XML dokument XSLT šablony musí být ve formátu odpovídajícím schématu error_list.xsd. Validační XSLT šablony musejí odpovídat standardu XSLT v. 1.1. [6].
3.2.3 Jmenné prostory Všechny jmenné prostory schémat, popisujících přenášené XML dokumenty popisované služby, budou ve formátu URN.
3.2.4 RDDL RDDL slouží ke snadnému přístupu ke zdrojům, spojeným se službou. RDDL soubory budou splňovat požadavky dokumentu [3], kap. 4.4.1. a 5.1.3.2.
3.3 Transportní protokoly 3.3.1 Základní transportní protokol Základním transportním protokolem pro popisovanou službu bude protokol SMTP. Komunikace při přenosu zpráv mezi klientem a bude asynchronní.
Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 Copyright © ASD Software, s.r.o., 2002-2007
7
3.3.2 Adresa služby Adresa služby je dána od používané verze služby a schémat. Výčet adres je uveden v kapitole 7.1
3.3.3 SOAP protokol Nad protokolem SMTP bude použit rozšiřující XML protokol SOAP ve verzi 1.1 [2]. Protokol SOAP bude mít implementováno jak záhlaví SOAP (element
), tak tělo SOAP (element ). V záhlaví SOAP budou v BizTalk elementech neseny administrativní informace (bližší viz 3.3.4). Při výskytu chyby zpracování zprávy bude generován element těla SOAP. Element bude obsahovat: • Povinný kód chyby v elementu s typem v souladu s deklarací seznamu chybových kódů ve schématu error_list.xsd. • Povinný textový popis chyby v elementu • Volitelný element . V tomto elementu budou neseny chybové XML dokumenty (jako výsledek validace přenášených XML dokumentů) ve formátu odpovídajícím schématu error_list.xsd. Všechny elementy SOAP budou mít nastaven atribut MustUnderstand na hodnotu 1.
3.3.4 Použití protokolu BizTalk Pro administraci zpráv bude použito elementů specifikace BizTalk [1]. Zprávy přenášející data (žádosti i odpovědi) budou povinně obsahovat elementy: • <endpoints> s indikací odesílatele a adresáta zprávy • <properties> popisující vlastní přenášený dokument v souladu s pravidly dle [3], kap. 4.2.5.1. • definuje že strana zasílající požadavek bude vyžadovat zprávu o doručení v souladu s pravidly dle [3], kap. 4.2.5.1. • že strana zasílající požadavek bude vyžadovat potvrzení o zpracování. v souladu s pravidly dle [3], kap. 4.2.5.1. Element <expiresAt> bude ignorován. Elementy specifikace BizTalk budou používat prosté řetězce emailových adres osob, které mají obdržet zprávu o doručení nebo o zpracování. V případě více emailových adres budou adresy odděleny středníky. Elementy budou uvádět jmenný prostor schématu, odpovídajícího přenášené zprávě. Pro jednoznačnou identifikaci dokumentu slouží subelement elementu <properties>. Platí následující pravidlo : • Naplnění elementu zajistí odesílající strana. Doporučeno je použití takového identifikátoru, které bude dokument jednoznačně identifikovat (generování UUID některým z vhodných nástrojů).V případě duplicity hodnoty elementu identity bude zpráva odmítnuta jako celek. Všechny elementy BizTalk, které mohou nést atribut MustUnderstand, musejí mít pro účely této služby tento atribut přítomen a nastaven na hodnotu 1.
3.4 Model přenosu zpráv Jako model pro přenos zpráv bude použit model message-passing dle [3], kap. 5.5.1.2
3.5 Popis služby ve formátu WSDL Tato služba, pro žádost o číselníky, bude popsána ve formátu WSDL v souladu s [3], kap. 4.2.7. Soubor WSDL bude umístěn na adrese WSDL . Soubor WSDL bude obsahovat dokumentaci, kdy formát RDF dokumentace bude odpovídat [3], kap. 5.1.3.1.
Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 Copyright © ASD Software, s.r.o., 2002-2007
8
3.6 Řešení bezpečnosti Služba ve verzi, odpovídající tomuto dokumentu, bude mít implementovány následující bezpečnostní funkce (viz též [3], kap. 5.7.1).
3.6.1 Integrita přenosu dat Integritou dat se rozumí zabezpečení citlivých dat před jejich změnou během transportu.. K zabezpečení integrity přenosu dat (viz [3], kap. 5.3.6) bude v této službě použito XML Signature). Podepisovat se budou BizTalk elementy <endpoints> , <properties> a a celý element . Pro podpis bude použito předem dohodnutých certifikátů, které budou samostatně předány mezi jednotlivými účastníky komunikace pro jejich zaevidování v informačních systémech. Element <Signature> bude mít atribut Id s hodnotou “Signature”
3.6.2 Požadavek o zaslání číselníků Tento typ přenosu (viz též 2.1) bude mít implementovány bezpečnostní funkce v závíslostní na typu zprávy. Pro zprávy s požadavkem na zaslání číselníků to budou následující: • Autentizace a autorizace žadatele • Integrita přenosu dat Zprávy s vygenerovanými číselníky budou zabezpečeny funkcemi: • Integrita přenosu dat
3.7 Pojmenovávací konvence RDDL soubory, umístěné na URL XXX a budou mít příponu .html. Všechny soubory, dostupné pomocí RDDL, budou mít názvy souborů vytvořené pouze malými písmeny. Tyto pravidla nemají vliv na uživatelské pojmenovávání souborů služeb, vztahují se pouze na soubory RDDL zdrojů a slouží pouze pro informaci.
3.8 Zpracování chyb Zpracování chyb bude ošetřeno v souladu se zásadami uvedenými v [3], kap. 5.10.1. Seznam chybových kódů bude odpovídat schématu error_list.xsd. • Client.Validity.Schema (chyba validace pomocí XML Schema) • Client.Validity.XSLT (chyba validace pomocí XSLT šablony) Pokud to bude vyžadovat povaha chyby, může administrace služby kontaktovat uživatele klientské aplikace na adrese, uvedené v atributu elementu <endpoints> dotazu.
3.8.1 Chyby na úrovni přenosového protokolu SMTP Chyby na úrovni přenosového protokolu SMTP budou řešeny standardními mechanismy protokolu a sítí. Služba se nebude pokoušet zpracovat žádnou zprávu, u níž došlo k selhání přenosu na úrovni základního protokolu, ani nebude generovat zvláštní chybové zprávy. Služba také nebude zaznamenávat žádnou takovouto zprávu do logu příchozích zpráv.
3.8.2 Chyby při načtení zprávy SOAP Do této třídy chyb patří chyby, vzniklé při načítání SOAP dokumentu. Mohou to být chyby způsobené špatným formátováním dokumentu nebo neodpovídajícím jmenným prostorem SOAP 1.1. ErrorText Dokument neobsahuje SOAP obálku požadované verze. Dokument neobsahuje SOAP element Header. Dokument neobsahuje SOAP element Body.
Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 Copyright © ASD Software, s.r.o., 2002-2007
9
Tyto zprávy již budou logovány. Na klienta bude odeslána pouze chybová zpráva ve formátu SOAP. Chybový kód je v tomto případě VersionMismatch (chybný jmenný prostor SOAP) nebo Client.WellFormedness (chyby správné struktury dokumentu).
3.8.3 Chyby vzniklé exspirací zprávy Tento typ chyb bude ignorován.
3.8.4 Chyba neoprávněného přístupu Tyto chyby klient obdrží v případě, že zpráva je podepsána jiným certifikátem než je požadováno. V případě chyby klient obdrží zprávu ve formátu SOAP. Chybový kód je v tomto případě Client.AccesDeny
3.8.5 Chyby na úrovni ověření digitálního podpisu Pokud dojde k chybě při ověření digitálního podpisu, je zpráva odmítnuta jako celek. Chybová zpráva ve formátu SOAP je odeslána klientovi. Chybový kód je v tomto případě Client.Signature. ErrorText Podpis nebyl overen. Přiložený certifikát není v úložišti certifikátů. Požadovaný element není podepsán. Požadovaný element pro test na podpis nebyl nalezen. Příchozí dokument neobsahuje element SignedInfo.
3.8.6 Chyby na úrovni validace pomocí XML Schema Při výskytu chyby na úrovni validace pomocí XML Schema je zpráva odmítnuta jako celek. Je odeslána chybová zpráva ve formátu SOAP; chybový kód je v tomto případě Client.Validity.Schema. ErrorText Dokument není validní.
3.8.7 Chyby na úrovni validace XSLT šablonou Při výskytu chyby na úrovni validace pomocí XSLT šablony je zpráva odmítnuta jako celek. Je odeslána chybová zpráva ve formátu SOAP; chybový kód je v tomto případě Client.Validity.XSLT.
3.8.8 Chyby na aplikační úrovni Tyto chyby se týkají např. selhání aplikační databáze CEDR III. Chybová zpráva ve formátu SOAP je odeslána zpět klientovi. Obecný chybový kód je v tomto případě Client.Validity.Application. Tento chybový kód bude extendován podle zásad, uvedených v [3], kap. 5.10.1.
Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 Copyright © ASD Software, s.r.o., 2002-2007
10
4. Popis předávaných dat 4.1 Ustanovení pro definici platnosti elementů Zkratka I P N
Význam Nebere se v úvahu (ignore) Povinné Nepovinné
Označení povinnosti předávání jednotlivých elementů a v nich předávaných dat je uvedeno v následující tabulce. První znak v použité zkratce udává povinnost elementu, druhý udává platnost dat nebo-li hodnotu elementu. Zkratka Význam PP Povinný Element Povinná Data NP Nepovinný Element Povinná Data NN
Nepovinný Element Nepovinná Data
NI
Nepovinný Element Ignorují se Data
Podrobný popis Element i data jsou povinná Element je volitelný ale pokud je uveden jsou povinná i data. Pokud je element uveden není nutné uvádět data. To je vhodné např. pro UPDATE kdy je zapotřebí hodnotu přepsat. Nejsou-li data u elementu uvedena je nutné nastavit atribut null na hodnotu true. Element je nepovinný, ale pokud bude uveden data budou ignorována. Např. při operaci DELETE je nutný pouze primární klíč a ostatní hodnoty jsou ignorovány.
4.2 Služba na vygenerování číselníků Tato část specifikuje požadavky kladené službou CEDR na osoby žádající o vygenerování číselníků.
4.2.1 Požadavek na vygenerování číselníků 4.2.1.1 Datové typy Pro požadavek na generování číselníků z IS CEDR III není definován žádný samostatný soubor s datovými typy. Všechny potřebné datové typy jsou definovány ve schématu s požadavkem na číselníky (viz. ciselníkyPozadavek.xsd) 4.2.1.2 Popis schémat Struktura a formát požadavku žádosti o číselníky na IS CEDR III je specifikována ve schématech ciselníkyPozadavek.xsd. 4.2.1.3 Zpráva s požadavkem na generování číselníků z IS CEDR III Zpráva s požadavkem na generování číselníky z IS CEDR III bude obsahovat následující : • Seznam požadovaných číselníků. Struktura požadavku obsahuje dodatečné informace v podobě atributů elementu. Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 Copyright © ASD Software, s.r.o., 2002-2007
11
Poř.č. 1 2 3
Jméno položky Datum vytvoření dávky Odkaz na XSLT validační šablonu Vazba - identifikátor požadavku souvisejících číselníků
Typ DateTime URL Boolean
Platnost PP NP NP
Poznámky 1 2 3
Datum a čas vytvoření dávky. Umístění dodatečné XSLT validační šablony. Používá se pro dávku dat s číselníky, jedná se o nepovinou položku. Nabývá hodnoty TRUE nebo FALSE. V případě TRUE se k požadovanému číselníku automaticky generují i případné související číselníky (např. k číselníku dotačních titulu se automaticky připojí i číselník ukazatelů SR). Hodnota FALSE znamená negenerovat související číselníky, nevyplněná hodnota má tejný účinek jako hodnota TRUE
4.2.1.4 Obsah Požadavku na generování číselníků Vlastní požadavek obsahuje pouze elementy JmenoCiselniku, kde hodnota musí odpovídat výčtovém typu ze schematu ciselníkyPozadavek.xsd a má následující obsah : Jméno číselníku Ukazatele Kapitoly Banky PravniFormy Paragrafy Polozky Staty DotacniTituly FinancniZdroje Agentury Poskytovatele CleneniFinancnichProstredku MerneJednotky GrantovaSchemata OperacniProgramy
Pokud je v hlavičce dokumentu nastaven atribut “vazby” na hodnotu false jsou generovány pouze požadované číselníky bez vazeb na číselníky nadřízené. V ostatních případech se generují i případné číselníky navazující. 4.2.1.5 Validace K validaci požadavku na vygenerování číselníků z IS CEDR III je použito schema ciselníkyPozadavek.xsd. 4.2.1.5.1 Kontroly XSLT Dodatečné kontroly pomocí XSLT xsltValidationCiselnikyPozadavek.xsl.
šablony
v rámci
žádosti
o
číselníky
jsou
definovány
4.2.1.5.2 Kontroly aplikační Aplikační kontroly v rámci požadavku na generování číselníků nejsou definovány.
Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 Copyright © ASD Software, s.r.o., 2002-2007
12
4.2.2 Odpověď na požadavek o vygenerování číselníků 4.2.2.1 Datové typy Pro přenos číselníků z IS CEDR III jsou definovány zvláštní datové typy z toho důvodu, že modul číselníku může být použit i u jiných typů rozhraní. Dané datové typy jsou specifikovány v souboru ciselnikyDataTypes.xml viz. příloha 4.2.2.2 Popis schémat Rozhraní pro předávání číselníků z IS CEDR III na resort je definováno pomocí schématu ciselníky.xsd odpovídající jednotlivým níže uvedeným datovým tabulkám. Každé tabulce ve schématu odpovídá určitá datová struktura ve formátu XML. Podrobnější popis je uveden níže samostatně pro každou samostatnou oblast dat. Všechny tabulky jsou vloženy do dávky, která je identifikována atributy dle kapitoly 4.2.2.3. Při kontrole na schéma jsou také kontrolovány datové typy a elementy, které tvoří primární klíč v dané tabulce, tzn. že tyto klíčové položky v jedné dávce dat nemohou být shodné. Pokud by byly, nastane chyba schématu. 4.2.2.3 Zpráva s číselníky z IS CEDR III Zpráva s číselníky z IS CEDR III bude obsahovat následující dávku dat: • dávka dat s číselníky Struktura dávky obsahuje dodatečné informace v podobě atributů elementu. Poř.č. 1 2 3
Jméno položky Datum vytvoření dávky Odkaz na XSLT validační šablonu Identifikátor požadavku souvisejících číselníků
Typ DateTime URL Boolean
Platnost PP NP NP
Poznámky 1 2 3
Datum a čas vytvoření dávky. Umístění dodatečné XSLT validační šablony. Používá se pro dávku dat s číselníky, jedná se o nepovinou položku. Nabývá hodnoty TRUE nebo FALSE. V případě TRUE se k požadovanému číselníku automaticky generují i případné související číselníky (např. k číselníku dotačních titulu se automaticky připojí i číselník ukazatelů SR, …). Hodnota FALSE znamená negenerovat související číselníky, nevyplněná hodnota má tejný účinek jako hodnota TRUE +/
+/ souvisejících číselníků Žádaný číselník Dotační tituly
Ukazatele SR
Související číselník Ukazatele SR Položky RS Paragrafy RS Kapitoly SR Kapitoly SR
4.2.2.4 Dávka dat s číselníky Ministerstvo financí ČR připravuje a udržuje aktualizované stavy číselníků používaných v evidenčním systému IS CEDRIII platné pro příslušný rok. Pro předávání dat ve formě XML je na MF ČR zprovozněna Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 Copyright © ASD Software, s.r.o., 2002-2007
13
služba, která se automaticky strará o vyřízení požadavků žadatelů o data s číselníky. Číselníky se předávají dle uvedených pravidel a v uvedeném rozsahu a struktuře v tzv. dávce dat s číselníky - viz níže na základě požadavku uživatele, který se předává e-mailem formou XML. Uživatel si zvolí rok, za který chce data předat, jaká data (tedy které číselníky) a e-mailovou adresu, na kterou se mají data odeslat. Služba požadavek ověří a v případě kladného ověření vygeneruje dávku dat s číselníky a odešle na požadovanou adresu. Dávka obsahuje vždy celý právě platný obsah dat číselníku. V této části jsou uváděny číselníky, jejichž využití se na straně resortu předpokládá pro správnou součinnost s IS CEDR III. • Číselník právní formy • Číselník kapitol SR */ • Číselník specifických ukazatelů SR */ • Číselník paragrafů rozpočtové skladby */ • Číselník položek rozpočtové skladby */ • Číselník dotačních titulů */ o Vazba dotační titul - položka RS o Vazba dotační titul - paragraf RS • Číselník zemí • Číselník bank • Číselník zdrojů finačních prostředků • Číselník agentur • Číselník poskytovatlů • Číselník členění finančních prostředků • Číselník měrných jednotek */ - U číselníků, které jsou vydávany pro každý kalendářní rok (např. číselník kapitol, ukazatelů) je nastavován atribut udávající hodnotu roku za které jsou data požadována (může být žádáno i více let). Číselníky, u nichž je platnost v intervalech platnosti od-do (nevydávají se tedy daždý kalendářní rok) atribut neobsahují. U každého záznamu s daty je nastavován atribut status, který udává režim operace s daty. Tj. vkládání Insert, modifikace - Update a mazání - Delete. V této verzi atribut Status nabývá vždy jen hodnoty Insert. Od verze 3.07 jsou číselníky územní identifikace (ÚIR - MMR) nahrazeny číselníky ÚIR - ADR, celostátním standardem pro územní identifikaci. Číselníky slouží ke kontrole správného vyplnění adresy příjemce dotace, konkrétně položek část obce, městská část a případně PSČ. Číselník okresů (správně NUTS4) pomáhá při určení obce, protože název obce je jedinečný jen v rámci okresu. Číselník krajů (NUTS3) se používá při agregaci dat pro statistické výstupy. Číselníky rovněž obsahují informaci o převodu jednotlivých položek (okresů, obcí a městských částí) na kódy NUTS, vyžadované pro vytváření statistik dle ČSÚ. Garanty číselníků ÚIR - ADR je MPSV a jejich struktura odpovídá Standardu ISVS k prostorové identifikaci, verze 4.2 vydané ÚVIS.Vzhledem k tomu, že obsah číselníků a změnové soubory těchto číselníku jsou veřejně přístupné (www.mpsv.cz) nebude IS CEDR III zasílat tyto číselníky územní identifikace v dávce dat s číselníky. Na vyžádání bude umožněno zaslat e-mailem požadované změnové soubory. Podrobnější popis datového slovníku z MPSV je v příloze č. 2 Popis dat ÚIR - ADR Dávka dat s číselníky může obsahovat následující části: • Právní forma - ve struktuře popsané v kapitole 4.2.2.4.1 • Kapitoly SR - ve struktuře popsané v kapitole 4.2.2.4.2 • Specifické ukazatele SR - ve struktuře popsané v kapitole 4.2.2.4.3 • Paragrafy RS- ve struktuře popsané v kapitole 4.2.2.4.4 • Položky RS - ve struktuře popsané v kapitole 4.2.2.4.5 • Dotační tituly - ve struktuře popsané v kapitole 4.2.2.4.6 Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 Copyright © ASD Software, s.r.o., 2002-2007
14
• • • • • • • • •
Země - ve struktuře popsané v kapitole 4.2.2.4.7 Banky - ve struktuře popsané v kapitole 4.2.2.4.8 Zdroj finančních prostředků - ve struktuře popsané v kapitole 4.2.2.4.9 Agentury - ve struktuře popsané v kapitole 4.2.2.4.10 Poskytovatele – ve struktuře popsané v kapitole 4.2.2.4.11 Členění finančních prostředků – ve struktuře popsané v kapitole 4.2.2.4.12 Číselník měrných jednotek – ve struktuře popsané v kapitole 4.2.2.4.13 Číselník granotvých schémat – ve struktuře popsané v kapitole 4.2.2.4.14 Číselník operačních programů – ve struktuře popsané v kapitole 14.2.2.4.15
4.2.2.4.1 Struktura číselníku právních forem Číselník formy příjemce dotace slouží ke správnému vyplnění datové položky Právní forma příjemce dotace Struktura věty předávaného datového souboru je uvedena v následující tabulce: Č 1 2 3 4 5 6
PK
P
P
Jméno položky Kód formy příjemce dotace Typ formy Zkrácený název formy příjemce dotace Úplný název formy příjemce dotace Platnost od Platnost do
Typ N N AN AN D D
Délka 3 1 3 30 10 10
Typ XML
Plat PP PP PP PP PP NP
Popis jednotlivých řádků: 1 2
Kód formy příjemce dotace. Typ formy pro účely určení povinných položek při pořizování dat (tato položka není předávána z ČSÚ, a slouží pro bližší specifikaci povinných položek v údajích o subjektech): Rozlišujeme čtyři typy formy: 1 - Fyzická osoba nepodnikající, identifikuje se rodným číslem. 2 - Fyzická osoba podnikající, identifikuje se rodným číslem a IČO. 3 - Právnická osoba, identifikuje se IČO. 4 - Zahraniční subjekt. 3 Zkrácený název formy příjemce dotace 4 Úplný název formy příjemce dotace 5 Platnost od – datum od kdy položka platí 6 Platnost do – datum do kdy položka platí, není-li uvedena záznam platí od doby Platnost od dále. Pozn. Pro stejnou hodnotu položky Kód formy příjemce se nesmí překrývat intervaly položek Platnost od a
Platnost do. 4.2.2.4.2 Struktura číselníku kapitol SR Číselník kapitol státního rozpočtu na sledovaný rok slouží k vytvoření správných jmen předávaných dávek dat a ke kontrole správného vyplnění datové položky Kapitola SR. Struktura věty předávaného datového souboru je uvedena v následující tabulce: Č 1 2
PK
P
Jméno položky Kód kapitoly SR Název kapitoly
Typ N AN
Délka 3 80
Typ XML
Plat PP PP
Popis jednotlivých řádků:
Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 Copyright © ASD Software, s.r.o., 2002-2007
15
1 2
Kód kapitoly státního rozpočtu. Název kapitoly státního rozpočtu.
4.2.2.4.3 Struktura číselníku ukazatelů SR Číselník ukazatelů SR slouží ke správnému vytvoření podkladů pro tvorbu číselníku dotačních titulů (vazba dotační titul-ukazatel SR). Struktura věty předávaného datového souboru je uvedena v následující tabulce: Č 1 2 3 4
PK
P P
Jméno položky Kód kapitoly SR Kód ukazatele SR Název ukazatele SR Kód nadřazeného ukazatele SR
Typ N AN AN AN
Délka 3 4 80 4
Typ XML
Plat PP PP PP NP
Popis jednotlivých řádků: 1 2 3 4
Kód kapitoly státního rozpočtu. Kód ukazatele státního rozpočtu Název ukazatele státního rozpočtu Kód nadřazeného ukazatele SR – informuje o tom, že se jedná o bližší specifikaci ukazatele s tímto nadřazeným kódem (jedná se o kód, který je vnitřně využívaný IS CEDR III a IS CEDR-resorty)
4.2.2.4.4 Struktura číselníku paragrafů rozpočtové skladby Číselník paragrafů rozpočtové skladby na sledovaný rok slouží ke kontrole správného vyplnění datové položky Kód paragrafu RS návratné dotace a Kód paragrafu RS nenávratné dotace. Struktura věty předávaného datového souboru je uvedena v následující tabulce: Č 1 2
PK
P
Jméno položky Kód paragrafu RS Název paragrafu RS
Typ N AN
Délka 4 50
Typ XML
Plat PP PP
Popis jednotlivých řádků: 1 2
Kód paragrafu rozpočtové skladby podle funkčního třídění. Název paragrafu rozpočtové skladby podle funkčního třídění.
4.2.2.4.5 Struktura číselníku položek rozpočtové skladby Číselník položek rozpočtové skladby na sledovaný rok slouží ke kontrole správného vyplnění datových položek Kód položky RS návratné dotace a Kód položky RS nenávratné dotace. Struktura věty předávaného datového souboru je uvedena v následující tabulce: Č 1 2
PK
P
Jméno položky Kód položky RS Název položky RS
Typ N AN
Délka 4 50
Typ XML
Plat PP PP
Popis jednotlivých řádků: Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 Copyright © ASD Software, s.r.o., 2002-2007
16
1 2
Kód položky rozpočtové skladby podle druhového třídění. Název položky rozpočtové skladby podle druhového třídění.
4.2.2.4.6 Struktura číselníku dotačních titulů Číselník dotačních titulů na sledovaný rok slouží ke kontrole správného vyplnění datové položky Kód dotačního titulu a jako podklad pro tvorbu dávek dat s předpisy pro poskytování dotací. Číselník dotačních titulů na sledovaný rok bude vždy připravován na MF ČR ve spolupráci s jednotlivými kapitolami SR na základě předaných dávek dat s podklady. S číselníkem dotačních titulů se předávají vždy také datové soubory obsahující vazby mezi dotačním titulem a položkou či paragrafem rozpočtové skladby. Struktura věty předávaného datového souboru je uvedena v následující tabulce: Č 1 2 3 4 5 6 7
PK
P
Jméno položky Kód dotačního titulu Vlastní kód dotačního titulu resortu Název dotačního titulu Zkrácený název dotačního titulu Kód ukazatele SR Platnost od Platnost do
Typ N AN AN AN AN D D
Délka 10 30 160 50 4 10 10
Typ XML
Plat PP NP PP PP PP PP NP
Popis jednotlivých řádků: 1 2
3 4 5 6 7
Kód dotačního titulu. Vlastní kód dotačního titulu resortu - kód dotačního titulu dosud používaný na resortu. Slouží k svázání nově přiděleného kódu dotačního titulu s kódem dotačního titulu používaném na resortu. Jedná se o kód, který je předáván s podklady pro tvorbu číselníku dotačních titulů, nebo může být případně generován na MF a v tomto případě začíná vlastní kód dotačního titulu resortu vždy řetězcem „cedr3“. Od roku 2000 je povinný. Název dotačního titulu. Zkrácený název dotačního titulu. Kód ukazatele státního rozpočtu Datum počátku platnosti Datum ukončení platnosti
Pozn. Hodnota roku položek Platnost od a Platnost do musí odpovídat hodnotě atributu Platnost. (U položky Platnost do platí jen v případě, že je hodnota vyplněná). 4.2.2.4.6.1 Struktura s vazbou dotační titul - položka RS Vazba mezi dotačním titulem a položkou rozpočtové skladby. Jeden dotační titul může být poskytován podle několika různých položek RS a naopak. Tento číselník je vždy předáván s číselníkem dotačních titulů. Struktura věty předávaného datového souboru je uvedena v následující tabulce: Č 1 2
PK
P P
Jméno položky Kód dotačního titulu Kód položky RS
Typ N N
Délka 10 4
Typ XML Plat PP PP
Popis jednotlivých řádků: 1
Kód dotačního titulu
Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 Copyright © ASD Software, s.r.o., 2002-2007
17
2
Kód položky rozpočtové skladby podle druhového třídění.
4.2.2.4.6.2 Struktura s vazbou dotační titul - paragraf RS Vazba mezi dotačním titulem a paragrafem rozpočtové skladby. Jeden dotační titul může být poskytován podle několika různých paragrafů RS a naopak. Tento číselník je vždy předáván s číselníkem dotačních titulů. Struktura věty předávaného datového souboru je uvedena v následující tabulce: Č 1 2
PK
P P
Jméno položky Kód dotačního titulu Kód paragrafu RS
Typ N N
Délka 10 4
Typ XML Plat PP PP
Popis jednotlivých řádků: 1 2
Kód dotačního titulu. Kód paragrafu rozpočtové skladby podle funkčního třídění.
4.2.2.4.7 Struktura číselníku zemí Číselník slouží ke správnému vyplnění datové položky Kód státu příjemce dotace a Kód státu pro adresu příjemce dotace. Je přebírán od ČSÚ. Struktura věty předávaného datového souboru číselníku států je uvedena v následující tabulce: Č 1 2 3 4 5 6 7 8 9
PK
P P
Jméno položky Třímístný alfabetický kód Platnost od Platnost do Dvoumístný alfabetický kód Třímístný numerický kód Plný název v češtině Zkrácený název v češtině Plný název v angličtině Zkrácený název v angličtině
Typ AN D D AN N AN AN AN AN
Délka 3 8 8 2 3 80 50 80 50
Des
Plat PP P NP PP PP PP PP NP NP
Popis jednotlivých řádků: 1 2 3 4 5 6 7 8 9
Třípísmenná zkratka státu, tato hodnota se předává v datovém souboru s příjemci dotace Datum od kdy platí uvedený záznam. Spodní hranice platnosti záznamu je nastavena na 01.01.1993 Datum do kdy platí uvedený záznam. Dvou písmenná zkratka státu. Třímístný numerický kód státu. Název státu český. Název státu český zkrácený. Název státu anglický Název státu anglický zkrácený
Pozn. Pro stejnou hodnotu položky Třímístný alfabetický kód se nesmí překrývat intervaly položek Platnost od a Platnost do.
4.2.2.4.8 Struktura číselníku bank
Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 Copyright © ASD Software, s.r.o., 2002-2007
18
Číselník bank zajišťuje předávání jednoznačných informací týkající se odkazu na daný finanční ústav a zároveň slouží ke kontrole správného vyplnění datové položky Kód banky. Struktura věty předávaného datového souboru je uvedena v následující tabulce: Č
PK
1P 2 3P 4 5
Jméno položky Kód banky KodBankaSWIFT Platnost od Platnost do Název banky
Typ N AN D D AN
Délka 4 8 8 8 80
Des
Plat PP NP PP NP PP
Popis jednotlivých řádků: 1. 2. 3. 4. 5.
Kód banky, obsahuje případné vedoucí nuly. Kód banky pro mezinárodní platební styk - tzv. SWIFT kód. nebo BIC Datum počátku platnosti záznamu Datum ukončení platnosti záznamu Název banky.
Pozn. Pro stejnou hodnotu položky Kód banky se nesmí překrývat intervaly položek Platnost od a Platnost do. 4.2.2.4.9 Struktura číselníku zdrojů finančních prostředků. Číselník zdrojů finančních prostředků vymezuje zdroj finančních prostředků na poskytnutí dotace nebo návratné finanční výpomoci. Struktura věty předávaného datového souboru je uvedena v následující tabulce: Č 1. 2. 3. 4. 5.
PK P
Jméno položky Kód zdroje finančních prostředků
Název zdroje finančních prostředků Platnost od Platnost do Kód nadřízeného zdroje finančních prostředků
Typ AN AN D D AN
Délka 20 80 8 8 20
Des
Plat PP PP PP NP NP
Popis jednotlivých řádků: 1. 2. 3. 4. 5.
Kód zdroje finančních prostředků – jednoznačný identifikátor. Název zdroje finančních prostředků – slovní popis. Datum začátku platnosti daného záznamu. Datum ukončení platnosti daného záznamu. Kód nadřízeného zdroje finančních prostředků – je vyplněn jen v případě existence nadřízeného záznamu.
4.2.2.4.10 Struktura číselníku agentur Číselník agentur slouží k identifikaci jednotlivých agentur zasílajících data do IS CEDR III. Struktura věty předávaného datového souboru je uvedena v následující tabulce: Č 1. 2. 3.
PK P P
Jméno položky Kód agentury Číslo agentury Kód nadřízené agentury
Typ AN N AN
Délka 38 2 38
Des
Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 Copyright © ASD Software, s.r.o., 2002-2007
Plat PP PP NP
19
4. 5. 6.
Název agentury Platnost od Platnost do
AN D D
50 8 8
PP PP NP
Popis jednotlivých řádků: 1. 2. 3. 4. 5. 6.
Kód agentury – jednoznačný identifikátor. Číslo agentury – rozlišuje dílčí zasilatele dat Kód nadřízené agentury – vytváří stromovou strukturu agentur. Název agentury. Datum začátku platnosti daného záznamu. Datum ukončení platnosti daného záznamu.
4.2.2.4.11 Struktura číselníku poskytovatelů Poskytovatelem se rozumí subjekt který poskytuje dotaci nebo návratnou finanční výpomoc ze státního rozpočtu. Poskytovatelem může být ústřední orgán státní zprávy, úřad práce. Akademie věd ČR, Grantová agentura ČR nebo organizační složka státu, kterou určí zvláštní zákon. Poskytovatel rozhoduje o přidělení dotace nebo návratné finanční výpomoci na základě žádosti příjemce.: Č 1. 2. 3. 4. 5.
PK P
Jméno položky Kód poskytovatele Kód nadřízeného poskytovatele Název poskytovatele Platnost od Platnost do
Typ N N AN D D
Délka 3 3 255 8 8
Des
Plat PP NP PP PP NP
Popis jednotlivých řádků: 1. 2. 3. 4. 5.
Kód poskytovatele – jednoznačný identifikátor. Kód nadřízeného poskytovatele – jednoznačný identifikátor. Název poskytovatele. Datum začátku platnosti daného záznamu. Datum ukončení platnosti daného záznamu.
4.2.2.4.12 Struktura číselníku členění finančních prostředků Číselník členění finančních prostředků je zaveden podle §44 ods. 2 písm. zákona č.218/2000 Sb. : Č 1. 2. 3. 4.
PK P
Jméno položky Kód členění finančních prostředků Název členění finančních prostředků Platnost od Platnost do
Typ N AN D D
Délka 3 255 8 8
Des
Plat PP PP PP NP
Popis jednotlivých řádků: 1. 2. 3. 4.
Kód členění finančních prostředků – jednoznačný číselný identifikátor. Název členění finančních prostředků Datum začátku platnosti daného záznamu. Datum ukončení platnosti daného záznamu.
Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 Copyright © ASD Software, s.r.o., 2002-2007
20
4.2.2.4.13 Struktura číselníku vybraných měrných jednotek Číselník vybraných měrných jednotek je převzat z Českého statistického úřadu viz. [7] Č 1. 2. 3. 4. 5. 6. 7.
PK P
Jméno položky Kód měrné jednotky Alfabetický mezinárodní kód měrné jednoty Měrná jednotka název Měrná jednotka zkrácený název Značka měrné jednotky Platnost od Platnost do
Typ AN AN AN AN AN D D
Délka 5 3 512 128 128 8 8
Des
Plat PP NP PP NP NP PP NP
Popis jednotlivých řádků: 1. 2. 3. 4. 5. 6. 7.
Jednoznačný kód měrné jednotky. Mezinárodní kód měrné jednotky Název měrné jednotky. Zkrácený název měrné jednotky Značka měrné jednotky Datum počátku platnosti daného záznamu. Datum ukončení platnosti daného záznamu.
4.2.2.4.14 Struktura číselníku grantových schémat Číselník grantových schémat je převzat z MSSF. Popis struktury číselníku je uveden v dokumentaci k rozhraní pro předávání dat do IS CEDR III [8] 4.2.2.4.15 Struktura číselníku operačních programů Číselník operačních programů je převzat z MSSF. Popis struktury číselníku je uveden v dokumentaci k rozhraní pro předávání dat do IS CEDR III [8]
Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 Copyright © ASD Software, s.r.o., 2002-2007
21
5. Podrobný popis životního cyklu zprávy Oprava chyb N Generování zprávy klientem
Start
Validace zprávy klientem
Zpráva je validní A
N
XSLT Validace zprávy klientem
Zpráva je validní A
Zpráva
Příjem zprávy
Odeslání zprávy na službu
Parsování zpravy
Zprávu lze parsovat
A
Ověření jména služby v hlavičce
N Shoduje se
A
Ověření ID zpravy
N Bylo jiz nekdy přijato
A
Ověření podepsaných elementu
N Jsou všechny podelsány
A
Ověření požadavku na zaslaní odpovědi
N N
Generování chyby
Zpráva s chybou klientovi
Je požadována odpověď
Zpráva o doručení klientovi
Konec
Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 Copyright © ASD Software, s.r.o., 2002-2007
A
Odeslání zprávy o doručení klientovi
Uložení zprávy do fronty
1
22
1
Načtení zprávy z fronty
Ověření podpisu
Je podpis ověřen
A
Validace XML dokumentu N Dokument je validni
A
XSLT Validace
N
Dokument je validni
A
Generování odpovědi
N
Vygenerováno bez chyb
N Generování chyby
A
N Dokument je vaidní
Validace odpovědi
A
N Dokument je validní
XSLT Validace odpovědi
A Odeslání odpovědi
Zpráva s chybou klientovi
Zpráva o zpracování klientovi
Konec
Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 Copyright © ASD Software, s.r.o., 2002-2007
23
Obr. 2 Životní cyklus zprávy Životní cyklus zprávy na straně služby, vyjádřený na předchozím obrázku, lze podrobně rozepsat v následujících bodech: 1. Odesílající strana (klient) vygeneruje zprávu, s požadavkem na vygenerování číselníku(ů). 2. Klient ověří vygenerovanou zprávu na schéma příslušné verze. • Pokud zpráva není validní nebude zprávu odesílat na službu. 3. Klient ověří vygenerovanou zprávu XSLT validační šablonou příslušné verze. • Pokud zpráva není validní nebude zprávu odesílat na službu. 4. Klient prostřednictvím emailového klienta zašle zprávu na příslušnou adresu služby. • Pokud dojde k selhání přenosu na úrovni protokolu SMTP, služba negeneruje chybovou zprávu SOAP (nemusí k ní zpráva dorazit). Indikace chybového stavu bude provedena standardními postupy pro daný protokol. V tomto případě musí detekovat problém odesílatel a odeslat případně zprávu znovu. 5. Služba obdržela zprávu a je možno odeslat chybovou zprávu klientovi. • Selže-li převzetí zprávy službou z důvodů chyby přijímající aplikace, je klientovi zaslána chybová zpráva SOAP s chybovým kódem Server.Program. Příchozí zpráva je odmítnuta jako celek. • Selže-li převzetí zprávy službou z důvodů chyby ve zprávě, je klientovi zaslána chybová zpráva SOAP s chybovým kódem Client.General. Příchozí zpráva je odmítnuta jako celek. 6. Obálka SOAP je načtena parserem. • Selže-li parsování zprávy službou z důvodů chyby přijímající aplikace, je klientovi zaslána chybová zpráva SOAP s chybovým kódem Server.Program. Příchozí zpráva je odmítnuta jako celek. • Selže-li parsování zprávy službou z důvodů porušení pravidla správného formátování, je klientovi zaslána chybová zpráva SOAP s chybovým kódem Client.WellFormedness. Příchozí zpráva je odmítnuta jako celek. • Selže-li parsování zprávy službou z důvodů porušení pravidla verze jmenného prostoru SOAP, je klientovi zaslána chybová zpráva SOAP s chybovým kódem VersionMismatch. Příchozí zpráva je odmítnuta jako celek 7. Služba ověří zda zpráva v SOAP hlavičce obsahuje korektní adresu služby v elementu <endpoints>
•
Pokud adresa neodpovídá adrese služby je klientovi zaslána chybová zpráva SOAP s chybovým kódem Client.General. 8. Jsou ověřeny identifikační údaje v obálce SOAP. • Selže-li tento krok z důvodů chyby přijímající aplikace, je klientovi zaslána chybová zpráva SOAP s chybovým kódem Server.Program. Příchozí zpráva je odmítnuta jako celek. • Jedná-li se o opakovanou zprávu (se stejným UUID) a tato zpráva již byla úspěšně přijata, je zpráva odmítnuta. Klientovi zaslána chybová zpráva SOAP s chybovým kódem Client.RepeatedMessage
9. Služba ověří elementy zprávy, které mají být podepsány • Pokud zpráva nemá podepsány požadované elementy je klientovi zaslána chybová zpráva SOAP s chybovým kódem Client.Signature. 10. Služba ověří zda zpráva obsahuje požadavek o zaslání zprávy o zpracování • Pokud zpráva neobsahuje požadovaný element je klientovi zaslána chybová zpráva SOAP s chybovým kódem Client.General. 11. Zpráva je přijata • Pokud je zpráva službou přijata klient je o tom vyrozuměn zprávou o přijetí, pokud ji požaduje. Přijatá zpráva je zařazena do fronty požadavků a čeká na okamžik zpracování. Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 Copyright © ASD Software, s.r.o., 2002-2007
24
12. Je ověřen elektronický podpis zprávy • Selže-li ověření elektronického podpisu z důvodu chyby aplikace, je klientovi zaslána chybová zpráva SOAP s chybovým kódem Server.Program. Příchozí zpráva je odmítnuta jako celek. • Selže-li ověření podpisu zprávy, je klientovi zaslána chybová zpráva SOAP s chybovým kódem Client.Signature. Příchozí zpráva je odmítnuta jako celek. 13. Zpráva je validována proti schématu a také (je-li deklarována) validační XSLT šabloně. • Selže-li tento krok z důvodů chyby přijímající aplikace, je klientovi zaslána chybová zpráva SOAP s chybovým kódem Server.Program. Příchozí zpráva je odmítnuta jako celek. • Selže-li tento krok z důvodů chyby validace schématem, je klientovi zaslána chybová zpráva SOAP s chybovým kódem Client.Validity.Schema. Příchozí zpráva je odmítnuta jako celek. • Selže-li tento krok z důvodů chyby validace XSLT šablonou, je klientovi zaslána chybová zpráva SOAP s chybovým kódem Client.Validity.XSLT. V tomto případě je chybový výpis XSLT šablony vložen do elementu elementu . Příchozí zpráva je odmítnuta jako celek. 14. Zpráva je zpracována IS CEDR a je vygenerována odpověď. • Selže-li tento krok z důvodů chyby přijímající aplikace, je klientovi zaslána chybová zpráva SOAP s chybovým kódem Server.Program. Příchozí zpráva je odmítnuta jako celek. 15. Klientovi je zaslána standardní zpráva SOAP s odpovědí.
Chování odesílající strany v případě komplikací s přenosem se nemusí řídit žádnou předem stanovenou logikou.
Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 Copyright © ASD Software, s.r.o., 2002-2007
25
6. Seznam změn v dokumentu od poslední verze 21.12.2004 1. Přídán číselník psokytovatelů viz. 4.2.2.4.11 2. Přídán číselník členění finančních prostředků viz. 4.2.2.4.12 3. Uprevena schemata dotazu viz. 7.3.1.1 4. Uprevena schemata odpovědi viz. 7.3.2.1 14.02.2005 1. 2. 3. 4.
Úprava kapitoly 4.2.2.4 Rozšíření číselníku bank o mezinárodní kód SWIFT viz. 4.2.2.4.8 Přidán číselník vybranch měrných jednotek viz. 4.2.2.4.13 Úprava příkladů viz. 7.5.1 a 7.5.2
22.02.2005 1. Upraven popis číselníku zdrojů finančních prostředků viz. 4.2.2.4.9 2. Upraven popis číselníku poskytovatelů viz. 4.2.2.4.11 3. Upraven rozsah položek číselníků dle schématu XSD. 14.02.2006 1. Změněny názvy číselníku viz. 4.2.1.4 20.09.2007 1. Přidána kapitola s popisem číselníku operačních programů 4.2.2.4.15 2. Přidána kapitola s popisem číselníku grantových schémat 4.2.2.4.14 3. Přidán odkaz na dokumentaci s popisem rozhraní pro příjem dat do IS CEDR III.
Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 Copyright © ASD Software, s.r.o., 2002-2007
26
7. Přílohy 7.1 Adresa služby 7.1.1 Verze 1.1.2 [email protected]
7.2 WSDL Pro službu na generování číselníků je popis služby WSDL
7.2.1 Verze 1.1.2 7.2.1.1 Umístění http://cedr.mfcr.cz/smtp/ciselniky_xml/v_1.1.2/WSDL
7.3 Schémata 7.3.1 ciselnikyPozadavek.xsd Pro zprávu s požadavkem na vygenerování číselníků jsou schemata 7.3.1.1 Verze 1.1.2 7.3.1.1.1 Umístění Pro zprávu s požadavkem na vygenerování číselníků jsou schemata umístěna na : http://cedr.mfcr.cz/ciselniky_xml/schemas/ciselnikyPozadavek/v_1.1.1/ciselnikyPozadavek.xsd
7.3.2 ciselniky.xsd Pro zprávu s odpovědí na generování číselníků jsou schemata 7.3.2.1 Verze 1.1.0 7.3.2.1.1 Umístění http://cedr.mfcr.cz/ciselniky_xml/schemas/ciselniky/v_1.1.0/ciselniky.xsd
7.3.3 ciselnikyDataTypes.xsd Pro schemata datových typů pro odpověď na vygenerování číselníků jsou schemata 7.3.3.1 Verze 1.0.1 7.3.3.1.1 Umístění http://cedr.mfcr.cz/ciselniky_xml/schemas/ciselniky/v_1.0.1/ciselniky.xsd
7.3.4 error_list.xsd Pro chybové hlášky jsou schemata
Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 Copyright © ASD Software, s.r.o., 2002-2007
27
7.3.4.1 Verze 1.0.0 7.3.4.1.1 Umístění http://cedr.mfcr.cz/ErrorList_xml/schemas/ErrorList/v_1.0.0/error_list.xsd
7.4 XSLT validační šablony 7.4.1 xsltValidationCiselnikyPozadavek.xsl XSLT validační šablona pro kontrolu požadavku na vygenerování číselníků 7.4.1.1 Verze 1.1.1 7.4.1.1.1 Umístění http://cedr.mfcr.cz/ciselniky_xml/xslt/v_1.1.1/xsltValidation.xsl
7.5 Příklady zpráv 7.5.1 Požadavek na vygenerování číselníků <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"> <SOAP-ENV:Header> <eps:endpoints xmlns:eps="http://schemas.biztalk.org/btf-2-0/endpoints" SOAP-ENV:mustUnderstand="1" Id="idEndpoints"> <eps:to> <eps:address>ciselnikyPozadavek112@wnts_test.asd-software.cz <eps:from> <eps:address>[email protected] <prop:properties SOAP-ENV:mustUnderstand="1" xmlns:prop="http://schemas.biztalk.org/btf-2-0/properties" Id="idProperties"> <prop:identity>6f82580a-fd41-47c8-a6e8-0ede5eff903d <prop:sentAt>2004-05-17T14:41:36 <prop:expiresAt>2004-05-19T14:41:36 <prop:topic/> <srv:services xmlns:srv="http://schemas.biztalk.org/btf-2-0/services" SOAP-ENV:mustUnderstand="1" Id="idServices"> <srv:commitmentReceiptRequest> <srv:sendTo> <srv:address>[email protected] <srv:sendBy>2004-05-19T14:41:36 <srv:deliveryReceiptRequest> <srv:sendTo> <srv:address>[email protected] <srv:sendBy>2004-05-19T14:41:36
Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 Copyright © ASD Software, s.r.o., 2002-2007
28
SFS6ghSYFJkCMdXZNLJulLKBUqk= 0oQIl/rdi/lZ9SsxaJaKUEFIpYA= F6A/9wxnI8N8nHuMwWnN2tE/9L8= SNnb28DHMMPssreX3l3Hj7QA0vQ= EXOppk3N36GuNX5PeNXI+sDCN1rUzTQ7nvIkcKxEU4xMj6Iwbh53wt6NI/SmQP2FaLJIkn10FupC/Cq Y5N3Q== C=CZ, L=SU, O=ASD Software, CN=ASDCertif5 7356f7710000000000e7 C=CZ, L=SU, O=ASD Software, CN=asd512 MIIC/jCCAqigAwIBAgIKc1b3cQAAAAAA5zANBgkqhkiG9w0BAQUFADBGMQswCQYDVQQGEwJDWj ELUEBxMCU1UxFTATBgNVBAoTDEFTRCBTb2Z0d2FyZTETMBEGA1UEAxMKQVNEQ2VydGlmNTAwMzA4MTIxMTU0MThaFw0wN DA4MTIxMjA0MThaMEIxCzAJBgNVBAYTAkNaMQswCQYDVQQHEwUEChMMQVNEIFNvZnR3YXJlMQ8wDQYDVQQDEwZhc2Q1MT IwXDANBgkqhkiG9w0BAM9HXXlt9oBJg5s0LARiAZRIXsqwGdLeLWZ9/FCJAMybaq/aKu/14KDTqfQGgl7zD03Vx5vPN+43UA5CQIDAQ ABo4IBejCCAXYwDgYDVR0PAQH/BAQDAgTwMBMGA1UdJQQGA1UdDgQWBBSrBjT1fUzNd6RNTZMHedKnCE76qzB9BgNVHSME djB0gBWX5g3KNnuyqfJJKNcqFKpEgwRjELMAkGA1UEBhMCQ1oxCzAJBgNVBAcTAlNVMRUwEQgU29mdHdhcmUxEzARBgNVBAM TCkFTRENlcnRpZjWCEG0ux9C6mI6vTw0iqgvlfBEAwPjA8oDqgOIY2aHR0cDovL3dudHM1LmFzZC1zb2Z0d2FyZS5jei9DZXJ0RW5xsL 0FTRENlcnRpZjUuY3JsMGgGCCsGAQUFBwEBBFwwWjBYBggrBgEFBQcwAoZMaHR0cDovL3LmFzZC1zb2Z0d2FyZS5jei9DZXJ0R W5yb2xsL3dudHM1LmFzZC1zb2Z0d2FyZS5jel9BU RDZXJ0aWY1LmNydDANBgkqhkiG9w0BAQUFAANBABuELGkUVGnUSw8XQhwWVLaRypyJ8pjDTXmIC9E+zRSXxZNMHKhWg7IqnJ xWkGQSib12GqfpOPhe/Mo= <SOAP-ENV:Body Id="idBody"> <JmenoCiselniku>Agentury
Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 Copyright © ASD Software, s.r.o., 2002-2007
29
7.5.2 Odpověď na požadavek <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"> <SOAP-ENV:Header> <eps:endpoints xmlns:eps="http://schemas.biztalk.org/btf-2-0/endpoints" SOAPENV:mustUnderstand="1" Id="idEndpoints"> <eps:to> <eps:address>[email protected] <eps:from> <eps:address>ciselnikyPozadavek111@wnts_test.asd-software.cz <prop:properties SOAP-ENV:mustUnderstand="1" xmlns:prop="http://schemas.biztalk.org/btf-20/properties" Id="idProperties"> <prop:identity>0ca66ef3-7b7f-44e9-aec8-33ce145f161c <prop:sentAt>2004-05-11T11:15:37 <prop:expiresAt>2004-05-11T12:15:37 <prop:topic>http://serveruvis/ciselniky_xml/schemas/ciselniky/v_1.1.1/ciselniky.xsd 1c2bec99-02f1-465b-8ef3-c039f799f19f 2004-05-11T11:15:37 positive /K9Phdwe5wmVzVTNoB2MKJMURpw= ezdsbDSFYZ6wY+FwGbcXmy4H58k= 7o72wkbYl6uuAeMirm84Lpikp/M= Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 Copyright © ASD Software, s.r.o., 2002-2007
30
cosXy6VzZsdo83fd4uIdwzkuQDs= janQaeyIutM4kSqnbBGoikSWHpBKh1o5zQxWEEKRcTT/prTNUk2CuxctLdtcsEQRY3Xy RhTzRTcO+zCWcZJkWz8MlCCCa0DTZgEPiGALDgGSpk9cTpbSNMRk5tiEV+rhMHpBwLDT5Kw= C=CZ, L=SU, O=ASD Software, CN=ASDCertif5 405032b00000000000a3 [email protected], C=CZ, S=Czech Republic, L=SU, O=ASD Software, CN=ServerCedrImportTest MIIFGTCCBMOgAwIBAgIKQFAysAAAAAAAozANBgkqhkiG9w0BAQUFADBGMQswCQ YDVQQGEwJDWjELUEBxMCU1UxFTATBgNVBAoTDEFTRCBTb2Z0d2FyZTETMBEGA1UEAxMKQVNEQ2VydGlmNT AwNDA1MDUxMjI4MTFaFw0wNTA1MDUxMjM4MTFaMIGeMTMwMQYJKoZIhvcNAQkBFiRTZXJ2ZXwb3J0VGVzdEBh c2Qtc29mdHdhcmUuY3oxCzAJBgNVBAYTAkNaMRcwFQYDVQQIEw5DeYmxpYzELMAkGA1UEBxMCU1UxFTATBgN VBAoTDEFTRCBTb2Z0d2FyZTEdMBsGA1UEVydmVyQ2VkckltcG9ydFRlc3QwgZ8wDQYJKoZIhvcNAQEBBQADgY0A MIGJAoGBALDebPEyJu+bk7gsu+XzxGwvYfrm6ZoNzXiSJqIYSsHhT5ys4aE2kTJCXOpwu9OvkgqWYN9fN1ihVzrq9q6x NSxdanJQBonY2KaNgR+zabOV361d6yE52D4lEh9zny4k6SqBdTv+wJl6qm HGYJurbUV+tCTTAgMBAAGjggL0MIIC8DAOBgNVHQ8BAf8EBAMCBPAwEwYDVR0lBAwwCgYIKwYBOBBYEFPDM5o a3BvKZ0bjjM8tsXRaCt0oVMH0GA1UdIwR2MHSAFEdByAOOZH1e7Kp8kko1yoUqkSDBGMQswCQYDVQQGEwJDWjE LMAkGA1UEBxMCU1UxFTATBgNVBAoTDEZ0d2FyZTETMBEGA1UEAxMKQVNEQ2VydGlmNYIQbS7H0LqYjq9PDSK qC+VaoDCCAQkGA UdHwSCAQAwgf0wgbyggbmggbaGgbNsZGFwOi8vL0NOPUFTRENlcnRpZjUsQ049d250czUsQ049RQLENOPVB1Ymx pYyUyMEtleSUyMFNlcnZpY2VzLENOPVNlcnZpY2VzLENOPUNvbmZpZ3VyYXRsREM9YXNkLXNvZnR3YXJlLERDPW N6P2NlcnRpZmljYXRlUmV2b2NhdGlvbkxpc3Q/YmFzZT vYmplY3RjbGFzcz1jUkxEaXN0cmlidXRpb25Qb2ludDA8oDqgOIY2aHR0cDovL3dudHM1LmFzZzb2Z0d2FyZS5jei9DZXJ 0RW5yb2xsL0FTRENlcnRpZjUuY3JsMIIBHAYIKwYBBQUHAQEEggEOvL0NOPUFTRENlcnRpZjUsQ049QUlBLENOPV B1YmxVzLENOPVNlcnZpY2VzLENOPUNvbmZpZ3VyYXRpb24sREM9YXNkLXYXJlLERDPWN6P2NBQ2VydGlmaWNh dGU/YmFzZT9vYmplY3RjbGFzcz1jZXJ0aWZpY2F0auQXV0aG9yaXR5MFgGCCsGAQUFBzAChkxodHRwOi8vd250czU uYXNkLXNvZnR3YXJlLmN6L0NlczUuYXNkLXNvZnR3YXJlLmN6X0FTRENlcnRpZjUuY3J0MA0GCSqGSIb3DQEEAeXF faEE5JpXdaZQLhnteWrne26FierprcJDiio/3AAm7VthGNHZbg3s6pvsbAzpEMB+SYhasZcrew== <SOAP-ENV:Body Id="idBody"> 304 0 Úřad vlády 2003-01-01 2050-01-01 304 1 Úřad vlády 2003-01-01 2050-01-01
Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 Copyright © ASD Software, s.r.o., 2002-2007
31
306 0 Ministerstvo zahraničních věci 1998-01-01 2050-01-01 .................... 772 1 772 Zlínský kraj 2003-01-01 2050-01-01
Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 Copyright © ASD Software, s.r.o., 2002-2007
32
8. Reference [1] BizTalk BizTalkTM Framework 2.0. Document and Message Specification. Microsoft Corporation, 12-December-2000. [2] SOAP Simple Object Access Protocol (SOAP) 1.1 W3C Note 08 May 2000. Viz http://www.w3.org/TR/SOAP [3] Standardy komunikace na bázi XML XML - Standardy komunikace na bázi XML - Použití ve finančních a podpůrných informačních systémech. Verze 1.05 ASD Software, s.r.o. 2002. Viz. http://www.mfcr.cz/download/xml/xmlkomunikace.zip [4] XML Extensible Markup Language (XML) 1.0 (Second Edition). W3C Recommendation 6 October 2000. Viz http://www.w3.org/TR/REC-xml [5] XML Schema XML Schema Part 0: Primer. W3C Recommendation, 2 May 2001 Viz http://www.w3.org/TR/xmlschema-0/ [6] XSLT XSL Transformations (XSLT) Version 1.1. W3C Working Draft 24 August 2001 Viz http://www.w3.org/TR/xslt11 [7] ČVMJ Číselník vybraných měrných jednotek z roku 2002 Č.j. 48/2002 Viz. http://www.czso.cz/csu/edicniplan.nsf/publ/0009-02[8] Rozhraní pro předávání dat do IS CEDR III Rozhraní pro předávání dat do IS CEDR III verze 2.17 Viz. http://cedr.mfcr.cz/smtp/Cedr3PrenosDat_204/documentation/Sluzba_CEDR_prijem_217.pdf
Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 Copyright © ASD Software, s.r.o., 2002-2007
33
9. Seznam použitých zkratek a pojmů ČSÚ FO FOP IČ IS CEDR IS CEDR III MF OB OS OST PO PRO RČ RO RS SR SW dávka dat s příjemci dávka dat s předpisy dávka dat s číselníky dávka dat s výsledky Agent (agent) Odpověď Odesílatel zprávy sender) Příjemce zprávy recipient) Požadavek Služba (service) SMTP služba Zpráva (message)
Český statistický úřad Fyzická osoba Fyzická osoba podnikající Identifikační číslo Informační systém CEDR Centrální registr dotací Ministerstvo financí Obec Občanské sdružení Ostatní Příspěvková organizace Právnická osoba Rodné číslo Rozpočtová organizace Rozpočtová skladba Státní rozpočet Software Dávka dat s údaji o příjemcích dotací Dávka dat s předpisy pro poskytování dotací Dávka dat s číselníky používanými při pořizování dat pro registr Dávka dat s výsledky zpracování přijatých dat od resortů Program, vykonávající úkol na základě požadavku jiné entity (osoby, procesu). Zpráva, která je službou zaslána agentu odesílateli a je vygenerována na základě požadavku od agenta odesílatele (message agent, vytvářející a odesílající zprávu (message agent, stanovený odesílatelem zprávy jako adresát (consumer) zprávy Zpráva, která je zaslána agentem odesílatele na službu. sada úkolů, tvořící z pohledu poskytovatele služby i žadatele služby jeden celek. jde o službu používajíci SMTP přenosový protokol. základní jednotka výměny dat mezi agenty (odesílatelem zprávy a příjemcem zprávy).
Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR, verze 1.07 ze dne 20.9.2007 Copyright © ASD Software, s.r.o., 2002-2007
34