Nové služby a funkčnosti modulu elektronických formulárov
Vážení používatelia a integrační partneri,
dovoľujeme si Vás informovať o nových službách a funkčnostiach modulu elektronických formulárov, ktoré budú spustené počas novembra 2023 v produkčnom prostredí ÚPVS (PROD).
V testovacom prostredí ÚPVS (FIX) sú poskytované už od roku 2020 od kedy prebiehalo ich testovanie, o čom boli integrované subjekty informované oznamom, v release pláne, v integračnom manuáli a v príručke pre registráciu formulára.
Pôvodné služby modulu zostávajú naďalej plne funkčné ako doteraz a nie je potrebná zmena integrácie. Z hľadiska integrácie pribúda len nový typ správy zasielaný do schránky žiadateľa pre výsledok validácie elektronického formulára.
1. Automatické schvaľovanie elektronických formulárov v module elektronických formulárov
Pre registráciu a schválenie elektronického formulára a pre zmenu metadát elektronického formulára už nebude potrebné kontaktovať NASES a ani čakať 5 dní, nakoľko schválenie bude vykonané automatizovane. Vo formulári žiadosti o zverejnenie elektronického formulára bude možné uvádzať ako dátum platnosti a účinnosti aj bezprostredne nasledujúci deň. Elektronické formuláre budú v produkčnom prostredí modulu elektronických formulárov automaticky sprístupnené na začiatku požadovaného dňa, najskôr však nasledujúci deň v skorých ranných hodinách.
Automaticky budú schválené len elektronické formuláre v ktorých nebudú zistené žiadne závažné chyby automatickými validáciami.
2. Validácie elektronických formulárov
Do elektronickej schránky žiadateľa bude v prípade zistenia chýb zasielaný výsledok technickej validácie elektronického formulára s novým Sk-Talk Class.
Žiadateľ o registráciu alebo validáciu formulára v prípade zistenia chýb v elektronickom formulári bude informovaný o zistených nedostatkoch správou zaslanou do elektronickej schránky. Chyby sú dvoch kategórií: WARNING (upozornenie) neblokujúce registráciu formulára alebo ERROR (chyba) blokujúce registráciu formulára.
Validácia je vykonávaná v dvoch prípadoch:
- pri každej žiadosti o registráciu elektronického formulára,
- pri manuálne zaslanej žiadosti o validáciu elektronického formulára bez registrácie formulára, ak chce vývojár alebo gestor otestovať valídnosť svojho formulára.
Cieľom funkcie je, aby tvorcovia elektronických formulárov postupne odstránili všetky chyby, ktoré sa vo formulári vyskytujú a môžu spôsobovať problémy pri jeho používaní v informačných systémoch.
Validácie automatizovane vykonávané pri registráciách elektronických formulárov bude NASES postupne sprísňovať a v prípade niektorých základných chýb nebude registrácia formulára umožnená. Žiadateľ bude môcť na základe zaslaného reportu elektronický formulár opraviť a opätovne požiadať o schválenie.
Zoznam v súčasnosti nastavených validácií v testovacom prostredí je dostupný na tejto adrese dostupnej v tomto prostredí.
Validácie pre produkčné prostredie budú po určení dátumu spustenia zverejňované v časti "Modul MEF" na stránke Technické informácie o ÚPVS.
Hodnoty Sk-Talk Class validačného reportu ako aj žiadosti o validáciu sú zverejnené v zozname Sk-Talk Class ako súčasť dokumentácie Schémy správ Sk-Talk.
Vysvetlenie účelu jednotlivých typov správ je uvedené v dokumente „Nové Sk-Talk class pre služby MEF pre validácie a transformácie pred registráciou formulára“ zverejnenom na Partner Framework Portáli spolu s príkladom validačného reportu. Zapracovanie nových Sk-Talk Class do integračného manuálu MEF (eFORM) bude zverejnené do konca septembra 2023.
Pri žiadosti o registráciu formulára sa vykonáva validácia bez ohľadu na formát balíku formulára (ZIP aj pkg.xml). Služba pre žiadosť o validáciu formulára v grafickom rozhraní bez registrácie formulára je aktuálne určená iba pre ZIP balíky elektronického formulára.
3. Dereferenciácia a zverejňovanie súčastí elektronických formulárov na vyskladateľných URL adresách
NASES pripravil zverejňovanie súčastí elektronických formulárov na pevných vyskladateľných URL adresách v zmysle §32 Vyhlášky č. 78/2020 Z. z. o štandardoch pre IT VS.
To umožní jednoduchý prístup ku všetkým súčastiam elektronického formulára (napr. k manifest.xml, prezentačným schémam a XSD schéme) na základe pevných pravidiel.
Formuláre budú zverejňované na vyskladateľných linkách raz denne, niekoľko hodín po ich sprístupnení v MEF.
Podrobnosti sú uvedené v príručke pre zverejňovanie elektronických formulárov.
K elektronickým formulárom teda bude možné automatizovane pristupovať aj bez integrácie na MEF. Pre spoľahlivý prístup k formulárom priamo z MEF však naďalej odporúčame používať integráciu na MEF.
4. Zverejňovanie datasetu elektronických formulárov
Zoznam elektronických formulárov vrátane základných metadát a URL linky pre dereferenciáciu bude zverejňovaný každý deň vo formáte JSON a neskôr sa plánuje aj vo forme CSV.
Dataset obsahuje aj dátum poslednej zmeny, napríklad ak je vo formulári zmenený dátum platnosti.
Dataset tak umožní aj subjektom, ktoré nemajú integráciu na MEF získavať informácie o nových formulároch a ich zmenách.
Štruktúra datasetu bude zverejnená v dokumentácii k modulu MEF.
5. Zákaz zmeny názvu formulára cez zmenu metadát
MEF neumožní zmenu názvu formulára cez zmenu metadát formulára. Dôvodom je, že názov formulára sa používa v podpisoch v historickom formáte XAdES_ZEP a pri overovaní podpisov sa kontroluje voči hodnote v MEF. V prípade zmeny v MEF by sa mohli zneplatniť existujúce historické podpisy.
6. Služba pre získanie náhľadu vizualizácií formulárov
MEF poskytuje v grafickom aj integračnom rozhraní službu pre získanie náhľadu elektronického formulára. Služba umožňuje získať náhľady aj pre elektronický formulár, ktorý ešte nie je zaregistrovaný v module elektronických formulárov a získať tak predstavu o jeho vizualizácii napríklad pri vývoji alebo testovaní formulára.
Funkčnosť a používané Sk-Talk Class sú popísané v príručke pre registráciu formulára ako aj v integračnom manuáli.
7. Zachovanie integrity súčastí elektronického formulára
MEF zabezpečí zachovanie integrity súčastí registrovaného elektronického formulára. S novými službami MEF sa preto už nestane, že by elektronický formulár odoslaný do MEF bol počas registrácie zmenený napríklad kanonikalizáciou ako sa to stávalo v minulosti
8. Zmeny v grafickom rozhraní MEF
V grafickom rozhraní MEF boli doplnené funkcie a zlepšenia pre zjednodušenie práce s elektronickými formulármi.
Funkcie sú nasadzované v zmysle Release plánu, zverejňovaného na portáli slovensko.sk.