Siin näed erinevusi valitud versiooni ja hetkel kehtiva lehekülje vahel.
wd:administraatorile:andmetüübihaldus:trükimallid:smarty [2014/08/15 11:36] admin |
wd:administraatorile:andmetüübihaldus:trükimallid:smarty [2019/08/08 02:06] |
||
---|---|---|---|
Rida 1: | Rida 1: | ||
- | ====== 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 "{" => "{{" | ||
- | "}" => "}}" | ||
- | Lisaks tuleb jutumärkide asemel kasutada märke <nowiki>'''</nowiki> 3 ühekordset jutumärki (ilma jutumärkideta). Ühekordse jutumärgi saamiseks tuleb kasutada märke <nowiki>''</nowiki> 2 ühekordset jutumärki (ilma jutumärkideta). | ||
- | |||
- | === Näide: === | ||
- | |||
- | ==Sisend== | ||
- | <code php>See on siin üks arvude hulk {ldelim}1,2,3{rdelim}</code> | ||
- | ==Väljund== | ||
- | <code php>See on siin üks arvude hulk {1,2,3}</code> | ||
- | 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.\\ | ||
- | <nowiki>// Parameeter "o" on vabalt valitud nimetus ja peab kattuma alamteekonnas antuga.</nowiki>\\ | ||
- | <nowiki>// Ainuke nõue on, et parameeter ei ole võrdne ühegi nö sisseehitatud parameetriga.</nowiki> | ||
- | <code php>{sle n=lhv | ||
- | p='''webdk_relations/webdk_relation/webdk_slave_item/webdk_item[item_id=''<<glv:o:lahetatav_id>>'']''' | ||
- | o=$lh}</code> | ||
- | <nowiki>// Antud näites leitakse kõik seotud lähetused kasutades tüübi identifitseerimiseks laienduse nime.</nowiki>\\ | ||
- | <nowiki>// See on universaalsem lähenemine ning võimaldab lihtsamini malle ühest süsteemist teise üle kanda.</nowiki> | ||
- | <code php>{sle n=lhs | ||
- | p='''webdk_relations/webdk_relation/webdk_slave_item/webdk_item[item_type_id=''<<type_ename:Lahetus> | ||
- | >'']'''}</code> | ||
- | \\ | ||
- | |||
- | ===== 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: === | ||
- | |||
- | <code php>{opt tids=27992,28007,34111}</code> | ||
- | |||
- | ==== 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: === | ||
- | |||
- | <code php>{sb p='''webdk_item[item_id=''45676'']'''}</code> | ||
- | |||
- | 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: === | ||
- | |||
- | <code php>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}</code> | ||
- | |||
- | <code php>{sle n=a p=webdk_relations/webdk_relation/webdk_slave_item/webdk_item} | ||
- | Esimese seose pealkiri: {gv p=pealkiri c=$a.0}</code> | ||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||