Přejít na obsah
Flexideo
Skip to main content

Požadavek undo

Účel a dopady​

Zruší (smaže) naplánovanou úlohu podle jejího id – ať šlo o import, export, odložený požadavek, akci apod.

Dostupnost, kontext, oprávnění apod.​

Server ověřuje oprávnění k výmazu vlastní nebo cizí úlohy; cizí úlohu může odstranit jen r_admin. Neexistující a cizí úloha se hlásí stejnou chybou (viz níže), bez rozlišení příčiny.

XML požadavek (syntax + popis)​

  <request>
   <undo
    id="{number}"
    />
  </request>

Parametry a pravidla (atributy, potomci)​

  • id - Číslo úlohy přidělené serverem (viz odpověď do-* požadavků nebo job-list). (typ: number; povinný – chybí nebo je neplatné/prázdné → chyba)

Požadavek nemá žádné potomky.

Příklady požadavku​

(Zatím bez ověřeného příkladu.)

Zpracování a vedlejší účinky​

Výmaz proběhne okamžitě, ne odloženě.

XML odpověď (syntax + popis)​

  <response>
   <undo
    status="ok|error"
    id="{string}"
    detail="{string}"
    />
  </response>

Atribut id v odpovědi je vždy doslovný echo vstupní hodnoty (i když je neplatná), ne nutně platné číslo.

Příklady odpovědi​

(Zatím bez ověřeného příkladu.)

Chyby a reakce​

  • status="error" id="{echo}" detail="Neplatna hodnota id" – id chybí, je prázdné nebo se nepodaří převést na číslo.
  • status="error" id="{echo}" detail="Uloha neexistuje, nebo nemate opravneni k jejimu vymazu" – záměrně nerozlišuje mezi neexistující úlohou a cizí úlohou bez oprávnění.
  • status="skip" detail="Transakce byla preskocena" / status="error" detail="Transakce byla odvolana" – transakční přeskočení/odvolání obálky.

Související požadavky​