u importů, které pouze vkládají umožňuje tato evidence při splnění dalších podmínek (otevření datového okruhu, tzn. je možné provádět změny) provést zrušení importu.

3 Standardní řešení okruhu „Imp“

V následující tabulce je uveden seznam objektů zařazených do okruhu Imp. V prvním sloupci je kód objektu, ve druhém označení druhu objektu (F = formulář, P = proces, S = sestava). Třetí sloupec popisuje obsah objektu

Tučným písmem jsou označeny již řešené a zdokumentované objekty:

Imp01	F	Provedené importy
Imp02	S	Imp02 – Import do Opv02 – Trvalé SLM - Platby
Imp09	S	Import Dcd – standard - viz - Doch_uzdoc Imp09
Imp11	S	Import Dcm01 – standard - viz v Doch_uzdoc Imp11
Imp17	S	Import kódu oboru vzdělání pro ISPV
Imp31	S	Import dokumentů

3.1 Imp01 – Provedené importy

Přehledový formulář s navigačním seznamem evidovaných importů, na záložce Detail jsou detaily aktuálního evidovaného importu.

Záložka ID pak obsahuje tabulku s identifikací vložených/změněných záznamů. Záznam je identifikován jménem tabulky a primárním klíčem záznamu.

Pomocí lokálního menu je možné provést export do Excelu.

3.2 Imp02 – Import do Opv02 – Trvalé SLM - Platby

Import není součástí standardního EGJE.

Import je doplňkem upřednostňovaného standardního importu jednorázových vstupů do mezd Vst11, který importuje přímo do Vyp01.

Tento import importuje do Opv02 – Trvalé SLM – Platby.

Import trvalých plateb je nebezpečnější v tom, že hrozí zpětný nesoulad mezi spočtenými mzdami a trvalými vstupy.

K tomu existuje řada kontrol, ale některé z nich jsou volitelné.

Zdrojovým souborem je XLSX soubor.

Jsou podporovány 3 typy hlaviček:

a) Plná
- v poli A1 je text „Režim“ (nebo „Mode“) a v A2 číselné označení režimu
- v řádku 2 jsou hlavičky sloupců

b) Redukovaná
- režim/mode se v souboru neuvádí – bere se vždy 1
- v řádku 1 jsou hlavičky sloupců

c) Bez hlavičky
- sloupce se berou v implicitním rozložení:

A - oscpv

B – slm

C - datum_od (je-li sloupec prázdný, tak se bere 1. den současného měsíce a samozřejmě se kontroluje uzavřenost)

D - castka_enc

E - tarif_plny_enc

F – procento

G - kod_castky – pokud není v importu načteme hodnotu s minimálním pořadím z číselníku SLM pro danou SLM

H - kod_doby – dtto

I - datum_do (default 3.3.3333)

Názvy sloupců i indikace režim/mode mohou být velkými, malými i smíšenými písmeny.

3.2.1 Imp02 - „Režim“/“Mode“

Položka se pro hlavičku a) zadává do A2.
Pro hlavičky b) a c) se bere 1.

Hodnoty:

1 - (default) Platba navazuje a přebírá hodnoty. Jsou zadány i SLM i datum od
pokud by šlo SLM s IA 1031, 1032, jde o chybu a je vypsána hláška: „Zpracujte jako režim 5 “nová sada”.

2 - Navazuje a přebírá hodnoty - hledá se SLM tarifu v číselníku SLM. Hledání probíhá odlišně dle Opv01 / Druh právního vztahu (cetpv.druh_pv)
pro Druh 6 DPČ se hledá nejmenší platná SLM s IA 2131
Druh 7 DPP se hledá nejmenší platná SLM s IA 2132
pro vše ostatní hledá tarif časové mzdy tj. nejmenší platnou SLM s IA 1101
Pozn. v tomto režimu se SLM do souboru nezadává, je vyhledána z číselníku SLM dle Druhu PV zaměstnance s výjimkou, kdy je přímo v importu zadaná.

3 - Nenavazuje - žádný záznam nebude ukončován – probíhá pouze vkládání nových záznamů.

4 - Navazuje a přebírá hodnoty - Vazbou je SLM a Typ struktury - minoritní režim – hledaný Typ struktury bereme právě a pouze ze typ_str1 (včetně null) struktury nepřebírá vyplní jen ty, které jsou v importu uvedeny

5 - Navazuje (ukončuje a začíná), ale nepřebírá hodnoty - Nová sada i více stejných SLM pro PV. Zde datum_od - 1 ukončí celou předchozí sadu hodnot SLM+PV - myšleno SLM z importního souboru.

To může být více ukončovaných záznamů s touto SLM
a stejně tak vkládaných záznamů může být více pro jednu dvojici SLM+PV.

Typicky pro SLM „Přerozdělení“, tj. s IA 1031, 1032 .
Obvykle mají záznamy Typ+Kód struktury a k tomu někdy částku a jindy procento.
Technicky v tomto režimu musíme mít pro jedno PV v importovaných záznamech stejné datum_od - pro všechny SLM tohoto PV - když nejsou, je hlášena chyba.

U režimů 1-5 je kontrolováno, jestli importovaná SLM datumově nezasahuje do vypočteného období konkrétního PV. Když ano, je hlášena chyba.

11, 12, 13, 14, 15 – stejné chování, ale kontrola na vypočtené období není prováděna. Přepočet mezd je třeba zajistit organizačně (pokud to je třeba).

“Platba navazuje” je datumová návaznost na minulý záznam pro PV+SLM (resp. i typ_str1 u režimu 4) - tj. mohou nastat 3 rovnocenné stavy:

a) je tam platný záznam - ten ukončujeme k datum_od - 1

b) je tam platný záznam a už je ukončen k datum_od - 1

c) není tam platný záznam - není co ukončit

U všech “Navazuje” potřebujeme datum_od - když není, tak od 1. dne aktuálního měsíce.

U “Nenavazuje” je to stejné – když datum_od není, do záznamu dáváme datum_od 1. dne aktuálního měsíce.

“Přebírání hodnot” z minulého záznamu u navazujících záznamů:

přebírání hodnot uplatníme pro “a)” i pro “b)” návaznosti plateb.
přebíráme základní údaje platby, které v importu nejsou jako sloupec, nebo jsou jako sloupec, ale u konkrétního záznamu je nevyplněno
0 vs nevyplněno pro nejdůležitější sloupce je tedy jinými slovy toto:

castka_enc - když je v importní sadě nevyplněno - přebereme hodnotu z případného minulého záznamu, když je 0, vložíme hodnotu 0
procento - dtto
PV, SLM - musí být - nevyplněno je chybou (u režimu 2 SLM nemusí být v importu, ale musí být nalezeno v číselníku)

3.2.2 Imp02 – Sloupce - dopočty

Seznam položek, které lze importovat, resp. přebírají v rámci návaznosti

Imp položka DB položka Default

-----------------------------------------------------------------------

id_tplatby

oscpv id_tpv

osc id_tpv

slm id_cslm

typ_vt typ_vt 0

castka_enc castka_enc

procento procento

datum_od datum_od 1. v akt. měsíci

datum_do datum_do 3333-03-03

kod_doby kod_doby slm01 nejnižší pořadí

kod_castky kod_castky slm01 nejnižší pořadí

tarif_plny_enc tarif_plny_enc

doklad doklad

hodiny hodiny

cast_uv cast_uv

duvod_zmeny_tar duvod_zmeny_tar

zuctovat 1

dalsi_xml

pozn_xml

korekce_enc

typ_str1 /cetplatby.dalsi_xml/str/@typ_str

kod_str1 /cetplatby.dalsi_xml/str/@id_cstr

typ_str2 /cetplatby.dalsi_xml/str/@typ_str

kod_str2 /cetplatby.dalsi_xml/str/@id_cstr

typ_str3 /cetplatby.dalsi_xml/str/@typ_str

kod_str3 /cetplatby.dalsi_xml/str/@id_cstr

prer_uvazek /cetplatby.dalsi_xml/@prer_uvazek

poznamka /cetplatby.pozn_xml/pozn/@hodnota

/cetplatby.pozn_xml/pozn/@datum DNESDATE

/cetplatby.pozn_xml/pozn/@autor Imp02

Vztah OSCPV a OSC:

OSCPV určuje PV jednoznačně a je pro import doporučováno
Pokud jej importující systém nezná, může být použit sloupec OSC.
předpokládá v tvaru OSC.PV tedy pořadové číslo PV je za společnou částí OSC, přičemž oddělovačem je tečka „.“.
Pak se použije kmenový PV a je to jako by bylo zadáno OSCPV kmenového PV.

DATUM_OD:

je-li sloupec prázdný, tak se bere 1. den současného měsíce
pro režimy 1-5 se kontroluje uzavřenost.

KOD_CASTKY – pokud není v importu, načteme hodnotu s minimálním pořadím z číselníku SLM pro danou SLM

KOD_DOBY – dtto

CASTKA_ENC - není-li poslána a je posílán TARIF_PLNY_ENC, tak u měsíčních plateb (kod_doby 12, 13, 336, 340) je podle týdenního úvazku přepočítán (tj. pokrácen)

3.2.3 Imp02 – Použití

Import má parametry:

*Parametr*	*Význam*
Soubor pro import:	Cesta ke XLSX souboru s daty
Smazat minulá data importovaná touto sestavou:	Import si pamatuje, které řádky, které volání vložilo a umí je po výběru smazat. POZOR ZMĚNĚNÉ OSTATNÍ ŘÁDKY (typicky datumové ukončení) UŽ IMPORT NEVRÁTÍ. NEJDE TEDY O PLNOHODNOTNÝ NÁVRAT K STAVU PŘED IMPORTEM!
Načti a zkontroluj bez uložení do databáze:	Při zaškrtnutí se vše provede, ale na závěr se do databáze nic neuloží, neprovede tedy v datech nic. Velmi dobrá věc pro kontrolu importu.

Jeho chování je popsáno v této tabulce.
Mezi parametry není Režim (mode) - ten je navržen tak, aby byl pouze v hlavičce importního XLSX souboru a nemohl už tam být změněno obsluhou. Mohlo by totiž při obejití kontrol (režimy > 10) dojít k nežádoucím úpravám dat.

A obecně - režimy mají odlišné chování a musí být v souladu s daty.

3.2.4 Imp02 – Kontroly

K určení, komu záznam nahrát, se používá buď jednoznačné OSCPV nebo OSC, kdy program k OSC části hledá kmenové PV.
Podmínkou je, že OSCPV je tvořeno jako „OSC.PV“.

PV je kontrolováno na přístupnost uživatele, který import volá (práva k řádkům, práva k SO).

Vztah položek „Částka“ (CASTKA_ENC) a „Měsíční částka na plný tarif“ (TARIF_PLNY_ENC):

- hodnoty jsou kontrolovány vůči Slm01 / v Slm01 nazvaná “Maximální výše srážky/příspěvku:”, pokud je vyplněno.

- pokud je (u měsíční platby) zadána jen částka na plný tarif, import ji umí pokrátit a uloží i pokrácenou hodnotu (dle týdenních úvazků dle konfigurovaného zaokrouhlení)

- opačný proces z částky na částku na plný tarif implementován není (problematické zaokrouhlování) – plný tarif je mazán (pokud nepřišel také importem).

KOD_CASTKY, KOD_DOBY – hodnoty z importu jsou kontrolovány na přístupnost v Slm01 pro konkrétní SLM.

DATUM_OD, DATUM_DO

je kontrolována syntaktická správnost datumů

pro režimy 1 - 5 - posouváme DATUM_OD až do prvního neuzavřeného období do budoucnosti (hledáme vždy otevřenost pro dobírku, tj. typ_vt=0)

PROCENTO – nevyplněno nebo číslo 0 – 200, povolena jsou i desetinná čísla, přesnost si zaokrouhlí db

TYP_STR1,KOD_STR1, TYP_STR2,KOD_STR2, TYP_STR3,KOD_STR3

Kontrola existence kódu v číselníku struktur cecstr (vč. nepovinného uvedení organizace id_csorg)

CASTKA_ENC, TARIF_PLNY_ENC - pokud je v číselníku Slm01 pro danou SLM vyplněna položka nazvaná “Maximální výše srážky/příspěvku:” (/cecslm.zapoc_xml/@maximalne) tak kontrolujeme, že částka tuto hodnotu nepřesahuje.

3.3 Imp09 – Import Dcd - standard

Import do denní docházky (denní vstupy) – je popsán v Doch_uzdoc Imp09

3.4 Imp11 – Import Dcm01 - standard

Import do měsíční docházky (měsíční vstupy) – je popsán v Doch_uzdoc Imp11

3.5 Imp17 – Import kódu oboru vzdělání pro ISPV (CZ)

Importní sestava umožňuje importovat kód OBORVZD - kód oboru nejvyššího dosaženého vzdělání - k jednotlivým PV zaměstnanců ze XLS souboru. Řešení předpokládá splnění těchto podmínek.

· XLS soubor obsahuje 2 sloupce

o OSCPV – osobní číslo pracovního vztahu (nezaměnit s OSC – osobním číslem zaměstnance), neboť obecně platí, že každý PV, může mít uvedený jiný kód.

o Kód – kód OBORVZD (30-ti znakový řetězec čísel a teček)

První řádek nebude importován.

Generátor kódu je možné nalézt na stránkách společnosti Trexima (https://www.ispv.cz/cz/Pro-respondenty-setreni/Aplikace-Obor-vzdelani.aspx).

3.6 Imp31 – Import dokumentů

Importní sestava. Umožňuje nahrávat dokumenty do evidence Opv31.

Je schopna i serverového provozu z Adm53 a adresáře s dokumenty k nahrání.

Komu nahrát se odvíjí ze jména souboru (Oscpv.ext resp. Osc.ext tedy např. 1216.01.docx).

Jak zaevidovat potom určí parametry této sestavy.

V případě, že jméno souboru není pouze Oscpv.ext nebo Osc.exp, ale obsahuje i další text (např. 1216.01_certifikat.jpg), je potřeba zvolit odpovídající oddělovač (parametr „Oddělovač osčpv“). Jsou povoleny pouze tři následující: pomlčka, podtržítko a mezera.

Nepovinný parametr "Do jména souboru ukládaného do db přidávat text:" umožňuje do zaevidovaného názvu souboru přidat určitý text.

Parametr "Do jména souboru ukládaného do db přidávat text:" je nepovinný.

Když jej uživatel vyplní, je pak název souboru následující: oscpv_text.ext

Jde o statický text vyjadřující, co je to za soubor (platový výměr, životopis, ...).

Maximální délka s oscpv a podtržítkem je 80 znaků.

3.7 Imp32 - Import individuálních kalendářů

Tento import je určený pro zaměstnance bez evidence docházky v EGJE. Slouží pro nahrání rozvrhu fondu pracovní doby. Fond je uložen do denních záhlaví, která výpočet mzdy upřednostňuje před rozvrhem z Kal01. Je třeba pokrýt vždy celý měsíc.

Import vyžaduje, aby výplatní termín byl otevřený. U spočtených zaměstnanců výpočet zruší.

V případě aktivace se pro PV s nástupem/ukončením v období importu může provést doplnění kalendáře ve dnech neplatného PV podle zvoleného režimu.

3.7.1 Parametry sestavy

Parametry sestavy pro spuštění:

! Soubor: - název souboru včetně cesty, kde je uložen

Procházet - tlačítko pro vyhledání souboru pro import

! Doplnit plán na obd. nástup/výstup:

0 – Nedoplňovat

1 - Doplňovat Po/Pa prům. směnu na FPD podle prům. týdne

2 - Doplňovat Po/Pa prům. směnu na FPD podle kalendáře

3 - Doplňovat podle plán. směny kalendáře

! Generovat protokol: - zaškrtávátko pro aktivaci zobrazení protokolu

3.7.2 Popis importního souboru

Importní soubor je ve formátu XLS(X), a očekávají se sloupce:

oscpv, popis, období, 1, 2, ...... 31, kde

oscpv obsahuje osobní číslo PV,

popis import nevyužívá - typicky je v něm celé jméno,

období ve tvaru RRRR-MM, povinný údaj,

čísla v hlavičce reprezentují jednotlivé dny v období (počet hodin a typ směny). Hodnotově ve sloupci očekáváme buď

prázdné pole - není směna

desetinné číslo - počet hodin směny

(automaticky bereme typ dne 1 Pracovní směna)
např. 7,5

desetinné číslo a P - dtto např. 7,5P

desetinné číslo a S - směna ve svátek

Písmenné specifikátory (jsou dány číselníkem typ dne):

	JPČ typ_dne	Specifikátor
1	Pracovní směna	P
2	Sváteční směna	S
3	Volný svátek - pracovní den	N
4	Volný svátek - volný den	C
5	Víkend	V
6	Klouzavé volno	K
7	Ostatní volno	M

3.7.3 Import dne svátku:

Zpracování importu pro den svátku.

a/ import dne svátku s nastavením hodin ale bez označení svátku

v tomto případě nastavíme režim svátku podle Kal01.Typ generovaní svátku pro akt. přiřazený kalendář pro importované PV

pokud Kal01.Typ generovaní svátku = 2 nastavíme typ dne = 2

pokud Kal01.Typ generovaní svátku = 3 nastavíme typ dne = 3

b/ import dne svátku s nevyplněným polem dne nebo s nastavením 0 bez označení typu dne

očekáváme povinné vyplnění dne svátku 0C, 0N nebo 0S, nebo nC, nN nebo nS

pokud pole pro import není vyplněno podle požadavky, zobrazíme hlášení:

Imp32-01 FAT: “Řádek <NN>, den státního svátku <datum> je nevyplněn. Povinné vyplnění nC, nN nebo nS (n je 0 nebo hodiny) ! Import ukončen !”

a ukončí se celý import

3.7.4 Automatické doplnění pracovních směn pro dny neplatného PV

V případě potřeby se může automaticky vykrýt čas před nástupem, resp. po ukončení PV v akt. období - pro stanovení FPD na měsíc.

Funkce se aktivuje a volí režim vyplnění nastavením parametru

„Doplnit plán na obd. nástup/výstup:“ - s volbou:

0 – Nedoplňovat

1 - Doplňovat Po/Pa prům. směnu na FPD podle prům. týdne

2 - Doplňovat Po/Pa prům. směnu na FPD podle kalendáře

3 - Doplňovat podle plán. směny kalendáře

Popis funkce

Pokud je „Doplnit plán na obd. nástup/výstup:“> 0.

Pokud je PV platné pro celé aktuální období, tak se doplnění neprovádí.

Spočteme importované hodiny z plánu směn:

FPD = součet hodin pro PV a akt. období a typ_dne = 1, 2, 3

Určíme průměrnou směnu

a spočteme požadovaný plánovaný fond: PFPD podle „Doplnit plán…“

= 1 (Doplňovat Po/Pa prům. směnu na FPD podle prům. týdne)

DATUM = datum nástupu, pokud je v rámci období nebo datum výstupu, pokud je v akt. období (pokud jsou oba v měsíci, tak datum nástupu)

PSMENA = Opv01, Popis, Průměrná délka směny: pro PV a platnost k DATUM

PDNI = Opv01, Popis, Průměrný týdenní počet směn: pro PV a platnost k DATUM

PFPD = PSMENA x PDNI x 4.3480 (Tj. průměrný počet týdnů v měsíci)

= 2 (Doplňovat Po/Pa prům. směnu na FPD podle kalendáře)

PFPD = součet hodiny z Kal01, Dny kalendáře pro kalendář přiřazen na Opv01 v rozsahu období při zohlednění případných časových řezů

= 3 (Doplňovat podle plán. směny kalendáře)

PFPD = 999

Hodiny pro vyrovnání FPD:

FPDN = FPPD - FPD

Pokud FPDN <= 0 (odpracovaný celý FPD pro aktuální PV)

Zobrazí se hlášení: IMP32101 <OSČPV> Hodiny do FPD <FPD> naplněné v rámci platného PV <PFPD>

Spustíme cyklus pro všechny dny akt. období pro PV, a pro každý den provedeme:

Začátek cyklu:

je DEN platný pro PV (DEN je v rozsahu Nástup/Výstup) ?:

Ano - pokračuj na další DEN

je den neplatný pro PV (DEN je mimo rozsah Nástup/Výstup) a hodiny v plánu > 0 ?

Zobrazí se hlášení: IMP32102 <OSČPV> Na den <d> mimo PV, naplánována směna <h> hod.

pokračuj na další DEN

je „Doplnit plán…“ 1 nebo 2 ?

Ano: Je DEN sobota/neděle ?

Ano: Ano - pokračuj na další DEN

je „Doplnit plán…„Doplnit plán…“ = 3

Je den bez plánované směny (typ dne = 1, 2, 3)?

Ano: Ano - pokračuj na další DEN

// Máme neplatný den pro PV a je Po/Pa nebo den s plánovanou směnou, doplníme do plánu a zkontrolujeme FPD

Aktualizujeme záznam plánu pro DEN:

Typ dne = 1

Pokud je „Doplnit plán…“ 1 nebo 2 ?

Ano: PSMENA = Opv01, Popis, Průměrná délka směny:

Pokud je „Doplnit plán…“ 3 ?

Ano: PSMENA hodiny z Kal01, Dny kalendáře

Pokud FPDN >= PSMENA ? (doplníme plnou směnu)

Ano: Plán hodiny = PSMENA

FPDN = FPDN – PSMENA (upravíme rozdíl pro vyrovnání)

Ne: (FPDN < PSMENA - doplníme částečnou směnu)

Plán hodiny = FPDN

FPDN = 0

Konec cyklu:

Pokud je „Doplnit plán…“ 1 nebo 2 a FPDN > 0 (nedošlo k vyrovnání na fond)

Zobrazí se hlášení: IMP32103 <OSČPV> Nezdařilo se vyrovnání do FPD <PFPD> o <FPDN> hod.

A pokračuj na další PV.

3.7.5 Kontroly importu

3.7.5.1 Chybný znak v buňce

Kontrolujeme obsah každé buňky na převoditelný text do čísla (problém způsobují především neviditelné znaky).

Pokud narazíme na buňku s nepřevoditelným obsahem, zobrazíme hlášení:

Imp32-02 Neplatný znak v řádku <x> sloupci <y>, opravte!

kde x a y určují chybnou buňku

buňku přeskočíme a pokračujeme zpracováním následující buňky

Počítáme, počet výskytů těchto chyb a při 30 výskytu, zobrazíme hlášení:

Imp32-03 V Importu není možné pokračovat, překročen povolený počet chyb.

a import je předčasně ukončen (žádná změna se neuloží).

Podle protokolu opravíme obsah v chybných buňkách a import zopakujeme.

3.8 Imp33 - Import fotografií

Sestava očekává fotografie buď v ZIP souboru - pro oba klienty resp. ve složce - pro java klienta.

Fotografie je soubor .jpg, .png, nebo .gif s názvem OSCPV a jednou z těchto extenzí.

Fotografie je zobrazována na Osb02, Pkz01 resp. miniatura v Dcu06.

Upozornění: Doporučujeme maximální rozlišení fotografie šířka 180 px a výška 240 px, neboť v EGJE klientovi je fotografie na toto rozlišení přepočítávána. Větší fotografie tedy zbytečně zatěžují databázi, síť, paměť serveru i procesor. Proveďte proto před nahráním konverzi na tento formát a nenahrávejte do systému mnohamegabytové soubory z dnešních fotoaparátů a mobilů!

4 Technologické poznámky a postupy pro uživatele

Většina importů nahrává buď z textových souborů nebo ze souborů Excel (xls, xlsx).

Importní sestavy je třeba psát tak aby nenarušily datovou integritu včetně uzavřenosti dat (uzávěrky osoby, období apod.).

5 Upozornění

Seznam přístupných částí dokumentace je zde.