Obě strany předchozí revize Předchozí verze Následující verze | Předchozí verze Následující verzeObě strany příští revize |
cinnost:registrace-vlastniho-katalogu-v-nkod [2017/08/15 08:17] – Jakub Klímek | cinnost:registrace-vlastniho-katalogu-v-nkod [2021/03/16 09:06] – [Registrace lokálního katalogu v NKOD] Jakub Klímek |
---|
</html> | </html> |
| |
Pokud Poskytovatel provozuje lokální katalog otevřených dat s podporou [[nastroj:ckan-api|CKAN API]], může si katalog zaregistrovat v NKOD a tím zajistit publikaci záznamů z lokálního katalogu v NKOD. Pro registraci je nutný přístup k datové schránce Poskytovatele dat nebo možnost datovou schránkou poslat XML soubor jako přílohu. | Pokud Poskytovatel provozuje lokální katalog otevřených dat s rozhraním dle [[https://ofn.gov.cz/rozhraní-katalogů-otevřených-dat/|Otevřené formální normy pro datové katalogy]], může si katalog zaregistrovat v NKOD a tím zajistit publikaci záznamů z lokálního katalogu v NKOD. |
| Pro registraci je nutný přístup k datové schránce Poskytovatele dat nebo možnost datovou schránkou poslat registrační soubor jako přílohu datové zprávy s předmětem "NKOD". |
| |
Správa záznamu lokálního katalogu je prováděna zasíláním XML dokumentů ve formě přílohy datové zprávy do datové schránky s identifikátorem <wrap box>uur3q2i</wrap> <wrap box>„Automat PVS (Ministerstvo vnitra)“</wrap> spravované Ministerstvem vnitra ČR. Tyto XML dokumenty lze získat pomocí [[https://portal.gov.cz/webfiller/FormService/Filler.Open?name=nkod.fo|formulářů]] dostupných na stránkách [[http://portal.gov.cz/portal/ovm/rejstriky/data/97899/|Rejstříku datových zdrojů]], kde je také k dispozici [[https://portal.gov.cz/portal/ovm/rejstriky/ogd/x-nkod.html|dokumentace]] jejich struktury. | Správa záznamu lokálního katalogu v NKOD je prováděna zasíláním registračních dokumentů ve formě přílohy datové zprávy s předmětem "NKOD" do datové schránky s identifikátorem <wrap box>m3hp53v</wrap> <wrap box>„Národní katalog otevřených dat (NKOD) (Ministerstvo vnitra)“</wrap> spravované Ministerstvem vnitra ČR. |
| Tyto dokumenty lze získat pomocí formulářů dostupných v NKOD přes odkaz "Registrovat nový lokální katalog" v patičce NKOD, či pomocí symbolu mazání na detailu datové sady v případě mazání lokálního katalogu. |
| Vždy zasílejte pouze jednu přílohu jednou datovou zprávou, jinak bude zpráva ignorována. |
| Dokumenty jsou ve formátu JSON-LD (s příponou ''.jsonld.txt'' kvůli omezení na typy příloh datových zpráv). |
| |
===== Registrace lokálního katalogu ===== | ===== Registrace lokálního katalogu ===== |
| Registrace lokálního katalogu je provedena zasláním registračního dokumentu, který lze získat vyplněním formuláře po kliknutí na odkaz "Registrovat nový lokální katalog" v patiččce NKOD. |
Registrace lokálního katalogu je provedena zasláním registračního XML dokumentu, který lze získat například vyplněním formuláře "Registrace odkazu na lokální katalog". V tom případě je postup registrace lokálního datového katalogu v NKOD následující: | Postup registrace lokálního katalogu v NKOD je následující: |
- Ve [[https://portal.gov.cz/webfiller/FormService/Filler.Open?name=nkod.fo|formuláři NKOD]] kliknout na "Registrace odkazu na lokální katalog"; | - V [[https://data.gov.cz/datové-sady|Národním katalogu otevřených dat]] kliknout v patičce na "Registrovat nový lokální katalog"; |
- Vyplnit název katalogu, jméno a email správce katalogu a kliknout na "Další"; | - Vyplnit všechny údaje dle popisu ve formuláři |
- Do pole Odkaz na stažení datového zdroje zadat adresu funkce <wrap box>package_list</wrap> CKAN API lokálního katalogu, která vrací seznam názvů obsažených datových sad, například <wrap box>https://priklad.cz/api/3/action/package_list</wrap>, a kliknout na "Další"; | - Název lokálního katalogu otevřených dat (povinný atribut) |
- V posledním kroku je třeba zvolit jednu ze dvou možností: | - Tento název rozlišuje mezi jednotlivými katalogy otevřených dat dané instituce. Pokud má jeden, může to být třeba 'Katalog otevřených dat XXX' |
- přímé odeslání z formuláře do ISDS - pokud jsou k dispozici přihlašovací údaje k datové schránce Poskytovatele dat; | - Jméno a email správce katalogu (povinné atributy) |
- alternativní způsob odeslání - pak je třeba výsledný XML soubor poslat datovou schránkou (například přes spisovou službu Poskytovatele dat) jako přílohu zprávy a adresovat ji na datovou schránku <wrap box>„Automat PVS (Ministerstvo vnitra)“</wrap> s ID <wrap box>uur3q2i</wrap>. | - Jméno a email správce lokálního katalogu otevřených dat, se kterým lze komunikovat o případných problémech s katalogem. To může být třeba problém s formátem API, přístupností rozhraní, apod. |
| - Typ API lokálního katalogu (povinný atribut) |
| - Stanovuje typ API (rozhraní) registrovaného katalogu. Více viz Otevřené formální norma [[https://ofn.gov.cz/rozhraní-katalogů-otevřených-dat/|Rozhraní katalogů otevřených dat]]. |
| - URL API lokálního katalogu (povinný atribut) |
| - Stanovuje URL API katalogu dle Otevřené formální norma [[https://ofn.gov.cz/rozhraní-katalogů-otevřených-dat/|Rozhraní katalogů otevřených dat]]. |
| - Domácí stránka katalogu (volitelný atribut) |
| - Uveďte URL domácí stránky vašho katalogu, pokud existuje. Váš lokální katalog může obsahovat větší množství informací a souvislostí, než se dostane do Národního katalogu otevřených dat. Proto můžete chtít, aby se uživatelé po nalezení vaší datové sady v NKOD mohli podívat i do vašeho katalogu. |
| - V posledním kroku formuláře je třeba výsledný dokument poslat datovou schránkou (například přes spisovou službu Poskytovatele) jako přílohu datové zprávy s předmětem "NKOD" a adresovat ji na datovou schránku <wrap box>Národní katalog otevřených dat (NKOD) (Ministerstvo vnitra)</wrap> s ID <wrap box>m3hp53v</wrap>. |
| |
===== Zrušení registrace lokálního katalogu ===== | ===== Zrušení registrace lokálního katalogu ===== |
| |
Registraci lokálního katalogu otevřených dat je možno zneplatnit (zrušit) zasláním XML dokumentu, který lze získat pomocí formuláře "Smazání datové sady nebo odkazu na katalog". V tom případě je postup zrušení následující: | Registraci lokálního katalogu otevřených dat je možno zrušit zasláním dokumentu, který lze získat pomocí formuláře pro smazání lokálního katalogu. |
- V [[https://portal.gov.cz/portal/ovm/rejstriky/data/97899/|Rejstříku datových zdrojů]] nalézt ID záznamu s registrací lokálního katalogu, viz obrázek; {{:cinnost:kat-mfcr.png?direct&300|}} | Postup zrušení je následující: |
- Ve [[https://portal.gov.cz/webfiller/FormService/Filler.Open?name=nkod.fo|formuláři NKOD]] kliknout na "Smazání datové sady nebo odkazu na katalog"; | - V [[https://data.gov.cz/lokální-katalogy|Seznamu lokálních katalogů v NKOD]] nalézt rušený lokální katalog a v jeho detailu kliknout na symbol smazání |
- Vyplnit ID záznamu a kliknout na „Další“; | - Ve formuláři je třeba výsledný dokument poslat datovou schránkou (například přes spisovou službu Poskytovatele) jako přílohu datové zprávy s předmětem "NKOD" a adresovat ji na datovou schránku <wrap box>Národní katalog otevřených dat (NKOD) (Ministerstvo vnitra)</wrap> s ID <wrap box>m3hp53v</wrap>. |
- V posledním kroku je třeba zvolit jednu ze dvou možností: | |
- přímé odeslání z formuláře do ISDS - pokud jsou k dispozici přihlašovací údaje k datové schránce Poskytovatele dat; | |
- alternativní způsob odeslání - pak je třeba výsledný XML soubor poslat datovou schránkou (například přes spisovou službu Poskytovatele dat) jako přílohu zprávy a adresovat ji na datovou schránku <wrap box>„Automat PVS (Ministerstvo vnitra)“</wrap> s ID <wrap box>uur3q2i</wrap>. | |