RON dokumentace

Nastavení sloupců zpracované docházky

Umožňuje změnit zobrazené sloupce v přehledu zpracované docházky, jejich pořadí, případně povolit nebo zakázat jejich editaci.

Výchozí nastavení:

    <?xml version="1.0"?>
    <zpracovanadochazka editovatvzdycelyden="0" vkladatprestavky="0" grafickaminwidth="200" grafickamaxwidth="600">
        <style>
           /* nepovinne nastaveni css stylu .... */
        </style>
        <sloupeczpracovanedochazky typ="SCHVAL1" />
        <sloupeczpracovanedochazky typ="SCHVAL2" />
        <sloupeczpracovanedochazky typ="SCHVAL3" />
        <sloupeczpracovanedochazky typ="DATUM" />
        <sloupeczpracovanedochazky typ="DOCH_G" />
        <sloupeczpracovanedochazky typ="DOCH_T" nadpis="" />
        <sloupeczpracovanedochazky typ="EDIT" nadpis="" />
    </zpracovanadochazka>
    



Pokud je parametr editovatvzdycelyden="1", bude se i při kliknutí na interval zobrazovat editace celého dne. Parametr není povinný, výchozí hodnota je "0".
Parametr vkladatprestavky určuje, jestli se mají při přepočtu docházky vkládat přestávky.
Nepovinné parametry grafickaminwidth a grafickamaxwidth určují minimální a maximální šířku grafického zobrazení docházky.
Pomocí parametru classDV je možné nastavit seznam časových složek, pro které se v řádku bude generovat class. Např. když se nastaví classDV="05;06", tak všechny řádky, ve kterých je nenulový denní výsledek s časovou složkou 05 nebo 06 budou označeny class="DV_05" respektive class="DV_06". To je pak možné použít například v uživatelských stylech pro zvýraznění řádků.
Nastavením parametru kontroly="1" se zapne načítání výsledků kontrol. Podle toho jsou pak podbarvovány nebo jinak označeny dny s chybou (způsob označení lze upravovat i pomocí css).
Parametrem obarvitkontroly="0" je možné vypnout obarvení řádků s kontrolami barvou nastavenou v aplikaci.
Parametrem mesicnikontroly je možné nastavit, kde se budou zobrazovat měsíční kontroly: 0=nikde, 1=dole (výchozí hodnota), 2=nahoře, 3=nahoře i dole.

Obecné parametry sloupců

nadpis="Text nadpisu" - text, který se zobrazí v záhlaví
title="HTML titulek sloupce" - text, který se zobrazí při najetí myší nad hlavičku sloupce
style="cssStyle" - css styl, který se přiřadí všem buňkám daného sloupce.
class="cssClass" - css třída, která se přiřadí všem buňkám daného sloupce. Lze použít pro nastavení stylů v uživatelských css. Narozdíl od style umožňuje nastavit styl buňky v kombinaci s class řádku.
headerclass="cssClass" - css třída pro buňku hlavičky
align="left/center/right" - nastavení zarovnání sloupce
rozdeleni="typ/kod1;kod2" - zobrazí sloupec pouze v případě, že je zaměstnanec v některém ze zadaných rozdělení nebo jim podřízených
profil="kod_profilu" - zobrazí sloupec pouze v případě, že je uživatel v zadaném profilu
editace="0/1" - (pouze pro některé typy sloupců) - zapíná možnost editovat hodnoty ve sloupci - kontrolují se také práva, schválení docházky a uzavření období
editovatnezpracovanou="0/1" - zapíná možnost editovat hodnoty ve sloupci i když ještě není v daném dni zpracována docházka
zobrazitGraf="0/1" - ve sloupci s denním výsledkem zobrazí hodnotu graficky:
zobrazitNuloveHodnoty="1" - zapne zobrazení nulových hodnot ve sloupci s denním výsledkem

Sloupce pro zobrazení schválení - první (zelená), druhá (žlutá) a třetí (červená) úroveň - se přidají pomocí položek s typem SCHVAL1, SCHVAL2 a SCHVAL3.
Pomocí sloupce SCHVAL se zobrazí sloupec obarvený podle nejvyšší schválené úrovně
Pro sloupec s datumem slouží typ DATUM - lze u něj nastavit atributy class, style a nadpis.

                ...
                <sloupeczpracovanedochazky typ="SCHVAL" />
                <sloupeczpracovanedochazky typ="SCHVAL1" />
                <sloupeczpracovanedochazky typ="SCHVAL2" />
                <sloupeczpracovanedochazky typ="SCHVAL3" />
                <sloupeczpracovanedochazky typ="DATUM" />
                ...
                
Grafické zobrazení intervalů docházky se zapne pomocí položky DOCH_G. Textové zobrazení intervalů docházky pomocí položky DOCH_T
          ...
          <sloupeczpracovanedochazky typ="DOCH_G" zobrazitsmenu="1"/>
          ...
          
Parametr zobrazitsmenu určuje, jestli se zobrazí počátek a konec směny a pevného jádra. Hodnoty parametru mohou být: KAL - zobrazí směnu podle kalendáře, KAP - zobrazí směnu podle kapacit, 1 - zobrazí automaticky směnu podle kalendáře nebo kapacit (toto je výchozí hodnota), 0 - směna se nezobrazí
Je možné zobrazit i text s proměnnými %KOD%, %POPIS% (název operace), %ZKRATKA%, %SMENA% (kód směny), %CASOD%, %CASDO%, %DELKA%.
          ...
          <sloupeczpracovanedochazky typ="DOCH_G" format="%ZKRATKA% (%KOD%)"/>
          ...
Stejné proměnné lze použít i v atributu titleFormat, který umožňuje nastavit formát HTML titulku.
Textový popis záznamů v jednom sloupci, oddělené čárkou:
          ...
          <sloupeczpracovanedochazky typ="DOCH_Z" nadpis="Záznamy" format="%ZKRATKA%" style="white-space:nowrap" />
          ...
          
          ...
          <sloupeczpracovanedochazky typ="DOCH_T" nadpis="Záznamy docházky" />
          ...
          

Příklad zobrazení informací o směně (podle nastavení kalendáře se automaticky použije směna podle kalendáře nebo podle plánování kapacit):
SMENA zobrazí kód směny, SMENA_POPIS zobrazí popis směny,
SMENA_Z, SMENA_K, SMENA_ZK zobrazí začátek a/nebo konec směny,
SMENA_DELKA zobrazí délku směny. SMENA_J zobrazí časy pevného jádra směny.

        ...
        <sloupeczpracovanedochazky typ="SMENA" nadpis="Směna" />
        <sloupeczpracovanedochazky typ="SMENA_POPIS" nadpis="Směna" />
        <sloupeczpracovanedochazky typ="SMENA_Z" nadpis="Směna od" />
        <sloupeczpracovanedochazky typ="SMENA_K" nadpis="Směna do" />
        <sloupeczpracovanedochazky typ="SMENA_ZK" nadpis="Směna od-do" />
        <sloupeczpracovanedochazky typ="SMENA_DELKA" nadpis="Délka směny" />
        <sloupeczpracovanedochazky typ="SMENA_J" nadpis="Pevné jádro" />
        ...
        
Podobně fungují i sloupce s typem KAL, KAL_POPIS, KAL_Z, KAL_K, KAL_ZK, KAL_DELKA, KAL_J - zobrazí údaje o směně podle kalendáře
a KAP, KAP_POPIS, KAP_Z, KAP_K, KAP_ZK, KAP_DELKA, KAP_J - zobrazí údaje o směně podle plánování kapacit. Sloupec KAP_PUV zobrazí kód směny z původního plánu.

Zobrazení editačních ikon

Sloupec EDIT zobrazuje ikony pro vložení nového záznamu, editaci dne a smazání dne.

Sloupec COPY zobrazuje ikonu pro zkopírování celého dne.

        ...
        <sloupeczpracovanedochazky typ="EDIT" />
        <sloupeczpracovanedochazky typ="COPY" />
        ...
        

Zobrazení prvního příchodu a posledního odchodu dne podle zpracované docházky - sloupce DOCH1 a DOCH2.

Příchody a odchody se započítávají do dne přiřazení intervalu docházky!
      ...
      <sloupeczpracovanedochazky typ="DOCH1" nadpis="Začátek" zobrazenycas="0/1" zapocitatoperace="01;10" prepsatoperace="02" hintpuvodni="0/1" hintpruchody="0/1"/>
      <sloupeczpracovanedochazky typ="DOCH2" nadpis="Konec" zobrazenycas="0/1" zapocitatoperace="01;10" />
      ...
      
Nepovinný parametr zapocitatoperace omezí výpočet zacatku a konce jen na vyjmenované operace. Pokud není zadán, započítají se všechny intervaly. Mohou tak být dva různé sloupce a každý z nich zobrazovat jinou operaci (nebo jinou skupinu operací). Lze použít i znak * pro započítávání všech operací - to má smysl v případě, že není u sloupce nastavana "operace" - místo toho jde nastavit zapocitatoperace="01;*".
Parametr zobrazenycas určuje jestli se má zobrazit započtený čas (hodnota 0, default) nebo zobrazený (hodnota 1).
Parametr prepsatoperace určuje seznam operací, které se mají přepsat. Lze použít pro zrušení přestávek, takže se pak znovu vygenerují.
Parametry hintpuvodni a hintpruchody určují, jestli se má v tooltipu pole (tj. při najetí myší nad pole) zobrazit seznam původní docházky, respektive průchodů.
Příchody a odchody je možné také editovat.
      ...
      <sloupeczpracovanedochazky typ="DOCH1" nadpis="Začátek" editace="1" operace="01" />
      <sloupeczpracovanedochazky typ="DOCH2" nadpis="Konec" editace="1" />
      ...
      
Při editaci příchodu/odchodu se upraví první/poslední interval dne tak, aby začínal/končil v požadovanou dobu. Pokud jsou v daném dni intervaly, které jsou celé před zadaným příchodem/po zadaném odchodu, tak se celé odstraní. Pokud je u daného sloupce nastavena operace (např. operace="01"), a je zadán příchod před prvním existujícím intervalem, (respektive odchod po posledním intervalu), tak se na začátek/konec vloží nový interval s danou operací. V případě, že v daném dni není žádný interval, pak je možné vložit tímto způsobem nový záznam pouze v případě, že má alespoň jeden ze sloupců nastavenu operaci.
Pokud je potřeba editovat více sloupců s různými operacemi, tak je nutné odlišit sloupce parametrem name. Pro správnou funkčnost je potřeba mít stejně pojmenovaný sloupec DOCH1 a DOCH2 pro každou operaci (tj. vždy 2 stejně pojmenované sloupce)

Sloupce pro zobrazení kalendáře přiřazeného zaměstnanci v daném dni se přidají pomocí položek s typem K_KOD a K_POPIS

      ...
      <sloupeczpracovanedochazky typ="K_KOD" nadpis="Kalendář" />
      <sloupeczpracovanedochazky typ="K_POPIS" nadpis="Kalendář" />
      ...
      

Je možné zobrazit denní výsledky (hodiny, dny, kalendářní dny) včetně možnosti editace.

      ...
      <sloupeczpracovanedochazky typ="DV" kod="105" jednotka="H" editace="1" nadpis="Prostředí." class="nazev_css_tridy"/>
      <sloupeczpracovanedochazky typ="DV" kod="993" jednotka="H" editace="0" nadpis="Přestávky" />
      <sloupeczpracovanedochazky typ="DV" kod="999" jednotka="H" editace="0" nadpis="Norma"  style="font-weight:bold; text-align:center"/>
      ...
      
Parametr kód určuje kód časové složky, jednotka může být "H" (hodiny), "D" (dny), "K" (kalendářní dny) nebo "P" (poznámka). Pokud je zadáno editace="1", bude sloupec editovatelný.
Pro úpravu stylu sloupce je možné použít parametr style nebo parametr class v kombinaci s uživatelsky definovanými styly v tagu </style> nebo v souboru s_user.css

Denní výsledek (hodiny, dny i kalendářní dny) je možné editovat také pomocí checkboxu (nastavuje hodnotu 0 nebo 1). V tom případě nastavte typ="DV_CHECK"

Poznámka ke dni docházky může být pouze zobrazena, nebo editovatelná (parametr editace="1")

      ...
      <sloupeczpracovanedochazky typ="P" editace="1" nadpis="Poznámka" />
      ...
      

Výsledky kontrol (varování, chyby)

          ...
          <sloupeczpracovanedochazky typ="KONTROLY" nadpis="" style="white-space:nowrap" />
          ...
          
Zobrazí příznaky výsledků kontrol.

Plánované absence a události

            ...
            <sloupeczpracovanedochazky typ="ABSENCE" nadpis="Absence" style="font-size: 80%; color:blue;" class="sloupec_absence" />
            <sloupeczpracovanedochazky typ="ABSENCE_EDIT" />
            ...
            
Zobrazí seznam absencí naplánovaných na daný den. Standardně se zobrazuje popis operace, ale je možné zobrazit i jiný text pomocí parametru format, například takto:
            format="&lt;span title='%POPIS%' &gt;%ZKRATKA% (%KOD%)&lt;/span&gt;"
            

V parametru format je možné použít proměnné %POPIS%, %KOD%, %ZKRATKA%, %UZIVATELSKA1%, ... %UZIVATELSKA5%

Pokud se nastaví u kořenového tagu atribut absenceclass='1', bude mít každý řádek nastaven class podle kódu absence. To je možné použít pro obarvení buněk tabulky nebo celých řádků.

Ve sloupci ABSENCE_EDIT se zobrazí ikony s odkazem na naplánování nové absence.

Rozdělení denních výsledků (tabulka DenniVysledek_R_E nebo DenniVysledek_R)

      ...
      <sloupeczpracovanedochazky typ="DV_ROZDELENI" nadpis="Rozdělení výsledků" />
          nebo
      <sloupeczpracovanedochazky typ="DENNIVYSLEDEK_R_E" nadpis="Rozdělení výsledků" />
          nebo
      <sloupeczpracovanedochazky typ="DENNIVYSLEDEK_R" nadpis="Rozdělení výsledků" />
      ...
      
Typy DENNIVYSLEDEK_R_E a DV_ROZDELENI jsou shodné - zobrazují data z tabulky DenniVysledek_R_E a typ DENNIVYSLEDEK_R zobrazuje data z DenniVysledek_R
Nepovinně je možné zadat parametr typrozdeleni. Pokud není zadán, použije se typ rozdělení z nastavení portálu.
Pomocí parametru format je možné zadat, co bude zobrazeno, například takto: format="&lt;SPAN class='zaznamrozdelenidv' title='%POPIS% - %POPIS_CS%'&gt;%KOD% (%HODINY%) %KOD_CS%&lt;/SPAN&gt;"
Lze použít parametry %KOD%, %POPIS% (kód a popis rozdělení), %KOD_CS%, %POPIS_CS% (kód a popis časové složky), %HODINY% (počet hodin) a uživatelské pole rozdělení 1-10 %UZIVATELSKA1% atd.

Původní docházka a průchody

          ...
          <sloupeczpracovanedochazky typ="PUV1" nadpis="První" />
          <sloupeczpracovanedochazky typ="PUV2" nadpis="Poslední" />
          <sloupeczpracovanedochazky typ="PUV" nadpis="Puvodní docházka" style="font-size:80%; color:darkgray"/>
          ...
          <sloupeczpracovanedochazky typ="PRUCH1" nadpis="První průchod" />
          <sloupeczpracovanedochazky typ="PRUCH2" nadpis="Poslední průchod" />
          <sloupeczpracovanedochazky typ="PRUCH" nadpis="Průchody" style="font-size:80%; color:darkgray"/>
          ...
          

Původní výroba

Podobně jako původní docházku lze zobrazit i záznamy z tabulky PuvodniVyroba
      ...
      <sloupeczpracovanedochazky typ="VYR1" nadpis="První" />
      <sloupeczpracovanedochazky typ="VYR2" nadpis="Poslední" />
      <sloupeczpracovanedochazky typ="VYR" nadpis="Původní výroba"/>
      
Pomocí atributu format lze nastavit, jak se tyto záznamy zobrazí. U sloupců VYR1 a VYR2 lze nastavit i titleFormat. Pro zobrazení jsou defiovány tyto proměnné: %CAS%, %POPIS% (název činnosti), %KOD% (kód činnosti), %TERMINAL%, %TERMINAL_POPIS% (kód a popis terminálu)

Přiložené dokumenty

          ...
          <sloupeczpracovanedochazky typ="DOC" nadpis="" style="vertical-align:middle" />
          ...
          

Nastavení zobrazených tlačítek

      <tlacitko typ="ulozit" umisteni="2" />
      <tlacitko typ="schvalit" umisteni="2"  style="background-color: #40C040"/>
      <tlacitko typ="zrusitschvaleni" umisteni="2"  style="background-color: #C04040"/>
      <tlacitko typ="podlepuvodni" umisteni="2" text="Obnovit původní" />
      <tlacitko typ="doplnitpuvodni" umisteni="2" text="Doplnit původní" />
      <tlacitko typ="rozdelenidv" umisteni="3" />
      <tlacitko typ="rozdelenimv" umisteni="3" />
      <tlacitko typ="rozdelenivyroby" umisteni="3" />
      <tlacitko typ="prepocitat" umisteni="4" />
      <tlacitko typ="vlozitprestavky" umisteni="4" />
      <tlacitko typ="kontrola" umisteni="4" />
      <tlacitko typ="vlozitdokument" umisteni="3" />
      <tlacitko typ="skript" umisteni="3" id="s1"   text="Spusť skript" kategorie="kategorie_skriptu" skript="nazev_skriptu" />
      <tlacitko typ="xml"    umisteni="3" id="xml2" text="XML událost" xmlid="81" />
      <tlacitko typ='vymazatvse' umisteni='3' />
      <tlacitko typ='dialogpodlekalendare' umisteni='3' />
      <tlacitko typ="kalendarosoby" umisteni="4" />
      <tlacitko typ="podlekalendare" umisteni="5" id="podlekalendare1" operace="08" text="Dovolená" parametry="..."/>
      <tlacitko typ="interval" umisteni="5"
             id="int_prace_8-1630" operace="01" text="Práce 8:00-16:30" casod="8:00" casdo="16:30" smena="R8" smazatvse="0"
             title="Vloží práci v nastaveném intervalu" />
      <tlacitko typ="pk_zrusitsmenu" umisteni="5" prepocitat="0/1" />
      <tlacitko typ="pk_zmenitsmenu" umisteni="5" prepocitat="0/1" />

    
Umístění může být "1" (vlevo nahoře), "2" (vpravo nahoře), "3" (vlevo dole), "4" (vpravo dole) nebo "5" (v postranním panelu zobrazeném po označení řádku). Nastavením umístění na hodnotu "-1" se tlačítko skryje (má smysl pro tlačítka, která se jinak zobrazí vždy, např "ulozit" )
Pomocí parametru style je možné určit css styl tlačítka (například barvu)
Nepovinný parametr text určuje nadpis tlačítka. Pokud není zadán, použije se výchozí text podle typu tlačítka
Nepovinný parametr dotaz určuje text dotazu, který se zobrazí při kliknutí na tlačítko.
Nepovinný parametr title určuje plovoucí titulek (hint), který se zobrazí při najetí myší na tlačítko.
Nepovinný parametr kalendar omezí zobrazení tlačítka jen u zaměstnanců se zadaným kalendářem. Je možné zadat i více kódů kalendářů oddělených středníkem.
Nepovinný parametr zpracovatpresah zajistí, že se úloha provede až do 1. dne následujícího měsíce (platí pro tlačítka doplnitpuvodni a podlepuvodni).

Filtry pro přepínaní zobrazených sloupců

Pro zapínání a vypínání jednotlivých sloupců je možné vytvořit filtry.

Uživatelské nastavení CSS stylů

Pomocí tagu <style> je možné nastavit css styly, které se vygenerují přímo do HTML stránky.

XML formuláře pro zobrazení jakýchkoliv uživatelských informací

Pomocí tagu <xml> je možné zobrazit obsah XML formuláře nad nebo pod zpracovanou docházkou.
    <xml id="..." umisteni="top"/>
  
pomocí atributu id se nastaví ID formuláře, který se má zobrazit. Pomocí atributu umisteni se určí, kde se formulář zobrazí. Možné hodnoty jsou top nebo nahore a bottom nebo dole. Do formuláře se předávají proměnné:
  • idPP
  • RC, osobniCislo, datumNastupu
  • jmeno, prijmeni, jmenoPrijmeni
  • obdobi

Tipy

Zvýraznění hodnoty časové složky, např. odpracovaná doba > 12
  • Vytvořit novou časovou složku, která bude mít nenulovou některou hodnotu v případě splnění požadované podmínky, jinak bude vše 0 (dny, kalendářní dny i hodiny). Kód časové složky pro příklad uvádím dále 100A.
  • V nastavení zpracované docházky přidat u tagu zpracovanadochazka parametr classDV="100A" - parametr může obsahovat více časových složek oddělených středníkem. Řádky, ve kterých je tato časová složka nenulová budou mít přiřazenu CSS třídu DV_100A. Je pak možné nastylovat celý řádek (jiná barva pozadí, fontu), nebo nějaký sloupec.
  • Pomocí tagu <style> pak nastavit pravidla pro zvýraznění řádků nebo buňek.
    Příklad pro zvýraznění řádku:
                <style>
                  .zpracovanadochazkabrowser tr.DV_100A {
                    background-color: #7cfc7c;
                  }
                </style>
              
    Příklad pro zvýraznění konkrétní buňky - je potřeba u příslušného sloupce nastavit css třídu, např. <sloupeczpracovanedochazky ... class="MUJ_SLOUPEC" /> a v <style> pak přidat:
                <style>
                  .zpracovanadochazkabrowser tr.DV_100A td.MUJ_SLOUPEC {
                    font-weight:bold;
                  }
                </style>
              
    Stylovat lze samozřejmě cokoliv, co jde v css nastavit (font, barva písma, barva pozadí, obrázek pozadí atd.)