Toto je staršia verzia dokumentu!
Samotný formulár dennej operatívy obsahuje dve základné premenné (objekty):
formData
- základné premenné, ktoré sú zároveň aj odosielané na server pri každej požiadavke. Tam sú dostupné v Smarty ako {$formData}
.helperData
- pomocné premenné, ktoré slúžia pre niektoré obslužné účely. Nie sú prenášané na server.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:
<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
.
Táto akcia mení vlastnosti nejakého iného prvku na aktuálnom tab-e.
Atribút controlId
je povinný a určuje prvok na aktuálnom tab-e, na ktorom sa urobia zmeny (cieľový prvok). Ostatné atribúty sú nepovinné.
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.
<layout controlId="cmd_tlacitko2" visible="1" />
Atribút | Popis | |
---|---|---|
controlId | string | ID prvku na aktuálnom tab-e, povinný atribút. |
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. |
visible | bool | 0 = nie je viditeľný 1 = je viditeľný |
enabled | bool | 0 = nie je povolený 1 = je povolený ![]() |
alpha | % | Priehladnosť, hodnoty 0 až 100. 0 = Úplne riehľadný 100 = Nepriehľadný |
broadcast | bool | 1 = odvysielajú sa udalosti definované na tomto tlačítku. |
updateControl | bool | 1 = cieľový prvok sa obnoví. |
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:
broadcast="1"
,<broadcast />
.Atribút | Popis | |
---|---|---|
dataId formDataId | string | Dátumová premenná (formData), ktorá sa bude nastavovať. |
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. |
visible | bool | 0 = nie je viditeľný 1 = je viditeľný |
enabled | bool | 0 = nie je povolený 1 = je povolený ![]() |
alpha | % | Priehladnosť, hodnoty 0 až 100. 0 = Úplne riehľadný 100 = Nepriehľadný |
broadcast | bool | 1 = odvysielajú sa udalosti definované na tomto tlačítku. |
updateControl | bool | 1 = cieľový prvok sa obnoví. |
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.
<set formDataId="aktivny_obcan" value="1" />
Atribút | Popis | |
---|---|---|
formDataId dataId | string | Index formData premennej, ktorá sa bude nastavovať. |
helperDataId | string | Index helperData 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 |
valueControlDataId | bool | Hodnota z formData podľa controlId aktuálneho prvku. |
type | string | Určenie typu, možné hodnoty atribútu: |
math | string | Základné matematické operácie: |
broadcast | bool | 1 = odvysielajú sa udalosti definované na tomto tlačítku. |
updateControl | bool |
Všetky príklady sa dajú použiť aj s nastavovaním helperDataId
namiesto formDataId
<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) -->
<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 -->
<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 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) -->
<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" -->
<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" -->
Spustenie akcie (akcia alebo tlačítko).
Atribút controlId
je povinný.
Atribút | Popis | |
---|---|---|
controlIdId | string | ID prvku, z ktorého bude vyvolaná akcia. |
<runAction controlId="cmd_zmena_obcana" />
Vyvolanie jednej konkrétnej udalosti.
Atribút eventId
je povinný.
Atribút | Popis | |
---|---|---|
eventId | string | ID udalosti. |
<broadcastEvent eventId="e_zmena_obcana" /> <!-- Vyvolá sa udalosť "e_zmena_obcana", takže zareaguje každý prvok, ktorý na túto udalosť počúva. -->
Vyvolanie udalosti.
Pokiaľ nebude zadaný atribút controlId
, vyvolajú sa udalosti, ktoré sú nastavené nad daným tlačítkom (alebo akciou).
Atribút | Popis | |
---|---|---|
controlId | string | ID prvku. |
<broadcast /> <!-- Vyvolanie udalostí, ktoré sú spriahnuté s aktuálnym prvkom. --> <broadcast controlId="cmd_obcan" /> <!-- Vyvolanie udalostí, ktoré sú spriahnuté s prvkom "cmd_obcan". -->
Pomocný príkaz, ktorý opätovne odošle formData na server pri spracovaní požiadaviek. Neobsahuje žiadne atribúty. Viac info u Romana S.
<set formDataId="vek" value="12" /> <resendFormData />
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út | Popis | |
---|---|---|
formData | bool | Zobrazia sa formData . |
helperData | bool | Zobrazia sa helperData . |
<analyze />
<date /> <date action="next_day" /> <date action="previous_day_day" /> <date action="next_week" /> <date action="previous_week_week" /> <date action="today" /> <date action="..." broadcast="1" /> <request /> <request function="" formData="" updateFormData="" updateHelperData="" broadcastAfter="1" runButtonAfter="BUTTON_CONTROL_ID" > <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" controlDataId="1" /> <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>