Správci a vývojáři
V ZR ROS je již delší dobu implementována funkcionalita, která nyní začíná být plně využívána. V tomto kontextu byl již několik verzí nazpátek v xsd (04/2022) zaveden element IcoKontrola, který se typicky využívá v response pro návrat hodnot pro osoby, ať již PO či PFO. V předchozích verzích se naplno nevyužívalo této funkcionality, takže se tento element ve výstupech neobjevoval. Nyní se jeho plnění již stává součástí připravované verze ROS, takže v prostředí ČSÚ TEST se již nějakou dobu objevuje v response vyplněný. Z pohledu ROS se nejedná o novou funkcionalitu, protože tento element byl v xsd publikován již dříve a na jeho existenci by měly být agendy přistupující do ROS připraveny.
Bylo již zaregistrováno několik případů, kdy při testování aplikací byly nahlášeny problémy, které ve svém důsledku souvisí s výskytem elementu IcoKontrola a které se projevují typicky tím, že v response jsou jakoby neúplná data. Typicky se to dá poznat např. na elementech CasZmeny a Idzmeny, které de facto nejsou vyplněny, respektive jsou vyplněny "nulovými" hodnotami a ne skutečnými, viz příklad:
<CasZmeny xmlns="urn:cz:isvs:ros:schemas:RosDotazyTypy:v1">0001-01-01T00:00:00</CasZmeny>
<IdZmeny xmlns="urn:cz:isvs:ros:schemas:RosDotazyTypy:v1">0</IdZmeny>
Doporučujeme tedy všem agendám a příslušným AIS prověřit, že používají ve svých službách aktuální poskytované api
Na produkci bude funkcionalita včetně naplnění elementu aktivována 1.7. 2024.
Po vytvoření žádosti s veřejným klíčem je potřeba tuto žádost nahrát do aplikace RAZR:
Další informace: Připojení agendových informačních systémů k základním registrům
Přístup z internetu: https://razr.egon.gov.cz/
Přístup z CMS: https://razr.egon.cms2.cz/
Doporučený postup pro vytvoření žádosti o digitální certifikát pro přístup k ISZR a ISSS je pomocí aplikace
Postup_pro_vytvoreni_zadosti_o_digitalni_certifikat_ ISZR_ISSS_Aplikaci.pdf1.13 MB22/04/2024, 12:07 |
GeneratorCertRAZR.zip1.56 MB11/12/2023, 07:00 Po stažení aplikace je potřeba napřed soubor rozbalit do pracovního adresáře odkud budete aplikaci spouštět. |
Vytvoření žádosti o digitální certifikát pro přístup k ZR a ISSS pomocí knihovny OpenSSL
Informační systém sdílené služby (ISSS) je základní rozhraní propojeného datového fondu veřejné správy.
Je určen ke sdílení údajů mezi jednotlivými agendovými informačními systémy veřejné správy (AIS).
Pokud orgán veřejné moci na základě zákonného zmocnění vede ve své agendě evidenci údajů, má povinnost tyto údaje publikovat prostřednictvím ISSS pro ostatní agendy, které mají ze zákona možnost tyto údaje využívat.
Správcem a provozovatelem ISSS je Digitální a informační agentura.
ISSS byl dříve označován jako eGon Service Bus (eGSB).
Veškeré požadavky související s ISSS/eGSB je nutné zadat do aplikace Service Desk Manager SZR.
Z důvodu vyšší přehlednosti a urychlení vyřízení požadavku při zadávání zadejte do položky Souhrn text ve formátu: ISSS – xxxxxxxx (např. ISSS – zaslání kontextu ke schválení).
Dokumentace k ISSS:
Průvodci připojením k propojenému datovému fondu
- Připojení_čtenářského_AIS_k_ISSS.pdf1.04 MB
- Připojení_publikačního_AISSSVÚ_k_ISSS_.pdf1 MB
- Publikace AIS na ISSS2.41 MB
- Využití služeb ISSS čtenářskými a publikačními AIS.pdf1.19 MB
- Katalog služeb ISSS.pdf634.19 KB
Popisy jednotlivých služeb ISSS
- Xsd_popis_sluzeb_20240229.zip1.64 MB – soubor .zip
- Metodika tvorby kontextů.pdf655.64 KB
- Metodika realizace nového kontextu subjektu či objektu práva předávaného prostřednictvím ISSS.pdf318.94 KB
Co jsou kompozitní služby:
kompozitní služby jsou eGON služby informačního systému základních registrů, které poskytují údaje vedené v základních registrech a v agendových informačních systémech.
Účel kompozitních služeb:
kompozitní služby slouží k usnadnění identifikace a následnému ztotožnění subjektů vedených v různých evidencích využitím nereferenčních údajů, které nejsou obsaženy v základních registrech.
Seznam kompozitních služeb:
Číslo služby: | Systém: | Poznámka: | Nahrazující služba: |
E158 - aiseoZtotozneni | AISEO | Na produkčním prostředí | E158 |
E171 - aiseoCtiAifo2 | AISEO | Na produkčním prostředí | |
E172 - aiseoCtiPodleUdaju2 | AISEO | Na produkčním prostředí | |
E173 - aiscCtiAifo2i | AISC | Na produkčním prostředí | |
E174 - aiscCtiPodleUdaju2 | AISC | Na produkčním prostředí | |
E188 - eopCtiAifo | AISEOP | Na produkčním prostředí | |
E189 - ecdCtiAifo | AISECD | Na produkčním prostředí | |
E191 - eopCtiHromadneAifo | AISEOP | Na produkčním prostředí | |
E192 - ecdCtiHromadneAifo | AISECD | Na produkčním prostředí | |
E194 - eopCtiPodleUdaju | AISEOP | Na produkčním prostředí | |
E195 - ecdCtiPodleUdaju | AISECD | Na produkčním prostředí | |
E197- agendaMediaDataCtiAifo | AISECD, AISEOP | Na produkčním prostředí | |
E198 - agendaMediaDataCtiPodleUdaju | AISECD, AISEOP | Na produkčním prostředí |
Rozdíly v kompozitních službách AISEO:
Přiložený soubor obsahuje popis rozdílů funkčnosti původních a nových kompozitních služeb AISEO.
Rozdíly v kompozitních službách (115,86 KB).
XSD soubory nových kompozitních služeb AISEO:
Přiloženy jsou XSD soubory pro služby E158, E171 a E172.
Související dokumenty:
V dokumentech níže jsou popsány konkrétní kroky nezbytné pro nastavení přístupu k údajům v AISEO, AISC, AIS EOP a AIS ECD.
Proces_pripojovani_do_AIS_EO_v_2.2.pdf128.06 KB
Proces_připojování_do_AIS_C_v 3.1.pdf132 KB
Proces_pripojovani_do_AIS_EOP_AISECD_a_MediaData_v2.2.pdf125.70 KB
Pokud chce některý z orgánů veřejné moci nebo soukromoprávní uživatel údajů připojit svůj agendový informační systém k informačnímu systému základních registrů (ISZR) a/nebo k informačnímu systému sdílené služby (ISSS) a využívat služby základních registrů a propojeného datového fondu, musí vyplnit žádost pomocí jednoduchého online formuláře Registrační autority základních registrů (RAZR).
Informace potřebné pro připojení AIS a pro vydání certifikátu:
Zde naleznete informace a potřebné k vývoji/modifikaci agendových informačních systémů (AIS) pro připojení k testovacímu a produkčnímu prostředí základních registrů (ZR). Prostředí systémů ZR je vždy složeno z prostředí testovacího a prostředí provozního. Dle podmínek nastavených správcem informačního systému základních registrů (ISZR) je nutné, aby byl AIS, který požaduje připojení k ISZR, otestován proti testovacímu prostředí ZR.
Katalog služeb vnějšího rozhraní ISZR
Katalog eGON služeb | Katalog eGON služeb a XSD a WSDL s popisem datových typů včetně seznamu publikačních služeb zafixovaných na vnějším rozhraní ISZR |
Podrobný popis eGON služeb | Podrobný přehled služeb, které jsou poskytovány na eGON rozhraní Informačního systému základních registrů. |
Popis_hlaviček_eGON_služeb_verze_1_6.pdf 142.73 KB | Dokument obsahuje návod na vyplnění parametrů v hlavičkách volání webových eGON služeb. |
Proces připojování AIS k AIS EOP a AIS ECD | Dokumenty popisují postup připojování agedových informačních systémů OVM k agendovým informačním systémům AISEO, AISC, AIS EOP a AIS ECD. |
Dokument specifikující změny ve volání služeb ISZR v souvislosti s povinným vyplňováním seznamu údajů, které bude vyžadováno u většiny eGON služeb a xls s detailní specifikací požadovaných údajů pro každou službu. | |
Správný_postup_práce_s_notifikacemi_a_udržovani _datoveho_kmene_navázaného_na_ROB.pdf410.71 KB |
Účelem tohoto dokumentu je poskytnout implementátorům AIS základní a ucelený postup zpracování notifikací ROB a dále vhodný postup, který má AIS používat při údržbě svého datového fondu navázaného na ROB prostřednictvím notifikací základních registrů. |
Chybová hlášení | Dokument sumarizuje a popisuje aplikační a systémové chyby, které vrací ISZR v hlavičce odpovědi a v aplikační části odpovědi na volání eGON služby, jestliže se při jejím zpracování vyskytla nějaká chyba |
egon_20230930.zip1.37 MB | XSD popis datových typů (30. 09. 2023) |
FaisNotifikace3Osoba2_xsd.zip2.79 KB | XSD popis pro potřeby automatizovaného zpracování poskytnutí údajů jiné osobě |
ID__RPP_na_ISZR.xls | Konverze ID položek RPP na položky ISZR (20. 7. 2018) |
služby_E20_E29_ver.01.02.pdf | Dokument popisuje rozdíly mezi službou E20 rosCtiIco a E29 rosCtiSeznamIco s ohledem na přechod od použití služby E20 na službu E29. |
SZR_popis_eGON_sluzeb_AISSE_sifrovani_FotoPodpis.pdf | AISSE šifrování |
Pokud je vytvářena nová eGON služba základních registrů, která nahrazuje stávající službu, pak stará služba musí být zachována funkční minimálně po dobu 12 měsíců od publikace nové služby. Dokumentace popisující činnost nahrazené služby musí být uložena pro zpětné potvrzení činnosti služeb.
Vazba datových prvků ISZR na datové prvky ISDP
Vazba_datovych_prvku_ISZR_ISDP.xls241.00 KB |
Provozní řád Informačního systému základních registrů
Provozní_řád_ISZR | Provozní řád ISZR upravuje především vztahy mezi jeho subjekty a dále vymezuje základní pravidla provozního řádu vnějšího rozhraní ISZR. |
Manuál pro kontrolu nastavení oprávnění přístupů k údajům základních registrů
Manuál.pdf745.60 KB | Účelem dokumentu je poskytnout správcům AIS, případně jejich implementátorům, postup kontroly nastavení oprávnění přístupů k osobním údajům registru obyvatel a registru osob |
Referenční agent pro prostředí .NET a JAVA
Pro účely zjednodušení a urychlení implementace AIS v oblasti připojení na Informační systém základních registrů vznikl referenční agent. Referenční agent slouží jako pomůcka pro vývojáře, kteří budou připravovat agendové informační systémy pro připojení k základním registrům. Vývojáři tak mohou formou nahlédnutí do zdrojového kódu referenčního agenta pochopit metodu volání webových služeb vnějšího rozhraní Informačního systému základních registrů implementovanou v prostředích .NET a Java.
Žádost o používání soukromého klíče referencniho agenta.docx |
Žádost o ukončení používání soukromého klíče referenčního agenta.docx |
Referencni_agent_nove_sluzby.pdf 145 KB, 23/01/2024 |
Návod na instalaci referenčního agenta.pdf 1.23 MB, 23/01/2024 |
Pravidla_pro_používání_soukromého_klíče_Referenčního_agenta_-_v.1.4.pdf 113 KB, 23/01/2024 |
Kořenové certifikáty pro instalaci Referenčního agenta nová CA.zip 3.78 KB |
Certifikáty_pro_referenčního_agenta_pfx.zip 4.53 Kb |
ISZR_Referencni_agent_NET_v_1_07.pdf 720 KB, 23/01/2024 |
ISZR_referencni_agent_Net_1_07.zip 3.16 MB 16/01/2024, 15:15 |
ISZR_Referencni_agent_JAVA_v_1_03.pdf 456 KB, 23/01/2024 |
ISZR_Referencni_agent_JAVA_v_1_02.zip 9.53 MB 22/02/2023 13:30 |