Metodika 2007 Prirucka Predkladatele a Poskytovatele v 2007 6

gdgd

fgdf

gCleverbee s.r.o.Radlick 740/113d CZ-158 00 Praha 5

+420 226 227 [email protected]

gdgd

fgdf

g

1/13

Nabidka. Verze: 1.0 2007

Uivatelsk pruka pro pedkladatele

Verze 1.0 2007

gdgd

fgdf



gdgd

fgdf

g

2/13


1 Obsah1 OBSAH.........................................................................................................................................................................2

2 VOD...........................................................................................................................................................................3

2.1 SYSTM ISPSP.......................................................................................................................................................32.1.1 ivotn cyklus kampan .................................................................................................................................3

2.2 SYSTMOV A PROVOZN NROKY PRO KLIENTY...................................................................................................42.2.1 WWW rozhran ISPSP...................................................................................................................................42.2.2 Provozn nroky ISPSP.................................................................................................................................4

2.3 ZPSOBY PODN DAT ...........................................................................................................................................42.3.1 Elektronick pota.........................................................................................................................................52.3.2 Webov rozhran ...........................................................................................................................................52.3.3 Webov sluba...............................................................................................................................................5

2.4 DIGITLN PODPIS ..................................................................................................................................................5

3 WEBOV ROZHRAN ISPSP..................................................................................................................................6

3.1 PIHLEN DO APLIKACE .....................................................................................................................................6

4 KONTROLA DAT......................................................................................................................................................7

5 OBRAZOVKY ............................................................................................................................................................8

5.1 ZKLADN OBRAZOVKA.........................................................................................................................................95.1.1 Detail pedkladatele......................................................................................................................................95.1.2 Informace o sbru dat .................................................................................................................................105.1.3 Zkontrolovat/Vloit data .............................................................................................................................105.1.4 Seznam Poskytovatel .................................................................................................................................11

5.2 IMPORT/EXPORT ..................................................................................................................................................125.2.1 Xml formt seznamu poskytovatel.............................................................................................................125.2.2 Csv formt seznamu poskytovatel .............................................................................................................12

5.3 HISTORIE .............................................................................................................................................................13

gdgd

fgdf



gdgd

fgdf

g

3/13


2 vodTento dokument slou jako uivatelsk pruka pedkladatele dat do Informanho systmu o platech a sluebnm pjmu (dle jen ISPSP).Sestv z:

ISP IS o platu ISPVP IS o platu vojk z povoln ISSPr IS o sluebnm pjmu

2.1 Systm ISPSP

Data jsou do ISPSP pedvna ve formtu XML.Jsou sbrna v pravidelnch kampanch sbru, kdy prbh sbru dat d sprvce, kter komunikuje s pedkladateli.

2.1.1 ivotn cyklus kampanKampan sbru dat se rozum jeden uzaven cyklus sbru dat do ISPSP za jedno obdob. Kampa sbru dat probh v nsledujcch krocch:

Vytvoen nov kampan poven sprvce zalo v ISPSP novou kampa, vypln zkladn informace o kampani a vlo soubor pedkladatel.

Registrace po doruen vzvy od sprvce pedkladatel provd registraci pro sbr dat a vkldaj nebo upravuj seznamy svch poskytovatel (vyjmen lze pravy poskytovatel provdt i v nsledujcm kroku).

Sbr dat poskytovatel exportuj data do definovanho XML formtu, kontroluj data pomoc kontrolnho programu (dle jen KP) a zkontrolovan data pedvaj pedkladateli. Pedkladatel zajist uloen dat do ISPSP.

Uzaven kampan po posbrn dat sprvce kampa uzave a tm znemon dal aktualizaci daj pro konkrtn kampa sbru dat (mimo sprvce).

Zazlohovn kampan znemon vkldn dat i sprvci.Na sbru dat do jednotlivch kampan se podlej nsledujc skupiny uivatel:Poskytovatelkolem poskytovatel je zajistit export dat z datovho loit mzdov agendy v definovanm XML formtu, provst kontrolu exportovanch dat a pedat vyexportovan soubor urenmu pedkladateli.PedkladatelPedkladatel budou vyzvni sprvcem kampan k poskytnut dat do ISPSP. Vzva bude obsahovat zkladn informace o kampani sbru dat a informace nutn pro pihlen do systmu ISPSP.Pedkladatel zajist seznam vech jemu nleejcch poskytovatel, za kter bude poskytovat daje do systmu ISPSP.Pedkladatel se pihls do ISPSP, vypln zkladn kontaktn daje a vlo soubor vech jemu nleejcch poskytovatel ve formtu csv, xml nebo poskytovatele vlo run.Pedkladatel kontaktuje poskytovatele a vyzve je k exportu dat z datovho loit do definovanho XML formtu.Exportovan data z loit jsou kontrolovna pmo poskytovatelem nebo pedkladatelem, jet ped odeslnm do ISPSP. Kontrolu je mon provst dvma zpsoby:

Kontrolnm programem na loklnm potai, kter je k dispozici ke staen na http://www.mfcr.cz/isp.

gdgd

fgdf



gdgd

fgdf

g

4/13


Anonymn kontrola na serveru ISPSP. Vce viz. 4 Kontrola dat. Kontrola pes email. Uivatel pole data jako plohy ve formtu xml samostatn nebo zabalen

v archivu zip na adresu: [email protected]. Ploh me bt v jedn emailov zprv vce. Pedmt emailov zprvy mus bt ve tvaru: i[mezera]test. Kde i pedstavuje osmimstn i pedkladatele. Velikost emailov zprvy me bt maximln 4MB.

Funknost KP a kontrolnho mechanismu na serveru je toton. KP provd dva typy kontrol: Syntaktick kontrola formtu XML souboru zda soubor XML odpovd formtu danmu pslunm

schmatem.

Logick kontroluje se obsah XML souboru mnostvm logickch kontrol, kter maj odhalit chyby v poskytnutch datech (napklad e souet poloky za zamstnance neodpovd celkovmu soutu u zamstnavatele).

Chyby, kter vypisuje KP, se dl na dva typy: W Varovn (informuje o chyb v poskytovanch informacch, kter nem vliv na dal zpracovn

dat).

E Zvan chyba (informuje o chyb, kter m zsadn dopad na zpracovn dat).Ped odeslnm dat do ISPSP mus poskytovatel ve spoluprci s pedkladatelem odstranit z dat vechny chyby typu E (Zvan chyba). Soubor, kter by obsahoval chyby typu E, nebude pijat k uloen do ISPSP.Po kontrole dat a odstrann chyb typu E me pedkladatel uloit data postupn za jednotliv poskytovatele do ISPSP.Ped vlastnm odeslnm dat do systmu ISPSP je mon XML soubor podepsat elektronickm podpisem pomoc KP. V ppad vloen dat elektronickou potou (tj. nejedn se o pouhou kontrolu dat) je elektronick podpis souboru s ISPSP daty vyadovn.

Data mohou bt do systmu ukldna pmo v definovanm formtu XML, nebo je mon takto pipraven soubor zkomprimovat do formtu zip (zkrt se doba penosu dat na server ISPSP).SprvceSprvce zajiuje a d prbh sbru pro danou kampa, komunikuje s pedkladateli a e problmy vznikl v prbhu sbru dat.Sprvce spravuje mnoinu pedkladatel a zajiuje doruen vzvy ke sbru dat tmto pedkladatelm.Dle zajiuje provoz ISPSP.

2.2 Systmov a provozn nroky pro klienty

Systmov nroky se udvaj oddlen pro kontroln program a WWW prohle k pstupu na serverovou st ISP.2.2.1 WWW rozhran ISPSPSe systmem ISPSP se komunikuje pomoc kterhokoliv WWW prohlee, kter podporuje XHTML 1.0. Tuto podmnku spluj napklad Mozilla Firefox 1.5 a Microsoft Internet Explorer 5.0 a jejich vy verze.2.2.2 Provozn nroky ISPSPVzhledem k pojet ISPSP je nutn zajistit uivatelm pstup k ISPSP serveru (na internetov adrese http://isp.mfcr.cz/) a zrove pstup ke schrnce elektronick poty. Mnoho informac mezi ISP a uivatelem se vymuje pomoc elektronick poty.Potovn klientsk vybaven (MS Outlook, Mozilla Thunderbird apod.) mus podporovat zpracovn zprv v kdovn utf-8.

2.3 Zpsoby podn datData lze podat do systmu ISPSP nsledujcmi zpsoby.

gdgd

fgdf



gdgd

fgdf

g

5/13


2.3.1 Elektronick potaPedkladatel pole data jako plohu ve formtu xml samostatn nebo v archivu zip na adresu: [email protected]. Ploh me bt v jedn emailov zprv vce. Vechny soubory xml mus bt digitln podepsny. Vce o digitlnm podpisu viz. 2.4 Digitln podpis. Pedmt emailov zprvy mus bt ve tvaru: i[mezera]data. Kde i pedstavuje osmimstn i pedkladatele. Velikost emailov zprvy me bt maximln 4MB.2.3.2 Webov rozhranVce viz. 5.1.3 Zkontrolovat/Vloit data.2.3.3 Webov slubaWebov sluba je sputna v kontextu /service/PodaniService aplikace ISPSP. Jej WSDL je k dispozici na URL /service/PodaniService?wsdl. Pro vkldn dat pomoc tto sluby je nutn nejprve pihlsit se metodou login(String userName, String password), piem vyuije stejn jmno a heslo, kter pouv i pro pihlaovn do aplikace ISPSP. Po spnm pihlen je vrceno sessionId, kter se pouije v metod uploadData(String sessionId, String data). Doporuujeme na zvr nezapomenout zavolat metodu logOff(String sessionId).

2.4 Digitln podpis

Aplikace ISPSP pouv pro ovovn autenticity ISPSP XML dat zaslanch ke zpracovn elektronickou potou elektronick XML podpis. Klient m monost bu vyuvat Certifikan autoritu vestavnou v aplikaci ISPSP a podepisovat data aplikac LKP, nebo pro podepisovn vyut jin digitln podpis a aplikaci pro podepisovn dat dle standardu XML Digital signature.Vestavn Certifikan autorita vystavuje X509 digitln certifikty a spolu s privtnm klem je ukld do JKS keystore, kter je jako Digitln podpis nabzen ke staen ke klientovi. Tento JKS keystore je pak pouit aplikac LKP.V ppad zjmu o vyuit vlastnho Digitlnho podpisu je nutn pomoc obrazovky S1/P1 zaregistrovat X509 certifikt v Base64 tvaru pro pslunho Pedkladatele.

gdgd

fgdf



gdgd

fgdf

g

6/13


3 Webov rozhran ISPSP

Obrzek 3-1 - vodn obrazovka

Pedchoz obrzek zachycuje vodn obrazovku aplikace. Kad obrazovka aplikace se skld z nsledujcch st:

Zhlav obsahuje nzev aplikace Pihlaovac formul je umstn v levm hornm rohu obrazovky a slou k pihlen/odhlen

uivatele do/z aplikace Menu je umstno v lev sti obrazovky pod pihlaovacm formulem a slou k navigaci mezi

jednotlivmi obrazovkami aplikace Hlavn st zabr zbytek obrazovky

3.1 Pihlen do aplikace Uivatel vypln pihlaovac jmno a heslo a stiskne klvesu Enter nebo klikne na tlatko Pihlsit. Pokud se uivatel pihlauje za pedkladatele uvede jako pihlaovac jmno pslun osmimstn I pedkladatele. Probhne-li pihlen spn, zobraz se zde dv nov tlatka Zmnit a Odhlsit. Po stisknut tlatka Zmnit se zobraz formul pro zmnu hesla. Stisknutm tlatka Odhlsit dojde k odhlen uivatele z aplikace. K sprvn funkci aplikace je nutn, aby byla v databzi ptomna alespo jedna kampa. Pokud dn kampa nen nalezena, pracuje aplikace v tzv. nouzovm reimu. Funknost aplikace je v tomto reimu velice omezen. V podstat odpovd funknosti, kter je k dispozici pro anonymnho uivatele. V tomto ppad je nutn kontaktovat administrtora, aby pslunou kampa vytvoil.

gdgd

fgdf



gdgd

fgdf

g

7/13


4 Kontrola dat

4-1 - Obrazovka Kontrola dat

Po kliknut na poloku Kontrola dat v menu se uivateli zobraz stejnojmenn obrazovka. Tato obrazovka slou k anonymn kontrole dat a je tedy pstupn i nepihlenm uivatelm. Uivatel zad cestu k souboru, kter chce zkontrolovat, adresu elektronick poty na kterou chce obdret soubor s vsledkem kontroly a vybere formt tohoto souboru. Po stisknut tlatka OK je zvolen soubor pedn k proveden kontroly. Vsledek kontroly je uivateli zasln jako ploha zprvy elektronick poty.Uivatel me zvolit tyto ti formty vsledku kontroly: html, xml, csv. Doporuujeme ponechat standardn formt html nebo je nejitelnj.

gdgd

fgdf



gdgd

fgdf

g

8/13


5 Obrazovky

5-1 - Podoba menu pro pedkladateleV tto sti popeme funknost aplikace z hlediska uivatele pihlenho jako pedkladatel. Podoba menu je znzornna na obrzku 5-2. K dispozici jsou tyto monosti:

vodn obrazovka obsahuje zkladn informace o aplikaci, dleit upozornn a zprvy od administrtora aplikace

Informace pesmrovn na domovskou strnku ministersva financ Kontrola dat obrazovka pro anonymn kontrolu dat. Ble viz. 4 Kontrola dat Zkladn obrazovka hlavn obrazovka pro prci uivatele s aplikac. Ble viz. Zkladn obrazovka Import/Export obrazovka slouc k importu/exportu selnk, sebranch dat a seznamu

poskytovatel. Ble viz. 5.2 Import/Export. Historie tato obrazovka zobrazuje pehled vech pokus o vloen dat do systmu a jejich vsledky.

Ble viz. 5.3 Historie. O aplikaci informace o tto aplikaci

gdgd

fgdf



gdgd

fgdf

g

9/13


5.1 Zkladn obrazovka

5-2 - Zkladn obrazovka

Zkladn obrazovka je rozdlna pomoc zloek na 4 logick sti, kter se nachzej na tech zlokch. Vechny sti te popeme.5.1.1 Detail pedkladatelePod zlokou Pedkladatel jsou zobrazeny informace o prv pihlenm pedkladateli. Dle jsou zde 3 tlatka. Po stisknut tlatka Poslat ov. Email se na zadanou adresu elektronick poty pole ovovac zprva. Tlatko Generovat dig. podpis slou automatickmu vygenerovn certifiktu. Tento certifikt slou k digitlnmu podepsn dat vkldanch pes elektronickou potu. Po stisku tlatka Upravit se zobraz formul umoujc vytvoit/zmnit informace o pihlenm pedkladateli. Krom standardnch poloek jako je Jmno, Telefon, El. Pota zde jsou i nsledujc pole:

Potvrz. kd slou k zadn potvrzovacho kdu pro oven sprvnosti emailov adresy. Tento kd piel uivateli v potvrzovacm emailu.

Veejn kl dig. podpisu slou k zadn vlastnho X509 certifiktu v Base64 tvaru.K uloen provedench zmn slou tlatko OK. Po stisknut tlatka Storno k dnmu uloen zmn nedojde.

gdgd

fgdf



gdgd

fgdf

g

10/13


5.1.2 Informace o sbru datPod zlokou Sbr dat zobrazuje druh st obrazovky v soutech informace pro pihlenho Pedkladatele a vybranou kampa. Vybranou kampa lze zmnit pomoc dvou combo box Rok a Obdob a tlatka Zmnit. 5.1.3 Zkontrolovat/Vloit dataFunkce tto sti obrazovky zvis na stavu zvolen kampan. Data lze vkldat pouze v ppad, e je zvolena kampa ve stavu Vkldn dat. Ve vech ostatnch ppadech se data budou jen kontrolovat a funkce formule je tak podobn obrazovce 4 Kontrola dat. Soubor s vkldanmi/kontrolovanmi daty se vybere v prvnm poli formule. Dal pole slou ke zvolen formtu vsledku dat. Po stisknut tlatka OK dojde k zaazen zvolenho souboru do fronty ke zpracovn. V ppad vloen dat se vsledek zpracovn zobraz v poli pod formulem (Ne v ppad pouh kontroly dat). Toto pole se v pravidelnch intervalech obnovuje. Po dokonen kontroly se zde zobraz odkaz Vsledek kontroly, kter uivatele zavede na obrazovku s podrobnm vpisem chyb nalezench bhem zpracovn. O vsledku kontroly resp. vkldn dat je uivatel vdy informovn elektronickou potou.

gdgd

fgdf



gdgd

fgdf

g

11/13


5.1.4 Seznam PoskytovatelPosledn st obrazovky nachzejc se pod zlokou Poskytovatel zobrazuje tabulku se seznamem poskytovatel pihlenho pedkladatele. Popis tabulky:Sloupce I, Kd org. a Nzev jsou zejm. Sloupec Z reprezentuje zpsob jakm pedkladatel vloil za poskytovatele data:{ Web, El pota, PVS, Sluba nebo Admin}. Sloupec Typ reprezentuje typ systmu do kterho poskytovatel vkld data:{ISP, ISPVP, ISPPr}. Sloupec Vloeno prac. obsahuje poet zamstnanc v poskytnutch datech. Sloupec Datum obsahuje datum zpracovn dat poskytovatele. Ikonou kku vyskytujc se v kadm dku tabulky je mon odstranit poskytovatele z registru organizac i se vemi jeho sebranmi daty ve vybran kampani. Ptice ikon se symboly ipek v hornm pravm rohu tabulky slou pro listovn v seznamu poskytovatel.

Pod seznamem poskytovatel se nachz formul, kter slou k zaloen novho/editaci daj ji zaloenho poskytovatele. Zvolenm tlatka Pidat se resetuje formul pro vloen/editaci daj poskytovatele. Tlatko se nezobrazuje dokud je seznam poskytovatel przdn.

Pidn novho poskytovatele:Po vyplnn alespo povinnch pol oznaench hvzdikou a stiskem tlatka OK je poskytovatel zaloen do databze a zobrazuje se v tabulce se seznamem poskytovatel.

Editace zaloenho poskytovatele:Oznaenm dku v seznamu poskytovatel se formul pro vloen/editaci poskytovatele pedvypln pslunmi hodnotami. I a Kd organizace nelze mnit. Pole Systm se mn comboboxem dle dostupnch typ Pedkladatele. Pi zmn typu poskytovatele se smaou i vechna souvisejc data (pro vybranou kampa). Stisknutm tlatka OK se daje o poskytovateli ulo. Tlatkem Storno se zmnn daje zahod.

gdgd

fgdf



gdgd

fgdf

g

12/13


5.2 Import/Export

5-3 - Obrazovka Import/ExportObrazovka Import/Export slou ke sprv selnk, registru organizac a sebranch dat. Zmny zde proveden se vztahuj ke zvolen kampani. dek Seznam poskytovatel obsahuje vstupn pole a sadu tlatek. Vstupn pole slou k volb souboru s importnmi daty. slo zobrazen vlevo od sady tlatek reprezentuje poet zznam ptomnch v databzi. Tlatka slou k importu/exportu dat do/z databze.

Tlatkem Vloit se spust vkldn (import) dat do databze. Vechna pedchoz data budou z databze vymazna.

Tlatko Doplnit slou k doplnn nebo ppadn aktualizaci dat starch. Z databze se dn data nemaou. Pedkladatel me vloit nebo doplnit pouze seznam svch poskytovatel ve formtech viz 5.2.1 a 5.2.2

Po stisku tlatka Zobrazit se zobraz nov obrazovka s pehledem dat ptomnch v databzi.

Tlatka St. XML a St. CSV slou k proveden exportu dat ve zvolenm formtu. Exportovan data jsou staena okamit po stisku pslunho tlatka.

5.2.1 Xml formt seznamu poskytovatelPopis struktury xml soubor xsd schma vetn ukzek xml soubor je soust dodan dokumentace ISPSP na mediu CD. Schma xml formtu je piloen v adresi: schema. Ukzky xml soubor jsou v adresi: schema/example.

5.2.2 Csv formt seznamu poskytovatelCsv formt sestv z hodnot oddlench stednky. Na zatku souboru je nutn uvst hlaviku v nsledujcm tvaru:AA0017;AA0113;ICOnadrizene;P_ISP;P_ISSPR;P_ISPVP;S_ISP;S_ISSPR;S_ISPVP;Nazev;Mail;Jmeno;Telefon;Overeno;BezKontrolTarifu;CertPublicKey

gdgd

fgdf



gdgd

fgdf

g

13/13


Jednotliv poloky odpovdaj elementm v xml fomtu. Za touto hlavikou ji nsleduj data jednotlivch poskytovatel. Kad poskytovatel na samostatnm dku. Informace je nutn uvst pouze u nsledujcch poloek:

AA0017 I poskytovatele AA0113 kd zazen poskytovatele. Pokud poskytovatel nem pidlen tak se neuvd nic. S_ISP, S_ISSPR a S_ISPVP uvd se 1 pokud jde o poskytovatele do ISP, ISSPR resp.

ISPVP. Jinak se uvd 0. Nazev nzev poskytovatele

U ostatnch poloek se nic neuvd, ale je nutn uvst vechny oddlovac stednky.

5.3 Historie

5-4 Obrazovka HistorieObrazovka Historie zobrazuje seznam zpracovanch soubor s vkldanmi daty pro pihlenho pedkladatele a zvolenou kampa. Sloupec I obsahuje krom I i kd organizace, pokud je definovn (ve form i/kd organizace), poskytovatele. Pokud soubor obsahuje vce poskytovatel, vype se jen prvn a pznak, e jich bylo vce (*). Sloupec Stav indikuje vsledek zpracovn souboru (zda obsahoval njak chyby). Kliknutm na tlatko Vsledky se pro vybran dek tabulky zobraz obrazovka s vsledkem kontroly. Kliknutm na tlatko Zobrazit zdroj se pro vybran dek tabulky zobraz vlastn obsah souboru s vkldanmi daty.

Date post:	25-Sep-2015
Category:	Documents
Upload:	debasish
View:	223 times
Download:	1 times

Metodika 2007 Prirucka Predkladatele a Poskytovatele v 2007 6

Documents