Erinevused

Siin näed erinevusi valitud versiooni ja hetkel kehtiva lehekülje vahel.

--- wd:administraatorile:andmetüübihaldus:risttabel [2015/09/11 10:47] – [Tabeli definitsioon välja täitmisest lähemalt] admin
+++ wd:administraatorile:andmetüübihaldus:risttabel [2025/04/24 13:54] (Hetkel kehtiv) – [Lihtsamad arvutusvalemid] support
@@ Rida 4: / Rida 4: @@
 ===== Milleks? =====
-Risttabel võimaldab luua andmekoosseise mitme tunnuse järgi. Risttabelit kasutatakse nt lähetuste puhul, kus tuleb kajastada erinevaid kululiike. Seejuures lisatakse tavaliselt risttabelisse ka arvutamisfunktsionaalsus, et lihtsustada andmesisestaja tööd.
+Risttabel võimaldab luua andmekoosseise mitme tunnuse järgi. Risttabelit kasutatakse nt lähetuste puhul, kus tuleb kajastada erinevaid kululiike koos maksumustega. Risttabelis kasutatakse sageli ka arvutamisfunktsionaalsust, et lihtsustada andmesisestaja tööd.
 ===== Kuidas seadistada? =====
   * Vaata väljade üldiseid seadistusvõimalusi [[wd:administraatorile:andmetüübihaldus:väljad|siit]].
-  * Vaata risttabeli andmete kasutamist trükimallil [[wd:administraatorile:andmetüübihaldus:trükimallid#trükimalli_näiteid|siit]].
+  * Vaata risttabeli andmete kasutamist trükimallil [[wd:administraatorile:trükimallid#trükimalli_näiteid|siit]].
+\\
+{{youtube>RCFAzrLBErw?large}}
+\\
 ==== Plokk "Välimus" ====
-{{ :wd:välimus_risttabel.png |}}
+{{ :wd:administraatorile:andmetüübihaldus:risttabel_valimusplokk.png |}}
@@ Rida 22: / Rida 24: @@
 ],
 "colModel":[
-{"name":"id","index":"id", "width":30, "sortable":false, "editable":false, "hidden":false},
+{"name":"id","index":"id", "width":30, "sortable":false, "editable":false, "hidden":true},
-{"name":"kuupaev","index":"name", "width":150, "sortable":false, "editable":true},
+{"name":"x_date","index":"x_date", "width":150, "sortable":false, "editable":true},
 {"name":"selgitus","index":"selgitus", "width":100, "sortable":false, "editable":true}
@@ Rida 30: / Rida 32: @@
 }
 </code>
+\\
+**Lõpptulemus - risttabeli lisamisvorm**\\
+{{ :wd:administraatorile:andmetüübihaldus:risttabel_lisamisvorm.png?700 |}}
 \\
 \\
@@ Rida 37: / Rida 45: @@
 ==== Tabeli read ====
-Sellele väljale sisestatud definitsioonid annavad täiendava võimaluse eeltäita valitud tabeliread uue dokumendi lisamisel. Järgmises näites lisatakse risttabelisse vaikimisi üks rida, kus päevarahaks on **32.00 €** {{ :wd:risttabel_v4ljade_eelt4itmine.png |}}
+Sellele väljale sisestatud definitsioonid annavad täiendava võimaluse eeltäita valitud tabeliread uue dokumendi lisamisel. Järgmises näites lisatakse risttabelisse vaikimisi üks rida, kus päevarahaks on **32.00 €**
 ** Näite 1 tabeli definitsioon:**
@@ Rida 82: / Rida 90: @@
 \\
-=== Tühi tabelirida ===
+=== Tühi tabelirida I variant ===
-Tühja tabelirea tekitamiseks pane tühik jutumärkide vahele. **{"paevaraha":"<color red>tühik</color>"}**
+Tühja tabelirea tekitamiseks pane tühik jutumärkide vahele **{"paevaraha":"<color red>tühik</color>"}** <color red>NB! Ei toimi SOSEL väljatüübi puhul.</color>
 **Näite 3 tabeli read**
@@ Rida 95: / Rida 103: @@
 \\
 \\
+=== Tühi tabelirida II variant ===
+Tühja tabelirea tekitamiseks, kus tabel sisaldab SOSEL väljatüüpi, toimi järgnevalt:
+**Näite 4 tabeli read**
+<code php>
+[
+{"__act":""}
+]
+</code>
+\\
+\\
+\\
 === Tabelirea ehk veeru kohustuslikkus ===
 Tabelirea kohustuslikuks seadistamiseks lisa parameeter **"required":true**.
+\\
+\\
+\\
+\\
+=== Numbrivälja kümnendike eraldamine punkti asemel komaga ning kümnendikkohtade arvu määramine ===
+<code php>
+{"name":"currency","index":"currency", "width":75, "sortable":false,
+"editable":true, "formatter": "number", "formatoptions":{"decimalSeparator":",", "decimalPlaces": 2}},
+</code>
+[[http://www.trirand.com/jqgridwiki/doku.php?id=wiki:predefined_formatter|Loe lisaks jqGrid Wiki-st...]]
+\\
+\\
+\\
+\\
+=== Lähetustaotluse tabeli definitsiooni näide ===
+<code php>
+{
+"colNames":[
+"Id","Kululiik","Kulude katmise allikas","Kulusumma"
+],
+"colModel":[
+{"name":"id","index":"id","width":150, "sortable":false, "editable":true, "hidden":true},
+{"name":"kululiik","index":"kululiik", "width":175, "sortable":false, "editable":true, "classifier" : "Kululiik"},
+{"name":"kulude_allikas","index":"kulude_allikas", "width":400, "sortable":false, "editable":true, "classifier" : "Kulude katmise allikas"},
+{"name":"kulusumma","index":"kulusumma", "width":175, "sortable":false, "editable":true}
+],
+"formulas" : {
+"sum(kulusumma:first..kulusumma:last)" : "crstbl_setExpFieldValue(\"summa_kokku\",result);"
+},
+"caption": null
+}
+</code>
+{{ :wd:administraatorile:andmetüübihaldus:risttabel_lahetuskulu.png?700 |}}
 \\
 \\
@@ Rida 107: / Rida 167: @@
 Esmalt tuleb määrata veergude nimed (atribuut **colNames**). Alati peab olema esimeseks veeruks “Id” ja ülejäänud jutumärkides ja komaga eraldatud.
 \\
-Veergude seadete (atribuudi **colModel**) määramisel on mitmeid võimalusi, nt veeru peitmine, mida tehakse reeglina Id veeru puhul; sidumine klassifikaatoriga (näites toodud teine veerg Kululiik veerus "name".\\
+Veergude seadete (atribuudi **colModel**) määramisel on mitmeid võimalusi, nt veeru peitmine, mida tehakse reeglina Id veeru puhul; sidumine klassifikaatoriga (näites toodud teine veerg Kululiik.\\
-=== Risttabeli võimalikud atribuudid ===
+=== Risttabeli veergude võimalikud atribuudid ===
-  * **name** – administraatori enda poolt tuletatud nimi (kohustuslik märkida) – ei tohi sisaldada täpitähti ja tühikuid;
+  * **''name''** – administraatori enda poolt tuletatud nimi (kohustuslik märkida) – ei tohi sisaldada täpitähti ega tühikuid;
-  * **sortable** - sorteeritavus (valikud: true, false);
+  * **''sortable''** - sorteeritavus (valikud: true, false) **"sortable":true**
-  * **editable** - muudetavus (valikud: true, false);
+  * **''editable''** - muudetavus (valikud: true, false);
-  * **width** - välja laius;
+  * **''width''** - välja laius;
-  * **hidden** – peidetud (valikud: true, false);
+  * **''hidden''** – peidetud (valikud: true, false);
-  * **align** – joondus (võimalikud valikud: left, center, right);
+  * **''align''** – joondus (võimalikud valikud: left, center, right);
-  * **classifier** – klassifikaator (WD-s määratud klassifikaatori nimi);
+  * **''classifier''** – klassifikaator (WD-s määratud klassifikaatori nimi);
     * **ajax** - klassifikaatorit kuvatakse ajax-valikuna (valikud: true, false) nt **"ajax":true**;
     * **combo** - klassifikaatorit kuvatakse ripploeteluna (valikud: true, false) nt **"combo":true**;
-  * **sosel** - [[#SOSEL_väli_ehk_ühe_objekti_valiku_väli|SOSEL väli ehk ühe objekti valiku väli]];
+  * **''sosel''** - [[#SOSEL_väli_ehk_ühe_objekti_valiku_väli|SOSEL väli ehk ühe objekti valiku väli]];
-  * **required** - [[#Tabelirea ehk veeru kohustuslikkus|Veeru täitmine on kohustuslik]];
+  * **''required''** - [[#Tabelirea ehk veeru kohustuslikkus|Veeru täitmine on kohustuslik]];
-  * **formulas** - valemid;
+  * **''formulas''** - valemid;
-  * **caption** - tabeli pealkiri.
+  * **''caption''** - tabeli pealkiri.
+  * **''formatter'':number** - kasutatakse numbrivormingut;
+  * **''formatoptions'': {"decimalSeparator":",", "decimalPlaces": 2}** - kasutatakse kümnendkohtade eraldajat ning komakohtasid on kaks, kasutatakse koos **''formatter'':number**
+  * **''translate''** <color blue>(WD 5.2.0 - 13.10.2015)</color> - risttabeli veergude tõlkimiseks, nt **"translate" : {"en":"Currency","ru":"Bалюта"}**\\
+  * **''"display_sosel_id_in_template":0''** - trükimallis ei kuvata tüübi ID-d
 [[http://www.trirand.com/jqgridwiki/doku.php?id=wiki:colmodel_options|Loe seadetest lähemalt jqGrid Wiki-st...]]
@@ Rida 136: / Rida 200: @@
   *[[wd:administraatorile:andmetüübihaldus:kuupäev|Vt rohkem tavapärase kuupäevavälja kohta]] \\
-Kuupäevavälja seadistamiseks tuleb laienduse nimetuses kasutada **date**.
+Kuupäevavälja seadistamiseks tuleb laienduse nimetuses kasutada **date**. \\
-  * Näide: **"name":"x_date","index":"x_date"**
+Näide: \\
+<code php>
+"name":"x_date","index":"x_date"
+</code>
   * Mitme kuupäevavälja puhul võib esimese rea laienduse nimetuseks olla nt "x_date" ning teise rea laienduse nimetuseks nt "y_date"
 \\
@@ Rida 145: / Rida 212: @@
   * [[wd:administraatorile:andmetüübihaldus:ühe_objekti_valik|Vt rohkem tavapärase SOSEL välja kohta]] \\
-Ühe objekti valiku välja seadistamiseks tuleb lisada parameeter **"sosel" : 59277**, kus 59277 viitab andmetüübi id-le.
+Ühe objekti valiku välja seadistamiseks tuleb lisada parameeter, kus 59277 viitab andmetüübi id-le.
+<code php>
+"sosel" : 59277
+</code>
 \\
 === Ühe väärtuse valiku väli ===
-  * [[wd:administraatorile:andmetüübihaldus:valikväli|Vt rohkem tavapärase SOSEL välja kohta]] \\
+  * [[wd:administraatorile:andmetüübihaldus:valikväli|Vt rohkem tavapärase valikvälja kohta]] \\
-Ühe väärtuse valiku välja seadistamiseks tuleb lisada parameeter **"classifier" : "Kululiik"**, kus "Kululiik" viitab klassifikaatori üksühele nimetusele.
+Ühe väärtuse valiku välja seadistamiseks tuleb lisada parameeter, kus "Kululiik" viitab klassifikaatori üksühele nimetusele.
+<code php>
+"classifier" : "Kululiik"
+</code>
+\\
 === Ühe kasutaja valiku väli ===
   * [[wd:administraatorile:andmetüübihaldus:ühe_kasutaja_valik|Vt rohkem tavapärase ühe kasutaja valiku välja kohta]]
-Ühe kasutaja valiku välja seadistamiseks tuleb lisada parameeter **"sosel" : 2**.
+Ühe kasutaja valiku välja seadistamiseks tuleb lisada parameeter:
+<code php>
+"sosel" : 2
+</code>
 \\
 \\
 \\
+=== Mitmerealine tekst ===
+  * [[wd:administraatorile:andmetüübihaldus:mitmerealine_tekst|Vt rohkem tavapärase mitmerealise tekstivälja kohta]] Mitmerealise tekstivälja seadistamiseks tuleb lisada parameeter:
+<code php>
+"edittype":"textarea"
+</code>
+\\
+\\
+\\
 ==== Lihtsamad arvutusvalemid ====
@@ Rida 170: / Rida 258: @@
 === Liitmine, lahutamine, korrutamine, jagamine ===
-Antud järgnevas näites korrutatakse esimeses reas omavahel Hind ja Kurss ning summa kantakse risttabeli vastava rea lõpus “Summa (EEK)” väljale.
+Antud järgnevas näites korrutatakse esimeses reas omavahel Hind ja Kurss ning summa kantakse risttabeli vastava rea lõpus “Summa (EUR)” väljale.
+<code php>
+\\(sellel väljal defineeritakse arvutustehe)
+"expr(price:1*rate:1)" : "sum_eur:1"
+</code>
+\\
-**"expr(price:1*rate:1)" : "sum_eek:1"**, (sellel väljal defineeritakse arvutustehe)\\
   * **expr** – viitab arvutustehtele, mille järel sulgudes vastav tehe defineeritakse;
   * **(price:1*rate:1)** – price ja rate tähistavad veergude nimesid ja nr **1** tabeli esimest rida;
@@ Rida 190: / Rida 283: @@
 === Komakohad arvutustehtes ja lõpptulemuses ===
-**"decimalPlaces" : {** (komakohtade defineerimiseks)\\
+<code php>
-  * **"expr" : "2",** - komakohad arvutustehtes
+"decimalPlaces" : {
-  * **"sum" : "2"** - komakohad lõpptulemuses
+"expr" : "2",
+"sum" : "2"
+},
+</code>
+expr - komad arvutustehtes
+sum - komad lõpptulemuses
 \\
 \\
@@ Rida 204: / Rida 303: @@
 {
 "colNames":[
-"Id","Kululiik","Hind","Ilma km","Km","Valuuta","Kurss","Summa (EEK)"
+"Id","Kululiik","Hind","Ilma km","Km","Valuuta","Kurss","Summa (EUR)"
 ],
 "colModel":[
@@ Rida 211: / Rida 310: @@
 {"name":"price","index":"price", "width":100, "sortable":false, "editable":true},
 {"name":"no_vat","index":"no_vat", "width":100, "sortable":false, "editable":true},
-{"name":"vat", "width":75, "sortable":false, "editable":true, "align":"right", "sorttype":"float"},
+{"name":"vat", "index":"vat", "width":75, "sortable":false, "editable":true, "align":"right", "sorttype":"float"},
 {"name":"currency","index":"currency", "width":75, "sortable":false, "editable":true},
 {"name":"rate","index":"rate", "width":75, "sortable":false, "editable":true, "align":"right", "sorttype":"float"},
@@ Rida 234: / Rida 333: @@
 === Liitmine ja korrutamine ühes tehtes ===
-**"expr(amount:1* (price:1+add:1))" : "sum:1"**
+<code php>
-  ***amount:1* ** järel peab olema tühik
+"expr(amount:1* (price:1+add:1))" : "sum:1"
-  ***(price:1+add:1))**peab kasutama topeltsulgusid
+</code>
 === Näide B ===
@@ Rida 260: / Rida 359: @@
 "expr" : "2",
 "sum" : "2"
+},
+"caption": null
+}
+</code>
+=== Sõidupäeviku näide ===
+<code php>
+{
+"colNames":[
+"Id","Kuupäev","Sõidu eesmärk","Näit alguses","Lõppnäit","Läbisõit"
+],
+"colModel":[
+{"name":"id","index":"id", "sortable":false, "editable":false, "hidden":true},
+{"name":"x_date","index":"x_date", "width":100, "sortable":false, "editable":true},
+{"name":"name","index":"name", "width":400, "sortable":false, "editable":true},
+{"name":"start","index":"start", "width":100, "sortable":false, "editable":true, "align":"right"},
+{"name":"end","index":"end", "width":100, "sortable":false, "editable":true, "align":"right"},
+{"name":"kilometrage","index":"kilometrage", "width":100, "sortable":false, "editable":true, "align":"right"}
+],
+"formulas" : {
+"expr(end:1 - start:1)" : "kilometrage:1",
+"sum(kilometrage:first..kilometrage:last)" : "crstbl_setExpFieldValue(\"labisoit_kokku\",result);"
 },
 "caption": null
@@ Rida 268: / Rida 390: @@
 {{tag>risttabel väljad}}
-**[[wd:administraatorile|Tagasi administraatori juhendi avalehele]]**
+**[[et:wd:administraatorile|Tagasi administraatori juhendi avalehele]]**