Nástroje používateľa

Nástoje správy stránok


omega:modules:dailyoperations:action

Toto je staršia verzia dokumentu!


Action

Tento prvok je určený pre spúšťanie rôznych akcii.

Akcie sa zapisujú ako XML, takže pozor na následujúce nástrahy:

  • Atribúty musia byť v úvodzovkách alebo apostrofoch.
  • Samotný element musí byť ukončený.
    <layout controlId="btn2" />

Ak bude nejaká hodnota typu boolean, môže sa používať aj alternatívny zápis on, off, yes, no, true, false.

Názov udalosti pre broadcast môže na začiatku obsahovať:

  • ^ znamená, že sa odvysiela udalosť pre prvky na všetkých TAB-och, teda nie len pre prvky v práve aktuálnom TAB-e. Napríklad ^e_select
  • @ znamená, že namiesto udalosti sa vykoná akcia nad tlačítkom alebo akciou. Napríklad @a_control1

Názov prvku controlId môže na začiatku obsahovať:

  • # znamená, že namiesto controlId sa použijú prvky, ktoré majú tento tag (štítok). Napríklad #tElements

layout

Táto akcia mení vlastnosti nejakého iného prvku na aktuálnom tab-e.

Atribút controlId určuje prvok na aktuálnom tab-e, na ktorom sa urobia zmeny (cieľový prvok). Ostatné atribúty sú nepovinné.

Atribút tag určuje prvky na aktuálnom tab-e, na ktorom sa urobia zmeny (cieľové prvoky). Ostatné atribúty sú nepovinné.

Musí byť zadaný atribút controlId alebo tag.

Ak je atribút broadcast=1, potom sa po skončení všetkých akcií na tlačítku odvysielajú udalosti tlačítka, ktoré vyvolalo túto akciu.

Príklad

<layout controlId="cmd_tlacitko2" visible="1" />

Atribúty

Atribút Popis
controlId string ID prvku na aktuálnom tab-e.
tag string Tag prvku na aktuálnom tab-e.
baseControlId
4.5.112
string Prvok, podľa ktorého sa určí offset.
Je možné použiť aj posledne použitý layout prvok, ktorý je označený ako _lastControl.
baseControlPoint
4.5.112
enum lt = Left Top left top
rt = Right Top right top, right (prednastavené)
lb = Left Bottom left bottom, bottom
rb = Right Bottom right bottom
width px Šírka cieľového prvku.
height px Výška cieľového prvku.
left px Pozícia vľavo (x) cieľového prvku.
top px Pozícia hore (y) cieľového prvku.
moveType
4.4.439+
enum absolute = základné nastavenie, na absolútne súradnice (prednastavené)
group = presun viacerých prvkov na základe tag-u podľa prvku, ktorý je najlavší a najhornejší
shift = posun viacerých prvkov na základe tag-u
visible bool 0 = nie je viditeľný
1 = je viditeľný
enabled bool 0 = nie je povolený
1 = je povolený
:!: Nie je zatiaľ implementované.
alpha % Priehladnosť, hodnoty 0 až 100.
0 = Úplne riehľadný
100 = Nepriehľadný
clear bool Vymazanie obsahu ovládacieho prvku (label, button). Vhodné kombinovať s atribútom preventUpdate.
label string Pre niektoré prvky (button, label) dokáže nastaviť label, aj pomocou {$formData.FORM_DATA_ID} a {$helperData.HELPER_DATA_ID}. Vhodné kombinovať s atribútom preventUpdate
hint string Nastavenie hint-u pre niektoré prvky (ako label).
preventUpdate bool Platí pre niektoré prvky (button, label), zabraňuje update prvku.
broadcast bool 1 = odvysielajú sa udalosti definované na tomto tlačítku.
updateControl bool yes = cieľový prvok sa obnoví.
timeout ms Ak bude nastavené kladné číslo, táto akcia sa vykoná až o zadaný počet milisekúnd.
timerName string Názov timera pre timeout.

date

Táto akcia nastavuje dátum.

Dátum sa bude nastavovať pre premennú objektu formData definovanú buď ako atribút akcie (dataId, formDataId), alebo definovanú na samotnom tlačítku ako dataId.

Treba myslieť na to, že táto akcia iba nastavuje premennú. Samotné prekleslenie nastane:

  • nastavením atribútu broadcast="1",
  • alebo ďalšou akciou <broadcast />.

Atribúty

Atribút Popis
dataId
formDataId
string Dátumová premenná (formData), ktorá sa bude nastavovať.
helperDataId string Dátumová premenná (helperData), ktorá sa bude nastavovať. (4.5.224+)
action string Typ akcie:
today - dnešný dátum
next_day - následujúci deň
previous_day - predchádzajúci deň
next_week - následujúci týždeň
previous_week - predchádzajúci týždeň

(4.5.4.5.349+)
next_month - 1. deň následujúceho mesiaca
previous_month - 1. deň predchádzajúceho mesiaca
this_monday - pondelok aktuálneho týždňa
next_monday - pondelok následujúceho týždňa
previous_monday - pondelok predchádzajúceho týždňa
monday - pondelok
first_day_of_month - prvý deň v mesiaci
last_day_of_month - posledný deň v mesiaci
broadcast bool 1 = odvysielajú sa udalosti definované na tomto tlačítku.
updateControl bool yes = cieľový prvok sa obnoví.

Príklad

<date formDataId="cmd_date1" action="next_week" />
<broadcast />
 
<!-- alternatívny zápis -->
<date formDataId="cmd_date1" action="next_week" broadcast="true" />

Od verzie 4.5.375 sa dá používať skrátený zápis ako pre element <set/>.


set

Táto akcia nastavuje formData alebo formHelperData.

Ak je atribút broadcast=1, potom sa po skončení všetkých akcií na tlačítku odvysielajú udalosti tlačítka, ktoré vyvolalo túto akciu.

Príklad

<set formDataId="aktivny_obcan" value="1" />

Atribúty

Atribút Popis
formDataId
dataId
string Index formData premennej, ktorá sa bude nastavovať.
helperDataId string Index helperData premennej, ktorá sa bude nastavovať.
controlId
var
string Prvok na aktuálnom TAB-e a názov premennej, ktorá sa bude nastavovať.
Hodnota
value string Priama hodnota z atribútu.
valueDataId
valueFormDataId
string Hodnota z objektu formData.
Napr. priezvisko
valueDataPath
valueFormDataPath
string Hodnota zo štruktúry formData.
Napr. obcan.vek
valueHelperDataId string Hodnota z objektu helperData.
Napr. pom_priezvisko
valueHelperDataPath string Hodnota zo štruktúry helperData.
Napr. pom_obcan.vek
keyHelperDataId
indexHelperDataId
string Index, kľúč na výslednej hodnote.
keyFormDataId
indexFormDataId
string Index, kľúč na výslednej hodnote.
(4.5.223+)
valueControlDataId bool Hodnota z formData podľa controlId aktuálneho prvku.
isKeyDown string Či je stlačená predraďovacia klávesa. Možné hodnoty:
control
shift
alt
type string Určenie typu, možné hodnoty atribútu:
string
boolean, bool
number
int
object
array
raw
nodestring
copy bool
math string Základné matematické operácie:
inc
dec
not
randomNumber

Pri inc, dec može value_… určiť, o koľko sa zvýši/zníži cieľová hodnota.
randomMin int Minimálna hodnota pre math=random
randomMax int Maximálna hodnota pre math=random
string string Základné stringové operácie:
substr, substring - používa atribúty stringStart, stringLength

(4.5.223+)
chr - používa atribúty stringAscii

(4.5.373+)
substrCount, substringCount - používa atribúty stringSearch
search - používa atribúty stringSearch, stringStart
replace - používa atribúty stringSearch, stringReplace
length, size
upper
lower
split - používa atribúty stringDelimiter, stringLimit, stringSplitMulti
stringStart int Začiatok pre string=substr, string=search
stringLength int Dĺžka pre string=substr
stringAscii int Ascii pre string=chr
stringSearch string Hľadaný výraz pre string=search, string=replace, string=substrCount
stringReplace string Čím sa nahradí nájdený výraz pre string=replace
stringDelimiter string Delimiter pre string=split
stringLimit int Limit pre string=split
stringSplitMulti bool Nastavenie pre string=split.
1 - každý jeden znak v stringDelimiter bude delimiterom. Každý prvok výsledného poľa bude trimovaný a výsledné pole nebude obsahovať prázdne prvky.
array string Základné operácie s poľom:
(4.5.373+)
length, count
date string (4.5.224+)
today - dnešný dátum
next_day - následujúci deň
previous_day - predchádzajúci deň
next_week - následujúci týždeň
previous_week - predchádzajúci týždeň

(4.5.345+)
now - aktuálny čas vo formate Y-m-d H:i:s'
timestamp - aktuálny čas ako timestamp (JS format)
unix_timestamp - aktuálny čas ako timestamp (UNIX, milisekundy v milisekundách)

(4.5.349+)
next_month - 1. deň následujúceho mesiaca
previous_month - 1. deň predchádzajúceho mesiaca
this_monday - pondelok aktuálneho týždňa
next_monday - pondelok následujúceho týždňa
previous_monday - pondelok predchádzajúceho týždňa
monday - pondelok
first_day_of_month - prvý deň v mesiaci
last_day_of_month - posledný deň v mesiaci

(4.5.351+)
format - jednoduché formátovanie, formát sa následne definuje v atribúte format.
format string (4.5.345+)
Iba pre date=now (od 4.5.351 plati aj pre ostatné date príkazy).
Formát dátumu, podľa PHP funkcie date()
broadcast bool 1 = odvysielajú sa udalosti definované na tomto tlačítku.
updateControl bool yes = cieľový prvok sa obnoví.

Príklady zadania cez atribút

Všetky príklady sa dajú použiť aj s nastavovaním helperDataId namiesto formDataId alebo ovládací prvok controlId.

<set formDataId="vek" value="25" />
<!-- formData.vek sa nastaví na hodnotu "25" -->
<set formDataId="vek" value="25" type="number" />
<!-- formData.vek sa nastaví na hodnotu 25 (ako číslo) -->
<set formDataId="vek" value="1" type="boolean" />
<!-- formData.vek sa nastaví na hodnotu TRUE (ako boolean) -->

formData

<set formDataId="aktivny_obcan" valueFormDataId="vybrany_obcan" />
<!-- formData.aktivny_obcan sa nastaví na formData.vybrany_obcan -->
 
<set formDataId="aktivny_obcan" valueDataId="vybrany_obcan" />
<!-- to isté, alternatívny zápis -->
<set formDataId="aktivny_obcan_vek" valueFormDataPath="obcan.vek" />
<!-- formData.aktivny_obcan_vek sa nastaví na formData.obcan.vek -->

helperData

<set formDataId="aktivny_obcan" valueHelperDataId="pom_obcan" />
<!-- formData.aktivny_obcan sa nastaví na helperData.pom_obcan -->
<set formDataId="aktivny_obcan_vek" valueHelperDataPath="pom_obcan.vek" />
<!-- formData.aktivny_obcan_vek sa nastaví na helperData.pom_obcan.vek -->
<set helperDataId="var1" value="vek"/>
<set formDataId="aktivny_obcan_vek" valueHelperDataPath="pom_obcan" indexHelperDataId="var1" />

Príklady zadania cez hodnotu

<set formDataId="vek">25</set>
<!-- formData.vek sa nastaví na hodnotu "25" -->
<set formDataId="vek" type="number">25</set>
<!-- formData.vek sa nastaví na hodnotu 25 (ako číslo) -->

formData

<set formDataId="aktivny_obcan">{$formData.vybrany_obcan}</set>
<!-- formData.aktivny_obcan sa nastaví na formData.vybrany_obcan -->
<set formDataId="kod">CX-{$formData.vybrany_obcan}</set>
<!-- formData.kod sa nastaví na "CX-formData.vybrany_obcan" -->
<set formDataId="vek">V-{$formData.vybrany_obcan.vek}</set>
<!-- formData.vek sa nastaví na "V-formData.vybrany_obcan.vek" -->

helperData

<set formDataId="aktivny_obcan">{$helperData.pom_obcan}</set>
<!-- formData.aktivny_obcan sa nastaví na helperData.pom_obcan -->
<set formDataId="vek">V-{$helperData.pom_obcan.vek}</set>
<!-- formData.vek sa nastaví na "V-helperData.pom_obcan.vek" -->

object/array

<set helperDataId="tmp_var1" value="1988" />
<set helperDataId="tmp_var2" type="object">
	<param key="key1" value="VALUE1" />
	<param key="key2" valueHelperDataId="tmp_var1" />
</set>
<!-- helperData.tmp_var2 sa nastaví na objekt s kľúčmi key1="value1" a key2="1988" -->

Skrátený zápis

Od verzie 4.5.375 je možné používať skrátené názvy:

Dlhý
názov
Skrátený
názov
Príklad
formDataId F
helperDataId H
valueFormDataId FI
valueFormDataPath FP
valueHelperDataPath HP
valueHelperDataId HI
{$formData} {$F} {$F.obcan.meno}
{$helperData} {$H} {$H.obcan.meno}
<!-- Pôvodný zápis -->
<set helperDataId="obcanov_vek" value="42" type="num"/>
<set helperDataId="pom_obcan" type="object">
	<param key="meno">Fero</param>
	<param key="vek" valueHelperDataId="obcanov_vek"/>
</set>
<set formDataId="aktivny_obcan" valueHelperDataId="pom_obcan"/>
<set formDataId="aktivny_obcan_meno1">{$helperData.pom_obcan.meno}</set>
<set formDataId="aktivny_obcan_meno2" valueHelperDataPath="pom_obcan.meno"/>
 
<!-- Skrátený zápis -->
<set H="obcanov_vek" value="42" type="num"/>
<set H="pom_obcan" type="object">
	<param key="meno">Fero</param>
	<param key="vek" HI="obcanov_vek"/>
</set>
<set F="aktivny_obcan" HI="pom_obcan"/>
<set F="aktivny_obcan_meno1">{$H.pom_obcan.meno}</set>
<set F="aktivny_obcan_meno2" HP="pom_obcan.meno"/>

push

Táto akcia pridá hodnotu do poľa pre formData, formHelperData alebo nejaký ovládací prvok controlId. Syntax je rovnaká ako pre akciu set.


unset

Táto akcia vymaže nastavenie pre formData, formHelperData alebo nejaký ovládací prvok controlId. Syntax je rovnaká ako pre akciu set.

Atribúty

Atribút Popis
formDataId
dataId
string Index formData premennej, ktorá sa bude vymazávať.
helperDataId string Index helperData premennej, ktorá sa bude vymazávať.
controlId
var
string Prvok na aktuálnom TAB-e a názov premennej, ktorá sa bude vymazávať.
broadcast bool 1 = odvysielajú sa udalosti definované na tomto tlačítku.
updateControl bool yes = cieľový prvok sa obnoví.

Príklad

<unset formDataId="vek" />
<!-- vymaže premennú formData.vek -->
<unset helperDataId="var5" />
<!-- vymaže premennú helperData.var5 -->

runControl

Spustenie akcie (akcia, tlačítko, dataRequest).

Atribút controlId alebo tag je povinný.

Pri dataRequest sa vyvolá update.

Atribúty

Atribút Popis
controlId string ID prvku, ktorý sa bude updatovať.
tag string Tag prvkov, ktoré sa budú updatovať.

Príklad

<runControl controlId="cmd_zmena_obcana" />

Od verzie 4.5.369+ Ak bude controlId obsahovať znak |, potom to bude vyodnotené ako parametre volania. Tieto parametre sa prenesú do helperData aktuálneho TAB-u pod kľúče _runControlArg0, _runControlArg1, ….

Tieto parametre môžu obsahovať aj zápis {$helperData.var88}, {$formData.var88} a pod.

Nie je implementované na každé controlId, aktuálne iba: runControl, messageBox.

<runControl controlId="cmd_spusti|akcia1|x55" />
<runControl controlId="cmd_spusti|akcia3|jano" />
<runControl controlId="cmd_spusti|akcia3|{$helperData.projectId}" />

updateControl

Vyvolanie akcie update pre konkrétny ovládací prvok. Napríklad pre prvok label to znamená prekreslenie obsahu, pre žurnál to znamená nové načítanie obsahu a pod.

Atribút controlId alebo tag je povinný.

Atribúty

Atribút Popis
controlId string ID prvku, ktorý sa bude updatovať.
tag string Tag prvkov, ktoré sa budú updatovať.

Príklad

<updateControl controlId="cmd_zmena_obcana" />

messageBox

Zobrazenie správy.

Atribúty

Atribút Popis
type string Typ:
normal
info
warning
error
question, yesno, yes_no
selectable boolean Bude selektovateľný?
width int Šírka
onYesBroadcastEventId
onYesEventId
string Udalosť, ktorá sa zavolá pri výbere voľby yes
onNoBroadcastEventId
onNoEventId
string Udalosť, ktorá sa zavolá pri výbere voľby no
onOkBroadcastEventId
onOkEventId
string Udalosť, ktorá sa zavolá pri výbere voľby ok
onCancelBroadcastEventId
onCancelEventId
string Udalosť, ktorá sa zavolá pri výbere voľby cancel
onYesRunControlId string Control pri udalosti yes
onNoRunControlId string Control pri udalosti no
onOkRunControlId string Control pri udalosti ok
onCancelRunControlId string Control pri udalosti cancel

Príklad

<messageBox>Ahoj, Mesiac!</messageBox>

V rámci textu pre zobrazenie sa dá použiť:

  • {$formData.VAR_NAME}
  • {$F.VAR_NAME} (4.5.375+)
  • {$helperData.VAR_NAME}
  • {$H.VAR_NAME} (4.5.375+)
  • {$E.entity} - magická premenná pre vkladanie entít (4.5.239+)

Od verzie 4.5.365 je možné použiť rozšírenú syntax, ktorá umožňuje definovať vlastné tlačítka.

<messageBox>
	<label> <!-- dá sa použiť aj <message></message>, prípadne netreba dávať žiaden vnorený tag (príklad nižšie) -->
		Chcete vidieť mesiac?
	</label>
 
	<option label="Áno" hint="Áno, chcem." eventId="ev_yes" controlId="cmd_yes" />
 
	<option event="ev_no" control="cmd_no" symbolId="cancel_symbol">
		Nie
	</option>
 
	<option eventId="ev_maybe" control="cmd_maybe">
		<label>Možno</label>
		<hint>Možno chcem {$helperData.VAR_NAME}</hint>
	</option>
 
</messageBox>

Príklad bez vnoreného tagu (<label>, <message>):

<messageBox>
 
	Chcete vidieť mesiac?
 
	<option label="Áno" hint="Áno, chcem." eventId="ev_yes" controlId="cmd_yes" />
 
	<option event="ev_no" control="cmd_no" symbolId="cancel_symbol">
		Nie
	</option>
 
	<br/>
	Koniec hlásenia.
 
</messageBox>

Možné názvy atribútu pre udalosť:

  • broadcastEventId
  • broadcastEvent
  • eventId
  • event

Možné názvy atribútu pre určenie prvku:

  • runControlId
  • runControl
  • controlId
  • control

Možné názvy atribútu pre symbol:

  • symbolId
  • symbol

inputBox

Vstup od užívateľa.

Atribúty

Atribút Popis
defaultValue string
runControlId string
broadcastEventId string
resultFormDataId string
resultF string (4.5.375+)
resultHelperDataId string
resultH string (4.5.375+)
multiline bool (4.5.373+) Vstup bude viacriadkový (viac riadkov sa bohužiaľ zatiaľ nezobrazí)

Príklad

<inputBox broadcastEventId="EVENT_ID" resultHelperDataId="tmp_input1">
	Ahoj, Mesiac!
</inputBox>

exit

Ukončenie vykonávania skriptu.

Príklad

<if>
	<rule matchType="..." />
	<true>
		<exit />
	</true>
</if>

return

Od verzie 4.5.376

Ukončenie vykonávania aktuálneho skriptu. Narozdiel of <exit />, <return /> ukončí iba aktuálny skript, nie nadradený skript.

Príklad

<if>
	<rule matchType="..." />
	<true>
		<return />
	</true>
</if>

cancelTimer

Zruší timer timerName.

Atribúty

Atribút Popis
timerName string Názov timer-a.

Príklad

<cancelTimer timerName="t_test" />

cancelAllTimers

Zruší všetky nastavené timer-y.

Príklad

<cancelAllTimers />

broadcastEvent

Vysielanie jednej konkrétnej udalosti.

Atribút eventId je povinný.

Atribúty

Atribút Popis
eventId string ID udalosti.
ignoreForControlTab boolean Nebudú sa oslovovať ovládacie prvky, ktoré sa nachádzajú na tom istom TAB-e ako prvkok, ktorý túto udalosť vyvolal.
Je to vhodné pre volanie udalostí na iných TAB-och.

Príklad

<broadcastEvent eventId="e_zmena_obcana" />
<!-- Vyvolá sa udalosť "e_zmena_obcana", takže zareaguje každý prvok, ktorý na túto udalosť počúva. -->

broadcast

Vysielanie udalosti. Pokiaľ nebude zadaný atribút controlId, budú sa vysielať udalosti, ktoré sú nastavené nad daným tlačítkom (alebo akciou).

Atribúty

Atribút Popis
controlId string ID prvku. FIXME toto nejako nefunguje

Príklad

<broadcast />
<!-- Vysielanie udalostí, ktoré sú spriahnuté s aktuálnym prvkom. -->
 
<broadcast controlId="cmd_obcan" />
<!-- Vysielanie udalostí, ktoré sú spriahnuté s prvkom "cmd_obcan". -->

switchProfile

Prepnutie na konkrétny profil, definovaný povinným atribútom profileId.

Atribúty

Atribút Popis
profileId string ID profilu.
timeout ms Ak bude nastavené kladné číslo, táto akcia sa vykoná až o zadaný počet milisekúnd.
timerName string Názov timera pre timeout.

Príklad

<switchProfile profileId="kdch" />

selectTab

Prepnutie na konkrétny TAB, definovaný povinným atribútom tabId.

Nastavenie tabId sa nastavuje v základných nastaveniach pre vybraný TAB.

Atribúty

Atribút Popis
tabId string ID TAB-u.
timeout ms Ak bude nastavené kladné číslo, táto akcia sa vykoná až o zadaný počet milisekúnd.
timerName string Názov timera pre timeout.

Ako tabId sa dajú použiť aj špeciálne kódy:

  • _FIRST - úplne prvý tab
  • _LAST - posledný tab
  • _PREVIOUS - naposledy vybraný tab (v histórii) FIXME

Príklad

<selectTab tabId="t_pomoc2" />

resendFormData

Pomocný príkaz, ktorý opätovne odošle formData na server pri spracovaní požiadaviek. Neobsahuje žiadne atribúty. Viac info u Romana S.

Príklad

<set formDataId="vek" value="12" />
<resendFormData />

disableFormData

Pomocný príkaz, ktorý „prečistí“ formData. Pri prečisťovaní nebude vymazávať tie formData, ktoré sú povolené cez enableFormData.

Od verzie 4.4.286

Príklad

<disableFormData id="my_jurnal" /> <!-- neodošle sa formData.my_jurnal -->
 
<disableFormData beginWith="chk" /> <!-- neodošlú sa formData, ktorých kľúč začína "chk" -->
 
<disableFormData contain="uro" /> <!-- neodošlú sa formData, ktorých kľúč obsahuje "uro" -->
 
<disableFormData all="yes" /> <!-- neodošlú sa žiadne formData -->

Od verzie 4.5.372 je možné použiť atribút delete, ktorý dané pravidlo vymaže.

Príklad

<disableFormData beginWith="chk" /> <!-- neodošlú sa formData, ktorých kľúč začína "chk" -->
 
<runControl controlId="a_loadData"/>
 
<disableFormData beginWith="chk" delete="yes"/> <!-- predchádzajúce pravidlo sa vymaže a formData, ktorých kľúč začína "chk" sa bude posielať -->

enableFormData

Pomocný príkaz k disableFormData, ktorý odošle kľúče, ktoré boli zakázané pomocou disableFormData.

Od verzie 4.4.286

Príklad

<disableFormData beginWith="chk" />
<enableFormData id="chk_a01" />
 
<!-- neodošlú sa všetky formData, ktorých kľúč začína "chk" okrem "chk_a01" -->
<enableFormData id="my_jurnal" /> <!-- odošle sa formData.my_jurnal -->
 
<enableFormData beginWith="chk" /> <!-- odošlú sa formData, ktorých kľúč začína "chk" -->
 
<enableFormData contain="uro" /> <!-- odošlú sa formData, ktorých kľúč obsahuje "uro" -->

Od verzie 4.5.372 je možné použiť atribút delete, ktorý dané pravidlo vymaže.

Príklad

<disableFormData beginWith="chk" />
<enableFormData id="chk_a01" />
 
<!-- Z dát chk* sa odošle iba chk_01 -->
<runControl controlId="a_loadData"/>
 
<!-- Prechdádzajúce pravidlá sa zrušia a budú sa posielať všetky chk* -->
<disableFormData beginWith="chk" delete="yes" />
<enableFormData id="chk_a01" delete="yes" />

reload

Opätovné načítanie dennej operatívy. Niečo ako reset.

Príklad

<reload />

analyze

Zobrazenie obsahu premenných. Bez zadania iných atribútov sa zobrazia formData a helperData. Jedná sa o pomocnú funkciu, ktorá by sa nemala zobrazovať v produkčnom režime.

Atribúty

Atribút Popis
formData bool Zobrazia sa formData.
commonFormData bool Zobrazia sa spoločné formData.
helperData bool Zobrazia sa helperData.
commonHelperData bool Zobrazia sa spoločné helperData.
accelerator bool (4.5.384+) Stav acceleratora.
formData string Zobrazí sa formData premenná podľa atribútu.
commonFormData string Zobrazí sa spoločná formData premenná podľa atribútu.
helperData string Zobrazí sa helperData premenná podľa atribútu.
commonHelperData string Zobrazí sa spoločná helperData premenná podľa atribútu.
all bool Zobrazenie formData aj helperData
full bool Výsledok nebude orezaný.
controls
controlId
string Zobrazia sa premenné vars ovládacích prvkov podľa controls (oddelené čiarkou).

Príklad

<analyze />

Kontextové menu

<contextMenuTitle
	title="TITLE"
	titleFormDataId="FORM_DATA_ID"
	titleHelperDataId="HELPER_DATA_ID"
 
	hint="HINT"
	hintFormDataId="FORM_DATA_ID"
	hintHelperDataId="HELPER_DATA_ID"
 
	symbol="SYMBOL_IDF"
	symbolFormDataId="FORM_DATA_ID"
	symbolHelperDataId="HELPER_DATA_ID"
 
	showSymbolMatchValue="ok_symbol"
	showSymbolHelperDataId="tmp_var1"
/>
 
 
<contextMenuTitle>
	<title>TITLE</title>
	<hint>HINT</hint>
</contextMenuTitle>
 
 
<contextMenuItem
	title="TITLE"
	titleFormDataId="FORM_DATA_ID"
	titleHelperDataId="HELPER_DATA_ID"
 
	hint="HINT"
	hintFormDataId="FORM_DATA_ID"
	hintHelperDataId="HELPER_DATA_ID"
 
	callId="ID"
	disabled="no"
 
	symbol="SYMBOL_IDF"
	symbolFormDataId="FORM_DATA_ID"
	symbolHelperDataId="HELPER_DATA_ID"
/>
 
<contextMenuItem callId="ID">
	<title>TITLE</title>
	<hint>HINT</hint>
</contextMenuItem>
 
 
<contextMenuBreak />
 
 
<displayContextMenu
	resultFormDataId="FORM_DATA_ID"
	resultHelperDataId="HELPER_DATA_ID"
	runControl="CONTROL_ID"
	broadcastEvent="EVENT_ID"
/>
 
 
<resetContextMenu />

showSymbolMatchValue, showSymbolHelperDataId 4.5.234+

Od verzie 4.5.375 sa dá používať skrátený zápis podobný ako pre element <set/>. Takže je možné použiť:

  • titleFI namiesto titleFormDataId
  • titleHP namiesto titleHelperDataPath
  • hintHI namiesto hintHelperDataId
  • resultH namiesto resultHelperDataId
  • a pod.

Príklad

<contextMenuTitle>
	<title>
		<![CDATA[<b>TITLE</b>]]>
	</title>
</contextMenuTitle>
 
<contextMenuItem callId="MAIN_ID1" title="Main 1" hint="Hint for Main 1"/>
<contextMenuItem callId="MAIN_ID2" symbol="resource_symbol">
	<title>Main 2</title>
	<hint>Hint for Main 2</hint>
</contextMenuItem>
<contextMenuBreak />
<contextMenuItem callId="MAIN_ID3" title="Main 3" />
 
<contextMenuItem callId="SUB1_ID" title="Sub 1">
	<sub>
		<contextMenuItem callId="SUB1_ID1" title="SUB 1.1" />
		<contextMenuItem callId="SUB1_ID2" title="SUB 1.2" />
 
		<contextMenuItem callId="SUB2_ID" title="Sub 2">
			<sub>
				<contextMenuItem callId="SUB2_ID1" title="SUB 2.1" />
				<contextMenuBreak />
				<contextMenuItem callId="SUB2_ID2" title="SUB 2.2" />
			</sub>
		</contextMenuItem>
	</sub>
</contextMenuItem>
 
<contextMenuItem callId="MAIN_ID6" title="Main 6 disabled" disabled="yes" />
 
<displayContextMenu runControl="a_context1" resultHelperDataId="context1" />

Switch

4.5.140+

<switch valueFormDataId="aktualny_datum">
 
	<case value="2018-05-07" />
	<case value="2018-05-08" />
	<do>
		<messageBox value="A1"/> <!-- Zobrazí sa, ako aktualny_datum bude "2018-05-07" alebo "2018-05-08" -->
	</do>
 
	<case value="2018-05-10" />
	<do>
		<messageBox value="A2"/>  <!-- Zobrazí sa, ako aktualny_datum bude "2018-05-10" -->
	</do>
 
	<case value="2018-05-12" />
	<case value="2018-05-13" > <!-- Alternatívny spôsob bez bloku <do></do>, vykoná sa prvý <case>, ktorý má obsah -->
		<messageBox value="A3"/>
	</case>
 
	<case value="2018-05-20" /> <!-- Default sa nevykoná, i keď <do> je prázdne. -->
 
	<default>
		<messageBox value="Default"/>
	</default>
 
</switch>
 
<switch MATCH_VALUE="var1" >
	<!--
		MATCH_VALUE: // getXmlValue()
			valueFormDataId
			valueFormDataPath
			valueHelperDataId
			valueHelperDataPath
			valueControlDataId
			value
			isKeyDown
	-->
</switch>
 
<switch valueFormDataId="var1" >
	<case VALUE="ABC" type=TYPE>
	<!--
		VALUE: // getXmlValue()
			valueFormDataId
			valueFormDataPath
			valueHelperDataId
			valueHelperDataPath
			valueControlDataId
			value
			isKeyDown
 
		TYPE:
			number,int
			string,str
			boolean,bool
	-->
</switch>
 
<switch value="XY" >
</switch>

Skrátený zápis

Od verzie 4.5.375 je možné používať skrátené názvy podobne ako skrátený zápis pre element <set/>:

Dlhý
názov
Skrátený
názov
Príklad
valueFormDataId FI
valueFormDataPath FP
valueHelperDataPath HP
valueHelperDataId HI


If

<if>
	<rule valueFormDataId="f_rec1" />
	<or />
	<!--
		<and />
	-->
 
	<rule valueFormDataId="f_rec2" />
 
	<rule valueFormDataId="val1" matchType="equal" matchValue="abc" />
	<rule valueFormDataId="val1" matchType="notEqual" matchValue="abc" />
 
	<rule valueFormDataId="val1" matchType="equal" matchFormDataId="FORM_DATA_ID" />
	<rule valueFormDataId="val1" matchType="equal" matchHelperDataId="HELPER_DATA_ID" />
 
	<rule valueFormDataId="val1" matchType="same" matchValue="abc" />
	<rule valueFormDataId="val1" matchType="notSame" matchValue="abc" />
 
	<!-- default type pre greater, greaterEqual, less, lessEqual je string -->
	<rule valueFormDataId="val1" matchType="greater" matchValue="15" type="string" />
	<rule valueFormDataId="val1" matchType="greater" matchValue="15" type="number" />
	<rule valueFormDataId="val1" matchType="greaterEqual" matchValue="15" />
 
	<rule valueFormDataId="val1" matchType="less" matchValue="15" />
	<rule valueFormDataId="val1" matchType="lessEqual" matchValue="15" />
 
	<rule valueFormDataId="val1" matchType="contains" matchValue="abc" />
	<rule valueFormDataId="val1" matchType="notContains" matchValue="abc" />
 
	<rule valueFormDataId="val1" matchType="type" matchValue="string" />
 
	<rule valueFormDataId="val1" matchType="true" />
	<rule valueFormDataId="val1" matchType="false" />
	<rule valueFormDataId="val1" matchType="truthy" />
	<rule valueFormDataId="val1" matchType="falsey" />
	<rule valueFormDataId="val1" matchType="empty" />
	<rule valueFormDataId="val1" matchType="notEmpty" />
 
 
	<rule valueFormDataId="val1" matchType="equal" matchValue="15" type="string" />
	<rule valueFormDataId="val1" matchType="equal" matchValue="15" type="str" />
	<rule valueFormDataId="val1" matchType="equal" matchValue="15" type="number" />
	<rule valueFormDataId="val1" matchType="equal" matchValue="15" type="int" />
	<rule valueFormDataId="val1" matchType="equal" matchValue="15" type="boolean" />
	<rule valueFormDataId="val1" matchType="equal" matchValue="15" type="bool" />
 
	<rule valueFormDataId="val1" matchType="null" />
 
	<true>
		<layout controlId="rec0" visible="yes" />
	</true>
 
	<false>
		<layout controlId="rec0" visible="no" />
	</false>
</if>

Skrátený zápis

Od verzie 4.5.375 je možné používať skrátené názvy:

Dlhý
názov
Skrátený
názov
Príklad
valueFormDataId FI
valueFormDataPath FP
valueHelperDataPath HP
valueHelperDataId HI
matchFormDataId matchFI
matchFormDataPath matchFP
matchHelperDataId matchHI
matchHelperDataPath matchHP

Magická premenná $E

<messageBox>
	Ahoj{$E.nbsp}užívateľ.
</messageBox>
n \n
r \r
rn \r\n
tab \t
sp Klasická medzera
nbsp Nedeliteľná medzera
quot
apos '
lt <
gt >
amp &

dailyOperations/dailyOperationsTools/fLoadEntities.class.php


Ostatné

FIXME Zatiaľ iba čiastočne zdokumentované.

<action timeout="200" timerName="T_TIMER_NAME" />
 
 
 
 
 
<runFunction controlId="CONTROL_ID" function="FUNCTION" />
<runFunction
	controlId="CONTROL_ID"
 
	__global="yes"
	__controlId="_global._MEDIC"
	__controlId="_global"
 
	function="FUNCTION"
	resultFormDataId="FORM_DATA_ID"
	resultHelperDataId="HELPER_DATA_ID"
	pass="arguments"
/>
 
 
<setControlVars controlId="CONTROL_ID">
	<param key="VARIABLE_NAME" value="10" type="number" />
</setControlVars>
 
 
<getControlVar
	controlId="CONTROL_ID"
	var="VARIABLE_NAME"
	resultFormDataId="FORM_DATA_ID"
	resultHelperDataId="HELPER_DATA_ID"
/>
 
 
 
 
<request />
<request
	function=""
	formData=""
	updateFormData=""
	updateHelperData=""
	resultFormDataId="FORM_DATA_ID"
	resultHelperDataId="HELPER_DATA_ID"
	broadcastAfter="yes"
	broadcastEventId="event1, event2"
	runControlAfter="CONTROL_ID"
	runControl="CONTROL_ID"
	disableForm="yes"
 
	onErrorBroadcastEvent=""
	onErrorRunControl=""
>
 
	<param key="KEY" value="VALUE" />
	<param key="KEY" value="VALUE {$formData.OTHER_DATA_ID}" />
 
	<param key="KEY" valueDataId="OTHER_DATA_ID" />
	<param key="KEY" valueDataPath="OTHER_OBJ.OTHER_DATA_ID" />
 
	<param key="KEY" valueHelperDataId="OTHER_HELPER_DATA_ID" />
	<param key="KEY" valueHelperDataPath="OTHER_HELPER_OBJ.OTHER_DATA_ID" />
 
	<param key="KEY" valueControlDataId="yes" />
 
	<param key="KEY">VALUE</param>
	<param key="KEY">VALUE {$formData.OTHER_DATA_ID}</param>
	<param key="KEY">VALUE {$helperData.OTHER_DATA_ID}</param>
 
	<param type="text" />
	<param type="string" />
	<param type="number" />
	<param type="int" />
	<param type="boolean" />
	<param type="bool" />
	<param type="object" />
	<param type="array" />
	<param type="raw" />
 
	<param key="KEY" type="object">
		<param key="OBJ1" value="VALUE" />
		<param key="ARR1" type="array">
			<param value="16" type="number" />
		</param>
	</param>
 
</request>
 
<report />
 
<flash
	object=""
	function=""
>
 
	<!-- ako <request /> -->
 
	<objectParams>
		<param key="KEY" value="VALUE" />
	</objectParams>
 
 
</flash>
 
 
<font color='#0000ff'><u>
	<a href='asfunction:_DAILY_OPERATIONS_FORM.runControl,a_change_data|24'>
		Zmeň na 24
	</a>
</u></font>
 
 
<!-- Spustenie milwa skriptu zo stringu. Môže byť generovaný aj zo servera, napr. cez dataRequest. -->
<runFunction global="Yes" controlId="_DAILY_OPERATIONS" function="runMilwascriptFromString" pass="arguments">
	<param valueHelperDataId="tmp_commands" />
</runFunction>
omega/modules/dailyoperations/action.1742541484.txt.gz · Posledná úprava: 2025/03/21 08:18 od admin