Zobrazí formulář pro editaci mzdových položek a měsíčních výsledků. Používá se v nastavení Portálu pro společnou hromadnou editaci měsíčních výsledků nebo v XML formulářích.
V XML formulářích musí tomuto tagu předcházet tagy
vyberobdobi
a vyberrozdeleni
(rozdělení může být nastaveno i pomocí tagu nastavrozdeleniformulare
).
Zadané hodnoty se zapisují přímo do databáze do mzdových položek (aplikace = "ADS") a měsíčních výsledků.
V případě změny se hodnoty přepisují - v databázi je vždy poslední zadaná hodnota.
<editacemesicnich sirkapole="55" vcetnepodrizenych="0/1/2/3" datumpp="0/1/2/-x" prepocetdochazky="0/1/2" proklikzpracovana="0/1/2/3" kontrolovatprava="0/1" prava="kod_typu_prava"> <filtreditacemesicnich> SQL filtr pro tabulky PracovniPomer a Osoba </filtreditacemesicnich> <sloupeceditacemesicnich typ="OSOBNICISLO"/> <sloupeceditacemesicnich typ="JMENO"/> <sloupeceditacemesicnich typ="PRIJMENI"/> <sloupeceditacemesicnich typ="JMENOPRIJMENI"/> <sloupeceditacemesicnich typ="MP" kod="kod_mzdove_polozky" lzeeditovat="0/1/check" nadpis="Nadpis_Sloupce" rozlisitrozdeleni="0/1/2/3" minimum="castka" maximum="castka" kod_limit_minimum="kod_polozky_s_minimem" kod_limit="kod_polozky_s_limitem" povolitprekrocenilimitu="0/1" neprekrocitelnylimit="hodnota" skrytnuly="0/1" zobrazitsoucet="0/1" typrozdeleni="123" /> <sloupeceditacemesicnich typ="PMP" kod="kod_mzdove_polozky" lzeeditovat="0/1/check" nadpis="Nadpis_Sloupce" rozlisitrozdeleni="0/1/2/3" povinna="0/1" /> <sloupeceditacemesicnich typ="MV" kod="kod_casove_slozky" jednotka="H/D/K" lzeeditovat="0/1/check" nadpis="Nadpis_Sloupce" format="number2" skrytnuly="0/1" limit="hodnota" kod_limit="kod_polozky_s_limitem" povolitprekrocenilimitu="0/1" neprekrocitelnylimit="hodnota" zobrazitsoucet="0/1"/> <sloupeceditacemesicnich typ="PMV" kod="kod_casove_slozky" lzeeditovat="0/1/check" nadpis="Nadpis_Sloupce" /> <sloupeceditacemesicnich typ="R" nadpis="Nadpis_Sloupce" class="no-wrap align-left"/> <sloupeceditacemesicnich typ="RP" nadpis="Nadpis_Sloupce" /> <sloupeceditacemesicnich typ="ROZD" typrozdeleni="123" datumrozdeleni="-1/0/1/2" nadpis="Nadpis_Sloupce" sqlfiltr="" /> <sloupeceditacemesicnich typ="ROZDP" typrozdeleni="123" datumrozdeleni="-1/0/1/2" nadpis="Nadpis_Sloupce" sqlfiltr="" /> <sloupeceditacemesicnich typ="ROZDIMG" typrozdeleni="123" nadpis="Nadpis_Sloupce" /> <sloupeceditacemesicnich typ="NASTUP" nadpis="Datum nástupu" align="right" styl="color: #b0b0b0;"/> <sloupeceditacemesicnich typ="UKONCENI" nadpis="Ukončení PP" styl="font-weight:bold; color:red; text-align:right;"/> <sloupeceditacemesicnich typ="TYPPP" nadpis="Typ PP" /> <sloupeceditacemesicnich typ="UZIVATELSKA" index="1" nadpis="Uživ.1" styl="font-weight:bold"/> <sloupeceditacemesicnich typ="UZIVATELSKAPP" index="1" nadpis="Uživ. pracovního poměru 1" styl="font-weight:bold"/> <sloupeceditacemesicnich typ="SCHVAL1" nadpis="Schválení 1" styl='text-align:center'/> <sloupeceditacemesicnich typ="SCHVAL2" nadpis="Schválení 2" styl='text-align:center'/> <sloupeceditacemesicnich typ="SCHVAL3" nadpis="Schválení 3" styl='text-align:center'/> <sloupeceditacemesicnich typ="SCHVAL" nadpis="Schválení" styl='text-align:center'/> <sloupeceditacemesicnich typ="SCHVALMZDY" nadpis="Zpracováno ve mzdách" styl="text-align:center"/> <sloupeceditacemesicnich typ="EDIT" nadpis="" styl="text-align:center" target="zpracovanadochazkawin"/> <sloupeceditacemesicnich typ="SQL" nadpis="" sql="SQL dotaz s parametry" zobrazitSoucet="1" /> ... <textchybyneprekrocitelnylimit>Hláška, která se zobrazí při překročení hodnoty "neprekrocitelnylimit"</textchybyneprekrocitelnylimit> </editacemesicnich>
<editacemesicnich sirkapole="55" datumpp="0/1/2/-x" prepocetdochazky="0/1" proklikzpracovana="0/1/2/3" prefix="MV1_" content="{$PROMENNA_S_OBSAHEM}" />
editacemesicnich
:sirkapole
určuje šířku editovatelného pole v pixelechvcetnepodrizenych
určuje, jestli se seznam osob načte včetně podřízených rozděleníraditpodlerozdeleni
je možné nastavit jestli se má seznam osob seřadit podle rozdělení.datumpp
určuje, podle kterého datumu se určí příslušnost zaměstnance do zvoleného rozdělení:prepocetdochazky
určuje, jestli se má po změně nějaké hodnoty provést pro daného zaměstnance přepočet docházky. Při hodnotě 2 se přepočet provede vždy (i když nedošlo k žádné změně)proklikzpracovana
určuje, jestli bude jméno zobrazeno jako odkaz (proklik) do zpracované docházky osoby. Možné hodnoty jsou:
prefix
slouží k rozlišení více tagů editacemesicnich
v jednom formuláři. Pokud je tag ve formuláři jen jednou, tak tento parametr není povinný.maxpocetosobproprepocet
určuje maximální počet pracovních poměrů, které se přepočítají jedním voláním agenta ADS_Agent_Processing. Výchozí hodnota je 20.parametryagentaprepoctu
určuje parametry agenta, které se použijí pro přepočet docházky.filtrovatzamestnance
určuje jestli se načtou jen pracovní poměry s příznakem zamestnanec > 0
u kterých se zpracovává docházka. Výchozí hodnota je 1.skrytduplicitni
určuje jestli se každý pracovní poměr zobrazí jen jednou, i když je zařazen na více rozděleních.kontrolovatprava
umožňuje zapnout kontrolu práv na editaci měsíčních výsledků a mzdových položek i pokud je tag použit v samostatném XML.
POZOR: Pokud uživatel nemůže zobrazit měsíční výsledek nebo mzdovou položku zaměstnance, zaměstnanec se vůbec nezobrazí.prava
umožňuje nastavit typ práv, kterým se řídí zobrazení seznamu osob. Pokud není nastaven, zobrazí se všechny osoby, kterým může uživatel prohlížet docházku nebo mzdové položky.name
umožňuje nastavit proměnnou zadaného jména - obsahuje řetězec se seznamem ID pracovních poměrů oddělených čárkou nebo zadaným oddělovačem.
Dále nastavuje proměnnou <name>_pole, která také obsahuje seznam ID pracovních poměru ale jako pole.delimiter
umožňuje změnit oddělovač, který se použije pro proměnnou (viz parametr name).fixedcols
umožňuje nastavit počet sloupců, které zůstanou zobrazené při horizontálním scrolování stránky.kontrolaobdobi
umožňuje nastavit způsob kontroly uzavřeného období. Možné hodnoty jsou:
ads
= Pokud je období uzavřeno v docházce nebo ve mzdách, nebude povolena editace. Tato hodnota je výchozí.mzdy
= Kontroluje se pouze uzavření období ve mzdách.jenads
= Kontroluje se pouze uzavření období v docházce.prvniotevrene
= Editace je povolena pouze v případě, že období otevřeno a předchozí období je již uzavřeno.nekontrolovat
= Uzavření období se vůbec neověřuje.kodaplikace
umožňuje nastavit kód aplikace, ze které se načítá období (2022-12: prozatím ale editacemesicnich nefunguje v databázi bez docházky - např. kvůli SchvaleniDochazky)exportvariablename
umožňuje export dat - například pro vygenerování obsahu sestavy. V případě že je nastaven,
tak se do proměnné zadaného jména uloží obsah formuláře v textové podobě.exportrowdelimiter
umožňuje nastavit oddělovač řádků pro export. Výchozí hodnota je "\r\n".exportcoldelimiter
umožňuje nastavit oddělovač řádků pro export. Výchozí hodnota je ";".typ
může být:
OSOBNICISLO
- Osobní čísloJMENO
- JménoPRIJMENI
- PříjmeníJMENOPRIJMENI
- Jméno a příjmeníIDPP
- Id pracovního poměruMP
- mzdová položkaPMP
- poznámna mzdové položky - Pozor! Poznámka mzdové položky by měla být uvedena až za příslušnou mzdovou položkou.MV
- měsíční výsledekPMV
- poznámka k měsíčnímu výsledku - Pozor! Editovat lze jen časové složky, které nejsou přepočítávané docházkou!R
- kód rozdělení (typ rozdělení podle formuláře)RP
- zobrazí popis rozdělení (typ rozdělení podle formuláře)ROZD
- zobrazí kód rozdělení - je možné zadat sql filtr, např. "Hlavni = 1" ROZDP
- zobrazí popis rozdělení - je možné zadat sql filtrROZDIMG
- zobrazí ikony rozdělení zadaného typu (podle nastavení pole cssClassObrazku)NASTUP
- datum nástupuUKONCENI
- datum ukončeníTYPPP
- kód typu pracovního poměruUZIVATELSKA
- uživatelské pole z tabulky osoba - musí být zadán parametr index (1 - 20)SCHVAL1
- schválení docházky úrovní 1 (zelená - zpracováno)SCHVAL2
- schválení docházky úrovní 2 (žlutá - zkontrolováno)SCHVAL3
- schválení docházky úrovní 3 (červená - schváleno)SCHVAL
- schválení docházky - zobrazí nejvyšší úroveň schválení, která je nastavenaSCHVALMZDY
- schválení docházky - zobrazí jestli jsou již zpracovány mzdyEDIT
- odkaz na zobrazení zpracované docházky v novém okněSQL
- výsledek SQL dotazu s parametry %RC%, %OsobniCislo%, %DatumNastupu%, %PocatekObdobi%, %KonecObdobi%,
%PocatekNasledujicihoObdobi%, %PocatekPredchozihoObdobi%, %KonecPredchozihoObdobi%,
%PocatekCtvrtleti%, %KonecCtvrtleti%, %PocatekPredchozihoCtvrtleti%, %KonecPredchozihoCtvrtleti%
razeni
).
Sloupce ROZD a ROZDP musí mít zadán kód typu rozdělení. Parametr "datumrozdeleni" určuje, ke kterému dni se bude zjišťovat
zařazení osoby na rozdělení (-1 = stejně jako datumpp u celého formuláře, 0 - kdykoliv v období, 1 - na začátku, 2 - na konci).
Výchozí hodnota je -1.
Parametr nadpis
určuje zobrazený nadpis sloupce
Parametr kod
určuje kód mzdové položky/časové složky
Parametr title
(nepovinný) umožňuje nastavit plovoucí titulek pro hlavičku sloupce
Parametr jednotka
určuje, jestli se u časové složky zobrazí hodiny (H), dny (D) nebo kalendářní dny (K)
Parametr format
určuje formát zobrazených dat. Může být např. int, number2, number_2, number1, number_1, nebo obecný formát pro funkci sprintf
Parametr skrytnuly
určuje, jestli se mají skrýt nulové hodnoty (tj. pokud záznam v databázi je, ale obsahuje hodnotu 0)
Parametr zobrazitsoucet
umožňuje skrýt součet ve sloupci. Pro typ sloupce SQL je ve výchozím nastavení vypnutý a je možné jej zapnout.
Parametr rozlisitrozdeleni
u mzdové položky (a od verze 4.2112.158 také u poznámky mzdové položky) určuje, jestli se má načíst/zapsat mzdová položka pro zadané rozdělení.
typrozdeleni
lzeEditovat
určuje, jestli je sloupec editovatelný. Hodnota "check"
určuje, že se zobrazí jako checkbox.pravaEditace
určuje typ práva, který se použije pro určení práva uživatele na editaci buňky. Pokud není zadán, vybere se automaticky podle typu sloupce.maximum
(nepovinný, původní název parametru limit) určuje maximální povolenou hodnotuminimum
(nepovinný) určuje minimální povolenou hodnotu. Kontroluje se jen v případě, že je hodnota zadána. kod_limit_minimum
(nepovinný) určuje kód časové složky/mzdové položky, která určuje minimální limitkod_limit
(nepovinný) určuje kód časové složky/mzdové položky, která určuje maximální limitpovolitprekrocenilimitu
(nepovinný) určuje, jestli je povoleno překročit zadaný limit. Pokud ano,
tak v případě překročení musí uživatel navíc zaškrtnout "Souhlasím s překročením limitu".neprekrocitelnylimit
(nepovinný) určuje maximální možnou hodnotu, které nemůže být překročena ani při zaškrtnutí "Povolit překročení"povinna
u poznámky určuje, jestli musí být poznámka vyplněna, pokud je zadána nějaká hodnotadefault
je možné přednastavit výchozí text, který se zobrazí, pokud položka nemá žádnou hodnotu.align
lze nastavit zarovnání sloupce (left
, right
, center
)class
lze nastavit css třídu sloupceheaderclass
lze nastavit css třídu záhlaví sloupcefooterclass
lze nastavit css třídu patičky sloupcestyl
(viz příklad u "R") lze nastavit css styl sloupce tabulkyformat
je možné nastvit formát zobrazené hodnoty, např. number1, number_1, number2, number_2, int, hodiny, minuty, sekundy, timeofday, anoneprava
je možné ovlivnit viditelnost hodnot v daném sloupci, nebo skrýt celý sloupec. Zadává se kód typu práva.
Hodnota ve sloupci se zobrazí jen v případě, že má uživatel na daného zaměstnance příslušné právo.
Pokud uživatel nemá toto právo vůbec (má nastaveno zakázat), tak se sloupec nezobrazí.profil
se omezí zobrazení sloupce jen pro uživatele se zadaným profilem. Je možné zadat i více profilů oddělených středníkem.condition
je možné zadat PHP podmínku, která určí, jestli se sloupec má zobrazit. V podmínce je možné použít proměnnou %OBDOBI%.
Například zobrazení sloupce jen pro první měsíc v roce lze provést takto: condition="date('n', %OBDOBI%) == 1"
razeni
zajistí, že se podle tohoto sloupce seznam seřadí. Zadejte celé kladné číslo. Pokud je více sloupců s nastaveným řazeným, tak se data řadí postupně podle hodnoty parametru,
tj. nejdříve podle sloupce s razeni="1"
, pak podle sloupce s razeni="2"
atd.options
umožňuje nastavit seznam možných voleb (jednotlivé texty oddělené středníkem). Pozor! Texty musí odpovídat zobrazovaným hodnotám. Příklad: options=";500,00;1 000,00;2 000,00"export
určuje, na jaký výstup se bude sloupec zobrazovat.
Pokud je prázdný (výchozí hodnota), zobrazí se všude.
Hodnota html
nastaví zobrazení jen pro HTML stránku (nebude v exportu),
hodnota export
mastaví zobrazení jen do exportu (nebude v html)exportFormat
určuje formát pro export (funguje stejně jako parametr format, ale použije se při generování dat pro export).
Tagem filtreditacemesicnich
(nepovinný) je možné omezit výběr osob pomocí SQL dotazu
sloupce
, ale je zastaralý!
Místo něj je vhodnější (a především přehlednější) použít vnořené tagy sloupeceditacemesicnich
MP:[kod]:0/1:Nadpis sloupce
- kod je kód mzdové pložky, 0/1 určuje, jestli bude editovatelný MV:[kod]:H/D/K:0/1:Nadpis sloupce
- kod je kód časové složky, H/D/K určuje jednotku (hodiny/dny/kalendářní dny), 0/1 určuje, jestli bude editovatelný<sqlvariable>
nebo <longvariable>
.
Pokud je parametr content zadán, tak je případný vnitřní obsah tagu ignorován.