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 />.
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 | |
|---|---|---|
formDataIddataId | 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. |
valueDataIdvalueFormDataId | string | Hodnota z objektu formData.Napr. priezvisko |
valueDataPathvalueFormDataPath | 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>