Kasutaja tarvikud
See on dokumendi vana versioon!
Sisujuht
Trükimallide koostamise juhend Webware Open Office generaatori (X-path) baasil
Üldine
Smarty keelt kasutatakse WebDesktopis trükimallide juures.
Kui Smarty keele märke { } (loogelisi sulgusid) tahetakse kasutada teksti sees, siis tuleb need eelnevalt asendada vastavalt „{“ ⇒ „trükimallid“ Lisaks tuleb jutumärkide asemel kasutada märke ''' 3 ühekordset jutumärki (ilma jutumärkideta). Ühekordse jutumärgi saamiseks tuleb kasutada märke '' 2 ühekordset jutumärki (ilma jutumärkideta).
Näide:
Sisend
See on siin üks arvude hulk {ldelim}1,2,3{rdelim}
Väljund
See on siin üks arvude hulk {1,2,3}
Täpsemat infot standardse Smarty süntaksi kohta saate aadressilt http://smarty.net.
Path (teekond)
Path on teekond elemendini XML-i puus. Lisaks traditsioonilisele X-Path-i syntax-ile saab kasutada nö alampath-e eraldades nad “«” ja “»” märkidega. Näiteks “«objekt_id»”. Alamteekondades saab lisaks tavalisele teekonnale kasutada ka veel nn erifunktsioone:
- glv:viide jadale:välja nimetus
- type_ename:tüübi laienduse nimetus
Näited:
Antud näiteks väärtustatakse lähetatav (lhv) lähetuselt (lh) loetud id (lahetatav_id) kaudu.
// Parameeter "o" on vabalt valitud nimetus ja peab kattuma alamteekonnas antuga.
// Ainuke nõue on, et parameeter ei ole võrdne ühegi nö sisseehitatud parameetriga.
{sle n=lhv p='''webdk_relations/webdk_relation/webdk_slave_item/webdk_item[item_id=''<<glv:o:lahetatav_id>>'']''' o=$lh}
// Antud näites leitakse kõik seotud lähetused kasutades tüübi identifitseerimiseks laienduse nime.
// See on universaalsem lähenemine ning võimaldab lihtsamini malle ühest süsteemist teise üle kanda.
{sle n=lhs p='''webdk_relations/webdk_relation/webdk_slave_item/webdk_item[item_type_id=''<<type_ename:Lahetus> >'']'''}
Tag-id
Opt
See tag on mõeldud optimeerimiseks. Programmile on vaja anda “vihjeid”, et milliseid tüüpe antud mallis soovitakse kasutada, samuti vajadusel ka välju (näiteks, mis jäävad iflause piirkonda). See hoiab suuresti kokku sisend-XML-i mahtu. Vaikimisi paneb süsteem selle tüübi ID, mille pealt trükkimist alustatakse. St kui soovitakse ainult otseselt samalt andmekaardilt andmeid, siis opt tag-i ei pea kasutama. Samas, kui soovitakse ka seostest andmeid võtta, siis on vaja vastavate seotud tüüpide ID-d määrata.
Parameetrid:
| Nimetus | Kirjeldus |
|---|---|
| tids | Tüübi ID-de loetelu komadega eraldatud |
| enames | Tüübi ekspordi nimetuste loetelu komadega eraldatud |
| max_depth | Maksimaalne sügavus XML-is. Vaikimisi on see 2. Juhul kui tahetakse näiteks seostest omakorda sügavamale seostesse minna, siis peaks olema max_depth=3 jne |
Näide:
{opt tids=27992,28007,34111}
sb
See tag on mõeldud baas teekonna määramiseks. Viimast on vaja eelkõige asukoha teekondade kirjelduste lühendamiseks. Kui ühtegi sb tag-i dokumendist ei leita, siis määratakse selleks automaatselt “/webdk_data/webdk_item”.
Parameetrid:
| Nimetus | Kirjeldus |
|---|---|
| p | path ehk teekond. Määrab asukoha XML-puus |
Näide:
{sb p='''webdk_item[item_id=''45676'']'''}
Määrab, et järgnevad teekonnad on alates item-ist id=4676.
gv (get value)
Seda tag-i kasutatakse väljade sisu kuvamiseks.
Parameetrid:
| Nimetus | Kirjeldus |
|---|---|
| p | path ehk teekond. Määrab asukoha XML-puus |
| c | context ehk kontekst. Määrab konteksti, millest alates väärtuse otsingut teostatakse. Vt näidet |
| t | type ehk tüüp. Määrab ära välja tüübi. Kui määramata, siis kuvatakse täpselt nii nagu on sisendis. Vt tüübid osa |
| req | On nõutud. Määrab, kas vastav muutuja on nõutud. Vaikimisi on “true” |
| empty | Juhul, kui väärtus on tühi või puudu (viimase korral peab req=false), siis antakse selle muutuja väärtus tagasi. Näiteks. {gv p=minuvaartus req=false empty=tühi}. |
Tüübid:
| Nimetus | Kirjeldus |
|---|---|
| date | Kuupäev ja/või kellaaeg. Määrab ära kuupäeva tüübi, mille abil saab sisendisolevaid kuupäevi erinevatel kujudel esitada. Kuju saab määrata parameetriga fmt |
| est_named _date | Kuupäev nn nimetatud kujul eesti keeles. Näiteks “30. oktoober 2008”. Vt näidet. |
| musel | Määrab ära, et tegemist on musel väärtusega, mis formaaditakse vastavalt parameetritele “musel_sep”, “musel_val”. Näiteks. {gv p=MVV t=musel musel_sep=, empty=tühi musel_val=« code »: «value» req=false} |
Näide:
Tüüp: {gv p=../webdk_item_type/item_type_name_translation/et} Pealkiri: {gv p=pealkiri} Kuupäev formaadis AAAA-KK-PP: {gv p=reg_date t=date fmt=''Y-m-d''} Kuupäev nimetatud formaadis: {gv p=reg_date t=est_named_date}
{sle n=a p=webdk_relations/webdk_relation/webdk_slave_item/webdk_item} Esimese seose pealkiri: {gv p=pealkiri c=$a.0}
Lehekülje tarvikud
