Tu môžete vidieť rozdiely medzi vybranou verziou a aktuálnou verziou danej stránky.
Both sides previous revision Previous revision Next revision | Previous revision | ||
omega:modules:dailyoperations:start [2015/05/11 17:15] Roman Sališ [Príklady zadania cez atribút] |
omega:modules:dailyoperations:start [2015/10/12 17:05] (aktuálne) Roman Sališ |
||
---|---|---|---|
Riadok 6: | Riadok 6: | ||
* ''helperData'' - pomocné premenné, ktoré slúžia pre niektoré obslužné účely. Nie sú prenášané na server. | * ''helperData'' - pomocné premenné, ktoré slúžia pre niektoré obslužné účely. Nie sú prenášané na server. | ||
- | ===== Button ===== | + | ===== Udalosti ===== |
- | Tento prvok je určený pre spúšťanie rôznych akcii. | + | Jednotlivé ovládacie prvky dokážu "vysielať" viac udalostí a zároveň dokážu reagovať na zachytené udalosti. |
+ | Každý prvok môže inak reagovať na zachytenú udalosť, napr. prekreslenie obsahu, zmena dátumu a pod. | ||
- | Akcie sa zapisujú ako XML, takže pozor na následujúce nástrahy: | + | ===== Ovládacie prvky ===== |
- | * Atribúty musia byť v úvodzovkách alebo apostrofoch. | + | |
- | * Samotný element musí byť ukončený. <code xml><layout controlId="btn2" /></code> | + | |
- | Ak bude nejaká hodnota typu ''boolean'', | ||
- | môže sa používať aj alternatívny zápis ''on'', ''off'', ''yes'', ''no'', ''true'', ''false''. | ||
- | |||
- | ---- | ||
- | ==== layout ==== | ||
- | 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. | ||
- | |||
- | === Príklad === | ||
- | |||
- | <code xml> | ||
- | <layout controlId="cmd_tlacitko2" visible="1" /> | ||
- | </code> | ||
- | |||
- | |||
- | === Atribúty === | ||
- | |||
- | ^ 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ý\\ :!: Nie je zatiaľ implementované. | | ||
- | | ''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í. | | ||
- | |||
- | |||
- | |||
- | |||
- | |||
- | ---- | ||
- | |||
- | ==== 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 === | ||
- | |||
- | <code xml> | ||
- | <set formDataId="aktivny_obcan" value="1" /> | ||
- | </code> | ||
- | |||
- | === Atribúty === | ||
- | |||
- | ^ 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:''\\ string\\ boolean, bool\\ number\\ int\\ raw'' | | ||
- | | ''math'' | //string// | Základné matematické operácie:''\\ not'' | | ||
- | | ||| | ||
- | | ''broadcast'' | //bool// | 1 = odvysielajú sa udalosti definované na tomto tlačítku. | | ||
- | | ''updateControl'' | //bool// | | | ||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | === Príklady zadania cez atribút === | ||
- | |||
- | Všetky príklady sa dajú použiť aj s nastavovaním ''helperDataId'' namiesto ''formDataId'' | ||
- | |||
- | <code xml> | ||
- | <set formDataId="vek" value="25" /> | ||
- | <!-- formData.vek sa nastaví na hodnotu "25" --> | ||
- | </code> | ||
- | |||
- | |||
- | <code xml> | ||
- | <set formDataId="vek" value="25" type="number" /> | ||
- | <!-- formData.vek sa nastaví na hodnotu 25 (ako číslo) --> | ||
- | </code> | ||
- | |||
- | |||
- | <code xml> | ||
- | <set formDataId="vek" value="1" type="boolean" /> | ||
- | <!-- formData.vek sa nastaví na hodnotu TRUE (ako boolean) --> | ||
- | </code> | ||
- | |||
- | |||
- | == formData == | ||
- | |||
- | |||
- | <code xml> | ||
- | <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 --> | ||
- | </code> | ||
- | |||
- | |||
- | <code xml> | ||
- | <set formDataId="aktivny_obcan_vek" valueFormDataPath="obcan.vek" /> | ||
- | <!-- formData.aktivny_obcan_vek sa nastaví na formData.obcan.vek --> | ||
- | </code> | ||
- | |||
- | |||
- | == helperData == | ||
- | |||
- | |||
- | <code xml> | ||
- | <set formDataId="aktivny_obcan" valueHelperDataId="pom_obcan" /> | ||
- | <!-- formData.aktivny_obcan sa nastaví na helperData.pom_obcan --> | ||
- | </code> | ||
- | |||
- | |||
- | <code xml> | ||
- | <set formDataId="aktivny_obcan_vek" valueHelperDataPath="pom_obcan.vek" /> | ||
- | <!-- formData.aktivny_obcan_vek sa nastaví na helperData.pom_obcan.vek --> | ||
- | </code> | ||
- | |||
- | |||
- | === Príklady zadania cez hodnotu === | ||
- | |||
- | |||
- | <code xml> | ||
- | <set formDataId="vek">25</set> | ||
- | <!-- formData.vek sa nastaví na hodnotu "25" --> | ||
- | </code> | ||
- | |||
- | |||
- | <code xml> | ||
- | <set formDataId="vek" type="number">25</set> | ||
- | <!-- formData.vek sa nastaví na hodnotu 25 (ako číslo) --> | ||
- | </code> | ||
- | |||
- | |||
- | <code xml> | ||
- | <set formDataId="aktivny_obcan">{$formData.vybrany_obcan}</set> | ||
- | <!-- formData.aktivny_obcan sa nastaví na formData.vybrany_obcan --> | ||
- | </code> | ||
- | |||
- | |||
- | <code xml> | ||
- | <set formDataId="kod">CX-{$formData.vybrany_obcan}</set> | ||
- | <!-- formData.kod sa nastaví na "CX-formData.vybrany_obcan" --> | ||
- | </code> | ||
- | |||
- | |||
- | <code xml> | ||
- | <set formDataId="vek">V-{$formData.vybrany_obcan.vek}</set> | ||
- | <!-- formData.vek sa nastaví na "V-formData.vybrany_obcan.vek" --> | ||
- | </code> | ||
- | |||
- | |||
- | |||
- | <code xml> | ||
- | <set formDataId="aktivny_obcan">{$helperData.pom_obcan}</set> | ||
- | <!-- formData.aktivny_obcan sa nastaví na helperData.pom_obcan --> | ||
- | </code> | ||
- | |||
- | |||
- | <code xml> | ||
- | <set formDataId="vek">V-{$helperData.pom_obcan.vek}</set> | ||
- | <!-- formData.vek sa nastaví na "V-helperData.pom_obcan.vek" --> | ||
- | </code> | ||
- | |||
- | ---- | ||
- | |||
- | |||
- | ==== runAction ==== | ||
- | |||
- | Spustenie akcie (akcia alebo tlačítko). | ||
- | |||
- | Atribút ''controlId'' je povinný. | ||
- | |||
- | === Atribúty === | ||
- | |||
- | ^ Atribút ^ ^ Popis ^ | ||
- | | ''__controlIdId__'' | //string// | ID prvku, z ktorého bude vyvolaná akcia. | | ||
- | |||
- | |||
- | === Príklad === | ||
- | |||
- | <code xml> | ||
- | <runAction controlId="cmd_zmena_obcana" /> | ||
- | </code> | ||
- | |||
- | |||
- | ---- | ||
- | |||
- | |||
- | ==== broadcastEvent ==== | ||
- | |||
- | Vyvolanie jednej konkrétnej udalosti. | ||
- | |||
- | Atribút ''eventId'' je povinný. | ||
- | |||
- | === Atribúty === | ||
- | |||
- | ^ Atribút ^ ^ Popis ^ | ||
- | | ''__eventId__'' | //string// | ID udalosti. | | ||
- | |||
- | === Príklad === | ||
- | |||
- | <code xml> | ||
- | <broadcastEvent eventId="e_zmena_obcana" /> | ||
- | <!-- Vyvolá sa udalosť "e_zmena_obcana", takže zareaguje každý prvok, ktorý na túto udalosť počúva. --> | ||
- | </code> | ||
- | |||
- | |||
- | ---- | ||
- | |||
- | |||
- | ==== broadcast ==== | ||
- | |||
- | Vyvolanie udalosti. | ||
- | Pokiaľ nebude zadaný atribút ''controlId'', vyvolajú sa udalosti, ktoré sú nastavené nad daným tlačítkom (alebo akciou). | ||
- | |||
- | === Atribúty === | ||
- | |||
- | ^ Atribút ^ ^ Popis ^ | ||
- | | ''controlId'' | //string// | ID prvku. | | ||
- | |||
- | === Príklad === | ||
- | |||
- | <code xml> | ||
- | <broadcast /> | ||
- | <!-- Vyvolanie udalostí, ktoré sú spriahnuté s aktuálnym prvkom. --> | ||
- | |||
- | <broadcast controlId="cmd_obcan" /> | ||
- | <!-- Vyvolanie udalostí, ktoré sú spriahnuté s prvkom "cmd_obcan". --> | ||
- | </code> | ||
- | |||
- | ---- | ||
- | |||
- | |||
- | |||
- | ==== 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 === | ||
- | |||
- | <code xml> | ||
- | <set formDataId="vek" value="12" /> | ||
- | <resendFormData /> | ||
- | </code> | ||
- | |||
- | ---- | ||
- | |||
- | |||
- | ==== 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''. | | ||
- | | ''helperData'' | //bool// | Zobrazia sa ''helperData''. | | ||
- | |||
- | |||
- | === Príklad === | ||
- | <code xml> | ||
- | <analyze /> | ||
- | </code> | ||
- | |||
- | ---- | ||
- | |||
- | |||
- | ==== Ostatné ==== | ||
- | |||
- | <code xml> | ||
- | |||
- | <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" /> | ||
- | | ||
- | | ||
- | <set /> | ||
- | <set dataId="KEY" value="VALUE" /> | ||
- | <set dataId="KEY" value="VALUE {OTHER_DATA_ID}" /> | ||
- | | ||
- | <set dataId="KEY" valueDataId="DATA_ID" /> | ||
- | <set dataId="KEY" valueDataPath="" /> | ||
- | | ||
- | <set dataId="KEY" valueHelperDataId="DATA_ID" /> | ||
- | <set dataId="KEY" valueHelperDataPath="" /> | ||
- | | ||
- | <set dataId="KEY" valueControlDataId="1" /> | ||
- | | ||
- | <set dataId="KEY">VALUE</set > | ||
- | <set dataId="KEY">VALUE {$formData.OTHER_DATA_ID}</set > | ||
- | | ||
- | <set helperDataId="KEY" value="..." /> | ||
- | | ||
- | <set dataId="..." broadcast="1" /> | ||
- | | ||
- | <set type="number" /> | ||
- | <set type="int" /> | ||
- | <set type="boolean" /> | ||
- | <set type="bool" /> | ||
- | | ||
- | <set dataId="..." math="not" /> | ||
- | | ||
- | | ||
- | | ||
- | | ||
- | |||
- | <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> | ||
- | | ||
- | | ||
- | |||
- | </code> | ||
+ | Denná operatíva momentálne obsahuje následujúce prvky: | ||
+ | * [[./action|Action]] | ||
+ | * [[./button|Button]] | ||
+ | * [[./date|Date control]] | ||
+ | ===== Príklady ===== | ||
+ | [[./examples|Príklady použitia.]] | ||