Nastavenie užívateľskej e-mailovej šablóny
Funkciu užívateľských e-mailových šablón nájdeme v menu Nástroje - Užívateľské mailové šablóny.
Formulár obsahuje zoznam všetkých e-mailových šablón, ktoré môžete pripájať k typom dokladov (alebo aktualizácii miezd) a pri odoslaní sa doklad pošle s textom vybranej šablóny. Pokiaľ nevyberiete žiadnu šablónu, použije sa predvolený text. Užívateľské mailové šablóny sú dostupné iba pre licenciu Premium.
Aby sme mohli šablónu použiť, musíme si ju najprv vytvoriť práve v menu Nástroje - Užívateľské e-mailové šablóny. Tu klikneme na tlačidlo Nový a vyplníme ľubovoľnú Skratku a Názov šablóny. Pokiaľ potrebujeme vyplniť názov vo viacerých jazykoch, klikneme na tlačidlo + a vyplníme cudzí preklad.
Karta Šablóna
Základné informácie
Do prázdneho poľa Šablóna potom vyplníme požadovaný text. Aby sa nám údaje menili s každým dokladom, môžeme použiť tzv. Freemarker premenné. Tieto premenné sú šablónovacím jazykom Javy, v ktorej je program ABRA Flexi naprogramovaný. Bez týchto premenných sa preto pri definovaní užívateľských šablón nezaobídeme. Premenné sa uzatvárajú do zložených zátvork { } a na začiatok premennej vždy dávame ikonu $:
${application} - názov aplikácie, teda "ABRA Flexi"
${user} - objekt používateľa, s ktorým môžeme ďalej pracovať
${company} - Nastavenie firmy
- V e-mailových šablónach je teraz možné zobraziť akékoľvek pole z nastavenia firmy, popis nájdete na adrese: server/c/firma/nastaveni/properties
${uzivatelJmeno} - Vaše krstné meno
${uzivatelPrijmeni} - Vaše priezvisko
${titulJmenoPrijmeni} - Vaše celé meno vrátane dosiahnutých titulov
${nazevFirmy} - Názov firmy
${object} - všeobecný prístup na odovzdávaný objekt
${doklad} - doklad určený na odoslanie
Pokiaľ potrebujeme napr. telefónne číslo používateľa, ktorý e-mail odosiela, použijeme premennú $(user), ktorú upravíme na ${user.mobil}. Vždy vychádzame z premenných danej evidencie server/c/firma/evidence-list:
(Pokiaľ máme firmu Záhradníctvo a adresa nášho servera, kam sa bežne pripájame a kde máme aj zakúpenú licenciu je zahradnictvi.flexibee.eu, zadáme do prehliadača nasledovné: zahradnictví.flexibee.eu/c/zahradnictvi/evidence-list)
Pokiaľ potrebujeme evidenciu používateľ, je objektom vo freemarkeri "user". Príkladom je vyššie spomínaný mobil prihláseného používateľa: ${user.mobil}
Prípadne sa môžete pozrieť na všeobecné premenné na demoverzii, napr: https://demo.flexibee.eu/c/demo/faktura-vydana/properties
Premenné môžete skladať do seba, teda napr. pokiaľ potrebujeme splatnosť konkrétnej faktúry, použijeme premennú:
${doklad.datSplat}
Pokiaľ by sme chceli celkovú sumu na konkrétnej faktúre, použijeme premennú:
${doklad.sumCelkem} apod.
Pokiaľ chceme uviesť dátum napr. 1. upomienky, pozrieme sa do properties a zistíme, že premenná pre 1. upomienku je datUp1. Budeme teda postupovať rovnako ako vo vyššie uvedenom prípade a to ${doklad.datUp1}, pre 2. upomienku ${doklad.datUp2} či pre pokus o zmier ${doklad.datSmir}:
Namiesto premennej doklad môžeme tiež zvoliť pole object, teda ${object.datUp1}.
Použitie polí relačných evidencií
Obdobne ako pole objektu samotného, môžeme pracovať aj s objektmi v reláciách. Pre vydané faktúry napr. s jej položkami.
Pokiaľ chceme do vydanej faktúry dostať napr. výšku súm jednotlivých položiek, bude vyzerať zápis napríklad takto:
Dobrý den, zasíláme vám fakturu s položkami ve výši:<br/>
<br/>
<#list object.polozkyFaktury as x>
${x.sumZkl}<br/>
</#list>
Výsledok
Nižšie sa môžete pozrieť, ako by mohla vyzerať nastavená šablóna s použitím Freemarker premenných.
Tip pre zadávanie: Šablónu je možné zadať v HTML, môžete teda využiť základné značky tohto jazyka na formátovanie textu, napríklad zalomenie riadku <br/> , odstavce <p></p> a ďalšie.
Po odoslaní sa do premenných doplnia konkrétne hodnoty, e-mail teda bude vyzerať nasledovne:
Karta Použitie
Na karte použitia vyberieme, pre ktoré doklady budeme chcieť šablónu používať zaškrtnutím príznaku pri konkrétnom poli. Pokiaľ máme jednu šablónu pre všetky typy dokladu, stačí zaškrtnúť v nastavení šablóny evidenciu, pre ktorú platí a nie je nutné ju definovať na type dokladu.
Karta Texty
Polia na karte Texty sú iba informačné a slúžia na interný popis alebo poznámku k danej šablóne, napr. pre lepší prehľad alebo komunikáciu s tímom.
Karta Nastavenie
Na karte Nastavenie si zvolíme predmet e-mailu. Pole Odosielateľ bohužiaľ v súčasnosti nie je funkčné.
V predmete e-mailu môžeme tiež využívať Freemarker premenné.
Priradenie šablóny k typu dokladu
Teraz šablónu priradíme ku konkrétnemu typu dokladu. Typy dokladov nájdeme pri každej evidencii, napr. Predaj - Typy dokladov - Typy vydaných faktúr. Rozklikneme si príslušný typ dokladu a na záložke Texty na doklad vyberieme šablónu, ktorá sa má na všetkých faktúrach daného typu použiť.
Nastavená šablóna má vždy prednosť pred textom vyplneným v poli Text pre odosielanie dokladu…
Využitie e-mailových šablón v prípade zasielania výplatných pások nájdete tu: Zasielanie výplatných pások cez SMTP | ABRA Flexi (flexibee.eu)