Typ do-task

Sdílené plánovací atributy společné všem požadavkům do-* (do-import, do-export, do-force-import, do-action, do-request, do-manage, do-optimize-files, do-scan-files).

  <do-task
   validity="{string}"
   repeat="{string}"
   failsafe="{string}"
   sched-from-end="{bool}"
   when-off="{bool}"
   run-as="{number}"
   by-action="{bool}"
   db-log="{bool}"
   />

Atributy

• validity - Platnost úlohy: once|today|still|from-{#YYYY-MM-DD}[;to-{#YYYY-MM-DD}]. (typ: string; nepovinný; výchozí: once)
• repeat - Opakování úlohy: none|hourly|daily|weekly|monthly|yearly|from-{#YYYY-MM-DD}[;to-{#YYYY-MM-DD}][;each-nn-(minutes|hours|days|weeks|months)][;at-{#hh:mm}]. (typ: string; nepovinný; výchozí: bez opakování) – nastavení na cokoli jiného než none/prázdné vyžaduje vlastnost uživatele p_repeat (roli r_repeat) nebo r_admin.
• failsafe - Opakování při chybě, syntaxe stejná jako repeat; stejná privilegovaná podmínka. (typ: string; nepovinný)
• sched-from-end - Počítat interval opakování od ukončení běhu, ne od jeho začátku. (typ: bool; nepovinný; výchozí: false)
• when-off - Doběhnout po obnovení provozu, vyšlo-li plánované spuštění na dobu odstávky serveru. (typ: bool; nepovinný; výchozí: false)
• run-as - Zastoupení jiného uživatele při běhu úlohy - vyžaduje r_admin, nebo r_impersonate u volajícího a úspěšný test zastoupení vůči cílovému uživateli; neplatná hodnota znamená, že se úloha vůbec nezaloží. (typ: number; nepovinný) – v dosavadní dokumentaci zcela chyběl.
• by-action - Označuje, že úloha byla založena jinou akcí (promítá se do job/@by-action v job-list). (typ: bool; nepovinný; výchozí: false) – v dosavadní dokumentaci zcela chyběl.
• db-log - Logovat běh úlohy do databáze. (typ: bool; nepovinný; výchozí: false) – v dosavadní dokumentaci zcela chyběl.

Potomci

Typ do-task sám o sobě žádné potomky nemá; konkrétní požadavek (do-import aj.) k těmto atributům přidává vlastní.