Repeat

Upravit obsah stránky

V atributu repeat je buď nastaveno slovo none nebo specifikována perioda v které se má úloha opakovat. Možnosti nastavení jsou následující:
[none]|hourly|daily|weekly|monthly|yearly|from-{#YYYY-MM-DD}[ {#HH[:MM[:SS]]}][;to-{#YYYY-MM-DD}[ {#HH[:MM[:SS]]}]][;each-nn-(minutes|hours|days|weeks|months)[[-xx]...]][;at-{#HH:MM:SS}]


Základní nastavení:
    bullet

    none - úloha se nebude opakovat (výchozí hodnota při nezadání)

    bullet

    hourly - úloha proběhne každou hodinu v první minutě pokud je specifikována platnost ve validity (pokud nebyla specifikována, pak v aktuální čas)

    bullet

    daily - úloha proběhne každý den o půlnoci pokud je specifikována platnost ve validity (pokud nebyla specifikována, pak v aktuální čas)

    bullet

    weekly - úloha proběhne každý týden o půlnoci v den specifikováný ve validity (pokud nebyla specifikována, pak v aktuální den a čas)

    bullet

    monthly - úloha proběhne každý měsíc o půlnoci v datum specifikovaný ve validity (pokud nebyl specifikován, pak aktuální den a čas)

    bullet

    yearly - úloha proběhne každý rok o půlnoci v datum specifikovaný ve validity (pokud nebyl specifikován, pak aktuální den a čas)


Rozšířené nastavení:
Volby from-{#YYYY-MM-DD}[ {#HH[:MM[:SS]]}] a to-{#YYYY-MM-DD}[ {#HH[:MM[:SS]]}] nastavují platnost úlohy buď jen datumově nebo datum a počet hodin nebo datum a čas na minuty, příp. i na sekundy. Časový údaj v části from, je-li uveden, zároveň říká, v jaký čas má být úloha opakována, není-li uveden, je opakována po půlnoci;
Volba each-nn-[minutes|hours|days|weeks|months][[-xx]...] nastavuje periodicitu opakování. Kde nn je počet jednotek pro opakování a xx je:
    bullet

    pro minutes, hours a days se xx nepoužije.

    bullet

    pro weeks xx znamená den v týdnu: [Mo|Tu|We|Th|Fr|Sa|Su], dny v týdnu lze kombinovat (zvolit více možností). Není-li xx zadáno, použije se aktuální den.

    bullet

    pro months pořadí dne v měsíci. Není-li xx zadáno, použije se aktuální den v měsíci.

    bullet

    pro years pořadí dne v roce. Není-li xx zadáno, použije se aktuální den v roce.


Opakování od konce úlohy
Spolu s nastavením opakování lze využít i atribut 
sched-from-end
, který zajišťuje nastavování časovače od okamžiku dokončení předchozí úlohy. Pokud tedy časovač slouží pro opakované provádění akce, umožňuje tato volba naplánovat spuštění na čas počítaný od okamžiku dokončení předchozího chodu akce, od jejího dokončení. Funguje pouze na "transparentní" opakované plánovaní, tedy takové, kdy je přidávána časová konstanta (sekundy, minuty, hodiny). Mezi tato plánování nepatří "weeks", "months" a "years".

Příklad
<do-action repeat="from-2025-01-01 13:13:00;each-3-seconds" sched-from-end="true" validity="still" name= ...

Tento příklad zajistí, že po dokončení první akce se další spustí za 3 vteřiny, dokud tento job nebude odebrán. Job může být odebrán i uvnitř chodu akce tak, aby se při vyhodnocení po ukončení již další chod akce neprovedl. Tato nastavení jsou běžná pro akční cyklovače.

Příklady:
    bullet

    from-2005-01-01;each-2-weeks-Mo-Fr
     = každé dva týdny v po a pá počínaje 1.1.2005

    bullet

    from-2005-01-01;each-1-months-5
     = každý 5. den v každém měsíci.


UPOZORNĚNÍ!
Pokud je nn jiné než jedna je podstatný datum from – determinuje od kdy se počítá perioda!!!