E-mail - inrichten templates
Inhoudsopgave
Inleiding
Voordat via de mailwizard e-mails verzonden kunnen worden dient eerst minimaal één template gekoppeld te zijn aan Beeyond. Er zijn geen default templates aanwezig zodat men direct kan afdrukken via Beeyond. Rede hiervoor is dat iedere inrichting in Beeyond uniek is, en daarnaast heeft iedere klant zijn eigen wensen wat betreft hetgeen er afgedrukt moet worden.
Een mailactie wordt altijd vanuit een bepaalde entiteit gestart. Dat betekent dat de entiteit in feite al vast ligt en in de template zelf niet aangegeven hoeft te worden. Dit wordt dus bepaald door de entiteit waar het template in Beeyond gekoppeld wordt. In de template kunnen wel variabelen gedefinieerd worden. Een variabele is een gegeven dat uit Beeyond opgehaald dient te worden in de verzonden e-mail. Dit wordt in de volgende sectie besproken.
Een template kan het beste opgesteld worden door een voorbeeldbestand (verderop in deze pagina) te bewerken. De extensie van de templatebestanden is .vm. Dit is een Java gebaseerd template geschreven volgens de Velocity Template Language. Dit type bestand kan via een tekstprogramma, zoals notepad of notepad++ bewerkt worden.
Definiëren variabelen
In het template dient de gewenste e-mail opgesteld te worden. De volgende gegevens zijn daarnaast verplicht om in dit template vast te leggen:
Afzender e-mail adres: dit adres ziet de ontvanger in de mail staan.
Afzender naam: dit is de naam van de afzender, en is een vaste waarde in het template (bijvoorbeeld info@beeyond.nl).
Ontvanger e-mail adres: selecteer hier het attribuut waarin het mailadres van de ontvanger staat.
Ontvanger naam: dit is de naam van de ontvanger.
Onderwerp: onderwerp van de e-mail.
In het template kan dit er als volgt uitzien:
#set ($personal = "Beeyond Info") | Afzender benaming |
#set ($from = "info@beeyond.nl") | Afzender email adres |
#set ($nameto = $bel.get("|C_CONTACT_NAME|")) | Ontvanger benaming |
#set ($email = $bel.get("|C_CONTACT_EMAIL|")) | Ontvanger email adres |
#set ($subject = "Aanmelding klantenpas") | Onderwerp |
In dit voorbeeld worden de variabelen $personal, $from en $subject als vaste waarden gedefinieerd in het template en worden $nameto en $email opgehaald uit Beeyond. Het is echter ook mogelijk om de afzender benaming en afzender mailadres uit Beeyond op te halen via een variabele.
Daarnaast kunnen nog afhankelijk van attributen in Beeyond aparte mails verzonden worden via één template. Zo kan bijvoorbeeld afhankelijk van een 'Taal' attribuut de mail worden opgesteld in diverse talen, afhankelijk van de geselecteerde taal bij de betreffende contactpersoon. Een ander voorbeeld kan zijn dat afhankelijk van een statusveld in Beeyond (aangemeld, in behandeling, afgewezen) bepaalde mails verzonden worden. In de voorbeelden die verderop in deze pagina worden behandeld wordt uitgegaan van het 1e voorbeeld, dus afhankelijk van een taal wordt een mail in de gewenste taal verzenden naar de ontvanger. Ook het onderwerp van de e-mail kan bepaald worden op basis van bijvoorbeeld dit 'Taal' attribuut.
Opmaak
In het mailtemplate is het mogelijk om de tekst op te maken. De lettergrootte en het lettertype kan zo bijvoorbeeld bepaald worden. Daarbij kan gebruikt worden gemaakt van HTML code.
Onderstaande tabel geeft hier enkele voorbeelden van:
HTML code | Resultaat |
|---|---|
<i>Deze tekst is cursief</i> |  |
<u>Deze tekst is onderstreept</u> |  |
<b>Deze tekst is vetgedrukt</b> |
|
<font size="4" face="times new roman"> |
|
Voorbeelden
Onderstaand is een aantal voorbeelden uitgewerkt. Open het bestand om de voorbeelden te bekijken.
Toelichting | Bestand |
|---|---|
Het onderwerp en de inhoudt van de mail zijn vaste gegevens. | |
Afhankelijk van het attribuut 'Taal' wordt de inhoudt van de mail bepaald. Het onderwerp is een vast gegeven. | |
Afhankelijk van het attribuut 'Taal' wordt de inhoudt van de mail bepaald. Ook het onderwerp wordt bepaald op basis van de geselecteerde taal. Daarnaast wordt in de tekst een URL verwerkt waarop de ontvanger kan klikken. | |
Afhankelijk van een attribuut in Beeyond wordt het onderwerp van de mail bepaald. | |
Afhankelijk van diverse attributen in Beeyond wordt de inhoud van de mail bepaald. | |
Template bestand welke Opmaak voorbeelden bevatten. |
Opmerking
Indien diakritische tekens zoals bv "ë" als � in de mail komen te staan kan dit komen doordat het document in het "verkeerde" formaat is opgesteld.
Probeer in dit geval het document op te maken met de karakterset UTF-8.