flexideo

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

Jde o uzel obsahující text TYP HODNOTY: string;

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 get-userPožadavek change-passwordPožadavek actionPožadavek send-requestPožadavek send-messagePožadavek confirm-messagePožadavek get-messagesPožadavek tranformPožadavek set-tempPožadavek get-tempPožadavek general-lockPožadavek encryptPožadavek decryptPožadavek max-keyPožadavek reload-sslPožadavek get-versionsPožadavek uuidPožadavek cnthashPožadavek rand