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).

syntax
<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ěď

Struktura odpovědi na požadavek max-key vrácená v obálce response:

syntax
<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í.


Požadavek actionPožadavek cnthashPožadavek cnthmacPožadavek confirm-messagePožadavek decryptPožadavek encryptPožadavek general-lockPožadavek get-keyPožadavek get-messagesPožadavek get-tempPožadavek get-userPožadavek get-versionsPožadavek change-passwordPožadavek loginPožadavek logoutPožadavek max-keyPožadavek randPožadavek reload-sslPožadavek send-requestPožadavek send-messagePožadavek set-tempPožadavek tranformPožadavek uuid