Specifikace http služby IS CEDR pro poskytování dokumentů z IS CEDR II



Podobné dokumenty
Základní zadání IS o ISVS. Sluţba poskytování dat IS o ISVS

Specifikace služby IS CEDR pro poskytování informací z IS CEDR III, veřejná část

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

l Kontakt s klientem SSP Popis automatizované komunikace s ÚP ČR v součinnosti a exekuci

Požadavky pro výběrová řízení TerraBus ESB/G2x

Funkční specifikace ABOKWS. Aplikační rozhraní elektronického bankovnictví ABO-K. Verze 0.5

PODMÍNKY POSKYTOVÁNÍ PŘÍSTUPU K PORTÁLU NAMĚŘENÝCH DAT POMOCÍ WEBOVÝCH SLUŽEB SPOLEČNOSTI ČEZ DISTRIBUCE, A. S.

Specifikace služby IS CEDR pro poskytování číselníků z IS CEDR

Úvod do Web Services

Popis B2B rozhraní pro elektronickou neschopenku

Specifikace rozhraní. Oznamovací povinnost podle zákona č. 307/2013 Sb., ve znění pozdějších předpisů. Martin Falc, SW architekt.

Chybová hlášení METODIKA MET-01/2014. SZR-56-1/OPICT-2013 počet stran 28 přílohy 0. Nahrazuje:

Specifikace služby IS CEDR pro poskytování informací o provedených kontrolách (verze II)

Národní elektronický nástroj. Technická specifikace rozhraní pro IEN

Pokročilé Webové služby a Caché security. Š. Havlíček

1. Webové služby. K čemu slouží? 2. RPC Web Service. 3. SOA Web Service. 4. RESTful Web services

Referenční rozhraní. Jiří Kosek. Ministerstvo informatiky ČR. ISSS 25. března 2003

Popis egon služ by. E219 - rppctieditoraovmspuu. Název dokumentu: Popis egon služeb Verze: Datum aktualizace: Správa základních registrů

Popis egon služby. E177 - iszrctireklamaci. Název dokumentu: Popis egon služeb Verze: Datum aktualizace: Správa základních registrů

Popis egon služ by. E234 isuivyhledejparcelugp. Název dokumentu: Popis egon služeb Verze: Datum aktualizace: Správa základních registrů

Dokumentace ke sluţbě SMS Connect.

Popis egon služby. E63 - iszrreklamujudajeros. Název dokumentu: Popis egon služeb Verze: Datum aktualizace: Správa základních registrů

TECHNICKÁ SPECIFIKACE VEŘEJNÉ ZAKÁZKY

Roční periodická zpráva projektu

IS SDSL Dálkový způsob ověření totožnosti a věku osoby žádající o registraci Praha, Martin Prem

Nastavení provozního prostředí webového prohlížeče pro aplikaci

Popis egon služ by. E218 - rppctizmenyovmspuu. Název dokumentu: Popis egon služeb Verze: Datum aktualizace: Správa základních registrů

ERP-001, verze 2_10, platnost od

Popis egon služeb. E94 - isknreklamujprvek. Název dokumentu: Popis egon služeb v rámci základních registrů. Datum aktualizace:

Popis egon služby. E162 - aiscctiaifo. Název dokumentu: Popis egon služeb Verze: Datum aktualizace: Správa základních registrů

Popis egon služ by. E231 - rppvypisseznamukonunazadost. Název dokumentu: Popis egon služeb Verze: Datum aktualizace: Správa základních registrů

Příloha: Dodatečné informace, včetně přesného znění žádosti dodavatele o dodatečné informace

TRANSPORTY výbušnin (TranV)

l Kontakt s klientem SSP Popis automatizované komunikace s ÚP ČR v součinnosti a exekuci

PODMÍNKY POSKYTOVÁNÍ PŘÍSTUPU K PORTÁLU NAMĚŘENÝCH DAT POMOCÍ WEBOVÝCH SLUŽEB SPOLEČNOSTI ČEZ DISTRIBUCE, A. S.

Verze dokumentu 0.1 duben 2016

Popis egon služ by. E210 - rppvypisseznamovmspuu. Název dokumentu: Popis egon služeb Verze: Datum aktualizace: Správa základních registrů

Microsoft Office 2003 Souhrnný technický dokument white paper

Michal Krátký, Miroslav Beneš

Popis egon služby. E15 - robctieditora. Název dokumentu: Popis egon služeb Verze: Datum aktualizace: Správa základních registrů

Alena Malovaná, MAL305

Popis egon služ by. E228 rppvypisovmspuu2. Název dokumentu: Popis egon služeb Verze: Datum aktualizace: Správa základních registrů

Popis egon služ by. E227 - iszrvypisopravnenipolozky. Název dokumentu: Popis egon služeb Verze: Datum aktualizace: Správa základních registrů

Popis egon služby. E165 - robvydejdat. Název dokumentu: Popis egon služeb Verze: Datum aktualizace: Správa základních registrů

Přehled základních kontrol v ISoSS

DEFINICE PROCESŮ DATOVÉ KOMUNIKACE TECHNICKÁ SPECIFIKACE DATOVÝCH SLUŽEB POSKYTOVANÝCH SPOLEČNOSTÍ ČEZ DISTRIBUCE, A. S.

Popis egon služby. E93 - roszapispravnistav. Název dokumentu: Popis egon služeb Verze: Datum aktualizace: Správa základních registrů

DEFINICE PROCESŮ DATOVÉ KOMUNIKACE TECHNICKÁ SPECIFIKACE DATOVÝCH SLUŽEB POSKYTOVANÝCH SPOLEČNOSTÍ ČEZ DISTRIBUCE, A. S.

Elektronická evidence tržeb. Neprodukční prostředí (playground) Přístupové a provozní informace

Popis egon služ by. E214 - rppvypisseznamkategoriiovmspuu. Název dokumentu: Popis egon služeb Verze: Datum aktualizace:

Popis egon služby E78 - orgctizmenyaifo

Národní elektronický nástroj. Import profilu zadavatele do NEN

Návrh funkcí webových služeb (WS) pro komunikaci mezi Informačním systémem datových schránek (ISDS) a spisovými službami (SS)

Popis egon služby. E62 - iszrreklamujudajerob. Název dokumentu: Popis egon služeb Verze: Datum aktualizace: Správa základních registrů

Integrovaný informační systém státní pokladny. Ministerstvo financí. Integrovaný informační systém Státní pokladny

Spisová agenda. Popis komunikačního rozhraní. Autor analýzy: Zadavatel: ver.: TranSoft a.s Vrbenská České Budějovice

Popis egon služby E28 - rosctizmeny

Popis egon služby. E184 - ruianctiseznamadres. Název dokumentu: Popis egon služeb Verze: Datum aktualizace: Správa základních registrů

EXTRAKT z technické normy ISO

Popis egon služby. E23 - roszapisdatovouschranku. Název dokumentu: Popis egon služeb Verze: Datum aktualizace: Správa základních registrů

Tvorba informačních systémů

Modul IRZ návod k použití

Popis egon služby. E99 - iszrasyncvypisfronty. Název dokumentu: Popis egon služeb Verze: Datum aktualizace: Správa základních registrů

Popis egon služby E34T - ruianvyhledejprvekvolebniokrsek

Popis webové služby pro sledování změn údajů o nemovitostech

Popis B2B rozhraní pro elektronickou neschopenku

Popis egon služby. E164 - iszrprobe. Název dokumentu: Popis egon služeb Verze: Datum aktualizace: Správa základních registrů

Referenční rozhraní národního konektoru Národního kontaktního místa pro ehealth úloha pacientský souhrn

ZP API V1.0 Návod pro vývojáře SW

KSRZIS. Postup kroků nutných pro napojení nemocničního informačního systému s registrem NSHNU v prostředí registrů resortu zdravotnictví

B2B SOAP - popis funkcionality

Popis egon služ by. E229 rppvypisagendu3. Název dokumentu: Popis egon služeb Verze: Datum aktualizace: Správa základních registrů

I N V E S T I C E D O R O Z V O J E V Z D Ě L Á V Á N Í

Platební systém XPAY [

Specifikace služby IS CEDR pro příjem podnětů ke kontrolám

Klientský formát POHLEDÁVKY platný od

Vykazování dat prostřednictvím SDNS Web Services

Dokumentace pro výrobce SW DIS13 - WS

Příloha č. 1, část 4 Kontrola souladu software s požadavky Národního standardu pro elektronické spisové služby

Dokumentace k nevizuálnímu rozhraní aplikace DopisOnline

mbank.cz mtransfer Okamžitá notifikace o mtransferu Dokumentace pro externího partnera

Příloha č. 1 Smlouvy o spolupráci B2B rozhraní VZP ČR

Benefit7 jak vyplnit projektovou ţádost

Validace souborů DS3

Microsoft Office 2003 Souhrnný technický dokument white paper

Česká správa sociálního zabezpečení

TECHNICKÁ SPECIFIKACE VEŘEJNÉ ZAKÁZKY

Elektronická komunikace s CSÚIS. Jak to řeší Fenix

PŘÍLOHA C Požadavky na Dokumentaci

Popis egon služby E162 - aiscctiaifo

Popis egon služby. E75 - orgctidavkuaifo. Název dokumentu: Popis egon služeb Verze: Datum aktualizace: Správa základních registrů

PODMÍNKY POSKYTOVÁNÍ DATOVÝCH SLUŽEB SPOLEČNOSTÍ ČEZ DISTRIBUCE, A. S.

SPRÁVA ZÁKLADNÍCH REGISTRŮ PODMÍNKY PRO PŘIPOJENÍ AGENDOVÝCH INFORMAČNÍCH SYSTÉMŮ DO ISZR. verze 2.00

Katalog egon služeb verze: 0.01

Transkript:

Specifikace http služby IS CEDR pro poskytování dokumentů z IS CEDR II vypracovala společnost ASD Software, s.r.o. dokument ze dne 8.6. 2011, verze 1.00.0 Název souboru : Sluzba_CEDR_DOK_v_100.0.doc 1

Specifikace http sluţby IS CEDR pro poskytování dokumentů z IS CEDR II Počet stran v dokumentu celkem : 16 Rozdělovník : Číslo Počet výtisků Předáno Převzal 1 1 x GFŘ, oddělení 333 Mgr. Vladimír Dlouhý, DiS.

OBSAH 1. ÚVOD... 5 2. PROCESNÍ POSTUPY... 6 2.1 PŘENOS INFORMACÍ... 6 2.2 PROVOZNÍ DOBA... 6 3. TECHNICKÉ ŘEŠENÍ... 7 3.1 PŘENOSOVÝ FORMÁT DAT... 7 3.2 VALIDACE A POPIS XML DOKUMENTŮ... 7 3.2.1 XML Schema... 7 3.2.2 Jmenné prostory... 7 3.2.3 RDDL... 7 3.3 TRANSPORTNÍ PROTOKOLY... 7 3.3.1 Základní transportní protokol... 7 3.3.2 Adresa služby... 7 3.3.3 SOAP protokol... 8 3.3.4 Použití WS-Addressing... 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... 8 3.6.1 Integrita přenosu dat... 8 3.6.2 Požadavek o zaslaní dokumentu... 8 3.7 PŘÍSTUPOVÁ OPRAVNĚNÍ KE SLUŢBĚ... 8 3.8 LOGOVÁNÍ PŘÍSTUPU KE SLUŢBĚ... 9 3.9 ZPRACOVÁNÍ CHYB... 9 3.9.1 Chyby na úrovni přenosového protokolu HTTPS... 9 3.9.2 Chyby při načtení zprávy SOAP... 9 3.9.3 Chyba neoprávněného přístupu... 9 3.9.4 Chyby na úrovni validace pomocí XML Schema... 9 3.9.5 Chyby na úrovni aplikační... 9 4. POPIS PŘEDÁVANÝCH DAT... 10 4.1 USTANOVENÍ PRO DEFINICI PLATNOSTI ELEMENTŮ... 10 4.2 SLUŢBA PRO POSKYTOVÁNÍ DOKUMENTŮ Z IS CEDR... 11 4.2.1 Požadavek na dokument... 11 4.2.1.1 Datové typy... 11 4.2.1.2 Popis schémat... 11 4.2.1.3 Zpráva s poţadavkem o dokument typu formulář... 11 4.2.1.4 Zpráva s poţadavkem o dokument typu odůvodnění... 11 4.2.2 Odpověď na požadavek o dokument... 11 4.2.2.1 Datové typy... 11 4.2.2.2 Popis schémat... 12 4.2.2.3 Zpráva s dokumentem... 12 5. PODROBNÝ POPIS ŽIVOTNÍHO CYKLU ZPRÁV... 13 Název souboru : Sluzba_CEDR_DOK_v_100.0.doc 3

6. PŘÍLOHY... 14 6.1 ADRESA SLUŢBY... 14 6.1.1 Verze 1.0.0... 14 6.2 WSDL... 14 6.2.1 Verze 1.0.0... 14 6.3 SCHÉMATA... 14 6.3.1 Dokumenty.xsd... 14 6.3.2 dokumentydatatypes.xsd... 14 6.4 PŘÍKLADY ZPRÁV... 14 6.4.1 Požadavek na formulář... 14 6.4.2 Odpověď na požadavek o formulář... 15 7. REFERENCE... 16 Název souboru : Sluzba_CEDR_DOK_v_100.0.doc 4

1. Úvod Tento materiál popisuje automatickou HTTP sluţbu, která na základě předaných poţadavků vrací zpět uţivateli poţadované informace, v našem případě dokumenty z IS CEDR II. Název souboru : Sluzba_CEDR_DOK_v_100.0.doc 5

2. Procesní postupy 2.1 Přenos informací Sluţba na straně IS CEDR bude podporovat moţnost vznášení dotazů na uloţená data v IS CEDR tak, jak je uvedeno na obr. 1: Dotaz na službu CEDR Zpracování dotazu CEDR Klient služby Odpověď služby CEDR Obr. 1 Dotazy klientů na databázi IS CEDR V tomto případě (obr. 1) probíhají globální procesy následujícícm způsobem: 1. Na straně klienta je vygenerována zpráva, obsahující poţadavek na aplikaci IS CEDR. Spuštění přenosu se děje ad hoc uţivatelem; to znamená, ţe neexistuje časový plán dotazů. 2. Zpráva (dotaz) je opatřena všemi náleţitostmi dle této specifikace a je odeslána pomocí protokolu HTTPS na adresu aplikace IS CEDR II. Spojení mezi komunikujícími stranami není přerušeno. 3. Aplikace IS CEDR II přijme poţadavek a zpracuje jej v souladu s pravidly, stanovenými v této specifikaci. Zpět klientské straně odešle zprávu o výsledku zpracování dotazu. 2.2 Provozní doba Sluţba je dostupná nonstop. Název souboru : Sluzba_CEDR_DOK_v_100.0.doc 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 dat 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 Jmenné prostory Jmenné prostory schémat, popisujících přenášené XML dokumenty popisované sluţby, budou ve formátu URN. 3.2.3 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 HTTPS. Komunikace při přenosu zpráv mezi klientem a sluţbou nebude přerušena, dotaz a přenos odpovědi sluţby ke klientovi proběhne tedy v rámci jednoho spojení. 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 6.1. Název souboru : Sluzba_CEDR_DOK_v_100.0.doc 7

3.3.3 SOAP protokol Nad protokolem HTTPS bude pouţit rozšiřující XML protokol SOAP ve verzi 1.1 Chyba! Nenalezen zdroj odkazů.. Struktura zpráv při pouţití SOAP protokolu je dána specifikací [1]. Dále bude pouţito formátování zprávy dle specifikace WS-Addressing [5] 3.3.4 Použití WS-Addressing Pro administraci zpráv bude pouţito elementů specifikace WS-Addressing [5]. Zprávy přenášející data (ţádosti i odpovědi) budou povinně obsahovat elementy: <Action> <MessageID> <ReplyTo> <To> 3.4 Model přenosu zpráv Jako model pro přenos zpráv bude pouţit model request-response. Vzhledem k on-line komunikaci nejsou implementovány informativní zprávy sluţby. 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 uvedené v kapitole 6.2. 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 na úrovni HTTPS přenosového protokolu). Pro podpis bude pouţito předem dohodnutých certifikátů, které budou distribuovány mezi jednotlivými účastníky komunikace po jejich zaevidování v autentizačním a autorizačním informačním systému. 3.6.2 Požadavek o zaslaní dokumentu Tento typ přenosu (viz téţ Chyba! Nenalezen zdroj odkazů.) bude mít implementovány bezpečnostní funkce v závíslostí na typu zprávy. Pro zprávy s poţadavkem na zaslání dokumentů to budou následující: Integrita přenosu dat Zprávy s dokumentem budou zabezpečeny funkcemi: Integrita přenosu dat 3.7 Přístupová opravně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 II. Kaţdému oprávněnému uţivateli je správcem systému CEDR II vystaven certifikát (na základě předloţení Název souboru : Sluzba_CEDR_DOK_v_100.0.doc 8

ţádosti oddělení 333), který je dále pouţit při zabezpečení zprávy dle kap. Chyba! Nenalezen zdroj odkazů.. Další podrobnější přístupová oprávnění na úrovni operací se záznamy nejsou sluţbou řešena. 3.8 Logování přístupu ke službě V rámci přístupu ke sluţbě se budou uchovávat následující informace: datum přístupu klienta IP 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 Doba uchování těchto informací není omezena. 3.9 Zpracování chyb Zpracování chyb bude ošetřeno v souladu se zásadami uvedenými ve specifikaci [1] a Chyba! Nenalezen zdroj odkazů.. 3.9.1 Chyby na úrovni přenosového protokolu HTTPS Chyby na úrovni přenosového protokolu HTTPS 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.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. Na klienta bude odeslána pouze chybová zpráva ve formátu SOAP. 3.9.3 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. 3.9.4 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. 3.9.5 Chyby na úrovni aplikační Tyto chyby se týkají např. selhání aplikační databáze CEDR, 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 CEDR bude v této verzi odmítnut celý dotaz. Chybová zpráva ve formátu SOAP je odeslána zpět klientovi. Obecný chybový kód je v tomto případě ServiceError. Název souboru : Sluzba_CEDR_DOK_v_100.0.doc 9

Název souboru : Sluzba_CEDR_DOK_v_100.0.doc 10

4. Popis předávaných dat 4.1 Ustanovení pro definici platnosti elementů 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 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 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 null 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. Název souboru : Sluzba_CEDR_DOK_v_100.0.doc 11

4.2 Služba pro poskytování dokumentů z IS CEDR Tato část specifikuje poţadavky kladené sluţbou CEDR na osoby ţádající o dokumenty. 4.2.1 Požadavek na dokument Sluţba je vyuţívána pro získání dvou typů dokumentů formulář a odůvodnění. 4.2.1.1 Datové typy Všechny potřebné datové typy pro poţadavky na dokumenty jsou definovány ve schématu datových typů viz. kapitola 6.3.2. 4.2.1.2 Popis schémat Struktura a formát poţadavku ţádosti o dokumenty na IS CEDR je specifikována ve schématech viz kapitola 6.3.1. 4.2.1.3 Zpráva s požadavkem o dokument typu formulář Zpráva s poţadavkem na získání formuláře bude obsahovat následují elementy, které jednoznačně určují poţadovaný formulář: Poř.č. Jméno položky Platnost Identifikátor datového prvku 1 Číslo jednací identifikátor PP AA0105 2 Pořadové číslo změny PP CA0009 3 Interní kód formuláře PP CA0009 Poznámka: Poloţky pro získání formuláře jsou obsaţeny v odpovědi sluţby CEDR VK, která poskytuje informace o výsledcích kontrol. 4.2.1.4 Zpráva s požadavkem o dokument typu odůvodnění Zpráva s poţadavkem na získání odůvodnění bude obsahovat následují elementy, které jednoznačně určují poţadovaný dokument s odůvodněním: Poř.č. Jméno položky Platnost Identifikátor datového prvku 1 Číslo jednací identifikátor PP AA0105 2 Pořadové číslo přílohy PP CA0009 3 Pořadové číslo změny PP CA0009 Poznámka: Poloţky pro získání důvodnění jsou obsaţeny v odpovědi sluţby CEDR VK, která poskytuje informace o výsledcích kontrol. 4.2.2 Odpověď na požadavek o dokument 4.2.2.1 Datové typy Všechny potřebné datové typy pro odpověď na ţádost o dokument jsou definovány ve schématu datových typů. (viz kapitola 6.3.2) Název souboru : Sluzba_CEDR_DOK_v_100.0.doc 12

4.2.2.2 Popis schémat Struktura a formát odpovědi na ţádost o dokument je specifikována ve schématech viz kapitola?. 4.2.2.3 Zpráva s dokumentem Zpráva s formulářem nebo odůvodněním bude mít stejnou následující strukturu: Poř.č. Jméno položky Platnost Identifikátor datového prvku 1 Dokument NP CA0010 2 Text chyby NP CA0011 3 Přípona NP AA1338 4 Kód výsledku dotazu PP CA0009 Poznámky 1 Binární podoba dokumentu 2 Text chyby, která vznikne při vykonávání ţádosti o dokument. 3 Přípona dokumentu (např. DOC, PDF, apod.) 4 Kód výsledku zpracování dotazu. -4 - chyba validace (poloţky pro získání dokumentu neodpovídají definici dle schémat) -3 - chyba sluţby -2 - neplatný certifikát (pro komunikaci se sluţbou byl pouţit neplatný certifikát) -1 - subjekt nemá přístup ke sluţbě (přiloţený certifikát nelze pouţít pro přístup ke sluţbě) 0 - subjekt nemá přístup k dokumentu (subjekt má přístup ke sluţbě, ale nemá přístup na poloţku dokumentem) 1 - platný přístup k dokumentu (subjekt má přístup na poloţku s dokumentem) Název souboru : Sluzba_CEDR_DOK_v_100.0.doc 13

5. Podrobný popis životního cyklu zpráv Ţivotní cyklus zprávy na straně sluţby lze podrobně rozepsat v následujících bodech: 1. Odesílající strana (klient) vygeneruje zprávu, s poţadavkem na dokument. 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 zašle zprávu na sluţbu s příslušnou adresou. Pokud dojde k selhání přenosu na úrovni protokolu HTTPS, sluţba negeneruje chybovou zprávu. Indikace chybového stavu bude provedena standardními postupy pro daný protokol. 4. 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 vrácena chybová zpráva SOAP s chybovým kódem InternalServiceFault. Příchozí zpráva je odmítnuta jako celek. Selţe-li převzetí zprávy sluţbou z důvodů chybného jemenného prostoru SOAP ve zprávě, je klientovi vrácen http chybový kod 400 Bad request. Selţe-li převzetí zprávy sluţbou z důvodů chybného jemenného prostoru WS-adressing ve zprávě, je klientovi vrácena chybová zpráva SOAP s chybovým kódem DestinationUnreachable. Příchozí zpráva je odmítnuta jako celek. 5. 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 vrácena chybová zpráva SOAP s chybovým kódem a:internalservicefault. 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 vrácena chybová zpráva SOAP s chybovým kódem VersionMismatch. Příchozí zpráva je odmítnuta jako celek. 6. Sluţba ověří, zda zpráva v SOAP hlavičce obsahuje korektní adresu sluţby v elementu <To> Pokud adresa neodpovídá adrese sluţby je klientovi zaslána chybová zpráva SOAP s chybovým kódem DestinationUnreachable. 7. Zpráva je validována proti schématu. Selţe-li tento krok z důvodů chyby přijímající aplikace, je klientovi zaslána chybová zpráva. 8. Zpráva je zpracována IS CEDR II 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. 9. 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. Název souboru : Sluzba_CEDR_DOK_v_100.0.doc 14

6. Přílohy 6.1 Adresa služby 6.1.1 Verze 1.0.0 https://app.mfcr.cz/cedr_dok_100/service.svc 6.2 WSDL Pro sluţbu na poskytování dokumentů je popis sluţby WSDL. 6.2.1 Verze 1.0.0 https://app.mfcr.cz/cedr_dok_100/service.wsdl 6.3 Schémata 6.3.1 Dokumenty.xsd Schéma obsahuje metody (GetFormular, GetOduvodneni) pro získání dokumentů. http://app.mfcr.cz/cedr2_xml/schemas/cedr_ii/dok/v_1.0.0/dokumenty.xsd 6.3.2 dokumentydatatypes.xsd Schéma obsahuje všechny datové typy, které jsou sluţbou pouţity. http://app.mfcr.cz/cedr2_xml/schemas/cedr_ii/dok/v_1.0.0/dokumentydatatypes.xsd 6.4 Příklady zpráv 6.4.1 Požadavek na formulář <s:envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/" xmlns:a="http://schemas.xmlsoap.org/ws/2004/08/addressing"> <s:header> <a:action s:mustunderstand="1">urn:cz:isvs:mfcr:schemas:cedrii:dokumenty:v100/iservice/getformular</a:action> <a:messageid>urn:uuid:dfa0f20b-93e1-4f62-b938-51792c5becba</a:messageid> <a:replyto> <a:address>http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous</a:address> </a:replyto> <VsDebuggerCausalityData xmlns="http://schemas.microsoft.com/vstudio/diagnostics/servicemodelsink">uidpo/fjvadqkvrdnbbm8ly509waaaaajkmqjrihoey4r Nm+EdfUH7ac3kXqvqhAnnORmdnpcc0ACQAA</VsDebuggerCausalityData> <a:to s:mustunderstand="1">https://cedr2.asd-software.cz/cedr_dok_100/service.svc</a:to> </s:header> <s:body xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xmlns:xsd="http://www.w3.org/2001/xmlschema"> <GetFormular xmlns="urn:cz:isvs:mfcr:schemas:cedrii:dokumenty:v100"> <param> <CisloJednaciId xmlns="urn:cz:isvs:mfcr:schemas:cedrii:dokumenty:datatypes:v100">12010000577</cislojednaciid> <CisloZmeny xmlns="urn:cz:isvs:mfcr:schemas:cedrii:dokumenty:datatypes:v100">2</cislozmeny> <FormularKod xmlns="urn:cz:isvs:mfcr:schemas:cedrii:dokumenty:datatypes:v100">1012</formularkod> </param> </GetFormular> </s:body> Název souboru : Sluzba_CEDR_DOK_v_100.0.doc 15

</s:envelope> 6.4.2 Odpověď na požadavek o formulář <s:envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/" xmlns:a="http://schemas.xmlsoap.org/ws/2004/08/addressing"> <s:header> <a:action s:mustunderstand="1">urn:cz:isvs:mfcr:schemas:cedrii:dokumenty:v100/iservice/getoduvodneniresponse</a:action> <ActivityId CorrelationId="34cf1aba-dde8-461c-97a3-05ff04e1c607" xmlns="http://schemas.microsoft.com/2004/09/servicemodel/diagnostics">84c2dec5-52d3-4018-aef0-748d1d0fb9a9</activityid> <a:relatesto>urn:uuid:27792bbd-363f-4002-b416-597529fb5d75</a:relatesto> <a:to s:mustunderstand="1">http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous</a:to> </s:header> <s:body xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xmlns:xsd="http://www.w3.org/2001/xmlschema"> <GetOduvodneniResponse xmlns="urn:cz:isvs:mfcr:schemas:cedrii:dokumenty:v100"> <GetOduvodneniResult> <Dokument xmlns="urn:cz:isvs:mfcr:schemas:cedrii:dokumenty:datatypes:v100">0m8r4kgxgueaaaaaaaaaaaaaaaaaaaaapgadap7/cqag AAAAAAAAAAAAAAABAAAAAQAAAAAAAAAAEAAAJwAAAAEAAAD+QAQAAEYpmUFSABjBQBsAG8ADgAACzIAAABOAEIAUABfA EIAbABvAGsAUAByAG8AbQBlAG4BAAACAAAAAAAAAAAAAAAAAAAAAAAxAAoAAAsiAAAAVgBTAFAAXwBQAHIAbwBtAFAAcgBv AFMAZQB6AG4AYQBtAAkAAAscAAAAVgBTAFAAXwBTAGUAegBuAGEAbQBQAG8AbABpAAIAAAsCAAAAOwAIAAALGAAAAFYAb wbsagiayqbqahiabwbdageacwblaagaaasyaaaatgbhahoadgb5aeeauabvahaaaqbzahkacgaacyiaaaboageaegb2ahk ASABvAGQAbgBvAHQAeQBBAE0AbwBkAHkACwAACyQAAABDAG8AcAB5AEYAcgBvAG0AVwBpAG4AZABvAHcATgBhAG0AZQA KAAALIAAAAEMAbwBwAHkAVABvAFcAaQBuAGQAbwB3AE4AYQBtAGUACAAACxoAAABUAHkAcABPAGQAZABlAGwAbwB2AGE AYwBlAA0AAAssAAAARgBvAHIAbQBhAHQAbwB2AGEAdABDAGkAcwBsAGEAUwB0AHIAYQBuAGUAawAIAAALGAAAAFAAbwBjA GUAdABUAGEAYgB1AGwAZQBrAAgAAAsYAAAAUABvAGMAZQB0AFMAbABvAHUAcABj</Dokument> <ErrorText xmlns="urn:cz:isvs:mfcr:schemas:cedrii:dokumenty:datatypes:v100"/> <Pripona xmlns="urn:cz:isvs:mfcr:schemas:cedrii:dokumenty:datatypes:v100">doc</pripona> <VysledekDotazuKod xmlns="urn:cz:isvs:mfcr:schemas:cedrii:dokumenty:datatypes:v100">1</vysledekdotazukod> </GetOduvodneniResult> </GetOduvodneniResponse> </s:body> </s:envelope> Název souboru : Sluzba_CEDR_DOK_v_100.0.doc 16

7. Reference [1] BizTalk BizTalk TM 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/cps/rde/xbcr/mfcr/xmlkomunikace300.zip?zoom_highlight=*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/klasifik.nsf/i/ciselniky [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.20 http://cedr.mfcr.cz/smtp/cedr3prenosdat_205/documentation/sluzba_cedr_prijem_220.pdf [9] Basic Profile Version Basic Profile Version 1.1 Viz. http://www.ws-i.org/profiles/basicprofile-1.1-2004-08-24.html [10] Dokumentaci k registru UIR-ADR struktury 4.2 Viz. http://forms.mpsv.cz/uir/dokum/popisdat42.zip Název souboru : Sluzba_CEDR_DOK_v_100.0.doc 17