flexideo

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.

Identifikace chyb při ukládání XML dokumentůIdentifikace chyb při ukládání XML dokumentůPříklad požadavků na pseudo-dokumentyUkládání pseudo dokumentůEvidence historie změn dokumentůPříklad pro rozpracované dokuementyPřímé SQL dotazy do databázePříklady práce se souboryPříklad XML nastaveníPříklad seznamu naplánovaných úlohPříklad naplánování úlohyPříklad odložení požadavku do-requestPožadavek registerPožadavek register-listPožadavek register-delPříklad transformPříklad spuštění akcePříklad spouštění akcí pomocí zpráv