ISZR -eGon služby

Michal KolaříkJosef Halámek

23.3.2012

Zavádíme a provozujeme užitečné informační technologie v organizacích.

Informační systém základních registrů

Informační systém základních registrůRegistrační číslo: CZ.1.06/1.1.00/03.05891Projekt Informační systém základních registrů byl spolufinancován z prostředků Evropské unie, Evropského fondu pro regionální rozvoj prostřednictvím Integrovaného operačního programu.Šance pro Váš rozvoj.

2

Zavádíme a provozujeme užitečné informační technologie v organizacích.

Agenda

Práce s údaji v ZR

Současný stav ISZR

eGon služby Struktura služeb Volání služeb Distribuce změn

3

Zavádíme a provozujeme užitečné informační technologie v organizacích.

Práce s údaji v základních registrech

Musí AIS neustále číst data přímo ze základních registrů ?

NE

Data v Agendovém systému musí být V SOULADU s referenčními údaji v Základních registrech

Zajištění tohoto souladu a optimalizace všech procesů je věcí implementátora/správce AIS

4

Zavádíme a provozujeme užitečné informační technologie v organizacích.

Hromadná distribuce změn: Pravidelná - ISZR připravuje každý den změny za poslední kalendářní den

(AIS musí tento proces spouštět v definovaném okamžiku) Nepravidelná – AIS může sám zažádat o zaslání změn v libovolný okamžik,

v tomto případě určuje počáteční (a případně koncový) okamžik změn.

Distribuce změn – příklad ROS: AIS volá eGON službu rosCtiZmeny

AIS ve výsledku služby získá odkaz na seznam IČO, u kterých došlo ke změně.

AIS volá eGON službu rosCtiSeznamICO pro čtení informací z ROS podle IČO pro vybrané IČO (vedené ve své evidenci – filtruje si před voláním získaný seznam) a aktualizuje svoje lokální data

AIS získává aktualizované informace o právnických osobách vedených v lokální databázi

Zajištění aktualizace dat

Zavádíme a provozujeme užitečné informační technologie v organizacích.

Současný stav ISZR

Dostupné instance ISZR Testovací prostředí

Publikační testovací prostředí Editační testovací prostředí

Provozní prostředí Dostupné v DC ČP

Vystaven katalog služeb v 7.0 Finální definice služeb

6

Zavádíme a provozujeme užitečné informační technologie v organizacích.

eGon služby

Základním principem eGON služeb je nastavení společných norem, respektive standardů: použití WSDL 1.1, použití SOAP 1.1, použití WS-I Basic Profile 1.1, použití SOAP/HTTP binding (HTTP bude komunikační protokol mezi systémy), použití soapAction pro všechny operace (nad požadavek WS-I Basic Profile 1.1), použití scénáře pro výměnu zpráv, MEP: In-Out, všechny QoS v separátním Policy dokumentu, na který se odkazuje z WSDL

dokumentu, pro přenos binárních dat použití MTOM/XOP (nad požadavek WS-I Basic Profile

1.1), XSD schéma pro popis katalogů, jednotný katalog pro společné struktury, jednotná metodologie pro tvorbu názvů WSDL elementů, jednotný systém verzování webových služeb, zabezpečení webových služeb pomocí komunikační vrstvy (nepoužívá se WS-

Security, XML-Signature a XML-Encryption, atd.).

7

Zavádíme a provozujeme užitečné informační technologie v organizacích.

Volání eGon služeb

Při volání eGON služby AIS povinen předat informace: o identifikaci uživatele, který službu přímo či nepřímo inicioval –

uživatelský identifikátor, o důvodu a konkrétním účelu využití služby, pokud to zákon

požaduje, o subjektu, pro jehož účely se údaje využívají nebo poskytují,

pokud to zákon požaduje, o OVM, pro který je služba vykonávána, o agendě, na základě které volání probíhá, o agendové roli, která službu využívá

Identifikace požadavků IszrZadostId - UUID - generuje ISZR – jedinečný

globálně AgendaZadostId – generuje AIS (jedinečný pro AIS)

8

Zavádíme a provozujeme užitečné informační technologie v organizacích.

Volání eGon služeb - volání

<urn1Iszr:ZadostInfo ><reg:CasZadosti>2012-03-07T10:17:00.000Z</reg:CasZadosti> <reg:Agenda>EO</reg:Agenda> <reg:AgendovaRole>EDITOR</reg:AgendovaRole> <reg:Ovm>EO</reg:Ovm> <reg:Ais>25</reg:Ais> <reg:Subjekt>Subjekt1</reg:Subjekt> <reg:Uzivatel>Uzivatel1</reg:Uzivatel> <reg:DuvodUcel>Důvod a Účel1</reg:DuvodUcel> <reg:AgendaZadostId>a3ec3188-4da1-4668-8d7d-1c32fbb538f0 </reg:AgendaZadostId> </urn1Iszr:ZadostInfo>

9

Zavádíme a provozujeme užitečné informační technologie v organizacích.

Volání eGon služeb - odpověď

<abs:OdpovedInfo><reg:CasOdpovedi>2012-03-07T10:17:01.2601441+01:00 </reg:CasOdpovedi> <reg:Status><reg:VysledekKod>OK</reg:VysledekKod> </reg:Status><reg:AgendaZadostId>a3ec3188-4da1-4668-8d7d-1c32fbb538f0 </reg:AgendaZadostId> <reg:IszrZadostId>749a250a-32ac-4562-a80e-72c957694251 </reg:IszrZadostId> </abs:OdpovedInfo>

10

Zavádíme a provozujeme užitečné informační technologie v organizacích.

eGon služby

eGON služby : editační dotazovací

služby referenční – služby umožňující čtení referenčních údajů z jednoho nebo kombinující údaje z více základních registrů,

služby informační - pro přístup ke službám spolupracujících AIS – služby umožňující čtení informací z jiných AIS napojených na systém ISZR jako poskytovatel služby .

eGON služby – reklamační eGON služby – servisní

11

Zavádíme a provozujeme užitečné informační technologie v organizacích.

eGon služby

Režimy služeb Synchronní https://egon.gov.cz/publikace/E03?sync Asynchronní https://egon.gov.cz/publikace/E03?async

pasivní režim odpovědi Asynchronní fronta (E100, E99, E101) aktivní režim odpovědi (ws-addressing,

IszrAsyncPushOdpovedZFronty.wsdl)

Serializace asynchronních požadavků - AgendaZadostId Prioritizace služeb (PrioritaAis) Opakované volání služby při omezení dat („stránkování“)

12

Zavádíme a provozujeme užitečné informační technologie v organizacích.

Distribuce změn

Hromadná distribuce změn Služby pro načtení změn za daný čas (E28, E38)

Notifikace (datové schránky)

13

Zavádíme a provozujeme užitečné informační technologie v organizacích.

eGon služby

Z hlediska dostupnosti služby: S1 – služby poskytující pouze individuální referenční

údaje či logické odpovědi na základě jednoznačného identifikátoru prvku (AIFO, IČO, adresní bod)

S2 – služby poskytující hromadné referenční údaje či logické odpovědi

S3 – služby poskytující výběrové informace nebo vyhledání podle souboru atributů,

S4 – služby poskytující informační nebo provozní údaje

14

Zavádíme a provozujeme užitečné informační technologie v organizacích.

Struktura eGon služeb

Systémová část (ZadostInfo, AutorizaceInfo, MapaAifo, SeznamIdAdres ) slouží pro přenos řídících informací mezi zúčastněnými

systémy, systémová část je definována ve společném katalogu typů, v systémové části jsou uloženy informace:

identifikace požadované služby, popis žádosti o službu (agenda, AIS, subjekt, uživatel, důvod, …), autorizační omezení a požadované údaje, mapování AIFO, seznam adres a prvků.

15

Zavádíme a provozujeme užitečné informační technologie v organizacích.

Struktura eGon služeb

Aplikační část eGON služby: slouží pro přenos aplikačně specifických dat, obsah aplikační části je pro většinu služeb pro ISZR

transparentní. obsah aplikační části odpovědi vzniká zřetězením

jednotlivých odpovědí ze základních registrů.

16

Zavádíme a provozujeme užitečné informační technologie v organizacích.

Poskytované služby

Katalog služeb Dostupný na www.szrcr.cz

Třídy služeb E – editační služby realizující zápis, změnu či výmaz S1 – služby poskytující pouze individuální referenční údaje na základě

jednoznačného identifikátoru (AIFO, IČO, adresní bod) či logické odpovědi S2 – služby poskytující hromadné referenční údaje či hromadné logické odpovědi S3 – služby poskytující výběrové informace nebo vyhledání prvku dle souboru

atributů S4 – služby poskytující informační nebo provozní údaje

SLA služeb Maximální doba zpracování služby

Synchronní/asynchronní služby17

Název Označení Verze Platnost Třída Režim SLA Popis Parametry Výstup WSDL XSD

Zavádíme a provozujeme užitečné informační technologie v organizacích.

Poskytované služby – definice službyNázev služby rosVlozOsobuOznačení služby

E18

Vzniklo ve verzi 2.00Stav rozhraní finální definicePlatnost od 30.9.2011Platnost do Nahrazeno Třída služby ERežim služby AsynchronníSLA služby SLA-NAPopis služby rosVlozOsobuChování a kontroly

Služba zakládá nový záznam osoby v registru. Vstupní údaje musí obsahovat validní referenční údaje (IČO se správnou kontrolní číslicí, referenční údaje musí odpovídat údajům, pro něž bylo IČO vydáno). Záznam není založen, pokud je IČO duplicitní a pokud jde o zápis fyzické osoby ani pokud je AIFO duplicitní. ROS kontroluje, zda AIS má oprávnění založit osobu s udanou právní formou. Pokud IČO nebylo vydáno pro zaslané referenční údaje, vrací služba chybový status s očekávanými údaji. Pokud je IČO nebo AIFO duplicitní, vrátí služba chybový status.

Popis vstupních parametrů

IČO a referenční údaje osoby. Povinné údaje jsou datum vzniku nebo zápisu do evidence, právní forma, a adresa sídla nebo místa podnikání. Pro fyzickou osobu jsou povinné dále AIFO (je-li možné je určit), a pokud není známo AIFO je povinnými údaji dále jméno (jména) a příjmení a adresa místa pobytu. Jedná-li se o fyzickou osobu, obchodní firma je naplněna jménem a příjmením. Pro právnické osoby je povinným parametrem také obchodní jméno a vstupní údaje mohou obsahovat i identifikaci satutárních zástupců.

Popis výstupní hodnoty

identifikátor změny, časový okamžik změny a status, případně detailní popis chyby

WSDL služby egon/wsdl/IszrRosVlozOsobu.wsdlXSD služby egon/xsd/IszrRosVlozOsobu.xsd

18

Zavádíme a provozujeme užitečné informační technologie v organizacích.

Kde hledat podporu?

http://www.szrcr.cz/vyvojari Katalog eGON služeb XSD, WSDL popis rozhraní Žádost o vydání certifikátu

19

Vývojářské fórum Jednotné kontaktní místo

podpora@szrcr.cz tel: +420 236 031 751