Nastavení pro výpočty a vyhodnocení

Vyhodnocení nebo zamítnutí výpočtu

Vztah zadaný v poli Výpočet poslouží k automatickému vyhodnocení relace mezi zadanými aktuálními daty ve formuláři. Hodnota získaná výpočtem se vloží do formulářového pole daného prvku.

Pro zobrazení výsledků výpočtů se používají zejména pole s výstupní hodnotou. Výpočty však lze vkládat i do jiných typů polí.

Mějme dvě číselná pole, do kterých se zadávají datové položky prvni_cislo a druhe_cislo. Budeme chtít vytvořit výpočetní vztah pro jejich součet.

image180

Dále vložme pole typu „pole s výstupní hodnotou“ – to znamená, že toto pole je určeno pro zobrazení hodnoty nějakého výpočtu a podobně. Jeho datová položka bude soucet.

image181

Panel Vlastnosti prvku obou zadávaných čísel nebude obsahovat nic zvláštního; za zmínku snad stojí jen to, že u číselných polí by měla být zadána nějaká počáteční hodnota.

Do prvku Součet je zapotřebí vložit výpočetní vztah. V jeho panelu klepněte na tlačítko se třemi tečkami v poli Výpočet.

V okně Vlastnosti prvku v sekci Výpočet na záložce XPath můžete teď vytvořit výpočetní vztah. Pomocí tlačítka Vložit datovou položku vložte datovou položku prvního sčítance – prvni_cislo. Pak napište operátor „plus“ a vložte datovou položku druhého sčítance. Výpočetní vztah uložte.

Mezery kolem operátoru „plus“ nejsou povinné, vkládají se jen pro lepší přehlednost.

Při zadávání datových položek si všimněte zaškrtávacího políčka relativní datový XPath. Pokud je zaškrtnuté, vloží se relativní přístupová cesta ke vkládané datové položce:

../d:prvni_cislo

V ní ty dvě tečky znamenají „uzel, kde právě jste“. Pokud políčko zaškrtnuté není, vloží se absolutní přístupová cesta od kořenového uzlu (root):

/d:root/d:UserData/d:prvni_cislo
image182

Pole Výpočet bude pak obsahovat nastavení výpočetního vztahu.

image183

Aby se hodnota výsledku v poli s výstupní hodnotou zobrazila – a také se dynamicky obnovovala při změnách hodnot vkládaných čísel – je zapotřebí vytvořit vazby mezi polem s výstupní hodnotou a poli pro zadání hodnot. K tomu slouží pole Závislosti, kde jako obvykle klepněte na tlačítko se třemi tečkami.

V okně Vlastnosti prvku pak pomocí tlačítka Vložit datovou položku vložte odkazy na datové položky tvořící součást výpočetního vztahu.

image184

Pole Závislosti se naplní odkazy na jednotlivé datové položky výpočetního vztahu oddělené znakem „|“.

image185
Pro úplnost si uveďme základní operátory pro numerické výrazy jsou: sčítání (+), odčítání (), násobení (*), dělení (div) a modulo (mod).

Někdy může být užitečné ošetřit případy, kdy výpočet nemá proběhnout. To umožňuje nastavení v poli Nepočítat když – je-li výraz vyhodnocen jako true, výpočet definovaný v položce Výpočet se neprovede, je-li false, výpočet se provede podle předpisu. Není-li v poli nic nastaveno, výpočet se provede vždy.

Vyhodnocení relevance

Pokud je výraz specifikovaný v poli Relevance vyhodnocen jako true, datová položka se považuje za relevantní, je-li false, není relevantní. Není-li nic nastaveno, položka se považuje za relevantní.

Tuto vlastnost je pak možné použít například při získávání a zpracování dat formuláře a je možné nastavit, že se v něm bude pracovat pouze s relevantními daty.

Vyhodnocení závislostí

Do pole Závislosti se vkládají odkazy na datové položky, při jejichž změně budou znovu vyhodnoceny výrazy podmínek pro tento prvek. Sledují se jak změny prováděné ručně uživatelem, tak změny provedené výpočtem na základě jiné akce.

image186

Vlastnosti takto prvku s takto definovanou závislostí budou přepočítány vždy, když se změní datové hodnoty prvni_cislo nebo druhe_cislo.

Akce při změně hodnoty v poli

Javascriptový kód vložený do pole Akce při změně se provede pokaždé, když uživatel změní hodnotu ve formulářovém poli.