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



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

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

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

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

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

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

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

Popis B2B rozhraní pro elektronickou neschopenku

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

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

Michal Krátký, Miroslav Beneš

Úvod do Web Services

Tvorba informačních systémů

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

Metody tvorby ontologií a sémantický web. Martin Malčík, Rostislav Miarka

Úvod do tvorby internetových aplikací

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

TECHNICKÁ SPECIFIKACE VEŘEJNÉ ZAKÁZKY

Úvod do aplikací internetu a přehled možností při tvorbě webu

Roční periodická zpráva projektu

Správa VF XML DTM DMVS Datový model a ontologický popis

CZ.1.07/1.5.00/

Informační systém pro vedení živnostenského rejstříku IS RŽP

Výtisk č.: Počet listů 9. Přílohy: 0 ÚZIS ČR

Webové služby. Martin Sochor

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

EXTRAKT z mezinárodní normy

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

Microsoft Office 2003 Souhrnný technický dokument white paper

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

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

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

X33EJA Web Services. Martin Ptáček, KOMIX s.r.o.

Dnešní téma. Oblasti standardizace v ICT. Oblasti standardizace v ICT. Oblasti standardizace v ICT

Katalog egon služeb verze: 0.01

PŘÍLOHA C Požadavky na Dokumentaci

Schéma e-pošty. UA (User Agent) rozhraní pro uživatele MTA (Message Transfer Agent) zajišťuje dopravu dopisů. disk. odesilatel. fronta dopisů SMTP

ERP-001, verze 2_10, platnost od

(Nelegislativní akty) NAŘÍZENÍ

Verze dokumentu 0.1 duben 2016

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

Identifikátor materiálu: ICT-3-10

Jmenné Rejstříky. Novelizace zákona o archivnictví a spisové službě z zavádí novou povinnost pro určené původce vedení jmenných rejstříků

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

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

Platební systém XPAY [

Komponentový návrh SW

Webové služby a XML. Obsah přednášky. Co jsou to webové služby. Co jsou to webové služby. Webové služby a XML

Obsah prezentace. Co je to XML? Vlastnosti. Validita

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

EU-OPVK:VY_32_INOVACE_FIL9 Vojtěch Filip, 2013

Internet Information Services (IIS) 6.0

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

Microsoft Office 2003 Souhrnný technický dokument white paper

2015 GEOVAP, spol. s r. o. Všechna práva vyhrazena.

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

1 Webový server, instalace PHP a MySQL 13

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

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

POLOPROVOZ ZNALOSTNÍ DATABÁZE INTERPI DOKUMENTACE

1. Webový server, instalace PHP a MySQL 13

Logický datový model VF XML DTM DMVS

VYHLÁŠKA. ze dne o provedení některých ustanovení zákona o léčivech týkajících se elektronických receptů

Datový slovník. Datum vyhlášení :00:00. Platnost od data. Platnost do data. Název oblasti datových prvků. Verze 102

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

1 Pro účely této vyhlášky se rozumí a) základnovou stanicí základnová stanice veřejné komunikační sítě,

XML terminologie a charakteristiky. Roman Malo

Ředitel odboru archivní správy a spisové služby PhDr. Jiří ÚLOVEC v. r.

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

3.4 Základní služby Internetu

TRANSPORTY výbušnin (TranV)

Principy fungování WWW serverů a browserů. Internetové publikování

ADIS Opt-Out rozhraní na okolní systémy. Technický popis rozhraní s pojišťovnami

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

Nadpis presentace. Princip řešení komunikace mezi IS vysokých škol a maturitní databází z pohledu IS veřejné správy. Petr Hujňák.

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

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)

Co nás čeká při skartačním řízení? Připravte se na změny balíčku SIP

Kapitola 1: Úvod. Systém pro správu databáze (Database Management Systém DBMS) Účel databázových systémů

Specifika a scénáře vykazování dat AnaCredit prostřednictvím systému MtS-ISL-SÚD-SDNS

[ 1 ] Ing. Tomáš Melen náměstek pro informatiku a ekonomiku 2009 Státní ústav pro kontrolu léčiv

Identifikátor materiálu: ICT-3-03

Výměnný formát XML DTM DMVS PK

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

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

Sémantický web 10 let poté

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

EXTRAKT z technické normy ISO

ELEKTROTECHNICKÝ ZKUŠEBNÍ ÚSTAV ATESTAČNÍ STŘEDISKO reg.č. 14

Uspořádání klient-server. Standardy pro Web

TECHNICKÁ SPECIFIKACE VEŘEJNÉ ZAKÁZKY

Obecná příručka IS o ISVS

Alena Malovaná, MAL305

Aplikace pro elektronicke odesla nı da vky Listu o prohlı dce zemr ele ho a dals ı ch da vek do NZIS.

Průzkumník IS DP. Návod k obsluze informačního systému o datových prvcích (IS DP) vypracovala společnost ASD Software, s. r. o.

Transkript:

Základní zadání IS o ISVS Sluţba poskytování dat IS o ISVS podle pokynů objednatele vypracovala společnost ASD Software, s.r.o. dokument ze dne 5.12.2012, verze 1.00

Sluţba poskytování dat IS o ISVS Počet stran v dokumentu celkem: 14 2

Obsah 1 ÚVOD... 4 2 GLOBÁLNÍ CHARAKTERISTIKA ŘEŠENÍ... 4 2.1 POSKYTOVÁNÍ SEZNAMU ISVS... 4 3 TECHNICKÁ SPECIFIKACE ŘEŠENÍ... 5 3.1 POŽADOVANÉ STANDARDY PRO DATA A METADATA... 5 3.1.1 Přenosový formát dat... 5 3.1.2 Formát popisu dokumentu... 5 3.1.3 Formát interní dokumentace schémat... 5 3.2 PODPOROVANÉ ZÁKLADNÍ PŘENOSOVÉ PROTOKOLY... 5 3.3 POUŽITÁ STRUKTURA ZPRÁV (SOAP MESSAGING).... 5 3.4 POUŽITÍ A UMÍSTĚNÍ METADAT O SLUŽBĚ (POPIS SLUŽBY VE FORMÁTU WSDL)... 6 3.5 ZABEZPEČENÍ KOMUNIKACE... 6 3.6 OBECNÁ PRAVIDLA ZPRACOVÁNÍ CHYB KOMUNIKACE... 6 3.6.1 Chyby na úrovni přenosového protokolu HTTPS... 7 3.6.2 Chyby při načtení zprávy SOAP... 7 3.6.3 Chyby na úrovni validace pomocí XML Schema... 7 3.6.4 Chyby na úrovni aplikační... 7 3.6.5 Opakování chybných dotazů... 7 4 SPECIFIKACE PŘENÁŠENÝCH DAT... 8 4.1 DATOVÉ TYPY, POUŽÍVANÉ SLUŽBOU IS O ISVS... 8 4.1.1 Základní bezvýznamové datové typy ISVS... 8 4.1.2 Obecné datové typy ISVS... 8 4.1.3 Datové typy ISVS pro popis ekonomického subjektu... 9 4.1.4 Datové typy ISVS pro popis ISVS... 9 4.2 PŘEDÁNÍ SEZNAMU ISVS... 10 4.2.1 Zpráva požadavku výpisu seznamu ISVS... 10 4.2.1.1 Validace pomocí schématu... 10 4.2.2 Odpověď služby IS o ISVS... 10 4.2.2.1 Validace pomocí schématu... 10 5 DETAILNÍ PRAVIDLA PŘENOSU ZPRÁV... 11 6 ZMĚNY OPROTI PŘEDCHOZÍ VERZI... 12 REFERENCE... 13 6.1 REFERENCE... 13 6.2 POUŽITÉ POJMY... 13 6.3 POUŽITÉ ZKRATKY... 14 3

1 Úvod Tato dokumentace obsahuje specifikaci služby IS o ISVS, která slouží k předávání informací o informačních systémech veřejné správy, např. pro potřeby Registru práv a povinností (RPP). Vymezuje základní podmínky pro přenášení informací z IS o ISVS. V této podobě se jedná o pracovní materiál; od konečné podoby se tento dokument může lišit úpravami, které budou reakcí na optimální realizaci služby v tomto dokumentu popsané. 2 Globální charakteristika řešení V této části dokumentace jsou formou slovního popisu, doplněného obrazovým schématem, charakterizovány procesy, probíhající při komunikaci pomocí vytvářené služby. Popis na této úrovni postihuje celé řešení, které je popsáno jako transakce, spuštěná iniciátorem transakce (např. osobou, časovou spouští apod.) Popis má v tomto oddíle globální charakter a vyhýbá se podrobnostem, které jsou řešeny v následujících částech. Slouží k pochopení celkového pojetí řešení a jako základ pro další části dokumentace. 2.1 Poskytování seznamu ISVS Obrázek č. 1 popisuje proces poskytnutí dat (seznamu ISVS) službou IS o ISVS klientské aplikaci (např. RPP): Zpráva s požadavkem na výpis Poskytování dat IS o ISVS Klientská aplikace (RPP) Odpověď IS o ISVS s daty ISVS Obr. 1 Poskytování dat o ISVS z IS o ISVS do klientské aplikace (RPP) 1. Na straně klientské aplikace je vygenerována zpráva, obsahující žádost o poskytnutí výpisu seznamu ISVS. Spuštění přenosu se děje ad hoc uživatelem nebo systémem klienta; to znamená, že služba IS o ISVS nepočítá s existencí časového plánu přenosů. 2. Zpráva je opatřena všemi náležitostmi dle této specifikace a je odeslána pomocí protokolu HTTP na adresu služby IS o ISVS (https://www.sluzby-isvs.cz/isoisvs/isoisvs.svc). Spojení mezi komunikujícími stranami není přerušeno. 3. Služba aplikace IS o ISVS přijme zprávu s požadavkem a zpracuje ji v souladu s pravidly, stanovenými v této specifikaci. Zpět klientské straně odešle zprávu o s výsledkem zpracování dotazu (seznam ISVS / chybové hlášení). 4

3 Technická specifikace řešení V této části dokumentace jsou popsány technická východiska řešení. Jsou deklarovány požadované technické standardy. 3.1 Požadované standardy pro data a metadata 3.1.1 Přenosový formát dat Přenosovým formátem dat bude ve všech případech zpráv služby IS o ISVS formát XML. Zprávy služby ve formátu XML musejí vyhovovat standardu XML 1.0, Second Edition. Kódová stránka XML zpráv služby bude UTF-8. Zprávy v kódování UTF-8 mohou obsahovat úvodní indikaci kódové stránky (Byte Order Mark - BOM). XML dokumenty zpráv budou mít připojenu deklaraci XML. 3.1.2 Formát popisu dokumentu Pro popis struktury zpráv a sémantiky dat, přenášených pomocí zpráv služby IS o ISVS, bude použit standard XML Schema. Implementace schémat se bude řídit metodickým dokumentem Metodika tvorby XML schémat v oblasti informačních systémů veřejné správy [2]. 3.1.3 Formát interní dokumentace schémat Schémata budou dostatečně dokumentována. Interní dokumentace schémat bude založena na standardu RDF a Dublin Core. 3.2 Podporované základní přenosové protokoly Pro přenos všech typů XML zpráv služby IS o ISVS se bude používat pouze komunikační protokol HTTPS. Pravidla pro použití protokolu HTTP(S) se budou řídit podle kapitoly 5.4.1.1 dokumentu Metodika komunikace na bázi XML - Použití ve finančních, kontrolních a podpůrných informačních systémech [1]: Protokol HTTP musí obsahovat ve svém záhlaví indikaci kódové stránky neseného XML dokumentu pomocí parametru charset. Znaková stránka, uvedená v deklaraci XML pro XML dokument, by se měla shodovat s kódovou stránkou protokolu HTTP. V případě rozporu bude kódová stránka XML dokumentu vždy ignorována. Protokol HTTP musí obsahovat ve svém záhlaví indikaci typu obsahu neseného XML dokumentu pomocí parametru content-type. Tento parametr bude pro XML dokumenty zpráv IS o ISVS nabývat hodnoty application/xml. Pro přenos zpráv XML služby IS o ISVS se bude používat protokol HTTP verze 1.1. Pro přenos zpráv XML služby IS o ISVS se bude používat metoda HTTP POST. Použití záhlaví SoapAction protokolu HTTP pro službu IS o ISVS není povoleno. Služba IS o ISVS, komunikující pomocí protokolu HTTPS, bude používat TCP port 443. Služba IS o ISVS bude používat při komunikaci stavové kódy HTTP. Pro rozhodnutí o výsledku přenosu zpráv však bude závazný obsah zprávy XML; stavový kód HTTP bude považován pouze za informativní údaj. 3.3 Použitá struktura zpráv (SOAP messaging). Služba IS o ISVS bude nad internetovým protokolem HTTPS používat nadstavbový XML protokol SOAP ve verzi 1.1. Webová služba IS o ISVS bude protokol SOAP používat v souladu se specifikací organizace WS-Interoperability Basic Profile Version 1.0a. Struktura zprávy SOAP bude následující: Zpráva bude nesena zvoleným přenosovým protokolem HTTPS. 5

Zpráva bude obsahovat povinnou obálku SOAP ve standardním formátu (bez uživatelských elementů) podle specifikace standardu SOAP 1.1. Zpráva bude obsahovat povinné záhlaví SOAP 1.1. Zpráva bude obsahovat tělo zprávy SOAP. Zpráva bude obsahovat v těle zprávy SOAP buď element XML souboru příslušné zprávy IS o ISVS, nebo element <Fault> s indikací případného problému na úrovni komunikace. Element <Fault> a elementy XML souborů zpráv se vylučují, zpráva tedy nesmí obsahovat data (elementy XML souborů zpráv) a element <Fault> současně. 3.4 Použití a umístění metadat o službě (popis služby ve formátu WSDL) Webová služba IS o ISVS bude popsána ve formátu WSDL 1.1 v souladu s doporučeními specifikace WS-I Basic Profile Version 1.0a. Soubor WSDL bude umístěn na URL adrese: https://www.sluzby-isvs.cz/isoisvs/isoisvs.svc?wsdl=wsdl0 3.5 Zabezpečení komunikace Služba IS o ISVS bude mít implementované následující bezpečnostní funkce: důvěrnost přenášených dat integritu přenášených dat důvěrnost spojení integritu spojení Technické řešení implementovaných bezpečnostních funkcí bude zabezpečeno použitím protokolu HTTPS. Všechny operace a zprávy služby budou mít bezpečnostní funkce implementovány stejným způsobem. 3.6 Obecná pravidla zpracování chyb komunikace Zpracování chyb bude ošetřeno v souladu se zásadami uvedenými v [1], kap. 5.8.1. Dojde-li při zpracování zprávy k chybě na úrovni celé zprávy (není možno vrátit žádnou požadovanou informaci) a je vyžadována odpověď, služba odpoví zařazením elementu <Fault> do těla zprávy odpovědi. Indikace důvodu chyby bude řešena výběrem ze seznamu chybových kódů. Seznam chybových kódů bude následující: VersionMismatch nesouhlasí verze jmenného prostoru elementu obálky SOAP. MustUnderstand přijímající strana dokonale neporozuměla elementu s atributem MustUnderstand= 1, obsaženému v záhlaví dokumentu SOAP. Client indikuje výskyt klientských chyb, např. dokument neodpovídá schématu, syntaktická chyba dokumentu apod. Server indikuje výskyt chyb na straně služby. Client.RequestNamespace nepodporovaná verze dotazu. Jmenný prostor dokumentu dotazu neodpovídá verzi, aktuálně podporované službou. Client.SchemaNamespace nepodporovaná verze namespace pro validaci parserem. Client.Validity chyba ověření validity dokumentu. Client.WellFormedness chyba ověření správného strukturování dokumentu. Server.Program interní chyba serverové aplikace Server.Service obecná chyba serverové služby Client.Validity.Schema (chyba validace pomocí XML Schema) Třídy chyb Client a Server znamenají generické třídy chyb. Obvykle se samostatně nevyskytnou a jsou používány s extenzí; nic však v indikovaných případech nebrání jejich použití. 6

Seznam chybových kódů bude využit jak v elementu <Fault>, tak i případně ve výstupních dokumentech validačních šablon. Webová služba IS o ISVS může vložit k aktuální chybě doplňující informaci. Pokud je doplňující informace použita, bude vložena do subelementu <Detail> odpovědi SOAP. 3.6.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.6.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. 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.6.3 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. 3.6.4 Chyby na úrovni aplikační Tyto chyby se týkají např. selhání aplikační databáze IS o ISVS, 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 o ISVS budou zprávy odmítány jako celek. 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 [1], kap. 5.8.1. 3.6.5 Opakování chybných dotazů Za zopakování chybných dotazů je zodpovědný odesílatel zprávy. 7

4 Specifikace přenášených dat V této části jsou specifikována přenášená data. Veškerá data, přenášená ve zprávách služby IS o ISVS, vycházejí z datových prvků ISVS, publikovaných v informačním systému o datových prvcích (IS DP). Pokud je datový prvek, definovaný v IS DP a publikovaný v XML schématech IS DP, možno použít přímo, je na takový prvek přímý odkaz ve schématech zpráv. V jednotlivých skupinách datových typů, uvedených dále v kapitole 4.1, jsou uvedeny jen ty datové typy, vyskytující se při komunikaci se službou IS o ISVS. 4.1 Datové typy, používané službou IS o ISVS V této kapitole jsou uvedeny veškeré datové typy, používané při komunikaci se službou IS o ISVS. 4.1.1 Základní bezvýznamové datové typy ISVS Základní bezvýznamové datové typy ISVS jsou používány pro XML schémata jednoduchých a komplexních datových typů ISVS a v rámci celého systému IS VS ČR. Satové typy vznikly na základě a s využitím filosofie schématu Core Component Types UBL (Universal Business Language). Ze základních datových typů vycházejí všechny ostatní datové typy ISVS, publikované v IS DP. XML schéma základních datových typů je dostupné na adrese http://www.sluzbyisvs.cz/isdp/xsd/corecomponenttypes.xsd. Název Typ Popis IdentifikatorType TextType DatumCasType xs:string xs:string xs:string Znakový řetězec jednoznačně identifikující instanci příslušného objektu od ostatních objektů v rámci jednoho identifikačního schématu; volitelně spolu s doplňkovými informacemi o údaji. Znakový obecně ve formátu volného textu i více slov; volitelně spolu s doplňkovou informací o jazyku. Hodnota konkrétního bodu v časové ose volitelně spolu s doplňkovou informací o formátu údaje. Používá se pro datum a/nebo čas. 4.1.2 Obecné datové typy ISVS Název Typ Od Do Maska Popis DatumXMLType cct:datumcastype 10 10 Obecné datové typy ISVS představují definice jednoduchých i složených datových prvků, používaných pro ostatní XML schémata ISVS včetně ostatních schémat datových prvků a v rámci celého systému ISVS ČR. Na rozdíl od bezvýznamových datových typů již většinou nesou konkrétní význam. Jsou používány napříč oblastmi veřejné správy. XML schéma obecných datových typů je dostupné na adrese http://www.sluzbyisvs.cz/isdp/xsd/isvs_common.xsd. \d{4}-((02-([0][1-9] [1- Datum vyjadřuje den, měsíc, rok 2]\d)) (04 06 09 11 příslušného aktu, k němuž se )-(30 [0][1-9] [1- vztahuje. Prezentace data odpovídá 2]\d) (01 03 05 07 formátu xs:date XML Schema. 08 10 12)- (30 31 [0][1-9] [1-8

2]\d)) 4.1.3 Datové typy ISVS pro popis ekonomického subjektu Tyto datové typy ISVS jsou používány pro identifikaci a popis ekonomického subjektu. XML schéma datových typů ekonomického subjektu je dostupné na adrese http://www.sluzbyisvs.cz/isdp/xsd/isvs_business.xsd. Název Typ Od Do Maska Popis SubjektICOType cct:identifikatortype 8 8 \d{8} SubjektObchodniJ menotype cct:texttype 1 255 Identifikační číslo (IČ) je číslicový pořadový kód, který slouží k jednoznačné identifikaci ekonomických subjektů. Ekonomickým subjektem je každá právnická osoba a dále fyzické osoby, které mají podle zvláštního předpisu postavení podnikatele. Obchodním jménem se rozumí název, pod kterým podnikatel činí právní úkony při své podnikatelské činnosti. Obchodní jméno fyzické osoby je její jméno a příjmení, popř. dodatek, odlišující osobu podnikatele nebo druh podnikání. Obchodní jméno obchodních společností a družstev je název, pod kterým jsou zapsány v obchodním rejstříku resp. živnostenském rejstříku. Součástí obchodního jména právnické osoby je i dodatek označující jejich právní formu. Obchodním jménem právnické osoby, která se nezapisuje do obchodního rejstříku, je název, pod kterým byla zřízena.. 4.1.4 Datové typy ISVS pro popis ISVS Tyto datové typy ISVS jsou používány pro identifikaci a popis informačního systému veřejné správy. XML schéma datových typů informačního systému veřejné správy je dostupné na adrese http://www.sluzby-isvs.cz/isdp/xsd/isvs_isvs.xsd. Název Typ Od Do Maska Popis InformacniSystem IdentifikatorType InformacniSystem NazevType cct:identifikatortype 7 7 \d{1,7} cct:identifikatortype 1 255 Unikátní identifikační kód v systému, který přiděluje ministerstvo; přidělován je každému ISVS. Jedná se o bezvýznamový identifikátor ve formátu celého čísla. Název ISVS, který používá správce daného systému. 9

InformacniSystem VerzeType InformacniSystem SpravceType cct:identifikatortype 1 25 bus:subjektobchodnij menotype 1 255 Verze daného ISVS, odpovídající aktuálnímu zápisu v IS o ISVS. Název orgánu veřejné správy, který je správcem ISVS. 4.2 Předání seznamu ISVS 4.2.1 Zpráva požadavku výpisu seznamu ISVS Název kořenového elementu zprávy: VypisISVSPozadavek Seznam subelementů: Název Typ/Odkaz Min. vyskyt Max. vyskyt VypisOdDatum cmn:datumxmltype 0 1 Popis struktury zprávy je definován schématem zprávy, dostupným na URL adrese http://www.sluzby-isvs.cz/isoisvs/schemas/isvs_request.xsd 4.2.1.1 Validace pomocí schématu Zpráva je validována schématem, dostupným na URL adrese http://www.sluzby-isvs.cz/isoisvs/schemas/isvs_request.xsd 4.2.2 Odpověď služby IS o ISVS Zpráva přenáší odpověď po přijetí požadavku na výpis seznamu ISVS. Název kořenového elementu zprávy: VypisISVSOdpoved Seznam subelementů: Nazev Typ/Odkaz Min. vyskyt Max. vyskyt ISVSSeznam 1 1 ISVS 0 n Identifikator isvs:informacnisystemidentifikatortype 1 1 Nazev isvs:informacnisystemnazevtype 1 1 Verze isvs:informacnisystemverzetype 1 1 SpravceNazev isvs:informacnisystemspravcetype 1 1 SpravceIC bus:subjekticotype 1 1 PlatnostOdDatum cmn:datumxmltype 1 1 Popis struktury zprávy je definován schématem zprávy, dostupným na URL adrese http://www.sluzby-isvs.cz/isoisvs/schemas/isvs_response.xsd 4.2.2.1 Validace pomocí schématu Zpráva je validována schématem, dostupným na URL adrese http://www.sluzby-isvs.cz/isoisvs/schemas/isvs_response.xsd 10

5 Detailní pravidla přenosu zpráv Tato část dokumentace upřesňuje, jak zprávy, definované v části specifikace dat (4), jsou přenášeny v souladu s technickou specifikací (3). Detailní pravidla přenosu zpráv pro každý typ přenášené zprávy stanoví striktní pravidla životního cyklu zprávy. Životní cyklus zprávy na straně služby lze podrobně rozepsat v následujících bodech: 1. Odesílající strana (např. klient RPP) vygeneruje zprávu, přenášející data dotazu. 2. Klient se prostřednictvím sítě Internet spojí protokolem HTTPS se službou na adrese https://www.sluzbyisvs.cz/isoisvs/isoisvs.svc a odešle zprávu. Pokud dojde k selhání přenosu na úrovni protokolu HTTPS, 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. 3. Zpráva je přijata službou 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. 4. 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. 5. 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 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. 6. Zpráva je zpracována procedurami přijímající aplikace IS o ISVS 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. 7. Klientovi je zaslána standardní zpráva SOAP s odpovědí. Chování klientské strany v případě komplikací s přenosem se bude řídit podle logiky, uvedené v následujícím odstavci. Za zopakování přenosu je vždy zodpovědný odesílatel zprávy. V zásadě může odesílající strana detekovat tyto situace: 1. Služba vrátila požadovaná data. V tomto případě je zpracování v pořádku, není vyžadována žádná další akce. 11

2. Služba vrátila potvrzení chybného přijetí zprávy nebo potvrzení chybného zpracování zprávy, kdy zpráva je odmítnuta jako celek. Chování klientské strany se řídí v tomto případě kódem chyby v elementu <Faultcode>. Kód Server.Program - v tomto případě klientská strana zopakuje zprávu znovu se stejným obsahem jako v původní zprávě. Kód Client.General - v tomto případě klientská strana odstraní nedostatky ve zprávě, upřesněné v elementu <Detail> obálky SOAP, a odešle opravenou zprávu znovu s odlišným obsahem. Kód Client.WellFormedness - v tomto případě klientská strana odstraní nedostatky ve zprávě a odešle opravenou zprávu znovu s odlišným obsahem jako v původní zprávě. Kód VersionMismatch - v tomto případě klientská strana odstraní nedostatky ve zprávě a odešle opravenou zprávu znovu s odlišným obsahem jako v původní zprávě. Kód Client.Validity.Schema - v tomto případě klientská strana odstraní nedostatky ve zprávě a odešle opravenou zprávu znovu s odlišným obsahem jako v původní zprávě. 3. Služba nevrátila žádnou zprávu V tomto případě klientská strana zopakuje zprávu znovu se stejným obsahem jako v původní zprávě. 6 Změny oproti předchozí verzi Č. Popis změny Verze Datum 12

Reference 6.1 Reference [1] 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 3.00 ASD Software, s.r.o. 2004. Viz. http://www.mfcr.cz/download/xml/xmlkomunikace.zip [2] Metodika XML schémat ISVS Metodika tvorby XML schémat v oblasti informačních systémů veřejné správy. Ministerstvo informatiky ČR, 25.ledna 2004 URL: http://www.mvcr.cz/clanek/metodika-tvorby-xml-schemat-v-oblasti-informacnich-systemu-verejnespravy.aspx 6.2 Použité pojmy Dokument definice sluţby (service description document) dokument, obsahující popis služby, který je využitelný klientskou aplikací pro automatické navázání spojení se službou. Sestává se z popisu rozhraní, sémantiky a popisu zpráv, vyměňovaných během scénáře výměny zpráv. Důvěrnost (confidentiality) charakteristika informace, která znemožňuje odhalení informace neautorizovanou entitou. Informační systém funkční celek nebo jeho část zabezpečující cílevědomou a systematickou informační činnost. Každý informační systém zahrnuje data, která jsou uspořádána tak, aby bylo možné jejich zpracování a zpřístupnění, a dále nástroje umožňující výkon informačních činností. Informační systém veřejné správy (ISVS) ve smyslu zákona č. 365/2000 Sb., o informačních systémech veřejné správy nebo dle kontextu více informačních systémů veřejné správy ve smyslu tohoto zákona. Interoperabilita (interoperability) schopnost informačního systému využívat funkčnost jiných informačních systémů a/nebo poskytovat vlastní funkčnost pro využití jinými informačními systémy. Odesílatel zprávy (message sender) agent, vytvářející a odesílající zprávu Příjemce zprávy (message recipient) agent, stanovený odesílatelem zprávy jako adresát (consumer) zprávy. Poskytovatel sluţby (service provider) subjekt, poskytující službu Scénář výměny zpráv (message exchange pattern) minimální sada zpráv, zahrnující jak zprávy odesílatele zpráv, tak příjemce zpráv, vyměňovaná během jednoho použití služby. Sémantika (semantics) význam, smysl či faktický obsah nějakého konceptu. Sluţba (service) sada úkolů, tvořící z pohledu poskytovatele služby i žadatele služby jeden celek. Subjekt entita s právní subjektivitou (právnická či fyzická osoba). Syntaxe (syntax) způsob zápisu určité informace. Sémanticky identický popis entity (např. datové) může být zapsán v různé syntaxi (např. v relačním modelu, hierarchickém modelu) Webová sluţba (web service) softwarová aplikace, identifikovaná pomocí URI, jejíž veřejná rozhraní jsou definována a popsána pomocí XML. Jiné aplikace mohou interagovat s webovou službou způsobem předepsaným její definicí pomocí zpráv XML, předávaných pomocí internetových protokolů. 13

Zpráva (message) základní jednotka výměny dat mezi agenty (odesílatelem zprávy a příjemcem zprávy). Ţadatel (service requester) subjekt nebo jiná entita, dotazující se na službu. 6.3 Použité zkratky BOM Byte Order Mark DTD Document Type Definition HTML Hypertext Markup Language HTTP HyperText Transfer Protocol. HTTPS HyperText Transfer Protocol Secure IETF Internet Engineering Task Force IS Informační systémy IS DP Informační systém datových prvků IS o ISVS Informační systém o informačních systémech veřejné správy ICT Informační a komunikační technologie ISVS Informační systémy veřejné správy RDF Resource Description Format SOAP Simple Object Access Protocol UBL Universal Business Language URI Uniform Resource Identifier URL Uniform Resource Locators URN Uniform Resource Names W3C World Wide Web Consortium WS Web Services WSDL Web Services Description Language WWW World Wide Web XML Extensible Markup Language XSLT Extensible Stylesheet Language for Transformations 14