Přejít na obsah
Skip to main content

Požadavek get-draft-list

Účel a dopady​

Vrátí seznam všech rozpracovaných draftů volajícího uživatele. Požadavek nic nemění, jen čte; výsledek je navíc serverem cachován za uživatele (draftcache) a znovu načten z databáze až po jeho invalidaci (uložením/smazáním draftu).

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

Dostupné každému přihlášenému uživateli, vždy jen pro jeho vlastní drafty – server sám dosazuje ID volajícího uživatele.

XML požadavek (syntax + popis)​

<request>
<get-draft-list/>
</request>

Parametry a pravidla (atributy, potomci)​

Požadavek get-draft-list neobsahuje žádné atributy ani potomky.

Příklady požadavku​

<request>
<get-draft-list/>
</request>

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

Server zavolá uloženou proceduru pro seznam draftů uživatele a její výstupní řádky vloží doslovně do odpovědi jako obsah get-draft-list-result. Přesný tvar uzlu row (jeho atributy) určuje databázová procedura; v seznamu níže je proto ponechán beze změny z dosavadní dokumentace jako neověřený předpoklad.

XML odpověď (syntax + popis)​

<response>
<get-draft-list-result
type="ok|error"
user="{number}"
>
<row ... /> *
</get-draft-list-result>
</response>

Uzel row (tvar určuje databázová procedura)​

<row
user="{number}"
dkey="{string}"
type="{string}"
label="{string}"
tplabel="{string}"
update="{string}"
/>

Příklady odpovědi​

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

Chyby a reakce​

  • type="error" – selhání na úrovni volání databáze/procedury.

Související požadavky​