RON dokumentace

Nastavení přehledu zpracované docházky

Umožňuje změnit zobrazená data v hromadném přehledu zpracované docházky.

Ukázka nastavení:

        <?xml version="1.0"?>
        <prehledzpracovane soucet="1" proklikzpracovana="1" maximalnipocetosob="100">
            <style>
                .soucetdv { font-weight: bold;  }
            </style>

            <sloupec typ="MV" kod="100" jednotka="H" nadpis="Celkem" style="font-weight: bold" />

            <dendochazky kodFiltru="grafika" filtr="Grafické zobrazení">
                <data typ="SCHVAL"  />
                <data typ="DOCH_G" width="35" height="10" />
            </dendochazky>

            <dendochazky obarvit="absence">
                <data typ="ABSENCE" nadpis="Absence" style="font-size: 80%;" format="%ZKRATKA% (%KOD%)" titleFormat="%POPIS% %DELKA%" />
            </dendochazky>

            <dendochazky kodFiltru="vysledky" filtr="Denní výsledky" nadpis="Odpr." obarvit="dochazka">
                <data typ="DV" kod="100" jednotka="H" style="font-weight:bold; color:lightgrey;" />
            </dendochazky>
            <dendochazky kodFiltru="vysledky" nadpis="Přesčas" obarvit="kontrola">
                <data typ="DV" kod="110" jednotka="H" />
            </dendochazky>
            <dendochazky kodFiltru="stravenky" filtr="Stravenky" nadpis="Strav.">
                <data typ="DV" kod="994" jednotka="K" style="background:white; width: 20px; color: blue; border: 1px solid grey; border-radius: 2px; margin: 0 auto;"/>
            </dendochazky>
            <dendochazky kodFiltru="kontroly" filtr="Kontroly">
                <data typ="KONTROLY" style="vertical-align:middle"/>
                <data typ="DOC" style="vertical-align:middle"/>
            </dendochazky>

            <sloupec typ="MV" kod="100" jednotka="D" nadpis="Dnů" format="number_2" />
            <sloupec typ="KONTROLY" zobrazitVse="0"/>

            <sloupec typ="MP" kod="115" nadpis="MP 115" />
            <sloupec typ="MP" kod="114" nadpis="MP 114" rozlisitrozdeleni="1"/>
            <sloupec prava="editace_mv" typ="UZIVATELSKA" index="1" nadpis="Uživatelska 1" style="font-style:italic"/>
        </prehledzpracovane>



    


Nastavení může obsahovat několik elementů <dendochazky> a <sloupec>. Pokud obsahuje alespoň jeden <dendochazky>, zobrazí se v tabulce seznam dnů a pro každý <dendochazky> jeden řádek (u každé osoby) s vybranými daty - vnořený element <data>.
Element <sloupec> zobrazuje měsíční data (například měsíční výsledky, mzdové položky), nebo další informace o osobě (například uživatelské položky).

Atributy tagu <prehledzpracovane>

Parametr soucet určuje, jestli se zobrazí sloupec se součtem denních výsledků.

Parametr proklikzpracovana určuje, jestli se zobrazí proklik do zpracované docházky:

Parametr datumpp určuje, ke kterému dni se určí příslušnost zaměstnance k rozdělení:

Parametr maximalnipocetosob určuje maximální počet řádků, které se zobrazí. Výchozí hodnota je 100.

Nastavení buňky v denním přehledu - <dendochazky>

Vzhled buňky je možné nastavit pomocí atributů:
nadpis="Text nadpisu" - text, který se zobrazí na řádku před denními daty
title="HTML titulek buňky" - text, který se zobrazí jako hint u každé hodnoty
kodfiltru="kod" filtr="popis filtru"- nepovinné parametry, které umožní uživateli vypnout celý tento řádek. Například nastavení
   <dendochazky kodFiltru="kontroly" filtr="Kontroly">
umožní zapnutí/vypnutí celého řádku uživatelem - viz popis nastavení filtrů
style="css styl" - css styl, který se přiřadí všem buňkám daného řádku.
class="cssClass" - css třída, která se přiřadí všem buňkám daného řádku. Lze použít pro nastavení stylů v uživatelských css.
obarvit="kontrola/absence/dochazka" - nepovinný parametr, který určuje, podle čeho se má buňka obarvit.
  • kontrola - buňka se obarví podle barvou kontroly v daném dni
  • absence - buňka se obarví podle plánované absence (barvou operace)
  • dochazka - buňka se obarví podle záznamů zpracované docházky - barvou operace, která v daném dni trvala v součtu nejdéle
Například <dendochazky obarvit="kontrola"> obarví buňku podle výsledku kontroly v daném dni
zobrazit="0/1" - nepovinný parametr, který umožní skrýt řádek, aniž by se musel smazat nebo zapoznámkovat
profil="..." - nepovinný parametr, který umožní zobrazit řádek jen uživatelům s konkrétním profilem. Je možné zadat i více profilů oddělených středníkem.

Data zobrazovaná v buňce

Zobrazované údaje se konfigurují pomocí elementu <data>
<data typ="SCHVAL"  />
Zobrazí pruh schválení - barva se určí podle nejvyšší schválené úrovně. Kromě typu SCHVAL je možné popužít také SCHVAL1, SCHVAL2 a SCHVAL3, které zobrazují jen jednu úroveň schválení.
<data typ="DOCH_G" width="35" height="10" />
Zobrazí časovou osu s grafickým zobrazením záznamů docházky.
<data typ="ABSENCE" nadpis="Absence" format="%ZKRATKA% (%KOD%)" titleFormat="%POPIS% %DELKA%" />
Zobrazí naplánovanou absenci. Atribut format určuje text, který se zobrazí v buňce a titleFormat určuje, co se zobrazí v titulku při najetí myší. V textu je možné použít proměnné %KOD%, %POPIS%, %ZKRATKA%, %DELKA%
<data typ="DV" kod="100" jednotka="H/D/K"/>
Zobrazí hodnotu denního výsledku. Atribut kod určuje časovou složku, jednotka určuje, jestli se zobrazí hodiny, dny nebo kalendářní dny. Dále je možné zadat atributy format a style.
<data typ="DVR" kod="100"/>
Rozepíše hodnotu denního výsledku podle rozdělení (data z tabulky DenniVysledekR). Atribut kod určuje časovou složku, Dále je možné zadat atribut style.
<data typ="SMENA"/>
Zobrazí směnu podle kalendáře nebo plánování kapacit (podle nastavevní přiřazeného kalendáře)
<data typ="KONTROLY"/>
Zobrazí výsledky denních kontrol docházky
<data typ="DOC"/>
Zobrazí dokumenty ke dni docházky
Pomocí parametru soucet="0" u tagu data je možné vypnout zobrazení součtu pro danou položku.

Sloupce s měsíčními údaji

<sloupec typ="MV" kod="100" jednotka="H/D/K" nadpis="Celkem"/>
Zobrazí měsíční výsledek výpočtu pro nastavenou časovou složku (kod)
<sloupec typ="MP" kod="1234" nadpis="Odměna" format="number2" />
Zobrazí hodnotu pro nastavenou mzdovou položku (kod)
<sloupec typ="KAL" />
Zobrazí první přiřazený kalendář v daném období. Parametrem format je možné nastavit formát zobrazení. Lze použít proměnné %KOD% a %POPIS%. Výchozí formát je
<span title="%POPIS%">%KOD%</span>
<sloupec typ="KONTROLY" zobrazitVse="0" nadpis="Kontroly"/>
Zobrazí výsledky měsíčních kontrol a pokud je zobrazitVse="1" tak i denních kontrol

Schválení docházky

<sloupec typ="SCHVALENI" nadpis="Schválení" format="check" class="muj-class-schvaleni"/>
Zobrazí zaškrtávátko pro nejvyšší úroveň, která je schválena až do konce měsíce
<sloupec typ="SCHVALENI" uroven="1" nadpis="Schválení" format="yes" class="muj-class-schvaleni"/>
<sloupec typ="SCHVALENI" uroven="1" nadpis="Schválení" class="muj-class-schvaleni"/>
<sloupec typ="SCHVALENI" nadpis="Schválení" class="muj-class-schvaleni"/>
<sloupec typ="SCHVALENI" uroven="all" format="yesno" nadpis="Schválení" class="muj-class-schvaleni"/>
<sloupec typ="SCHVALENI" uroven="all" nadpis="Schválení" class="muj-class-schvaleni"/>
Zobrazí schválení docházky. Formát může být check (zobrazí "fajfku"), yes (zobrazí ANO při schválení do konce měsíce), yesno (zobrazí ANO/NE), table (zobrazí jen obarvenou buňku tabulky jako ve zpracované docházce), jinak zobrazí datum. Pokud je zadán parametr uroven, zobrazí konkrétní úroveň. Pokud není zadán, tak zobrazí:
  • nejvyšší úroveň schválenou do konce měsíce (pro formáty check, yes a yesno)
  • nejvyšší úroveň, která má zadanou nějakou hodnotu

Rozdělení

<sloupec typ="ROZD" typrozdeleni="11" nadpis="Kódy rozdělení" />
<sloupec typ="ROZDP" typrozdeleni="11" nadpis="Názvy rozdělení" />
<sloupec typ="ROZDIMG" typrozdeleni="11" nadpis="Ikony rozdělení" />
Zobrazí seznam rozdělení (kód, popis nebo obrázek)

Údaje osoby

<sloupec typ="JMENO" nadpis="Jméno" proklikzpracovana="1"/>
<sloupec typ="PRIJMENI" nadpis="Příjmení" proklikzpracovana="1"/>
<sloupec typ="JMENOPRIJMENI" nadpis="Jméno" proklikzpracovana="1"/>
<sloupec typ="OSOBNICISLO" nadpis="Osobní číslo" proklikzpracovana="1"/>
Zobrazí jméno, přijmení, osobní číslo. Parametr proklikzpracovana určuje, jestli se zobrazí jako odkaz do zpracované docházky (0 = není to odkaz, 1 = ano, 2 = ano, zobrazí se v novém pojmenovaném okně, 3 = ano, zobrazí se v novém okně)
<sloupec typ="NASTUP" nadpis="Nástup"/>
Zobrazí datum nástupu osoby
<sloupec typ="UZIVATELSKA" index="1" nadpis="Uživatelska 1"/>
Zobrazí uživatelské pole osoby
<sloupec typ="UZIVATELSKAPP" index="1" nadpis="Uživatelska PP 1"/>
Zobrazí uživatelské pole pracovního poměru
<sloupec typ="FOTO" />
Zobrazí fotografii osoby

SQL výraz

<sloupec typ="SQL" nadpis="..." format="..." sql="..." />
Zobrazí výsledek SQL dotazu. První sloupec výsledné tabulky se zobrazí, případný druhý sloupec se použije pro title. SQL výraz může obsahovat parametry: %RC%, %OsobniCislo%, %DatumNastupu%, %PocatekObdobi%, %KonecObdobi%, %PocatekNasledujicihoObdobi%, %PocatekPredchozihoObdobi%, %KonecPredchozihoObdobi%, %PocatekCtvrtleti%, %KonecCtvrtleti%, %PocatekPredchozihoCtvrtleti%, %KonecPredchozihoCtvrtleti%
Příklad: zobrazení kalendáře přiřazeného na počátku období
          <sloupec typ="SQL" nadpis="Kal." title="Kalendář"
               sql="
                 SELECT PrirazeniKalendare.Kalendar FROM PrirazeniKalendare
                 WHERE RC = %RC%
                 AND OsobniCislo = %OsobniCislo%
                 AND DatumNastupu = %DatumNastupu%
                 AND PlatnostOd &lt;= %PocatekObdobi%
                 AND (PlatnostdO &gt;= %PocatekObdobi% OR PlatnostDo IS NULL)" />
        

Parametry sloupců

styl="..." - nastaví sloupci css styl
cssClass="..." - nastaví sloupci zadanou css class
prava="..." - typ práva, kterým se řídí zobrazení sloupce
profil="..." - zobrazí sloupec jen uživatelům se zadaným profilem. Je možné zadat i více profilů oddělených středníkem.
condition="..." - skryje sloupec, pokud se zadaná PHP podmínka vyhodnotí jako false. Lze použít parametr %OBDOBI%. Například condition="date('n', %OBDOBI%) == 1" zobrazí sloupec jen pro leden.

Uživatelské nastavení stylu

Pomocí tagu <style> je možné nastavit uživatelský styl, který se vloží do stránky.