Specifikace služby IS CEDR pro příjem dat obecným XML rozhraním IS CEDR III

GFŘ - informační systém CEDR III Vypracováno pro oddělení 171 PRO INTERNÍ POTŘEBU Specifikace služby IS CEDR pro příjem dat obecným XML rozhraním IS CEDR III vypracovala společnost ASD Software, s.r.o. dokument ze dne 20.09.2012, verze 2.33

GFŘ - informační systém CEDR III, vypracováno pro oddělení 171 Specifikace služby IS CEDR pro příjem dat obecným XML rozhraním IS CEDR III Počet stran v dokumentu celkem : 91 Rozdělovník: Číslo Počet výtisků Předáno Převzal 1. 1 x GFŘ, vedoucí oddělení 171 Ing. Marie Frantová 2. 1 x GFŘ, vedoucí referátu 1711 Mgr. Vladimír Dlouhý, DiS. 2

Obsah GFŘ - informační systém CEDR III, vypracováno pro oddělení 171 1 Úvod 6 2 Use-case studie rozhraní 7 2.1 Předávání dat z resortních IS do IS CEDR III 7 2.1.1 Obecný popis operace služby IS CEDR III 7 3 Technické řešení 9 3.1 Přenosový formát dat 9 3.2 Validace a popis XML dokumentů 9 3.2.1 XML Schema 9 3.2.2 Doplňková validace XSLT šablonami 9 3.2.3 Jmenné prostory 9 3.2.4 Komprimace zpráv 9 3.3 Transportní protokoly 10 3.3.1 Základní transportní protokol 10 3.3.2 SOAP protokol 10 3.3.3 Použití protokolu BizTalk 10 3.4 Model přenosu zpráv 11 3.4.1 Předávání dat do IS CEDR III 11 3.5 Řešení bezpečnosti 11 3.5.1 Implementované bezpečnostní funkce 11 3.5.1.1 Integrita přenosu dat 11 3.5.1.2 Důvěrnost přenosu dat 12 3.5.1.3 Nepopíratelnost odesílatele 12 3.5.1.4 Nepopíratelnost doručení 12 3.5.2 Předávání dat do IS CEDR III 13 3.6 Přístupová oprávnění ke službě 13 3.7 Logování přístupu ke službě 13 3.8 Dostupnost služby 13 3.9 Zpracování chyb 13 3.9.1 Chyby na úrovni přenosového protokolu SMTP-MIME 13 3.9.2 Chyby při načtení zprávy SOAP 14 3.9.3 Chyby vzniklé exspirací zprávy 14 3.9.4 Chyby na úrovni ověření digitálního podpisu nebo šifrování 14 3.9.5 Chyby na úrovni validace pomocí XML Schema 14 3.9.6 Chyby na úrovni validace XSLT šablonou 14 3.9.7 Chyby na úrovni aplikační 14 3.10 Doporučený postup zpracování zpráv od služby 15 4 Specifikace předávaných dat 17 4.1 Ustanovení pro definici platnosti elementů 17 4.2 Postup při zpracování jednotlivých záznamů 17 4.2.1 Vkládání záznamů 17 4.2.2 Modifikace záznamů 18 4.2.2.1 Modifikace podle objektid a PlatnostZaznamu 18 4.2.2.2 Modifikace podle objektid 18 3

GFŘ - informační systém CEDR III, vypracováno pro oddělení 171 4.2.3 Mazání záznamů 18 4.2.4 Zobrazení předaných dat do IS CEDR III 18 4.2.5 Vazba N:N u Příjemce dotace-projekt, Příjemce dotace-žádost, Příjemce dotace-žádost-projekt 19 4.3 Atributy elementů 19 4.4 Elementy u kterých bude uveden atribut objektid 19 4.5 Předávání dat do IS CEDRIII 21 4.5.1 Grafické znázornění závislosti objektů ve schématu 22 4.5.1.1 Příjemce pomoci 22 4.5.1.2 Operační programy 23 4.5.1.3 Grantová schémata 23 4.5.2 Datové typy 24 4.5.2.1 simpletype 24 4.5.2.2 Restrikce a extenze na základní datové typy 26 4.5.2.3 PrijemcePomociBaseStructure 28 4.5.2.4 OsobaIdentitaBaseStructure 28 4.5.2.5 ObchodniJmenoBaseStructure 30 4.5.2.6 ZádostBaseStructure 30 4.5.2.7 ProjektBaseStructure 32 4.5.2.8 ProjektDoplnkovyStavBaseStructure 33 4.5.2.9 OperacniProgramKodyStructure 33 4.5.2.10 ProjektEtapaBaseStructure 34 4.5.2.11 FinancniCastkaZdrojBaseStructure 34 4.5.2.12 SplatkaPlanovanaBaseStructure 35 4.5.2.13 KalendarSplatekBaseStructure 35 4.5.2.14 FinancniCastkaObdobiBaseStructure 36 4.5.2.15 FinancniCastkaUvolnenaBaseStructure 36 4.5.2.16 FinancniCastkaCerpanaBaseStructure 37 4.5.2.17 FinancniCastkaVracenaBaseStructure 37 4.5.2.18 TransferPolozkaBaseStructure 38 4.5.2.19 DokumentBaseStructure 38 4.5.2.20 DokumentDataBaseStructure 38 4.5.2.21 ProjektDokumentBaseStructure 39 4.5.2.22 BankaUcetBaseStructure 39 4.5.2.23 PlatbaBaseStructure 39 4.5.2.24 PlatbaSignedBaseStructure 40 4.5.2.25 UzemniRealizaceBaseStructure 40 4.5.2.26 AdresaVystupniKodyBaseStructure 42 4.5.2.27 ObjektAdresaBaseStructure 43 4.5.2.28 ObjektAdresaTextBaseStructure 43 4.5.2.29 ObchodniKontaktBaseStructure 44 4.5.2.30 UzivatelBaseStructure 44 4.5.2.31 KontaktniUdajBaseStructure 45 4.5.2.32 PodkladDotaceTitulBaseStructure 45 4.5.2.33 PredpisDotaceTitulBaseStructure 45 4.5.2.34 RozpoctovaSkladbaParagrafStructure 46 4.5.2.35 RozpoctovaSkladbaPolozkaStructure 46 4.5.2.36 UkazatelBaseStructure 46 4.5.2.37 UkazatelNazvyBaseStructure 47 4.5.2.38 OperacniProgramBaseStructure 47 4.5.2.39 OperacniProgramPrioritaBaseStructure 48 4.5.2.40 OperacniProgramPodprogramBaseStructure 48 4.5.2.41 OperacniProgramOpatreniBaseStructure 49 4.5.2.42 OperacniProgramPodopatreniBaseStructure 49 4.5.2.43 ProjektExterniSystemIdentifikatorBaseStructure 50 4.5.2.44 GrantoveSchemaKodyStructure 50 4.5.2.45 GrantoveSchemaBaseStructure 50 4.5.2.46 ProgramPodporaBaseStructure 51 4

GFŘ - informační systém CEDR III, vypracováno pro oddělení 171 4.5.2.47 CinnostTypBaseStructure 51 4.5.2.48 DavkaCedrStructure 51 4.5.2.49 DavkaCedrOdpovedStructure 52 4.5.2.49.1 simpletype 53 4.5.2.49.2 errorlocalityitemtype 53 4.5.2.49.3 errorlocalitytype 53 4.5.2.49.4 error 53 4.5.2.49.5 reason 54 4.5.3 Popis schémat 54 5 Podrobný popis životního cyklu zpráv 56 5.1 Předávání dat do IS CEDR III 56 6 Seznam změn v dokumentu od poslední verze 60 7 Seznam obrázků 61 8 Přílohy 62 8.1 XSLT validační šablona 62 8.1.1 verze 2.0.4 62 8.2 XSD schema s datovými typy 62 8.2.1 verze 2.0.4.00 62 8.3 XSD schema pro příjem dat 62 8.3.1 verze 2.0.4 62 8.4 XSD schema pro odpověď na příjem dat 62 8.4.1 verze 2.0.4 62 8.5 XSD schema s chybovými kódy 62 8.5.1 verze 1.0.1 62 8.6 Adresa služby pro import dat do IS CEDR III 62 8.6.1 verze 2.0.8 62 8.7 Jednotlivé položky vyhlášky 63 8.7.1 Položky přílohy č.1 63 8.7.2 Položky přílohy č. 2 66 8.8 Příklad dávky dat pro import do CEDR III 70 8.9 Příklad odpovědi na příjem dat do CEDR III 86 9 V dalších verzích bude řešeno 89 10 Reference 90 11 Seznam použitých zkratek a pojmů 91 5

1 Úvod GFŘ - informační systém CEDR III, vypracováno pro oddělení 171 Tento materiál obsahuje základní požadavky na rozhraní mezi informačním systémem IS CEDR III na straně GFŘ a informačními systémy či jinak realizovanými evidencemi finančních prostředků na straně jednotlivých zdrojů těchto dat (např. resortů) vstupujících do IS CEDR III po technické stránce ve formě XML. Finančními prostředky jsou míněny např. účelové dotace, prostředky ISPROFIN, SAPARD a podobně. 6

2 Use-case studie rozhraní GFŘ - informační systém CEDR III, vypracováno pro oddělení 171 Procesy při předávání dat mezi informačními systémy evidencí finanční prostředky a IS CEDR III lze charakterizovat schématy, uvedenými v této kapitole. 2.1 Předávání dat z resortních IS do IS CEDR III 2.1.1 Obecný popis operace služby IS CEDR III Obrázek č. 1 popisuje proces předávání zpráv s dávkami dat z IS resortů do IS CEDR III. Schéma je platné pro operaci, zmíněné v kap. 2.1.1.: Odeslání dat resorty Zpráva s daty Příjem zprávy CEDR III Zpracování dat CEDR III Seznam osob resorty Zpráva o přijetí dat Příjemci dat resorty Zpráva o zpracování s daty obrázek 1 Předávání dávek dat z IS resortů do IS CEDR III Uvedené schéma na obrázek 1 lze slovně popsat následujícím způsobem: 1. Na straně IS resortu (klientská strana) je vygenerována zpráva, obsahující data pro přenos na IS CEDR III. Spuštění přenosu se děje ad hoc uživatelem; to znamená, že neexistuje pevný časový plán přenosů. 2. Zpráva je opatřena všemi náležitostmi dle této specifikace a je odeslána pomocí elektronické pošty na adresu služby aplikace IS CEDR III dle kap. 8.6. 3. Aplikace CEDR III přijme zprávu a zařadí ji do fronty příchozích zpráv. Na adresy v distribučním seznamu pro vyrozumění o doručení zprávy, uvedeném ve zprávě s dávkou dat, rozešle informativní zprávy o přijetí dávky dat ke zpracování. 4. Aplikace CEDR III zpracuje zprávu. 5. Aplikace CEDR III vygeneruje zprávu, obsahující informace o provedení importu jednotlivých záznamů. 7

GFŘ - informační systém CEDR III, vypracováno pro oddělení 171 Schéma na obr.1 je zjednodušené a obecné, nepředpokládá např. komplikace během přenosu. Stanovení pravidel pro řešení případných problémů během přenosu uvádí kapitola 5 tohoto dokumentu. 8

GFŘ - informační systém CEDR III, vypracováno pro oddělení 171 3 Technické řešení 3.1 Přenosový formát dat Jako formát pro přenos dat bude použit standard XML 1.0, Second Edition [5]. 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 [6]. 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. Nevalidní dokument je důvodem k odmítnutí zprávy. 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 s výjimkou zpráv SOAP Fault, kde lokalizace schématu není požadována. Všechna schémata budou obsahovat dokumentaci schématu. Formát RDF dokumentace bude odpovídat [4], kap. 10.4.6. Všechna schémata budou verzována v souladu se zásadami, uvedenými v [8], kap. 5.1.5.2. Validace zprávy s daty pro import do IS CEDR III bude prováděna dle schématu viz. kap. 8.3 Validace zprávy s odpovědí na import do IS CEDR III bude prováděna dle schématu viz. kap. 8.4 3.2.2 Doplňková validace XSLT šablonami Procesní validace XML dokumentu (viz [4], kap. 10.4.3.2.), bude prováděna pomocí XSLT validačních šablon v souladu s metodou, uvedenou v [4], kap. 10.4.3.2. Informace o lokalizaci validační šablony bude nesena (opět dle [4], kap. 10.4.3.2.) v atributu validation_xslt kořenového elementu příslušného dokumentu.výstupní XML dokument XSLT šablony bude ve formátu odpovídajícím schématu s odpovědí na zpracování Validační XSLT šablony a bude odpovídat standardu XSLT v. 1.1. [7]. Dokument nevalidní na doplňkovou XSLT validaci je důvodem k odmítnutí zprávy. Doplňková validace bude prováděna podle XSLT šablony dle kap. 8.1 3.2.3 Jmenné prostory Všechny jmenné prostory schémat, popisujících přenášené XML dokumenty popisovaného rozhraní, budou ve formátu URN. 3.2.4 Komprimace zpráv Vzhledem k předpokládanému rozsahu zpráv bude nutno zprávy před odesláním komprimovat. Komprimováno bude celé tělo zprávy SOAP (element <Body>). Pro komprimaci bude využito standardu XML Encryption, kdy otevřený text elementu <Body> bude zkomprimován pomocí 9

GFŘ - informační systém CEDR III, vypracováno pro oddělení 171 algoritmu popsaného na adrese http://www.gzip.org/zlib/rfc-zlib.html. Postup při komprimaci a dekomprimaci částí zprávy bude vyhovovat popisu dle [4], kap. 10.6.7. 3.3 Transportní protokoly 3.3.1 Základní transportní protokol Základním transportním protokolem pro popisované rozhraní bude protokol SMTP-MIME. 3.3.2 SOAP protokol Nad protokolem SMTP-MIME bude použit rozšiřující XML protokol SOAP ve verzi 1.1 [3]. Protokol SOAP bude mít implementováno jak záhlaví SOAP (element <Header>), tak tělo SOAP (element <Body>). V záhlaví SOAP budou v BizTalk elementech neseny administrativní informace (bližší viz 3.3.3). Záhlaví SOAP bude dále vždy obsahovat element elektronického podpisu ve formátu XML Signature a v indikovaných případech, pro dokumenty se šifrovaným obsahem, i element XML Encryption nesoucí informace o klíčích. Detailní popis řešení bezpečnosti transportu obsahuje kapitola 3.6. Při výskytu chyby přijetí nebo zpracování zprávy bude generován element <Fault> těla SOAP. Element <Fault> bude obsahovat: Povinný kód chyby v elementu <Faultcode> s typem v souladu s deklarací seznamu chybových kódů ve schématu dle kap. 8.5 Povinný textový popis chyby v elementu <Faultstring> Volitelný element <Detail>. 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 dle kap. 8.5 Všechny elementy SOAP budou mít nastaven atribut MustUnderstand na hodnotu 1. 3.3.3 Použití protokolu BizTalk Pro administraci zpráv bude použito elementů specifikace BizTalk [1]. Pro účely tohoto rozhraní bude sada elementů BizTalk využívána rozdílně pro zprávy přenášející data a pro zprávy o doručení. Zprávy přenášející data budou povinně obsahovat elementy: <endpoints> s indikací odesílatele a adresáta zprávy pro zprávy s daty do IS CEDR <services> s dceřinným elementem <deliveryreceiptrequest> a <comitmentreceiptrequest> se specifikací požadavku na vyrozumění o přijetí zprávy a na vyrozumění o zpracavání pro zprávy o doručení zprávy s daty na službu <deliveryreceipt>. pro zprávy s odpovědí na zpracování <comitmentreceipt>. <properties> popisující vlastní přenášený dokument v souladu s pravidly dle [4], kap. 10.5.4.1. Zprávy o doručení/zpracování budou pak vyhovovat popisu dle [4], kap. 10.5.4.2. Všechny elementy BizTalk, které mohou nést atribut MustUnderstand, musejí mít pro účely tohoto rozhraní tento atribut přítomen a nastaven na hodnotu 1. 10

3.4 Model přenosu zpráv GFŘ - informační systém CEDR III, vypracováno pro oddělení 171 3.4.1 Předávání dat do IS CEDR III Jako model pro přenos zpráv do IS CEDR III bude použit model message passing dle [4], kap. 10.8.2. Rozlišovat se budou dva typy zpráv: zprávy nesoucí data informativní zprávy (vyrozumění o přijetí zprávy, oznámení o výsledku zpracování zprávy) V modelu komunikace pro přenos zpráv z resortních IS do IS CEDR III budou informativní zprávy povinné. Požadavek na vyrozumění o přijetí zprávy musí být ve zprávě nesoucí data přítomen (viz 3.3.3). Identifikace typu informativní zprávy bude nesena v elementu <properties/topic>. Doporučujeme použití řetězce DeliveryReceipt pro identifikaci zprávy o doručení a řetězce CommitmentReceipt pro identifikaci zprávy o zpracování. Výsledek zpracování zprávy bude nesen ve zprávě o zpracování v elementu <commitmentreceipt>/<decision>. Pokud se bude jednat o částečné zpracování zprávy bude element obsahovat řetězec positive. V případě zamítnutí celé dávky bude obsahovat řetězec negative. Potvrzení o přijetí informativních zpráv (vyrozumění o přijetí zprávy) zpět na službu nebude vyžadováno a očekáváno. 3.5 Řešení bezpečnosti 3.5.1 Implementované bezpečnostní funkce Rozhraní ve verzi, odpovídající tomuto dokumentu, bude mít implementovány následující bezpečnostní funkce (viz též [4], kap. 5.6.1) Integrita přenosu dat Důvěrnost přenosu dat Nepopíratelnost odesílatele Nepopíratelnost doručení 3.5.1.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 pro zprávy nesoucí data (viz [4], kap. 5.6.1.3) bude v tomto rozhraní použito XML Encryption. Jedná se o zašifrování obsahu dokumentu, nebo jen části, pomocí symetrického klíče, který se bude přenášet v rámci XML dokumentu. Tento symetrický klíč bude z důvodu bezpečnosti pro každou novou zprávu vygenerován znovu a kód klíče bude zašifrován asymetrickým klíčem. Podrobnější informace ohledně XML Encryption jsou k dispozici v [4] v kapitole 5.6.2. a 10.6.7 Šifrovat se bude jen obsah elementu <Body> obálky SOAP. Pozn. Distribuce veřejné části serverového certifikátu služby IS CEDR III proběhne v rámci instalace verze na resortech případně bude předán správcem registru dotací IS CEDR III. Bude vygenerován serverový certifikát služby IS CEDR III, který bude instalován na klientské stanice pro účely 11

GFŘ - informační systém CEDR III, vypracováno pro oddělení 171 zabezpečení symetrických šifrovacích klíčů. Na klientské straně budou dále vygenerovány certifikáty identity klientů a jejich veřejné části bude předána správci registru dotací IS CEDR III. Ke službě IS CEDR III pak budou mít přístup jen klienti, autentizovaní proti seznamu ověřených certifikátů identity. V dalších verzích se počítá s využitím ověřených certifikačních autorit a jejich služeb. Při šifrování bude uplatněn postup, kdy element <Body > bude nejprve zkomprimován (viz 3.2.4.) a teprve poté zašifrován. Integrita přenosu dat pro informativní zprávy (viz 3.4) bude zabezpečena pomocí XML Signature. Podepisovat se budou BizTalk elementy <endpoints>, <properties> a <services> a celý element <Body> zprávy SOAP. Jelikož ne všechny zprávy od služby mohou být zašifrovány (nepodařilo se rozparsovat příchozí zprávu a tím získat klíč pro šifrování) je nutné na straně klienta nejprve ověřit, zda zpráva je zašifrována a dále pokračovat ve zpracování. 3.5.1.2 Důvěrnost přenosu dat Důvěrností přenosu dat rozumíme zabezpečení dat proti odposlechu během transportu. Implementace XML Encryption podle 3.6.1 zajistí i důvěrnost přenosu dat pro zprávy nesoucí data. Zprávy informativní nemusejí mít implementovánu důvěrnost přenosu dat. 3.5.1.3 Nepopíratelnost odesílatele Nepopíratelnost odesílatele bude implementována v souladu s [4], kap. 5.6.1.8. Pro účely zajištění nepopíratelnosti odesílatele bude podepisován algoritmem XML Signature celý element <Body> zprávy SOAP a BizTalk elementy <endpoints>, <properties> a <services>. Pro podpis bude použit certifikát identity. Vzhledem k tomu, že v technologii tohoto rozhraní jsou kombinovány XML Signature a XML Encryption, je nutno stanovit jasný postup šifrování a podepisování. Vzhledem k jednoduchému toku zpráv na rozhraní bude zvolen následující model, kdy na klientské straně proběhnou kroky: Element <Body> obálky SOAP otevřeného dokumentu bude komprimován a poté zašifrován. V zašifrovaném dokumentu budou podepsány příslušné části (viz výše). Při příjmu dokumentu na straně služby bude postup opačný. Nejprve je nutno ověřit elektronický podpis standardním algoritmem. Poté se dešifruje zašifrovaný element <Body> obálky SOAP a výsledek se na závěr dekomprimuje. Jelikož ne všechny zprávy od služby mohou být podepsány (služba z nějakého důvodu nemá přístup k certifikátu identity) Je nutné před ověřováním podpisu zjistit zda zpráva je podepsána a nenese pouze informativní zprávu. 3.5.1.4 Nepopíratelnost doručení Nepopíratelnost doručení bude implementována opět v souladu s doporučeními dle [4], kap. 5.6.1.9. Podepisovat se budou BizTalk elementy <endpoints>, <properties> a <comitmentreceipt> a celý 12

GFŘ - informační systém CEDR III, vypracováno pro oddělení 171 element <Body> zprávy SOAP, ve kterém bude zopakován element <SignedInfo> obsahující kontrolní součty z příchozí zprávy. Pro podpis bude použit serverový certifikát služby IS CEDR III. 3.5.2 Předávání dat do IS CEDR III Všechny operace předávání dat do IS CEDR III (viz kap. 2.1.1) budou mít implementovány následující bezpečnostní funkce dle 3.5.1: Integrita přenosu dat Důvěrnost přenosu dat Nepopíratelnost odesílatele Nepopíratelnost doručení 3.6 Přístupová oprávnění ke službě Popisovaná služba je neveřejná a přístup ke službě je omezen pouze oprávněným uživatelům. Oprávnění uživatelé jsou registrováni v systému pro přístup ke službám CEDR III. Každému oprávněnému uživateli je správcem systému CEDR III vystaven certifikát, který je dále použit při zabezpečení zprávy dle kap. 3.5 Další podrobnější přístupová oprávnění na úrovni operací se záznamy nejsou službou řešena. 3.7 Logování přístupu ke službě V rámci přístupu ke službě se budou uchovávat následující informace: datum a čas přístupu klienta adresa odesílatele požadavku na službu výsledek zpracování požadavku datum a čas odeslání výsledku zpracování požadavku příchozí a odchozí zprávy Logování se provádí automaticky a logovací údaje jsou ukládány do databáze, příchozí a odchozí zprávy se ukládají do adresářové struktury na zabezpečeném serveru. K údajům v rámci logování mají přístup oprávnění uživatelé (správce úlohy). Doba uchovávání těchto informací není omezena. 3.8 Dostupnost služby Služba je přístupná 24 denně. 3.9 Zpracování chyb Zpracování chyb bude ošetřeno v souladu se zásadami uvedenými v [4], kap. 5.8.2. Seznam chybových kódů bude odpovídat schématu dle kap. 8.5. 3.9.1 Chyby na úrovni přenosového protokolu SMTP-MIME Chyby na úrovni přenosového protokolu SMTP-MIME 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. 13

GFŘ - informační systém CEDR III, vypracováno pro oddělení 171 V případě výskytu této chyby je nutné zprávu, která selhala při přenosu, odeslat opakovaně. Za zopakování přenosu je zodpovědný odesílatel zprávy. 3.9.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. Tyto zprávy již budou logovány. Nelze však provést parsing dokumentu, proto chybová zpráva ve formátu SOAP bude odeslána pouze na odesílající adresu, a na adresu správce služby. Chybový kód je v tomto případě VersionMismatch (chybný jmenný prostor SOAP) nebo Client.WellFormedness (chyby správné struktury dokumentu). Za zopakování přenosu je zodpovědný odesílatel zprávy. 3.9.3 Chyby vzniklé exspirací zprávy Tyto chyby jsou způsobeny vypršením lhůty v BizTalk elementu <expiresat>. Zpráva je odmítnuta jako celek, chybová zpráva ve formátu SOAP je odeslána na distribuční seznam příjemců zpráv o přijetí dokumentu a na adresu správce služby. Chybový kód je v tomto případě Server.Expiration. Za zopakování přenosu je zodpovědný odesílatel zprávy. 3.9.4 Chyby na úrovni ověření digitálního podpisu nebo šifrování Pokud dojde k chybě při ověření digitálního podpisu nebo při dešifrování dokumentu, je zpráva odmítnuta jako celek. Chybová zpráva ve formátu SOAP je odeslána na distribuční seznam příjemců zpráv o přijetí dokumentu a na adresu správce služby. Chybový kód je v tomto případě Client.Signature, resp. Client.Encryption. Za zopakování přenosu je zodpovědný odesílatel zprávy. 3.9.5 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. Chybová zpráva ve formátu SOAP je odeslána na distribuční seznam příjemců zpráv o přijetí dokumentu a na adresu správce služby. Chybový kód je v tomto případě Client.Validity.Schema. Za zopakování přenosu je zodpovědný odesílatel zprávy. 3.9.6 Chyby na úrovni validace XSLT šablonou Při výskytu chyby na úrovni validace pomocí XSLT šablony je zpráva odmítnuta jako celek. Chybová zpráva ve formátu SOAP je odeslána na distribuční seznam příjemců zpráv o přijetí dokumentu a na adresu správce služby. Chybový kód je v tomto případě Client.Validity.XSLT. Za zopakování přenosu je zodpovědný odesílatel zprávy. 3.9.7 Chyby na úrovni aplikační Tyto chyby se týkají např. narušení referenční integrity či primárních klíčů aplikační databáze. Při výskytu chyby na úrovni validace pomocí vnitřní logiky aplikace IS CEDR III budou odmítány jen jednotlivé přenášené záznamy. Za zopakování přenosu chybných záznamů je zodpovědný odesílatel zprávy. 14

3.10 Doporučený postup zpracování zpráv od služby Start Zpracování odpovědi ze služby CEDR III GFŘ - informační systém CEDR III, vypracováno pro oddělení 171 Přijetí zprávy Obsahuje zpráva element Signature? ANO Ověř podpis NE Nastala chyba při ověření podpisu? ANO NE NE Obsahuje zpráva element Encryption? ANO Dekryptuj zprávu Nastala chyba při ověření dekryprovaní? ANO NE Rozzipuj zprávu Nastala chyba při rozzipování? ANO NE Obsahuje zpráva element Properties? NE ANO Identifikátor zrávy na ktrou je odpovídáno je nesen v elementu CommitmentReceipt CommitmentReceipt Jakou hodnotu má element topic? DeliveryReceipt Obsahuje zpráva element CommitmentReceipt? NE ANO Identifikátor zrávy na kterou je odpovídáno je nesen v elementu DeliveryReceipt negative Jakou hodnotu má element decision? Obsahuje zpráva element DeliveryReceipt? NE Obsahuje zpráva element Body/Fault? NE positive ANO Pokud zpráva byla zamítnuta jako celek odesílatel bude další zprávu posílat se shodným číslem dávky. Vpripade chyby validace je zpráva zamítnuta jako celek a je priložen element detail s elementem Error_list s chybami validace. ANO Pokud byla zpráva částečně zpracována odesílatel bude další zprávu posílat s číslem dávky o jedno vyšší Zpráva byla zamítnuta jako celek Zpráva byla částečně zpracována Jedná se o zprávu o doručení Chybná zpráva Zpracování jednoduché chyby Konec obrázek 2. Postup zpracování zprávy ze služby 15

GFŘ - informační systém CEDR III, vypracováno pro oddělení 171 Na obrázku obrázek 2 je znázorněn doporučený postup při zpracování zpráv ze služby na straně klienta. Algoritmus popisuje jednotlivé po sobě jdoucí akce zpracování jak zpráv o doručení a o zpracování, tak zpráv chybových tak jak je doporučeno. 16

4 Specifikace předávaných dat GFŘ - informační systém CEDR III, vypracováno pro oddělení 171 4.1 Ustanovení pro definici platnosti elementů Při návrhu struktur jednotlivých elementů rozhraní je nutné specifikovat pro koncového uživatele povinnost jednotlivých elementů a v nich předávaných dat pro jednotlivé operace s daty (vkládání, modifikace a mazání záznamu) Zkratka Význam I Nebere se v úvahu (ignore) P Povinné N Nepovinné Označení povinnosti předávání jednotlivých elementů a v nich předávaných datech 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 Podrobný popis PP Povinný Element Povinná Data Element i data jsou povinná NP Nepovinný Element Povinná Data Element je volitelný ale pokud je uveden jsou povinná i data. NN Nepovinný Element Nepovinná 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 nil na hodnotu true. NI Nepovinný Element Ignorují se Data 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 Postup při zpracování jednotlivých záznamů Jednotlivé záznamy v jednotlivých datových objektech se zpracovávají sekvenčně za sebou tak, jak jsou uvedeny v XML dokumentu. Atribut ObjektId je jednoznačný identifikátor objektu v rámci zdroje dat, tedy pro hodnoty Id zdroje dat a Č. zdroje podle 4.3. 4.2.1 Vkládání záznamů Pro operaci vkládání záznamu bude atribut status daného záznamu nastaven na hodnotu insert a atribut objektid na jedinečnou hodnotu v rámci zdroje dat a daného vkládaného objektu. Dále budou vyplněny povinné elementy PlatnostZáznamu, DatumAktualizace a UzivatelKod. Pokud bude záznam s předaným objektid nalezen v DB, bude celý záznam s příjemcem dotace odmítnut, ikdyž chyba bude nalezena v zanořeném záznamu. 17

GFŘ - informační systém CEDR III, vypracováno pro oddělení 171 4.2.2 Modifikace záznamů Pro operaci modifikace záznamu bude atribut status příslušného záznamu nastaven na hodnotu update a dále budou zadány povinné elementy PlatnostZáznamu, DatumAktualizace a UzivatelKod. Pokud bude potřeba provést modifikaci záznamu ve vnořené větvi hierarchie dokumentu bez modifikace nadřízených záznamů, nadřízené záznamy budou mít nastaven atribut status na hodnotu nothing a atribut objectid na požadovanou hodnotu objektu. Modifikace se bude dále dělit na : modifikaci subjektů. Tj. záznamů ze struktur PrijemceDotace, PrijemceDotace/SidloAdresa a kontaktní adresy PrijemceDotace/Adresy. Tyto záznamy se budou modifikovat podle algoritmu viz kap. 4.2.2.1. modifikaci ostatních záznamů. Tyto záznamy se budou modifikovat podle algoritmu viz kap. 4.2.2.2 Pokusem o modifikaci záznamu s nepředaným objektid bude celý záznam o příjemci dotace zamítnut, ikdyž modifikovaný záznam bude zanořený záznam příjemce dotace 4.2.2.1 Modifikace podle objektid a PlatnostZaznamu Jako klíč k výběru dat bude použita kombinace hodnot elementů objektid a PlatnostZaznamu. 1. Provede se test zda existují záznamy s předaným objektid od daného zdroje jak v historické tak datové tabulce. 2. Záznamy s předaným objektid byly nalezeny, pokusíme se porovnat PlatnostZáznamu nalezeného a předaného záznamu 3. Záznam s danou hodnotou PlatnostZáznamu byl nalezen provedeme jeho modifikaci. 4. Záznam s danou hodnotou PlatnostZáznamu nebyl nalezen provedeme jeho vložení do DB a to tak aby v datové tabulce byl záznam s největší hodnotou PlatnostZáznamu. 4.2.2.2 Modifikace podle objektid Jako klíč je použita pouze hodnota atributu objektid. Modifikace se chová jako zásobník a v datové tabulce je uložena vždy naposledy modifikovaná hodnota bez ohledu na hodnotu elementu PlatnostZáznamu. Původní hodnota z datové tabulky ja zapsána do historické tabulky. 4.2.3 Mazání záznamů Pro operaci mazání záznamů v DB CEDR III je nutné u požadovaného záznamu nastavit atribut status na hodnotu delete a dále naplnit atribut objektid požadovanou hodnotou. Mazáním se rozumí smazání všech záznamů svázaných s daným objektem v hierarchii. (S mazáním příjemce dotace budou smazány veškeré záznamy sním svázané tj. projekty, částky, dokumenty atd.) Pokusem o mazání záznamu s nepředaným objektid bude celý záznam o příjemci dotace zamítnut, ikdyž mazaný záznam bude zanořeným záznam příjemce dotace 4.2.4 Zobrazení předaných dat do IS CEDR III Jelikož je kladen požadavek na zobrazování záznamů k subjektům za jednotlivá období a operací modifikace je vytvářena historie při zobrazování se bude postupovat následovně: 18

GFŘ - informační systém CEDR III, vypracováno pro oddělení 171 1. požadavkem na zobrazení dat k danému roku budou vybrány takové záznamy, které mají v daném roce největší PlatnostZáznamu a DatumAktualizace je největší v celé historii. 4.2.5 Vazba N:N u Příjemce dotace-projekt, Příjemce dotace-žádost, Příjemce dotace-žádost-projekt V těchto případech v IS CEDR III bude docházet k slučování Projektů a Žádostí na základě předaného objektid. Pokud se tedy více subjektů (příjemců dotace) podílí na jednom projektu je toto možné zaslat do systému operací insert projektu, žádosti s již vloženým objektid projektu, žádosti ale různým obejtkid subjektu (příjemce dotace). Modifikaci projekt,žádosti v tomto případě stačí poslat pouze k projektu, žádosti jednoho subjektu. Mazání projektu, žádosti je nutné provést tolikrát, kolik subjektů (příjemců dotace) se na daném projektu, žádosti účastní. 4.3 Atributy elementů Atributy elementů, které nejsou zmiňovány v tomto dokumentu, nejsou v XML dokumentu vyplňovány. Pokud by byly vyplněny, budou aplikací zpracovávající XML dokument ignorovány. 4.4 Elementy u kterých bude uveden atribut objektid DavkaCedr/crd:Uzivatele/crd:Uzivatel/ DavkaCedr/crd:Uzivatele/crd:Uzivatel/crd:KontaktniUdaje/crd:KontaktniUdaj/ DavkaCedr/crd:UkazateleCiselnik/crd:UkazatelCiselnik/ DavkaCedr/crd:DokumentyData/crd:DokumentData/ DavkaCedr/crd:OperacniProgramy/crd:OperacniProgram/ DavkaCedr/crd:OperacniProgramy/crd:OperacniProgram/crd:Ukazatele/crd:Ukazatel/ DavkaCedr/crd:OperacniProgramy/crd:OperacniProgram/crd:Podprogramy/crd:Podprogram/ DavkaCedr/crd:OperacniProgramy/crd:OperacniProgram/crd:Podprogramy/crd:Podprogram/crd:Ukazatele/crd:Ukazatel/ DavkaCedr/crd:OperacniProgramy/crd:OperacniProgram/crd:Podprogramy/crd:Podprogram/crd:Priority/crd:Priorita/ DavkaCedr/crd:OperacniProgramy/crd:OperacniProgram/crd:Podprogramy/crd:Podprogram/crd:Priority/crd:Priorita/crd:Ukazatele/crd:Ukaz atel/ DavkaCedr/crd:OperacniProgramy/crd:OperacniProgram/crd:Podprogramy/crd:Podprogram/crd:Priority/crd:Priorita/crd:OpatreniSeznam/cr d:opatreni/ DavkaCedr/crd:OperacniProgramy/crd:OperacniProgram/crd:Podprogramy/crd:Podprogram/crd:Priority/crd:Priorita/crd:OpatreniSeznam/cr d:opatreni/crd:ukazatele/crd:ukazatel/ DavkaCedr/crd:OperacniProgramy/crd:OperacniProgram/crd:Podprogramy/crd:Podprogram/crd:Priority/crd:Priorita/crd:OpatreniSeznam/cr d:opatreni/crd:podopatreniseznam/crd:podopatreni/ DavkaCedr/crd:OperacniProgramy/crd:OperacniProgram/crd:Podprogramy/crd:Podprogram/crd:Priority/crd:Priorita/crd:OpatreniSeznam/cr d:opatreni/crd:podopatreniseznam/crd:podopatreni/crd:ukazatele/crd:ukazatel/ DavkaCedr/crd:OperacniProgramy/crd:OperacniProgram/crd:Priority/crd:Priorita/ DavkaCedr/crd:OperacniProgramy/crd:OperacniProgram/crd:Priority/crd:Priorita/crd:Ukazatele/crd:Ukazatel/ DavkaCedr/crd:OperacniProgramy/crd:OperacniProgram/crd:Priority/crd:Priorita/crd:OpatreniSeznam/crd:Opatreni/ DavkaCedr/crd:OperacniProgramy/crd:OperacniProgram/crd:Priority/crd:Priorita/crd:OpatreniSeznam/crd:Opatreni/crd:Ukazatele/crd:Ukaz atel/ DavkaCedr/crd:OperacniProgramy/crd:OperacniProgram/crd:Priority/crd:Priorita/crd:OpatreniSeznam/crd:Opatreni/crd:PodopatreniSeznam /crd:podopatreni/ DavkaCedr/crd:OperacniProgramy/crd:OperacniProgram/crd:Priority/crd:Priorita/crd:OpatreniSeznam/crd:Opatreni/crd:PodopatreniSeznam /crd:podopatreni/crd:ukazatele/crd:ukazatel/ DavkaCedr/crd:PodkladyDotaceTitul/crd:PodkladDotaceTitul/ DavkaCedr/crd:PodkladyDotaceTitul/crd:PodkladDotaceTitul/crd:RozpoctovaSkladbaPolozky/crd:RozpoctovaSkladbaPolozka/ DavkaCedr/crd:PodkladyDotaceTitul/crd:PodkladDotaceTitul/crd:RozpoctovaSkladbaParagrafy/crd:RozpoctovaSkladbaParagraf/ DavkaCedr/crd:PredpisyDotaceTitul/crd:PredpisDotaceTitul/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:ObchodniJmena/crd:ObchodniJmeno/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:SidloAdresa/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:BankaUcty/crd:BankaUcet/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Zadosti/crd:Zadost/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Zadosti/crd:Zadost/crd:ProjektUcet/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Zadosti/crd:Zadost/crd:ProjektAdresa/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Zadosti/crd:Zadost/crd:Dokumenty/crd:Dokument/ 19

GFŘ - informační systém CEDR III, vypracováno pro oddělení 171 DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Zadosti/crd:Zadost/crd:FinancniCastky/crd:FinancniCastkyZdrojZadani/crd:Financ nicastkazdroj/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Zadosti/crd:Zadost/crd:FinancniCastky/crd:FinancniCastkyZdrojDokumentace/crd: FinancniCastkaZdroj/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Zadosti/crd:Zadost/crd:FinancniCastky/crd:FinancniCastkyZdrojProjekt/crd:Financ nicastkazdroj/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Zadosti/crd:Zadost/crd:Ukazatele/crd:UkazateleZadani/crd:Ukazatel/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Zadosti/crd:Zadost/crd:Ukazatele/crd:UkazateleDokumentace/crd:Ukazatel/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Zadosti/crd:Zadost/crd:Ukazatele/crd:UkazateleProjektu/crd:Ukazatel/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Zadosti/crd:Zadost/crd:UzemniRealizace/crd:Lokalita/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Zadosti/crd:Zadost/crd:Etapy/crd:Etapa/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Zadosti/crd:Zadost/crd:Etapy/crd:Etapa/crd:FinancniCastkyZdroj/crd:FinancniCast kazdroj/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Zadosti/crd:Zadost/crd:Etapy/crd:Etapa/crd:Dokumenty/crd:Dokument/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Zadosti/crd:Zadost/crd:Etapy/crd:Etapa/crd:Ukazatele/crd:Ukazatel/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Zadosti/crd:Zadost/crd:Etapy/crd:Etapa/crd:UzemniRealizace/crd:Lokalita/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Zadosti/crd:Zadost/crd:DoplnkoveStavy/crd:DoplnkovyStav/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:ProjektUcet/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:ProjektAdresa/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:Dokumenty/crd:Dokument/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:FinancniCastky/crd:FinancniCastkyZdrojZadani/crd:Finan cnicastkazdroj/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:FinancniCastky/crd:FinancniCastkyZdrojZadani/crd:Finan cnicastkazdroj/crd:castkyobdobi/crd:castkaobdobi/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:FinancniCastky/crd:FinancniCastkyZdrojZadani/crd:Finan cnicastkazdroj/crd:castkyobdobi/crd:castkaobdobi/crd:castkyuvolnene/crd:castkauvolnena/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:FinancniCastky/crd:FinancniCastkyZdrojZadani/crd:Finan cnicastkazdroj/crd:castkyobdobi/crd:castkaobdobi/crd:castkyuvolnene/crd:castkauvolnena/crd:platba/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:FinancniCastky/crd:FinancniCastkyZdrojZadani/crd:Finan cnicastkazdroj/crd:castkyobdobi/crd:castkaobdobi/crd:castkyuvolnene/crd:castkauvolnena/crd:platba/crd:prijemceucet/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:FinancniCastky/crd:FinancniCastkyZdrojZadani/crd:Finan cnicastkazdroj/crd:castkyobdobi/crd:castkaobdobi/crd:castkyuvolnene/crd:castkauvolnena/crd:platba/crd:platceucet/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:FinancniCastky/crd:FinancniCastkyZdrojZadani/crd:Finan cnicastkazdroj/crd:castkyobdobi/crd:castkaobdobi/crd:castkyuvolnene/crd:castkauvolnena/crd:transfery/crd:transfer/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:FinancniCastky/crd:FinancniCastkyZdrojZadani/crd:Finan cnicastkazdroj/crd:castkyobdobi/crd:castkaobdobi/crd:castkycerpane/crd:castkacerpana/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:FinancniCastky/crd:FinancniCastkyZdrojZadani/crd:Finan cnicastkazdroj/crd:castkyobdobi/crd:castkaobdobi/crd:castkyvracene/crd:castkavracena/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:FinancniCastky/crd:FinancniCastkyZdrojDokumentace/cr d:financnicastkazdroj/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:FinancniCastky/crd:FinancniCastkyZdrojDokumentace/cr d:financnicastkazdroj/crd:castkyobdobi/crd:castkaobdobi/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:FinancniCastky/crd:FinancniCastkyZdrojDokumentace/cr d:financnicastkazdroj/crd:castkyobdobi/crd:castkaobdobi/crd:castkyuvolnene/crd:castkauvolnena/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:FinancniCastky/crd:FinancniCastkyZdrojDokumentace/cr d:financnicastkazdroj/crd:castkyobdobi/crd:castkaobdobi/crd:castkyuvolnene/crd:castkauvolnena/crd:platba/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:FinancniCastky/crd:FinancniCastkyZdrojDokumentace/cr d:financnicastkazdroj/crd:castkyobdobi/crd:castkaobdobi/crd:castkyuvolnene/crd:castkauvolnena/crd:platba/crd:prijemceucet/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:FinancniCastky/crd:FinancniCastkyZdrojDokumentace/cr d:financnicastkazdroj/crd:castkyobdobi/crd:castkaobdobi/crd:castkyuvolnene/crd:castkauvolnena/crd:platba/crd:platceucet/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:FinancniCastky/crd:FinancniCastkyZdrojDokumentace/cr d:financnicastkazdroj/crd:castkyobdobi/crd:castkaobdobi/crd:castkyuvolnene/crd:castkauvolnena/crd:transfery/crd:transfer/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:FinancniCastky/crd:FinancniCastkyZdrojDokumentace/cr d:financnicastkazdroj/crd:castkyobdobi/crd:castkaobdobi/crd:castkycerpane/crd:castkacerpana/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:FinancniCastky/crd:FinancniCastkyZdrojDokumentace/cr d:financnicastkazdroj/crd:castkyobdobi/crd:castkaobdobi/crd:castkyvracene/crd:castkavracena/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:FinancniCastky/crd:FinancniCastkyZdrojProjekt/crd:Fina ncnicastkazdroj/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:FinancniCastky/crd:FinancniCastkyZdrojProjekt/crd:Fina ncnicastkazdroj/crd:castkyobdobi/crd:castkaobdobi/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:FinancniCastky/crd:FinancniCastkyZdrojProjekt/crd:Fina ncnicastkazdroj/crd:castkyobdobi/crd:castkaobdobi/crd:castkyuvolnene/crd:castkauvolnena/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:FinancniCastky/crd:FinancniCastkyZdrojProjekt/crd:Fina ncnicastkazdroj/crd:castkyobdobi/crd:castkaobdobi/crd:castkyuvolnene/crd:castkauvolnena/crd:platba/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:FinancniCastky/crd:FinancniCastkyZdrojProjekt/crd:Fina ncnicastkazdroj/crd:castkyobdobi/crd:castkaobdobi/crd:castkyuvolnene/crd:castkauvolnena/crd:platba/crd:prijemceucet/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:FinancniCastky/crd:FinancniCastkyZdrojProjekt/crd:Fina ncnicastkazdroj/crd:castkyobdobi/crd:castkaobdobi/crd:castkyuvolnene/crd:castkauvolnena/crd:platba/crd:platceucet/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:FinancniCastky/crd:FinancniCastkyZdrojProjekt/crd:Fina ncnicastkazdroj/crd:castkyobdobi/crd:castkaobdobi/crd:castkyuvolnene/crd:castkauvolnena/crd:transfery/crd:transfer/ 20

GFŘ - informační systém CEDR III, vypracováno pro oddělení 171 DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:FinancniCastky/crd:FinancniCastkyZdrojProjekt/crd:Fina ncnicastkazdroj/crd:castkyobdobi/crd:castkaobdobi/crd:castkycerpane/crd:castkacerpana/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:FinancniCastky/crd:FinancniCastkyZdrojProjekt/crd:Fina ncnicastkazdroj/crd:castkyobdobi/crd:castkaobdobi/crd:castkyvracene/crd:castkavracena/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:Ukazatele/crd:UkazateleZadani/crd:Ukazatel/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:Ukazatele/crd:UkazateleDokumentace/crd:Ukazatel/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:Ukazatele/crd:UkazateleProjektu/crd:Ukazatel/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:UzemniRealizace/crd:Lokalita/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:Etapy/crd:Etapa/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:Etapy/crd:Etapa/crd:FinancniCastkyZdroj/crd:FinancniCa stkazdroj/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:Etapy/crd:Etapa/crd:FinancniCastkyZdroj/crd:FinancniCa stkazdroj/crd:castkyobdobi/crd:castkaobdobi/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:Etapy/crd:Etapa/crd:FinancniCastkyZdroj/crd:FinancniCa stkazdroj/crd:castkyobdobi/crd:castkaobdobi/crd:castkyuvolnene/crd:castkauvolnena/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:Etapy/crd:Etapa/crd:FinancniCastkyZdroj/crd:FinancniCa stkazdroj/crd:castkyobdobi/crd:castkaobdobi/crd:castkyuvolnene/crd:castkauvolnena/crd:platba/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:Etapy/crd:Etapa/crd:FinancniCastkyZdroj/crd:FinancniCa stkazdroj/crd:castkyobdobi/crd:castkaobdobi/crd:castkyuvolnene/crd:castkauvolnena/crd:platba/crd:prijemceucet/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:Etapy/crd:Etapa/crd:FinancniCastkyZdroj/crd:FinancniCa stkazdroj/crd:castkyobdobi/crd:castkaobdobi/crd:castkyuvolnene/crd:castkauvolnena/crd:platba/crd:platceucet/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:Etapy/crd:Etapa/crd:FinancniCastkyZdroj/crd:FinancniCa stkazdroj/crd:castkyobdobi/crd:castkaobdobi/crd:castkyuvolnene/crd:castkauvolnena/crd:transfery/crd:transfer/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:Etapy/crd:Etapa/crd:FinancniCastkyZdroj/crd:FinancniCa stkazdroj/crd:castkyobdobi/crd:castkaobdobi/crd:castkycerpane/crd:castkacerpana/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:Etapy/crd:Etapa/crd:FinancniCastkyZdroj/crd:FinancniCa stkazdroj/crd:castkyobdobi/crd:castkaobdobi/crd:castkyvracene/crd:castkavracena/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:Etapy/crd:Etapa/crd:Dokumenty/crd:Dokument/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:Etapy/crd:Etapa/crd:Ukazatele/crd:Ukazatel/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:Etapy/crd:Etapa/crd:UzemniRealizace/crd:Lokalita/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Projekty/crd:Projekt/crd:DoplnkoveStavy/crd:DoplnkovyStav/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Adresy/crd:Adresa/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Kontakty/crd:Kontakt/ DavkaCedr/crd:PrijemciPomoci/crd:PrijemcePomoci/crd:Kontakty/crd:Kontakt/crd:KontaktniUdaje/crd:KontaktniUdaj/ 4.5 Předávání dat do IS CEDRIII Tato část specifikuje požadavky kladené systémem IS CEDR III na přijímané zprávy, cílem je zajistit přenos požadovaných informací plynoucí z potřeby kontroly poskytování finanční podpory ze SR. 21

4.5.1 Grafické znázornění závislosti objektů ve schématu 4.5.1.1 Příjemce pomoci GFŘ - informační systém CEDR III, vypracováno pro oddělení 171 22

obrázek 3 XML datový model příjemce pomoci GFŘ - informační systém CEDR III, vypracováno pro oddělení 171 4.5.1.2 Operační programy obrázek 4 - Závislost objektů ve struktuře OperacniProgram 4.5.1.3 Grantová schémata 23

GFŘ - informační systém CEDR III, vypracováno pro oddělení 171 obrázek 5: Závislost objektů ve struktuře Grantových schémat 4.5.2 Datové typy Základní datové typy, které neodpovídají prvků ISDP jsou uvedeny v následující kapitole. 4.5.2.1 simpletype Název Typ Od Do Výčet Popis StatusType xs:string insert update delete nothing DavkaCisloType xs:int DatumCasType xs:datetime DavkaZdrojDatKodType AgenturaKodType DavkaZdrojDatCisloType xs:short 1 99 DavkaXsltValidationType xs:string 1024 ObjektIDType xs:token 1 38 AgenturaKodType xs:token 1 38 DokumentIdentifikatorTyp xs:token 1 38 ChybaPopisType xs:string 1 500 ChybaKodType xs:int LogickaHodnotaIndikatorSimpleType xs:string true false 24

GFŘ - informační systém CEDR III, vypracováno pro oddělení 171 25

4.5.2.2 Restrikce a extenze na základní datové typy Název Typ Od Do Výčet Maska Popis DokumentDruhKodType cct:kodtype 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 11, 12, DotaceTitulKodType cct:kodtype (*){3-4}\d{7} OperacniProgramOpatreniKodType cct:kodtype 1 38 OperacniProgramPodopatreniKodType cct:kodtype 1 38 OperacniProgramPrioritaKodType cct:kodtype 1 38 OperacniProgramKodType cct:kodtype 1 38 UcelZnakKodType cct:kodtype [0-9]{7} StatniRozpocetUkazatelKodType cct:kodtype 1 12 RozpoctovaSkladbaPolozkaKodType cct:kodtype 1 24 RozpoctovaSkladbaParagrafKodType cct:kodtype 1 16 StatniRozpocetKapitolaKodType cct:kodtype 3 4 DotacniTitulNazevZkracenyType cct:texttype 1 50 DotacniTitulResotKodType cct:kodtype 1 30 KontaktHodnotaType cct:texttype 1 512 UkazatelDruhType cct:kodtype kvalitativní, kvantitativní, makroekonomický, analytický, popisný, finanční, fyzický, věcný, časový, hospodářský, prognostický, poměrový, fyzikální, chemický, výkonnostní, vstupů, výstupů, výsledků, dopadů, neuvedeno, MenaKodType cmn:menakodtype 3 3 \p{l}{3} StatKodType spa:statkodtype 3 3 \p{l}{3} BankaKodType cmn:bankakodtype 4 4 \d\d\d\d DoplatekIndikatorType cct:indikatortype 0, 1, UkazatelDopadRovnePrilezitostiType cct:kodtype silný, slabý, žádný, UkazatelDopadZivotniProstrediType cct:kodtype silný, slabý, žádný, UkazatelPohlaviType cct:kodtype muž, žena, oba, UkazatelVazbaPolitikaType cct:kodtype přímá, nepřímá, žádná, OsobaZamestnaniPostaveniKodType per:osobazamestnanipostavenikodtype 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 98, 99, ZmenaSmlouvyIndikatorType cct:indikatortype 0, 1, ProjektKodType cct:kodtype 1 38 PolozkaTransferPoradiType cct:pocettype BankaPobockaNazevType cct:texttype 1 80 UcetDruhKodType cct:kodtype 1, 2, MezinarodniPusobnostIndikatorType cct:indikatortype 1, 0, UkazatelNazevZkracenyType cct:texttype 1 50 UkazatelPopisType cct:texttype 1 3000 UkazatelUrovenDruhType cct:texttype OperacniProgramCisloType cct:identifikatortype 1 50 26

TextType cct:texttype 1 3000 PlanovanyStavPopisType fkis:planovanystavpopistype 1 3000 DocilenyStavPopisType fkis:docilenystavpopistype 1 3000 UzemniRealizaceLokalitaPopisType fkis:uzemnirealizacelokalitapopistype 1 3000 SubjektObchodniJmenoType SubjektCinnostUkonceniDatum SubjektShodaKod cct:kodtype 0 [123][0123][0456789][0123456789] AdresaShodaKod cct:kodtype 0 [12][01234567] ProgramPodporaKodType cct:kodtype 1 38 LogickaHodnotaIndikatorType cct:indikatortype true, false, GrantoveSchemaKodType cct:kodtype 1 38 CinnostTypKodType cct:kodtype 1 38 GrantoveSchemaNazevType cct:texttype 1 255 GrantoveSchemaCisloType cct:kodtype 1 50 ProgramPodporaNazevType cct:texttype 1 255 ProgramPodporaCisloType cct:kodtype 1 50 CinnostTypNazevType cct:texttype 1 255 CinnostTypCisloType cct:kodtype 1 50 FinancniCastkaUsignedType cct:cenatype ((0 [1-9]{1}\d{0,10})([,] [.])\d{2} (0 [1-9]{1}\d{0,14})) FinancniCastkaSignedType cct:cenatype ([\-]?)((0 [1-9]{1}\d{0,10})([,] [.])\d{2} (0 [1-9]{1}\d{0,14})) 27

4.5.2.3 PrijemcePomociBaseStructure Struktura s informacemi o příjemci pomoci. Hodnota elementu ZaznamPlatnostDatum je použita k dohledání hodnot StatKod, PravniFormaKod v číselníku. Hodnota elementu musí splňovat podmínku ZaznamPlatnostDatum <= DavkaCedr/@davkaSestaveniDatumCas Číslo Název Typ/Odkaz Min Max výskyt výskyt Insert Update Delete NothingIdentifikátor 1 ICO bus:subjekticotype 0 1 ERR ERR NI NI AA0017 NP NN NI NI PP NP NI NI NP NN NI NI 2 DIC SubjektDICStructure 0 1 NP NN NI NI AAC011 3 ObchodniJmeno ObchodniJmenoStructure 1 ERR ERR NI NI 4 SidloAdresa ObjektAdresaStructure 0 1 PP NP NI NI 5 OsobaIdentita OsobaIdentitaBaseStructure 0 1 NN NN NI NI 6 StatKod StatKodType 0 1 PP NP NI NI AA0033 7 PravniFormaKod bus:subjektpravniformakodtype 0 1 PP NP NI NI AA0019 8 ShodaKod SubjektShodaKod 0 1 NP NN NI NI CA0002 9 CinnostUkonceniDatum cmn:datumxmltype 0 1 NP NN NI NI CA1082 10 BankaUcet BankaUcetStructure 1 11 Zadost ZadostStructure 1 12 Projekt ProjektStructure 1 13 Adresa ObjektAdresaStructure 1 14 Kontakt ObchodniKontaktStructure 1 15 Rozsireni cmn:rozsirenistructure 0 1 16 ZaznamPlatnostDatum cmn:datumxmltype 1 1 PP PP NI NI CA1082 17 ZaznamAktualizaceDatumCas DatumCasType 1 1 PP PP NI NI CA0003 18 UzivatelID ObjektIDType 1 1 PP PP NI NI CA0004 1 Identifikační číslo dle specifikace ÚVIS, uvádí se pro typ právní formy právnická osoba a fyzická osoba podnikající. S případnými vedoucími nulami.pokud se hodnota elementu StatKod!="CZE" a hodnota elementu PravniFormaKod!=421 řídí se vyplnění dle pravní formy. Daňové identifikační číslo.složené z FinancniUradKod s případnými vedoucími nulami a z SubjektPlatceDaneId Id subjektu plátce daně S 2 případnými vedoucími nulami. Nebo struktura složená z kódu státu a z SubjektPlatceDaneEUiD datový prvek, který slouží k identifikaci a registraci plátce daní v rámci EU. Je vytvořen podle legislativy jednotlivých států EU 3 Zde je uvedeno obchodní jméno daného subjektu v daném specifikovaném jazyce. Kód jazyka je specifikován výčtovým typem. Zde je uvedena adresa subjektu. Pro právnicé osoby se uvádí sídlo firmy (hodnota kvalifikátoru adresy = 1). U fyzických osob a fyzických osob 4 podnikajících se uvádí trvalé bydliště (hodnota kvalifikátoru adresy = 4). U cizinců (právní forma 421) mohou být uvedeny oba typy adresy. Pokud je uveden StatKod!= "CZK" a typ právní formy je 1 nebo 2 bude v SidleAdresa očekáván typ adresy 4. Při insertu je element povinný a závisí na typu právní formy. Při modifikaci je nepovinný. 5 Údaje o fyzické osobě. Při insertu je element povinný a závisí na typu právní formy. Při modifikaci je nepovinný. 6 Datový prvek pro kódové označení státu. Pozn.: Kód musí být ve tvaru třímístný abecední. V případě, že forma subjektu = 421 musí být Kód státu povinně vyplněn a být různý od 'CZE'. 7 Kód právní formy dle číselníku ČSÚ, doplněného o kód 100 udávající fyzickou osobu. Pokud byl jednou subjekt do systému zaslán s nějakou PF. Tuto právní formu již nelze modifikovat. 8 Kód shody informací o subjektu ověřených v externích systémech. Hodnota je předávána do IS CEDR III. 9 Datum ukončení činnosti daného subjektu. Hodnota je předávána do IS CEDR III. 10 Struktura s údaji o účtu daného subjektu 11 Struktura s žádostí daného subjektu 12 Struktura s informacemi o projektu k danému subjektu. 13 Struktura s informaci o adrese k subjektu. 14 Struktura s informacemi o kontaktu na daný subjekt 15 Struktura pro přenos informací, které nepostihuje dané schéma 16 Hodnota elementu udává platnost daného záznamu k danému datu. 17 Hodnota elementu udává datum aktualizace daného záznamu v systému poskytovatele dat. 18 Hodnota udává identifikátor uživatele, který provedl změnu daného záznamu v systému poskytovatele. 4.5.2.4 OsobaIdentitaBaseStructure Struktura osoba identita Číslo Název Typ/Odkaz Min výskyt Max výskytinsert Update Delete NothingIdentifikátor 1 OsobaRodneCislo per:osobarodnecislotype 0 1 PP NP NI NI AA0001 PP NP NI NI ERR ERR NI NI ERR ERR NI NI 2 CizinecRodneCislo per:cizinecrodnecislotype 0 1 PP NP NI NI AA0009 28