Evidence historie změn dokumentů
Příklady požadavků pro získávání informací z evidence historie dokumentů. Příklad dotazu na seznam historie dokumentů:
<get-history>
<list type="kontakt" dkey="1234"/>
</get-history>
Dotaz na konkrétní historickou podobu:
<get-history>
<document type="kontakt" dkey="1234" id="123456"/>
</get-history>
V dotazu jsou k dispozici atributy type a dkey (typ a instance typu), které společně slouží k jednoznačné identifikaci konkrétního datového dokumentu.
Výsledkem prvního bude následující obsah response:
<history-list>
<kontakt
dkey="1234"
id="123456
date="2004-05-20"
time="14:30:15"
author="5"
version="01-01-01"/>
<kontakt
dkey="1234"
id="123789
.../>
...
</history-list>
Výsledkem druhého dotazu je již konkrétní dokument – ne jen jeho hlavička a navíc je uvedena i verze systému, jejíž znalost je nezbytná pro správné formátování dokumentu:
<history-doc>
<kontakt
dkey="1234"
id="123456
date="2004-05-20"
time="14:30:15"
author="5"
version="01-01-01">
...
</kontakt>
</history-doc>
Identifikace chyb
Pokud dojde k chybě bude v kmenovém tagu history-list v atributu uveden atribut type, který se za normálních okoloností v této odpovědi nevyskytuje vůbec a jeho obsah bude nastaven na hodnotu error, například pokud uvedete neplatný typ dokumentu nebo např. číselně neplatný dkey, bude v obálce response tento obsah:
<history-list type="error" detail="Neplatny typ dokumentu nebo dkey"/>
Pokud uvedete jen dkey, které není v databázi, server se bude chovat obdobně, jako při požadavku požadavkem get-document a vrátí prázdný history-list (bez obsahu i jakéhokoli atributu).
U vracení historického obsahu get-history už se server chová totožně jako při získávání aktuální podoby dokumentu get-document. To znamená, že uvedete-li neplatný typ, neexistující dkey nebo dokonce i číselně neplatný dkey, server to jako chybu nevyhodnotí a pouze vrátí prázdnou odpověď v podobě prázdného tagu history-doc v obálce response.