Skip to main content

repeat

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í:

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

  • 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)

  • 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)

  • 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)

  • 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)

  • 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:

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

  • 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.

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

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

Příklady:

from-2005-01-01;each-2-weeks-Mo-Fr = každé dva týdny v po a pá počínaje 1.1.2005
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!!!

Čas provedení v rámci dne: at a on-idle-between​

Ve výchozím stavu (bez at i bez on-idle-between) se úloha spouští v čase daném částí from popsanou výše, případně o půlnoci, není-li v from čas uveden.

  • at-{#HH:MM:SS} – vynutí přesný čas spuštění v rámci dne.

  • on-idle-between-{#fromHour}-and-{#toHour} – nezdokumentovaná, ale reálně používaná klientská možnost. Generuje ji plánovací dialog úlohy (pole „nebo někdy od–do“): místo pevného času nechá server vybrat libovolný okamžik uvnitř zadaného rozsahu celých hodin (fromHour–toHour), kdy je server nejméně vytížený/nečinný („idle“). V dialogu jsou at a on-idle-between vzájemně se vylučující volby – vyplněním jedné se pole pro druhou deaktivuje.

Příklad:

still;each-1-days;on-idle-between-13-and-14 = každý den, spuštěno kdykoliv mezi 13. a 14. hodinou dle vytížení serveru

Omezení na periodicitu: on-idle-between (stejně jako at) dává smysl jen u periody s jednotkou days, weeks nebo months (tzn. daily/weekly/monthly/yearly, nebo each-nn-days/each-nn-weeks/each-nn-months) – tedy tam, kde se úloha spouští nejvýše jednou denně a má smysl vybírat přesný čas či hodinové okno v rámci dne. Pro jednotky minutes a hours (each-nn-minutes, each-nn-hours) klient pole pro at/on-idle-between v dialogu vůbec nezobrazuje – jednorázový okamžik v rámci dne nedává u periody kratší než den smysl. Kombinaci each-nn-hours/each-nn-minutes s on-idle-between-… proto nepoužívejte, nejde o podporovanou ani smysluplnou kombinaci.