Kasutaja tarvikud

Lehe tööriistad



et:yld_print_form

Erinevused

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

Lõlita võrdlemise vaatele

Both sides previous revision Previous revision
Next revision
Previous revision
et:yld_print_form [2021/05/27 13:16]
mer [Häälestamine]
et:yld_print_form [2023/04/13 11:14] (Hetkel kehtiv)
ott [GS1 kood]
Rida 2: Rida 2:
 Directo väljatrükk on oma olemuselt HTML kujundus, mille kirjeldamine toimub XSL Stylesheet-i abil. Väljatrükkides võetakse andmed XML-ist (igale dokumendile ja aruandele on oma XML kogum). ​ Directo väljatrükk on oma olemuselt HTML kujundus, mille kirjeldamine toimub XSL Stylesheet-i abil. Väljatrükkides võetakse andmed XML-ist (igale dokumendile ja aruandele on oma XML kogum). ​
 =====Häälestamine===== ​ =====Häälestamine===== ​
 +Väljatrükkide häälestamiseks peab kasutajal olema õigus, mida saab määrata kasutaja/​grupi õiguste MUU saki alt.
 +{{:​et:​triin20211110-142625.png}}
 +
 ''​Seadistused>​ Üldised seadistused > Väljatrükkide häälestamine''​ ''​Seadistused>​ Üldised seadistused > Väljatrükkide häälestamine''​
  
Rida 17: Rida 20:
 {{:​et:​triin20210527-102013.png}} {{:​et:​triin20210527-102013.png}}
  
-Väljatrükivormi kujundus asub nupu **XLS** all. Akna paremal ääres on ülevaade tervest koodist, mis aitab paremini navigeerida ning kiirelt erinevate sektsioonide peale hüpata või nende vahel liikuda. Kui sisestada koodi algus, pakub redigeerija vasteid ja abistab koodi lõpuleviimisega. Muudatused tuleb rakendumiseks salvestada.+Väljatrükivormi kujundus asub nupu **XSL** all. Akna paremal ääres on ülevaade tervest koodist, mis aitab paremini navigeerida ning kiirelt erinevate sektsioonide peale hüpata või nende vahel liikuda. Kui sisestada koodi algus, pakub redigeerija vasteid ja abistab koodi lõpuleviimisega. Muudatused tuleb rakendumiseks salvestada.
 {{:​et:​triin20210527-111605.png}} {{:​et:​triin20210527-111605.png}}
  
Rida 30: Rida 33:
   * <​nowiki><​!--</​nowiki>​mailnopdf:​1<​nowiki>​ --></​nowiki>​pdfi asemelt tehakse html    * <​nowiki><​!--</​nowiki>​mailnopdf:​1<​nowiki>​ --></​nowiki>​pdfi asemelt tehakse html 
   * <​nowiki><​!--</​nowiki>​mailnoattachment:<​nowiki>​ --></​nowiki>​pdfi manust ei lisata üldse, ainult enda kirjutatud tekst    * <​nowiki><​!--</​nowiki>​mailnoattachment:<​nowiki>​ --></​nowiki>​pdfi manust ei lisata üldse, ainult enda kirjutatud tekst 
-  * PDF parameetrid \\ Väljund ​landscape: \\ <​nowiki><​!--</​nowiki>​pdfparams:​BrowserWidth=1000,​isLandscape=1,​version=1,​HeaderHeight=60,​FooterHeight=60<​nowiki>​--></​nowiki> ​ **debug_pdf=1** ​näha visuaalselt päise ja jaluse tsoon \\ **Engine=1** ​Gecko renderer (IE asemel) ​\\ **FontEmbed=1** ​lisab PDFi fondid kaasa (lisada saab serverile [[et:​fntlist|installitud fontide]] seast) ​\\ **InsetX=10,​InsetY=10** ​X ja Y koordinaadid joonistamise alguseks ​\\ **BrowserWidth=800** võimaldab määrata nö Zoom astet, ehk kui suur vaade välja näeb (vaikimisi 800). \\ ** ImageQuality=10** pildifailide kompressioon 0 - 100  (0=pakitud, halb kvaliteet, 100=ilma pakkimata, kvaliteedikaota)+  * PDF parameetrid \\ Parameetrid eraldatakse komaga. Näide: PDF luuakse ​landscape ​formaadis: \\ <​nowiki><​!--</​nowiki>​pdfparams:​BrowserWidth=1000,​isLandscape=1,​version=1,​HeaderHeight=60,​FooterHeight=60<​nowiki>​--></​nowiki> ​<​WRAP>​ 
 +^Parameeter^Selgitus^  
 +|**debug_pdf=1**|näha visuaalselt päise ja jaluse tsoon
 +|**BrowserWidth=800**|Lehe laius joonistamisel pikslites (vaikimisi 800, landcape puhul 1000)| 
 +|**isLandscape=1**|PDF luuakse lanscape formaadis (laius suurem kui kõrgus)| 
 +|**version=1**|vajalik parameeter, et koordinaadid arvutataks lehe äärest äärde piksli pealt| 
 +|**Engine=1**|Gecko renderer (IE asemel) ​NB! sellega ei toimi üle lehe "​voolavad"​ layoudid| 
 +|**HeaderHeight=60**|Päise kõrgus mm| 
 +|**FooterHeight=60**|Jaluse kõrgus mm| 
 +|**HeaderHeight1=60**|Esilehe päise kõrgus mm (kui see peab erinema ülejäänutest)| 
 +|**FooterHeight1=60**|Esilehe jaluse kõrgus mm (kui see peab erinema ülejäänutest)| 
 +|**FontEmbed=1**|lisab PDFi fondid kaasa (lisada saab serverile [[et:​fntlist|installitud fontide]] seast) ​
 +|**InsetX=10,​InsetY=10**|X ja Y koordinaadid joonistamise alguseks ​
 +|**BrowserWidth=800**|võimaldab määrata nö Zoom astet, ehk kui suur vaade välja näeb (vaikimisi 800)|  
 +|** ImageQuality=10**|pildifailide kompressioon 0 - 100  (0=pakitud, halb kvaliteet, 100=ilma pakkimata, kvaliteedikaota) ​
 +|**MediaBox=A4**|lehe suurus (vaikimisi A4) | 
 +|**Rect=0 0 210 297**|meedia "​ruudu"​ dimensioonid mm, näide on A4 (0 0 = x ja y joonistamise alguspunkt lehe vasakul alanurgas; 210 - laius mm; 297 kõrgus mm)| 
 + 
 +</​WRAP>​
   * <​nowiki><​!--</​nowiki>​output-excel <​nowiki>​ --></​nowiki>​lisab exceli headeri - fail avatakse exceliga ​   * <​nowiki><​!--</​nowiki>​output-excel <​nowiki>​ --></​nowiki>​lisab exceli headeri - fail avatakse exceliga ​
   * <​nowiki><​!--</​nowiki>​clear-output<​nowiki>​ --></​nowiki>​väljundiks on ainult puhas XSL-i transformatsioon (ilma Directo päiseta)   * <​nowiki><​!--</​nowiki>​clear-output<​nowiki>​ --></​nowiki>​väljundiks on ainult puhas XSL-i transformatsioon (ilma Directo päiseta)
-  * Meili saates luuakse sündmus, ​soovikorral ​saab muuta loodud sündmuse parameetreid vastavate XSL parameetritega <​nowiki><​!--ev_type:​xxx --> <​!--ev_status:​xxx --> ​ <​!--ev_status:​xxx -->  ​<​!--ev_object:​xxx --> ​ <​!--ev_start:​xxx --> ​ <​!--ev_end:​xxx --> ​ </​nowiki>​+  * Meili saates luuakse sündmus, ​soovi korral ​saab muuta loodud sündmuse parameetreid vastavate XSL parameetritega <​nowiki><​!--ev_type:​xxx --> <​!--ev_status:​xxx --> <​!--ev_object:​xxx --> ​ <​!--ev_start:​xxx --> ​ <​!--ev_end:​xxx --> ​ </​nowiki>​
   * <​nowiki><​!--output-pdf--></​nowiki>​ väljatrükk avaneb alati PDFina ​ (aruannete puhul faili nime määramiseks tasub ka mailattachment parameeter määrata - vt järgmine punkt)   * <​nowiki><​!--output-pdf--></​nowiki>​ väljatrükk avaneb alati PDFina ​ (aruannete puhul faili nime määramiseks tasub ka mailattachment parameeter määrata - vt järgmine punkt)
   * <​nowiki><​!--</​nowiki>​mailattachment:​attachmendi/​faili_nimi<​nowiki>​ --></​nowiki>​saab kasutada tagi {nr} ning parameetreid {param:​parami_nimi}   * <​nowiki><​!--</​nowiki>​mailattachment:​attachmendi/​faili_nimi<​nowiki>​ --></​nowiki>​saab kasutada tagi {nr} ning parameetreid {param:​parami_nimi}
   * <​nowiki><​!--</​nowiki>​mailsubject:​uus_subjekt<​nowiki>​ --></​nowiki>​saab kasutada tagi {nr} ning parameetreid {param:​parami_nimi}   * <​nowiki><​!--</​nowiki>​mailsubject:​uus_subjekt<​nowiki>​ --></​nowiki>​saab kasutada tagi {nr} ning parameetreid {param:​parami_nimi}
   * <​nowiki><​!--</​nowiki>​output-file:​failinimi.txt<​nowiki>​ --></​nowiki>​väljund faili    * <​nowiki><​!--</​nowiki>​output-file:​failinimi.txt<​nowiki>​ --></​nowiki>​väljund faili 
-  * <​nowiki><​!--</​nowiki>​charset:​windows-xxx<​nowiki>​ --></​nowiki>​tavapäraselt on //​output-file//​ puhul on encodinguks windows-1257,​ seda juhul, kui xsl-is pole kusagil //​charset=utf-8//​ (siis on encodinguks mõistagi UTF-8). Kui aga määrata charset parameeter eraldi, siis võetakse siin määratud encoding ​+  * <​nowiki><​!--</​nowiki>​charset:​windows-xxx<​nowiki>​ --></​nowiki>​tavapäraselt on //​output-file//​ puhul encodinguks windows-1257,​ seda juhul, kui xsl-is pole kusagil //​charset=utf-8//​ (siis on encodinguks mõistagi UTF-8). Kui aga määrata charset parameeter eraldi, siis võetakse siin määratud encoding ​ 
 +  * <​nowiki><​!--</​nowiki>​mailbody:​xxx<​nowiki>​ --></​nowiki>​massmeili puhul meili sisu tekst. Kui xxx on number, võetakse sisu antud numbriga tekstist, mis on kirjeldatud ''​Üldised seadistused>​Tekstid''​ all
  
 Parameetrite **mailsubject,​ mailattachment,​ output-file,​ mailfrom, mailto ja mailname** puhul saab kasutada: Parameetrite **mailsubject,​ mailattachment,​ output-file,​ mailfrom, mailto ja mailname** puhul saab kasutada:
Rida 200: Rida 222:
 |UPC-E|upce| |UPC-E|upce|
 |UPC-E Composite|upcecomposite| |UPC-E Composite|upcecomposite|
 +
 +
 +====GS1 kood=====
 +GS1 standard võimaldab koodis edastada andmeid mitme erineva parameetri kohta. Näiteks seerianumber,​ parim enne jne. Konkreetne parameeter ehk nn.[[https://​www.gs1.org/​standards/​barcodes/​application-identifiers|AI]] on standardis defineeritud. Koodi genereerimisel tuleks AI esitada sulgudes, näiteks ribakoodi seerianumbri ja parim enne jaoks oleks kood formaadis ''​(01)ribakood(21)seerianr(15)YYMMDD''​
 + \\ \\
 +GS1-128 ribakoodina \\
 +{{https://​login.directo.ee/​logos/​qr.asp?​t=(01)ribakood(21)seerianr(15)YYMMDD&​code=gs1-128&​.png?​}}
 +
 +GS1 QR koodina \\ {{https://​login.directo.ee/​logos/​qr.asp?​t=(01)ribakood(21)seerianr(15)YYMMDD&​code=gs1qrcode&​.png?​}}
  
  
Rida 208: Rida 239:
 Tähelepanu tuleks pöörata järgnevale:​ Tähelepanu tuleks pöörata järgnevale:​
 ====Scripti kasutamine XSLis==== ====Scripti kasutamine XSLis====
-<​xsl:​stylesheet>​ lehe deklareerimiselpeavad olema defineeritud ka järgnevad script atribuudid:+<​xsl:​stylesheet>​ lehe deklareerimisel peavad olema defineeritud ka järgnevad script atribuudid:
     * <​code>​xmlns:​script = "​http://​topxml.com/​forum/​script"</​code>​     * <​code>​xmlns:​script = "​http://​topxml.com/​forum/​script"</​code>​
     * <​code>​xmlns:​x="​ignore"​ exclude-result-prefixes="​script"</​code>​     * <​code>​xmlns:​x="​ignore"​ exclude-result-prefixes="​script"</​code>​
Rida 227: Rida 258:
 Kõik <​msxsl:​script>​ blokis tuleks ka oma kujundusse kopeerida (siin asub funktsioon, mille abil tehakse ribakoodi pilt) Kõik <​msxsl:​script>​ blokis tuleks ka oma kujundusse kopeerida (siin asub funktsioon, mille abil tehakse ribakoodi pilt)
  
-====Funktsiooni ​väljakutse====+====Funktsiooni ​väljakutsumine====
   * Ribakoodi kuvamiseks kutsutakse välja eelpool mainitud funktsioon <​code><​xsl:​value-of disable-output-escaping="​yes"​ select="​string(script:​code128(string(artikkel)))"/></​code>​   * Ribakoodi kuvamiseks kutsutakse välja eelpool mainitud funktsioon <​code><​xsl:​value-of disable-output-escaping="​yes"​ select="​string(script:​code128(string(artikkel)))"/></​code>​
   * Võib juhtuda, et mõningate sümbolite korrektsena kuvamiseks tuleb ribakoodilugejat seadistada õiget tüüpi klaviatuuri emuleerima (testitud käpaga õnnestus kood lugeda, kui klaviatuuri tüübiks oli määratud SWE/FIN)   * Võib juhtuda, et mõningate sümbolite korrektsena kuvamiseks tuleb ribakoodilugejat seadistada õiget tüüpi klaviatuuri emuleerima (testitud käpaga õnnestus kood lugeda, kui klaviatuuri tüübiks oli määratud SWE/FIN)
Rida 338: Rida 369:
 </​code>​ </​code>​
  
 +=====Pilt tabeli taustaks=====
 +Pildi saab kasutada tabeli taustana, selleks tuleb määrata tabeli stiil järgnevalt: ​
 +<​code>​
 +<table style="​background:​ url(/​logos/​files/​pilt.png);​background-size:​ 150px; background-position:​ 260px 10px;​background-repeat:​no-repeat;"​ border="​0"​ cellpadding="​0"​ cellspacing="​0"​ valign="​top">​
 +</​code>​
 +
 +Pdfparams parameeter Engine peab antud juhul olema 1.
 +<​code>​
 +<​!--pdfparams:​BrowserWidth=1000,​isLandscape=1,​version=1,​HeaderHeight=60,​FooterHeight=60,​Engine=1-->​
 +</​code>​
 =====Lingi kasutamine===== =====Lingi kasutamine=====
 <code xsl><​a target="​_blank">​ <code xsl><​a target="​_blank">​
Rida 372: Rida 413:
   * võimalus on signeerimist kasutada ka lihtsalt nö manusena PDFi salvestajana. Sellisel juhul signeerimist ei toimu, lihtsalt signeerimise väljatrükk salvestatakse PDFina dokumendi manuseks. Selle saavutamiseks tuleks lisada XSLi ülal mainitud **img** tagi **emulator** atribuut: <code html><​img sign="​signhere"​ emulator="​1"​ width="​1"​ border="​0" ​  /></​code>​   * võimalus on signeerimist kasutada ka lihtsalt nö manusena PDFi salvestajana. Sellisel juhul signeerimist ei toimu, lihtsalt signeerimise väljatrükk salvestatakse PDFina dokumendi manuseks. Selle saavutamiseks tuleks lisada XSLi ülal mainitud **img** tagi **emulator** atribuut: <code html><​img sign="​signhere"​ emulator="​1"​ width="​1"​ border="​0" ​  /></​code>​
  
 +=====PDF manuseks=====
  
 +Kui dokumendile on loodud PDF väljatrükk,​ mida on vaja digiallkirjastada,​ saab sellest väljatrükist mugavalt ühe nupu vajutusega luua manuse. Selleks tuleb ''​Seadistused > Väljatrükid''​ alt leida õige dokument, soovitud väljatrüki real teha "​Signeeri"​ tulbas valik **PDF manuseks** ja salvestada.\\
 +{{:​et:​evelint20220902-103249.png}}
 +
 +Kui eelnev seadistus on tehtud, tekib dokumendile nupp "PDF manuseks"​. Olukorras, kus seadistus on tehtud ühe dokumenti mitmele väljatrükile,​ on nuppudel lisaks ka väljatrüki nimetus.
 +{{:​et:​evelint20220902-103412.png}}
 +
 +Nupu vajutuse tagajärjel tekib väljatrükist dokumendi {{:​et:​evelint20220902-105915.png}} alla manus.
 +
 +PDF manuseks loomise tugi on hetkel järgmistel dokumentidel:​
 +  * Pakkumine
 +  * Tellimus
 +  * Lähetus
 +  * Arve
 +  * Sündmus
 +  * Klient
 +  * Leping
 +  * Liikumine
 +  * Personal
  
 =====EveryPay Linkpay===== =====EveryPay Linkpay=====
Rida 383: Rida 443:
   - EveryPay portaalis tuleb luua **LINKPAY>​Lingid** alt link   - EveryPay portaalis tuleb luua **LINKPAY>​Lingid** alt link
   - Lingi detailvaates on kuvatud **Lingi token**, mis tuleb kopeerida ning määrata Directo süsteemi seadistustes ''​EveryPay LinkPay lingi token''​ väärtuseks   - Lingi detailvaates on kuvatud **Lingi token**, mis tuleb kopeerida ning määrata Directo süsteemi seadistustes ''​EveryPay LinkPay lingi token''​ väärtuseks
-  - Lingi //Muuda// vaates tuleb //​Aktiivne//​ tulbas valida aktiivseks __ainult__ //Arve number// väli. ​Lisaks määrata ​väljadele //​Tasumisele kuuluv summa// ​ja //Arve nr// linnud ​ tulbas ​ //URL MUUDETAV// ​{{:et:ott20201005-151349.png}} :!: Kui //URL MUUDETAV// tulpa pole näha, pöörduda EveryPay kasutajatoe poole, et see lisada. +  - Lingi //Muuda// vaates tuleb //​Aktiivne//​ tulbas valida aktiivseks __ainult__ //Arve number// väli. ​Kui kasutusel on ka viitenumber ning EveryPay poolt on aktiveeritud //​Pangalingi maksed//, tuleks valida ka Viitenumber.  
-  - EveryPay portaali **SEADED>​Üldised seaded** alt kopeerida **API salasõna** Directo süsteemiseadistuse ''​EveryPay LinkPay API salasõna''​ väärtuseks+  - Määrata linnud tulbas ​ //URL MUUDETAV// ​väljadele //​Tasumisele kuuluv summa (transaction_amount)// ning //Arve nr (invoice_number)//, Viitenumbri puhul ka Viitenumber (reference_number) ​  {{:et:ott20210831-171549.png}} :!: Kui //URL MUUDETAV// tulpa pole näha, pöörduda EveryPay kasutajatoe poole, et see lisada. ​\\ :!: Viitenumber saadetakse, kui süsteemiseadistus ''​Transpordi viitenumber''​ on **Arvelt** \\ :?: Süsteemiseadistus ''​EveryPay tasuda välja alus''​ võimaldab määrata, milline summa saadetakse makselingile - arve saldo, kliendi saldo või arve tasuda summa 
 +  - EveryPay portaali **SEADED>​Üldised seaded** alt kopeerida **API parool** Directo süsteemiseadistuse ''​EveryPay LinkPay API parool''​ väärtuseks
   - Süsteemi seadistus ''​EveryPay LinkPay URL''​ on vaikimisi täidetud testkeskkonna aadressiga <​nowiki>​https://​igw-demo.every-pay.com</​nowiki>​ Pärast testimist tuleb see täita live teenuse aadressiga <​nowiki>​https://​pay.every-pay.eu</​nowiki>​   - Süsteemi seadistus ''​EveryPay LinkPay URL''​ on vaikimisi täidetud testkeskkonna aadressiga <​nowiki>​https://​igw-demo.every-pay.com</​nowiki>​ Pärast testimist tuleb see täita live teenuse aadressiga <​nowiki>​https://​pay.every-pay.eu</​nowiki>​
-  - Link tekib arve XMLi, kui väljatrüki definitsiooni aknasse **Väljad** alt on valitud //EveryPay LinkPay link// \\ :?: See valik tekib automaatselt peale salvestamist,​ kui lisada //​everypay_link//​ XMLi tag järgmises punktis toodud näite alusel.+  - Link tekib nii arve kui ka tellimuse ​XMLi, kui väljatrüki definitsiooni aknasse **Väljad** alt on valitud //EveryPay LinkPay link// \\ :?: See valik tekib automaatselt peale salvestamist,​ kui lisada //​everypay_link//​ XMLi tag järgmises punktis toodud näite alusel. ​Analoogselt arvele edastatakse ka tellimuse puhul viitenumber
   - Lingi võib lisada väljatrükile sobivasse kohta, loomise näide: <code xsl><​a><​xsl:​attribute name="​href"><​xsl:​value-of select="/​documents/​document/​everypay_link"​ disable-output-escaping = "​yes"/></​xsl:​attribute>​MAKSA SIIN</​a></​code>​   - Lingi võib lisada väljatrükile sobivasse kohta, loomise näide: <code xsl><​a><​xsl:​attribute name="​href"><​xsl:​value-of select="/​documents/​document/​everypay_link"​ disable-output-escaping = "​yes"/></​xsl:​attribute>​MAKSA SIIN</​a></​code>​
 +
 +:!: Makselingi kaasa minevat tasuda summat saab seadistada süsteemi seadistusega ''​EveryPay LinkPay tasuda välja alus''​.
  
 :!: Vajadusel saab mitme lingi olemasolul luua eraldi loogika, mis valib mis iganes kriteeriumi põhjal sobiva (eeldefineeritud) lingi, mida konkreetsele väljatrükile luuakse. Seadistamiseks kirjuta palun [[info@directo.ee]] :!: Vajadusel saab mitme lingi olemasolul luua eraldi loogika, mis valib mis iganes kriteeriumi põhjal sobiva (eeldefineeritud) lingi, mida konkreetsele väljatrükile luuakse. Seadistamiseks kirjuta palun [[info@directo.ee]]
Rida 551: Rida 614:
 ====Summeerimine===== ====Summeerimine=====
  
-Univeraalne ​summeerimise funktsioon, parameetrid:​+Universaalne ​summeerimise funktsioon, parameetrid:​
   - sisend number mida lisatakse   - sisend number mida lisatakse
   - grupp (suvaline konteksti kirjeldav string, kui üks summimine siis võib olla näiteks summ)   - grupp (suvaline konteksti kirjeldav string, kui üks summimine siis võib olla näiteks summ)
Rida 558: Rida 621:
        * 1 - grupi summa        * 1 - grupi summa
        * 2 - tühjus        * 2 - tühjus
 +       * 3 - grupi summa ilma summat tühjendamata
    ​Väljund on string tüüpi, seega kui on vaja tulemusega arvutada, tuleb see numbriks konvertida enne. 1 ja 2 nullivad ka hetkel grupi.    ​Väljund on string tüüpi, seega kui on vaja tulemusega arvutada, tuleb see numbriks konvertida enne. 1 ja 2 nullivad ka hetkel grupi.
        
Rida 595: Rida 659:
  if( ret == 0 )  if( ret == 0 )
  rt = ''​+v;​  rt = ''​+v;​
- if( ret == 1 )+ if( ret == 1 || ret == 3 )
  rt = ''​+Number(sums[grp]);​  rt = ''​+Number(sums[grp]);​
  if( ret == 1 || ret == 2 )  if( ret == 1 || ret == 2 )
et/yld_print_form.1622110565.txt.gz · Viimati muutnud: 2021/05/27 13:16 persoon mer