ISZR - eGon služby

1. ISZR -eGon služby Michal Kolařík Josef Halámek 23.3.2012

2. 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.05891 Projekt 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.

3. Agenda • Práce s údaji v ZR • Současný stav ISZR • eGon služby • Struktura služeb • Volání služeb • Distribuce změn

4. 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

5. Zajištění aktualizace dat • 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

6. 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

7. 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.).

8. 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)

9. 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>

10. 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>

11. 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. • eGONslužby – reklamační • eGON služby – servisní

12. 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 • Prioritizaceslužeb (PrioritaAis) • Opakované volání služby při omezení dat („stránkování“)

13. Distribuce změn • Hromadná distribuce změn • Služby pro načtení změn za daný čas (E28, E38) • Notifikace (datové schránky)

14. 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

15. 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ů.

16. 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ů.

17. 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žby

18. Poskytované služby – definice služby

19. Kde hledat podporu? • http://www.szrcr.cz/vyvojari • Katalog eGON služeb • XSD, WSDL popis rozhraní • Žádost o vydání certifikátu • Vývojářské fórum • Jednotné kontaktní místo • podpora@szrcr.cz • tel: +420 236 031 751