~~ODT~~
====== Trükimallid ======

===== Milleks? =====

Trükimallid võimaldavad luua dokumendifaili eelvormindatud mallile. 

===== Kuidas seadistada? =====

<note tip>Trükimallide haldamise õigus on töölauaadministraatoril, tavaadministraatoril ja üksuse administraatoril üksuse piires. Ülevaate sisestatud trükimallidest leiate [[#trükimalli_seadete_muutmine|trükimallide haldamise moodulist]], kus on võimalik malle ja nende seadistusi muuta ning uusi malle lisada. </note>

<note important>**Me ei soovita** trükimalle luua ning redigeerida **LibreOffice** ega **MS Word** tekstitöötlusprogrammides, kuna lõpptulemus võib olla ettearvamatu. **Trükimallide loomiseks on toetatud OpenOffice programm.**</note>


**Trükimalli kasutamiseks tuleb läbida järgnevad seadistamise etapid:**
    * Looge tekstitöötlusprogrammi OpenOffice Writer abil dokumendifail. **Trükimallide loomisel kasutatakse Webware Open Office generaatorit ning seepärast tuleb dokumendifail salvestada odt-vormingusse.  **
    * WebDesktopi mallide puhul kasutatakse süntaksina Smarty-keelt. Smarty keele jaoks on spetsiaalseteks märkideks loogelised sulud { } (ilma jutumärkideta). [[wd:administraatorile:andmetüübihaldus:trükimallid:smarty|Vt lähemalt Smarty-keele kohta siit.]] Oletame, et soovime automaatselt luua väljasaadetava dokumendi, millel oleks informatsioon registreeritud dokumendi pealkirja, registreerimisnumbri ning registreerimiskuupäeva kohta. 
      * Selleks tuleb kontrollida, kas väljasaadetava dokumendi andmetüübi vastavatel väljadel on olemas ekspordinimed. [[wd:administraatorile:andmetüübihaldus#Kuidas seadistada|Avage andmetüübi seadistused.]]
      * Seejärel avage [[wd:administraatorile:andmetüübihaldus:väljad#Plokk"Üldine"|välja seadistused.]] Avaneb [[wd:administraatorile:andmetüübihaldus:väljad#Plokk "Üldine"|välja muutmise aken]], kus asub ka ekspordinime väli. 
<note important>Ekspordinimes, mida kasutatakse trükimallides, ei tohi kasutada numbreid. Näiteks “minuvali2” ei leita, samas “minuvali_b” leitakse.</note> <note important>Piltide kasutamiseks trükimallil, kasutage **.jpg** vormingus pildifaili. **.png-failide** kasutamine pole toetatud.</note>
    * **Sisestage dokumendifaili vastava välja ekspordinimi kujul {gv p=ekspordinimi}**. Nt pealkirja välja puhul võib ekspordinimi olla "pealkiri". Tulemus oleks siis {gv p=pealkiri}.
    * **Laadige odt-vormingus trükimalli fail WD-sse.** Avage struktuuripuus kataloog, millesse soovite faili lisada, seejärel valige "Lisa uus" -> "Fail". {{ :wd:administraatorile:malli_faili_lisamine.png?600 |}}
      * Avaneb faili lisamise aken, kus tehke faili **asukoha valik**, kuhu fail salvestakse. Juhul kui mõni asukoht on puudu, saate seda seadistada [[wd:administraatorile:struktuuripuu#kataloogide_sisestamine|kataloogi lisamise või muutmise vormilt]], sidudes kataloogi andmetüübiga "Fail".
      * Faili üleslaadimiseks klõpsake nuppu "**Choose File**" / "**Lae fail**".
      * Linnutage **Kasuta trükimallina** - pärast salvestamist liigute automaatselt trükimallide haldamise lehele "Haldamine" -> "Trükkimise alused", vt Uue aluse lisamine.
      * Juhul kui Te soovite hiljem kasutada sama faili järgmistel kordadel alusdokumendina nt alusfailina järgmiste trükimalli failide loomisel, tehke linnuke "On alusdokument". Järgmistel kordadel saate kasutada alusdokumendiks märgitud faile. Alusdokumendi staatust saate eemaldada faili vaatamise vormilt nupuga "Märgi mittealusdokumendiks".
      * Faili lisamiseks vajutage "**Salvesta**".

<note>Kui lisatavas mallis on valemiviga, siis WD kuvab valget lehte.</note>

==== Uue aluse lisamine ====

Trükimalli fail tuleb siduda andmetüübiga. Selleks valige "Haldamine" -> "Trükkimise alused" ning täitke "Uue aluse lisamine" plokk.

{{ :wd:administraatorile:uue_aluse_lisamine.png?600 |}}
  * Nimi - trükkimise aluse nime kuvatakse registreeritud dokumendikande vaatamise vormil trükkimise aluste plokis;
  * Fail - trükimalli faili sidumine trükkimiste aluste plokiga. Pildil on trükimalli fail vaikimisi lisatud, aga vajadusel saate otsida WDs olevatest failidest (luubi ikoon);
  * Keel - trükimalli keel;
  * Väljundformaadid - võimalikud failivormingud, millesse saab dokumenti luua;
  * Vaikimisi formaat - failivorming, millesse dokument luuakse, kui kasutaja pole teinud formaadi valikut;
  * Faili väli - saate seadistada, millisele registreeritud kande väljale fail salvestatakse. Valikus on tüübil olevad ühefaili-tüüpi väljad. Kui jätta valik "puudub", saab kasutaja valida, kas loob faili väljale või kohtarvutisse.
  * Faili nimi - saate etteseadistada loodava dokumendi failinime, millele lõppu lisatakse kuupäev ja kellaaeg (kui faili nimi jäetakse seadistamata, siis pannakse failile nimi dünaamilise nime reegli alusel ning lõppu lisatakse kuupäev ja kellaaeg);
  * Moodul - WebDesktopi uuemad versioonid kasutavad "Webware's Open Office generator (XPath-based)" trükkimise aluste moodulit, mis on töölauaadministraatorile vaikimisi ettevalitud;
  * On aktiivne - kui on linnutatud, siis on trükkimise alus aktiivne.


==== Trükimalli näiteid ====
^Trükimalli sisu ^Trükimalli fail (odt-vormingus)^
|**Lihtne mall** nt {gv p=reg_kp},{gv p=reg_nr}; pildifaili kasutamine; **vabatekst** nt "Lugupidamisega"|{{:wd:lihtne_trykimall.odt|Lihtne trükimall}} |
|[[wd:administraatorile:kontaktiregister_seadistamine#kontakti_saatja_saaja_kuvamine_trükimallil|Kontaktiregistri lahendusega]] seotud väljasaadetava algatuskirja mall. **Kui valikvälja „Teabekandja“ (eksp nimi = teabekandja) väärtus on võrdne „digitaalne“**, siis pannakse märge (kuupäev digiallkirjas), vastasel juhul  registreerimiskuupäev. |{{:wd:valjasaadetav_dokument_algatuskiri.odt|Väljasaadetava dokumendi algatuskiri}}|
|[[wd:administraatorile:kontaktiregister_seadistamine#kontakti_saatja_saaja_kuvamine_trükimallil|Kontaktiregistri lahendusega]] seotud väljasaadetava vastuskirja **mall "Teie-Meie" osaga (läheb alati mallile)**|{{:wd:valjasaadetav_dokument_vastuskiri.odt|Väljasaadetava dokumendi vastuskiri}}|
|**Kasutaja ei pea tegema valikut algatus- ja vastuskirjade hulgast**, vaid valib ühe kirja trükimalli. **Kui koostaja on sama mis allkirjastaja, pannakse koostaja osasse ainult koostaja e allkirjastaja telefoninumber (ilma nimekorduseta).** Kui koostaja ei ole võrdne allkirjastajaga pannakse koostaja osasse koostaja ees- ja perenimi koos koostaja telefoninumbriga. Koostaja ja allkirjastaja peavad selleks asuma [[wd:administraatorile:andmetüübihaldus:ühe_kasutaja_valik|ühe kasutaja valikväljal]]|{{:wd:kirjamall_algatus_vastus_2in1.odt|Algatus- ja vastuskirja ühine mall}}|
|**Seotud andmetüübilt andmete pärimine**|{{:wd:leping_seotud_tyybilt_andmete_p4rimine.odt|Seotud tüübilt andmete pärimine}}|
|**[[wd:administraatorile:andmetüübihaldus:risttabel|Risttabeli]] andmete kandmine mallile**|{{:wd:risttabel_mallile.odt|Risttabelist andmete pärimine}}| 
|Tühja **[[wd:administraatorile:andmetüübihaldus:risttabel|risttabeli]] peitmine**|{{ :wd:risttabel_tyhi.odt|Tühja risttabeli peitmine}}|
|**Mitme väärtuse valiku alusel väärtuste linnutamine dokumendil**|{{:wd:linnukestega_mall2.odt|Väärtuste linnutamine dokumendil}}|
|**Suunamiste info kuvamine tabeli kujul**|{{:wd:administraatorile:suunamiste_aruanne.odt|Suunamiste aruanne}}|
|**Juurdepääsupiirang mallile**|{{:wd:administraatorile:mall_piirangualus_jpp.odt|JPP mallile}}|

\\
\\


=== Üksuse info mallile ===

<color blue>(WD 5.1.1)</color>\\
Üksuse info lisamiseks dokumendile pange mallile järgnev süntaks: **{gv p=item_unit_name}**

=== Kuupäev ja kellaaeg eestipäraselt mallile ===

<color blue>(WD 5.1.1 - 16.04.2015)</color>\\
Kuupäeva ja kellaaja kuvamine eestipäraselt nt **28. aprill 2025**. Lisage ekspordinimele **t=est_named_date** nt {gv p=reg_kpkell <color red>t=est_named_datetime</color>}
\\

=== Kuupäev inglisepäraselt mallile ===

<color blue>(WD 5.2.2 - 06.06.2016)</color>\\
Kuupäeva kuvamine inglisepäraselt nt **January 7th 2025**. Lisage ekspordinimele **t=eng_named_date** nt {gv p=reg_date <color red>t=eng_named_date</color>}


=== Kuupäeva tingimuslik arvutamine (nt +5 aastat) ===

<color blue>(Hub 7.23.0)</color>\\
Lisage ekspordinimele **t=date d_modify=** nt <code>{gv p=reg_kp t=date d_modify=''+5 years''} </code>
Kasutatavaid viiteid:

^d_modify string    ^ Tähendus ^
|+5 years|5 aastat juurde|
|-2 months|2 kuud maha|
|+10 days| 10 päeva juurde|
|+1 year 2 months 3 days| kombineeritud:1 aasta, 2 kuud ja 3 päeva juurde|
|next year | järgmine aasta (sama kuupäev)|
|last friday | eelmine reede |
|first day of this month| selle kuu esimene päev|
|+1 year first day of january| lisab 1 aasta ja seab kuupäevaks selle aasta 1.jaanuari|




=== Seostes olevate kannete esitlemine tabelis sorteerituna kuupäeva välja järgi ===

<color blue>(WD 5.2.3 - 12.02.2017)</color>\\

{{:wd:seostes_olevad_kanded_mallile_n2idis.odt|Näidisfail kommentaaridega}}

valem mallis:
<code>{table p='''webdk_relations/webdk_relation/webdk_slave_item/webdk_item[tegevuse_labiviija]''' sort=kuupaev_iso} </code>

kuupaev xml-s:
<kuupaev type="date">12.02.2017</kuupaev>

=== Mitmerealiselt HTML-vormingus tekstiväljalt andmete kuvamine mallile ===

Mallile lisada: \\
**{gv p=sisu c=$d.0 t=html}**

kus "sisu" = "välja ekspordinimi"

=== Klassifikaatori väärtused mallile vastavalt valitud WD keelele ===

<color blue>(WD 5.4.0 - 30.11.2017)</color>

Kui valikväli on seotud klassifikaatoriga ning väärtused on tõlgitud, on võimalik klassifikaatori väärtuseid tuua mallile üle vastavalt WD keelele. Oletame, et kasutame igapäevaselt WD-d eesti keeles, kuid soovime üht dokumenti genereerida inglisekeelsele mallile, selleks peame WD-s ajutiselt enda kasutajakonto keele muutma inglise keeleks, genereerima dokumendifaili ning hiljem keele tagasi muutma.


=== Malli abil genereeritava failinime pikkus ===

<color blue>(WD 5.3.6 - 04.08.2017)</color>\\

Kasutajatoel on võimalik lasta seadistada mallidele genereeritavate failinimede pikkust (tasuline teenus). Selleks on koniguratsioonis muutuja: WEBDK_FILENAME_BY_TEMPLATE_LENGTH. 

Kui see on aktiveeritud, siis limiteeritakse mallide põhjal genereeritud failide nimed selle väärtuse pikkuseni faili laiendust arvestamata. Kui pole, siis käitub nagu enne ehk piire pole.  

=== Trükimalli info ühe faili väljalt ===

Trükimalli algusesse tuleb loetleda faili väljade ekspordinimed opt fieldsina, nt
**{opt fields=originaalfail}**

Ühe faili väljal oleva faili nime saamiseks tuleb ekspordinime lõppu panna "_name", nt **{gv p=originaalfail_name}**


===== Trükimalli faili muutmine =====

  - Liigu "Haldamine" -> "Trükkimise alused" {{ :wd:administraatorile:trykimalli_faili_muutmine.png |}}
  - Klõpsa failil, mida soovid muuta;
  - Avaneb faili vaatamise vorm: {{ :wd:administraatorile:trykimalli_faili_vaatamisvorm.png?600 |}}
  * Faili vaatamise vormile jõuab ka vasakult puust: ava trükimallide kataloog, vastava malli real klõpsa ikooni "Vaata".

  * **"Muuda"** nupu abil saate lisada kohtarvutist muudatustega faili. {{ :wd:administraatorile:trykimalli_muutmine.png?400 |}}

  * Vali fail - saate kohtarvutist valida faili.
  * Tee uus versioon - tekitab vanade versioonide loetelu, mida on hiljem võimalik taastada.

===== Trükimalli seadete muutmine =====

==== Milleks? ====

Kui on vaja juurde lisada nt failivorminguid (docx, pdf jms), millesse dokumendifail luuakse või muuta trükkimise aluse nime, siis seda saate teha "Trükkimise alused" mooduli kaudu. 

==== Kuidas seadistada? ====

  - Valige ülamenüüst „Haldamine“ → „Trükkimise alused“.
  - Vastava trükimalli rea lõpus („Tegevused“ veerus) vajutage „Muuda“ nuppu. {{ :wd:administraatorile:trykimalli_seaded.png |}}
  - Tehke vajalikud muudatused ning muudatuste salvestamiseks vajutage „Muuda“.

===== Trükimalli kustutamine =====

Trükimalle on võimalik kustutada 2 moodi:
  - Valige ülamenüü „Haldamine“ → „Trükkimise alused“. Vastava malli rea lõpus („Tegevused“ veerus) vajutage „Kustuta“ nuppu.
  - Valige „Haldamine“ → „Töölaua admin“ → „Tüübid“. Vastava (alam)tüübi kaardil „Trükkimise alused“ plokis vajutage „Kustuta“ nuppu.
Viimasena tuleb fail ära kustutada ka vasakul puus olevast kataloogist „Trükkimise alused“. Kustutamiseks märgistage linnukesega vastav mall ning vajutage „Kustuta valitud“.

{{tag>trükimall}}

**[[et:wd:administraatorile|Tagasi administraatori juhendi avalehele]]**