Klient pro komunikaci s webovými službami DMVS

DMVS klient je modul pro přímou komunikaci s webovými službami DMVS. Umožňuje využívat služeb DMVS přímo z aplikace, bez nutnosti přihlašování k portálu DMVS.

Pro autentizaci požadavků je využíván serverový certifikát. Tento certifikát je třeba pořídit u některé z certifikačních autorit, např. u PostSignum.

Získání certifikátu

Pro komunikaci se službami DMVS je třeba získat serverový komerční certifikát. Jedná se o jiný typ certifikátu, než je třeba k elektronickému podpisu.

Následující postup je pro pořízení certifikátu u certifikační autority PostSignum. Pořízení certifikátu probíká v těchto krocích:

  1. Uzavření smlouvy o poskytování služeb s certifikační autoritou. Tato smlouva se uzavírá pouze jednou pro všechny certifikáty dané osoby, takže máte-li od certifikační autority PostSignum již elektronický podpis, máte s ní již smlouvu uzavřenou. V takovém případě bude třeba dohledat číslo smlouvy o poskytování certifikačních služeb.

  2. Vytvoření a podání žádosti o certifikát pomocí aplikace iSignum a uložení privátního klíče.

    1. V aplikaci iSignum je zahajte žádost o vydání nového certifikátu:

      iSignum - zahájení žádosti o vydání certifikátu

    2. Vyplňte údaje o certifikátu a odešlete žádosst.

      Pozor: nezapomeňte zvolit správný typ certifikátu: Komerční certifikát (VCA).

      iSignum - zadání informací o certifikátu

      Odešlete žádost o vydání certifikátu.

    3. Po odeslání žádosti budete vyzváni k uložení privátního klíče. Nezapomeňte místo uložení privátního klíče, klíč chraňte před zneužitím. Při ukládání budete vyzváni k zadání hesla ke klíči. Privátní klíč i heslo bude třeba při připojování k webovým službám DMVS.

    4. V dalším kroku budou zobrazeny informace o vygenerovaném privátním klíči včetně ID žádosti o certifikát. ID si můžete uložit do schránky pro další krok, kterým bude doplnění údajů pro odeslání žádosti o certifikát.

      iSignum - ID žádosti o certifikát

    5. Na zadanou mailovou adresu bude doručen odkaz pro zobrazení stránky pro doplnění informací o certifikátu.

      Na stránce otevřené pomocí odkazu je třeba opět zvolit správný typ certifikátu (komerční serverový), vyplnit číslo smlouvy o poskytování certifikačních služeb, jméno žadatele a název certifikátu.

      Dále je třeba zvolit zda žádáte o jednoletý nebo víceletý certifikát, a vložit ID žádosti z předchozího kroku.

      Dále pokračujte dle instrukcí na stránkách PostSignum.

  3. Stažení a uložení vydaného certifikátu.

  4. Nahrání certifikátu na server DMVS prostřednictvím portálu DMVS. Certifikáty se ukládají do uživatelského profilu pomocí Správy subjektu v sekci Systémové informace. Certifikát musí mít příponu .pem. Uloží-li se s příponou .crt, je třeba jej přejmenovat.

Spuštění a konfigurace modulu pro komunikaci s webovými službami DMVS

Poznámka

Pro komunikaci s webovými službami DMVS je z bezpečnostních důvodů na straně serveru nastavena minimální prodleva mezi požadavky na hodnotu 1 minuta, což je pro práci se službami poměrně nepříjemné. Objeví-li se při odeslání žádosti nebo dotazu na server chybové hlášení Při zpracování požadavku nastala chyba: Příliš časté dotazování, je třeba chvíli počkat a odeslat žádost znovu.

Modul pro komunikaci s webovými službami DMVS lze spustit příkazem DTMDMVS klient

Modul má podobu dialogového okna s kartami funkcí po levé straně.

Mezi jednotlivými stránkami na kartách se můžete pohybovat vpřed a zpět pomocí tlačítek se šipkami v horní části okna:

DMVS Klient - navigace mezi stránkami

Do nastavení modulu se dostanete volbou karty Nastavení:

Nastavení modulu DMVS Klient

Modul umožňuje definovat více uživatelských profilů (více identit pro přihlášení k webovým službám DMVS). Pro práci pod více identitami potom stačí přepínat aktivní uživatelský profil v horní části dialogového okna, není třeba vždy přenastavovat přístupové údaje.

Certifikát musí být ve formátu PFX

Heslo k certifikátu nemusí být vyplněno. Nechcete-li, aby bylo heslo uloženo ve Vašem uživatelském profilu, můžete pole pro heslo ponechat nevyplněné. V takovém případě se aplikace při prvním připojení k webovým službám na heslo dotáže, ale nebude je nikam ukládat.

Stisknutím tlačítka Uložit nastavení uložíte uživatelský profil do seznamu uživatelských profilů.

Stisknutím tlačítka Odstranit uživatelský profil odstraníte zvolený profil ze seznamu uživatelských profilů.

Žádost o podklady

Karta slouží k podávání a zobrazování žádostí o výdej podkladů z DMVS.

DMVS Klient - žádost o podklady

Na kartě jsou zobrazeny nabídky pro zobrazení přehledu odeslaných žádostí a pro podání nové žádosti.

Přehled podaných žádostí o podklady

DMVS Klient - seznam žádostí o podklady

Karta slouží k zobrazení seznamu již podaných žádostí o podklady.

Při zobrazení karty je načteno 20 posledních žádostí. Pod seznamem je uveden počet zobrazených žádostí a celkový počet žádostí. Chcete-li zobrazit starší žádosti, další skupinu zobrazíte stisknutím tlačítka Načíst další.

V seznamu je uveden typ žádosti, datum podání, stav zpracování a odkaz pro zobrazení podrobností a vygenerovaných datových sad.

Zobrazení podrobností o žádosti o podklady

DMVS Klient - detail žádosti o podklady

Karta slouží k zobrazení informací o podané žádosti o podklady.

Na kartě jsou zobrazeny podrobné informace o žádosti. V případě, že je již žádost zpracována, je zde zobrazen jeden nebo více odkazů pro stažení vydaných datových sad.

Podání žádosti o podklady

DMVS Klient - podání žádosti o podklady

Karta slouží k podání nové žádosti o podklady.

Na zobrazené mapě můžete pomocí myši definovat oblast, pro kterou mají být vygenerována data.

Pomocí levého tlačítka myši určíte hranice oblasti. Po zadání celé oblasti ukončíte zadávání pravým tlačítkem myši.

Po ukončení zadávání můžete oblast ještě upravovat. Kliknutím myší na libovolnou hranici bude do zvoleného místa vložen nový lomový bod. Lomové body lze posouvat přetažením myší.

Pod mapou je průběžně zobrazován rozsah definované oblasti. Maximální povolená plocha pro ad-hoc výdej dat je 100ha, požadavek na větší rozsah skončí chybou.

Pod mapovým oknem jsou zobrazena tlačítka s dalšími funkcemi:

  • Kreslit polygon: Spustí režim kreslení polygonu. Pokud byl již dříve polygon definován, bude odstraněn.
  • Upravit polygon: Spustí režim úpravy polygonu. V tomto režimu lze do linií vkládat další lomové body a přesouvat již existující lomové body.
  • Odstranit polygon: Existující polygon bude odstraněn.
  • Načíst polygon: Umožňuje načíst již dříve definovaný polygon ze souboru ve formátu WKT.
  • Uložit polygon: Umožňuje uložit definovaný polygon do souboru ve formátu WKT pro další použití.
  • Odeslat žádost: Žádost o výdej dat v definovaném polygonu bude odeslána. Zpracování žádosti lze dále sledovat na stránce Seznam podaných žádostí o podklady.

Žádost o validaci změnové dávky GAD

Karta slouží k podávání a zobrazování žádostí o validaci souboru se změnovou dávkou.

DMVS Klient - žádost o validaci JVF

Na kartě jsou zobrazeny nabídky pro zobrazení přehledu odeslaných žádostí a pro podání nové žádosti.

JVF soubor pro validaci je třeba podat stejnou formou jako při odeslání změnové dávky GAD, tedy zazipovaný.

Při validaci souboru proběhne pouze formální kontrola struktury souboru (kontrola zda soubor odpovídá validačnímu schematu JVF XML), neprobíhá žádná kontrola dat v souboru.

Podání změnové dávky GAD

Karta slouží ke kontrolnímu nebo finálnímu podávání změnové dávky GAD a zobrazování informací o podání.

DMVS Klient - podání změnové dávky GAD

Na kartě jsou zobrazeny nabídky pro zobrazení přehledu odeslaných podání a pro odeslání nového podání.

Přehled podání změnové dávky GAD

DMVS Klient - seznam podání změnové dávky GAD

Karta slouží k zobrazení seznamu již podaných aktualizačních dokumentací GAD.

Při zobrazení karty je načteno 20 posledních záznamů. Pod seznamem je uveden počet zobrazených záznmů a celkový počet záznamů. Chcete-li zobrazit starší záznamy, další skupinu zobrazíte stisknutím tlačítka Načíst další.

V seznamu je uveden typ záznamu, datum podání, stav zpracování a odkaz pro zobrazení podrobností.

Je-li v seznamu u záznamu uvedeno zelenou barvou Zpracováno, neznamená to, že byla podaná GAD přijata, ale pouze že byla žádost zpracována, bez ohledu na výsledek. Výsledek podání lze zjistit až v podrobnostech o podání.

Zobrazení podrobností o žádosti o podklady

DMVS Klient - detail podání změnové dávky GAD

Karta slouží k zobrazení informací o podané žádosti o zapracování GAD.

Na kartě jsou zobrazeny podrobné informace o žádosti. V případě, že je již žádost zpracována, je zde zobrazen výsledek podání, tedy zda je změnová dávka zapracovatelná nebo nezapracovatelná.

Je-li podání zpracováno, lze pomocí tlačítek vpravo uložit nebo přímo zobrazit protokol o výsledku zpracování a uložit archiv obsahující případný seznam chyb ve formátu XML, který lze následně načíst do manažeru chyb v grafickém modulu DTM.

Podání žádosti o zapracování GAD

DMVS Klient - podání změnové dávky GAD

Karta slouží k podání žádosti o zapracování GAD.

Na kartě je třeba vyplnit informace o podávané GAD a připojit podepsaný archiv s kompletní dokumentací.

Název souboru s archivem GAD lze vybrat pomocí tlačítka Vybrat, nebo přetáhnout myší ze správce souborů přímo na vstupní řádek s názvem souboru.

Dále je třeba zvolit kód kraje, do něhož má být GAD odeslána ke zpracování

Nakonec je třeba zvolit typ podání - Kontrolní mebo Finální. Při kontrolním podání proběhne pouze kontrola podané dokumentace, ale nikoli její finální zapracování do DMVS.

Protokol o komunikaci s DMVS

Karta slouží zobrazení protokolu o komunikaci se službami DMVS. Informace jsou určeny k diagnostickým účelům v případě řešení chyb při komunikaci.

DMVS Klient - protokol o komunikaci s DMVS