Kontrolní pravidlo check

Tag check je v XDS uváděn jako přímý potomek tagu cba. Počet kontrolních pravidel v dokumentu není omezen a i k jednomu prvku jich může být přidruženo několik. Princip kontrolního pravidla spočívá v zapsání jednoho logického výrazu, který zachycuje určitý problém, kterému se chceme vyhnout nebo na něj alespoň upozornit. Můžeme rovněž nastavit závažnost dané podmínky. Tedy to, co se má při jejím splnění (nalezení nežádoucího stavu) provést. Počínaje pouhým informováním uživatele a konče odmítnutím uložení dokumentu. Vlastní výraz pravidla se vepisuje do atributu test a zpráva pro uživatele při splnění pravidla (nalezení problému) do atributu message. I ostatní vlastnosti pravidla se zaznamenávají do atributů tagu check. Pojďme se nyní podívat na jednotlivé atributy kontrolního pravidla:

label - podobně jako u segmentů i zde tento atribut označuje název. Tento název je pak součástí vlastního hlášení uživateli a také slouží pro snazší orientaci mezi kontrolními pravidly.

descr (comment) - i tento atribut je možné najít u segmentů. Zde však není zobrazován uživateli a slouží pro případné poznámky pro tvůrce, aby bylo možné se snadněji mezi pravidly orientovat. Je sice pravda, že totéž můžeme docílit klasickým XML komentářem, ale na rozdíl má atribut výhodu v tom, že je nedělitelnou součástí tagu pravidla a při případných přesunech nedojde k záměně komentářů.

on-change, on-save - tyto atributy mohou obsahovat logickou hodnotu true nebo false (výchozí hodnotou při neuvedení je vždy true); tyto vlastnosti určují, kdy se má kontrolní pravidlo provádět - zda při změně hodnoty políčka on-change=true nebo až v momentu ukládání celého dokumentu bez ohledu na to, zda změna nastala či nikoli on-save=true (nebo při obou příležitostech - obě na hodnotu true).

type - určuje způsob reakce při nesplnění podmínky a tím i důležitost daného pravidla; jedná se o povinný atribut, který může nabývat hodnot - stop (zamezí uložení dokumentu při nesplnění pravidla), ask-stop (informuje uživatele o nesplnění pravidla a vyzývá k neuložení v případě již daného povelu uložit - dává však uživateli možnost dokument uložit i při nesplnění pravidla) ask-continue (rovněž informuje uživatele o nesplnění pravidla, ale nabízí jako přednastavenou možnost uložení dokumentu - umožňuje však uživateli v případě že již dal povel uložit vrátit se do formuláře dokumentu a provést případnou opravu), info (při povelu uložit informuje uživatele o nesplnění podmínky, ale dokument uloží a uživateli nedává před uložením možnost opravy)

match - určuje výchozí segment, ke kterému je pravidlo připojeno, a ze kterého se odvíjí všechny relativní odkazy uvedené v pravidlu v atributu test; atribut match je povinný; match obsahuje absolutní odkaz (začínající lomítkem) na přidružený segment, kde v prvním kroku je uvedeno jméno hlavní oblasti.

Atribut message musí obsahovat smysluplný text hlášení uživateli tak, aby uživatel snadno pochopil a mohl rychle sjednat nápravu. Kontrolní pravidla v atributu test mají stejnou syntaxi, jakou používají výrazy v akcích.


Nastavitelné vlastnosti uzlu check

Substrukturu check je možné specifikovat následujícími vlastnostmi:

comment - Pracovní komentář segmentu pro účely popisu defince. Nezobrazuje se finálnímu uživateli.;

discarted - Pomůcka VYŘAZENÍ (tj. "odpoznámkování" v kódu definice). Je-li uzel označen touto vlas ...

interface - Vlastnost služby dokumentu, která říká zda se jedná o službu popisující rozhraní, jež ...

label - Určuje název (štítek), který se objevuje u definovaného segmentu;

match - ;

message - Text hlášky zobrazované uživateli při nesplnění výrazu kontrolního pravidla v okamžiku e ...

on-change - Specifikuje okamžik aplikování kontrolního pravidla při editaci dokumentu na moment zm ...

on-save - Specifikuje okamžik aplikování kontrolního pravidla při editaci dokumentu na moment ulož ...

release-level - Specifikace bezpečnostní úrovně, která již danou substrukturu pro určitý okruh uži ...

release-section - Specifikace oddělení a bezpečnostní úrovně pro tato oddělení, kde se již daná su ...

test - Vlastnost pro zápis výrazu podmínky, která musí být splněna, aby se provedla aktivace.;

to-view-types - Způsob použití v příp. pohledových dokumentech. Je uplatnitelné pouze pokud je pra ...


Potenciální vlastnické uzly

Substrukturu check je možné uvést u následujících uzlů:

cba - obal akcí a kontrolních pravidel (substruktura definice);


Možní potomci uzlu check

Substrukturu check je možné rozšířovat o následující potomky:

lang - jazyková nastavení;


Substruktura check

kontrolní pravidlo


Substruktura alwaysKontrolní pravidlo checkSubstruktura action actionSubstruktura control controlSubstruktura param paramSubstruktura request requestSubstruktura response responseSubstruktura value valueSubstruktura otherwiseSubstruktura node nodeVybrané info ze schematu schema-infoSubstruktura whenSubstruktura with-paramTisková šablona print-temp