Nástroje používateľa

Nástoje správy stránok


omega:modules:dailyoperations:start

Rozdiely

Tu môžete vidieť rozdiely medzi vybranou verziou a aktuálnou verziou danej stránky.

Odkaz na tento prehľad zmien

Both sides previous revision Previous revision
Next revision
Previous revision
omega:modules:dailyoperations:start [2015/05/11 17:38]
Roman Sališ [Ostatné]
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''​. 
  
----- +Denná operatíva momentálne obsahuje následujúce prvky: 
-==== layout ==== +  * [[./​action|Action]] 
-Táto akcia mení vlastnosti nejakého iného prvku na aktuálnom tab-e.+    * [[./​button|Button]] 
 +    * [[./date|Date control]]
  
-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é.+===== Príklady =====
  
-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. +[[./examples|Príklady použitia.]]
- +
-=== 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>​ +
- +
- +
- +
-===== Date ===== +
- +
-Dátumové tlačítko, s možnosťou nastavenia formátu.+
  
omega/modules/dailyoperations/start.1431358738.txt.gz · Posledná úprava: 2015/05/11 17:38 od Roman Sališ