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:40] Roman Sališ [Denná operatíva] |
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. | ||
- | Denná operatíva momentálne obsahuje následujúce prvky: | + | ===== Udalosti ===== |
- | * [[./button|Button]] | + | Jednotlivé ovládacie prvky dokážu "vysielať" viac udalostí a zároveň dokážu reagovať na zachytené udalosti. |
- | * Date control | + | Každý prvok môže inak reagovať na zachytenú udalosť, napr. prekreslenie obsahu, zmena dátumu a pod. |
- | ===== Button ===== | + | |
- | 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: | + | ===== 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í. | | + | |
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | ---- | + | |
- | + | ||
- | ==== 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ť. | | + | |
- | | ''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ň | | + | |
- | | ''broadcast'' | //bool// | 1 = odvysielajú sa udalosti definované na tomto tlačítku. | | + | |
- | | ''updateControl'' | //bool// | 1 = cieľový prvok sa obnoví. | | + | |
- | === Príklad === | + | |
- | <code xml> | + | |
- | <date formDataId="cmd_date1" action="next_week" /> | + | |
- | <broadcast /> | + | |
- | + | ||
- | <!-- alternatívny zápis --> | + | |
- | <date formDataId="cmd_date1" action="next_week" broadcast="true" /> | + | |
- | </code> | + | |
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | ---- | + | |
- | + | ||
- | + | ||
- | ==== 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> | + | |
- | + | ||
- | + | ||
- | == formData == | + | |
- | + | ||
- | + | ||
- | <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> | + | |
- | + | ||
- | + | ||
- | == helperData == | + | |
- | + | ||
- | <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" /> | + | |
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | <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]] | ||
- | ===== Date ===== | + | ===== Príklady ===== |
- | Dátumové tlačítko, s možnosťou nastavenia formátu. | + | [[./examples|Príklady použitia.]] |