Požadavek max-key
Nejvyšší klíč typu
Slouží k získání posledního přiděleného klíče (pdk, dkey) daného dokumentu. Pro získání příslušného klíče musí mít role uživatele přístup k dokumentu (požadavek podporuje opt-roles).
<request>
<max-key
doc="{string}"
/>
</request>
Atributy
doc - typ dokumentu - Typový název dokumentu definovaného v XDS.(typ: string)
Potomci
Požadavek max-key neobsahuje žádné další elementy, ani žádné jiné číselné či řetězcové hodnoty. Uzel nemá povolen prázdný obsah.
Odpověď
Jde o uzel obsahující text TYP HODNOTY: string;
Struktura odpovědi na požadavek max-key vrácená v obálce response:
<response>
<max-key
status="ok|error"
doc="{string}"
value="{string}"
>
<error ... /> ?
</max-key>
</response>
Atributy
status - Obsahuje hodnoty ok nebo error
Možnosti obsahu:
» ok ~ Požadavek proveden bez chyb.
» error ~ Při provádění požadavku došlo k chybě.
doc - typ dokumentu - Typový název dokumentu definovaného v XDS.(typ: string)
value - klíč dokumentu - Celočíselný klíč dokumentu nebo řetězec se znakem '#' pro nové instance.(typ: string)
Potomci
Uzel error
Popis uzlu error, který je potomkem uzlu max-key je umístěn v popisu typových uzlů.
Bližší popis viz. error.
Výraz pro identifikaci chyb v odpovědi serveru: max-key[@status='error'] (odkaz na popis detailu: @details).
Další info
Požadavek vrací poslední, tedy nejvyšší primární klíč dokumentu (pdk údaj v databázi hlavní tabulky každého dokumentového typu). Jakmile na další požadavek server vrátí vyšší klíč, než minule, znamená to, že do databáze byl přidána nová instance dotazovaného dokumentového typu.
Předností je rychlost odezvy a možnost použít tento požadavek v krátkých, i několika sekundových, intervalech. Server flexideo tyto požadavky vyřizuje pouhým přečtením hodnoty ve své operační paměti a je tak spojen s minimální režií.