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
- get-draft – načtení konkrétního draftu ze seznamu.
- save-draft, remove-draft – změny, které seznam ovlivňují.