Overview

Email Templates pickup values from the system using merge codes also known as Symbols - here is an example

See Also Correspondence explained

Table of Contents

Used when setting up email Templates in your system - see also Correspondence Management

An email may be sent:

1. On a system event with no user input
   1. For example a sales order is dispatched or a booking is confirmed
   2. Ask us if you want a new event to trigger an email.
2. When a user selects from a menu
   1. Example on an invoice - Action - email invoice
3. Manually
   1. example from the Correspondence Tab - send email

How does the system know which email template is appropriate

The system finds the appropriate email template/s by looking at Email Template Workflow Information

When a sales order is picked:

• If the Debtor form, Extended Attributes, Invoicing Rules, Auto Email Invoice is ticked
• If there is an email template with System Usage: Credit Note, Usage Context: Sales and Recipients Role: Customer
• The customer has at least 1 accounts email address

then an email with the invoice will be sent.

When a new debtor credit note is saved for the first time:

• If the value > $1
• If the Debtor form, Extended Attributes, Invoicing Rules, Auto Email Invoice is ticked
• If there is an email template with System Usage: Order/Booking Invoice, Usage Context: Debtor and Recipients Role: Customer
• The customer has at least 1 accounts email address

then an email with the credit note will be sent.

Auto-email invoices is on the Debtor

Note this can be setup to run by default on the Debtor

How to set Auto Email Invoice is ticked by default for new customers (on host company)

Note - it might not be ticked for all customers - but will for all new customers added.

Accounts email addresses include:

• Company or Person Contact with a key of Accounts payable email
• Debtor Contact with a role of Accounts
• Debtor Email address if none of the above
• Company or Person Email address if none of the above

System Usage - indicates the situation that would call for this template

• Any time an email is to be sent - the system looks for the correct email to send.  So you need to first identify how the system identifies which email to send
• This might be in the wiki for the application area that is using the email template or might be obvious. If not, ask us.
• Use "Manual" if you would like this template available anytime a manual email is to be sent

Usage Context - indicates the document this template will be used by

Recipients Role

Used by the system when multiple templates are sent to different roles on the same trigger.

Note - an email template may be linked using Symbols Config in rare cases

From Email Address

The from email address may be entered directly into the email template.

Franchise Groups From Email Address

When franchise groups are using email templates - and they would like to be able to define the from address in each franchisee then use a symbol (seen below in the from box):

Display as below is explained in the useful special codes section

Note that the from email address is stored as a Symbol

Editing the Text

The text editor allows the building up of an email template easily

1. Body of the email
   1. Text Tab

      1. If you would like to send text only emails then enter the body text of the email here. This text will only be used in the email if there is no HTML text.  

      2. The text can include symbols that will be replaced with data from the entity associated with the email.

      3. Text tab is used for sms

   2. HTML Tab

      1. This is where you will normally enter the body text of the email. 

      2. The editor for this field has limited formatting ability. If you require more formatting than offered by the editor then you can edit the text in an external html editor and then paste the result here. 

      3. Alternatively, you can edit the html code by using the button at the right of the editor tool bar.

      4. The HTML text can include symbols that will be replaced with data from the entity associated with the email (see Symbol Substitution below).

   3. Syncronise Text with HTML checkbox
      1. If this is ticked then the text portion of the HTML tab, without the HTML tags, will be copied to the Text tab.
2. Apply Standard Footer
   1. If this is ticked then the Host Company standard footer will be appended to the body text of the email (Administration menu, Host Company (your business/s), select the relevant host company, Web Customisation tab).
   2. Note: Symbol substitution cannot be used in the standard footer, except that [msg.FromDisplay] will be replaced with the 'Display as' name.

Testing the email

Email test view is available on the test tab

Or can send test to self on the bottom of the screen (will use test id /search code to identify the record to use for the merge).

Standard Footer on Host Company

Standard footer can display images from the host company imbedded in the email (rather than a link to a url)

Displaying Images

Images that are on a public website can be imbedded in the email template.  

This is a great way to have your logo displayed - simply imbed the url and the image will display

The imbed an image window will display

If you put a link in then your customers can click on the link and go directly to the url you have entered.

Alt-text is the text they will read if they hover their mouse over the image

Refresh next to the URL to view the image

Imbedding Images - for html savvy users - requires knowledge of html

An imbedded image is sent with the email (instead of simply being a link).  There are reasons people do this - but it is a little more complicated.

1. Upload the image into our system
2. Give it a Code
3. Imbed the following in your html where you want the image to be placed (where Code is replaced with the Code you entered).
   1. <IMG src="cid:Code"/>

Do you know HTML?

If you do - you can write the email directly in html - toggle the window using the symbol

The text editor is a display of html.   The toolbar actually is creating html when you add a table etc

So if you imbed a table like this

the html looks like this - standard html.

Merging information from the system into your template

Use labels you see on the screen

You can imbed the labels used for a particular record into your email template.  This is especially useful if the labels on the screen change depending on information in the booking.

How to find the names of the field to use and the related label

Use square brackets with the field name - followed by the @ label symbol 

For example [FlightTime@Label]

Setting up a new template

Example - Setting up a template for order confirmation

For this example - I will assume that an email is required to be sent on Sales Order Confirmation.

Get a list of the merge fields in this situation - with example values from an existing Sales Order.

Retrieve a sales order in the system - Open the sales order list and find a suitable sales order example

Use the sales order number to view the symbols you can use.

Or using the ID - Find the ID of this order (ActivityPersistentId) as per below 

This is done by reviewing the xml that was returned by the server when the sales order was found 

Enter the ID into the Test ID Field - then review the symbols to see what you would have got

Now build your email (on the General Tab) using the merge codes in the Header line, the body of the email etc.

Here is an example built from a Booking

Send a test to yourself anytime using the test booking number on the test tab.

Or build the SMS you would like to send

Cloning an Email Template

To create a new email template similar to an existing one:

1. Display the existing template.
2. Edit - Copy for Pasting Duplicating
3. Clear the form
4. Edit - Paste
5. Enter the new Search Code to create a unique template
6. Make whatever other changes are required for the new template.
7. Click Save F4.

Testing an Email Template

1. Select the template to be tested
2. Go to the Test tab
3. Select the activity that the Email Template will be associated with
4. Enter a valid transaction number (in the test search) or the ID for an existing transaction
5. Depending on the type of test that you want to do:
   1. Click the 'Text' button. If your template has Text the Subject and Body will be displayed after symbol replacement.
   2. Click the 'HTML' button. The Subject and Body will be displayed after symbol replacement, however HTML markup will also be displayed without interpretation.
   3. Click the 'Send Test to Self' button at the bottom of the form. This will send the generated email to your Employee email address using the ID

Franchise Networks

Franchisors can create email templates that are visible and used by the Franchisee.

Manual templates will all be listed (Franchisee + Franchisor Shared templates)

Automated emails - Will check the franchisee and if not found will use Franchisor template.

Franchisee's can see and test these templates - but not edit and save changes.

Workflow templates can have footers with information from the host company they are sent from (eg franchisee name, address, bank details etc)

Franchisees can easily create a variation

It is common that a franchisees want to create a minor variation to the franchisor email template

1. Edit > Make an inplace copy / duplicate
2. Give the copy a search code > save

Now you have a copy of the franchisor template in the franchisee and this can be modified. 

Examples

Using text editor

html view

view of html

If you define your email in a html editor and then export the html you can load it up into the system

Email Templates usages

Email templates can be setup for different usages / context / recipient roles - example order confirmation.

The same configuration may trigger a different template depending on the tag used.  For example below email confirmations uses a different template depending on the tag trigged by the situation.  Where you want to have different email templates triggered in the same situation based on rules in the system - talk to us and we will setup a new tag