Versions Compared

Old Version 41

changes.mady.by.user P Sawkins (Unlicensed)

Saved on

compared with

New Version Current

changes.mady.by.user Paul Sawkins

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

OverviewEmail Templates pickup values from the system using merge codes also known as Symbols - Overview

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

See Also Correspondence explained

...

  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

BCC email addresses are setup on host compant Host Company (your business/s)#Emailbcc-allemailssentfromthesystemwillbcctothisaccount

How does the system know which email template is appropriate

...

Note

If the company is a franchisee - the franchisor emails that have been shared are available. Automation checks for a result in the franchisee and if none found then looks in the franchisor.checks for a result in the franchisee and if none found then looks in the franchisor.

Sending an Employee a new password

Note - no template is required - if one does not exist a simple email is sent with the password to the employee.

To define a template = Template settings : usage “reminder” context “authentication” role “employee”

When a sales order is picked:

...

Note
titleUseful special codes

Useful special codes

"Attention Company Name" or "Hi Fname Lname"

When the system is sending to a Creditor or Debtor it could be a company or a person. [Visitor.EmailSalutation] results in

  1. For a company = "Attention - Company name" or "Attention - Contact Name"
  2. For a person = "Hi FirstName" (note that the Hi can be changed to Dear or another salutation )

Time Fields - Time@AMPM etc

When using any time field - example [Time] - you can specify the property of the result as follows

  1. [Time@TimeAMPM] - will result in am or pm
  2. [Time@Time24] - will result in a 24 hour time
  3. [Today@LongDate] - will result in day of week, month, day, year = Tues 15th February 2016
  4. [fieldname@property] Finds a Field called "Fieldname" and then a property such as Time24, DayOfWeek etc within that field - example "InspectionTime@time24 = 13:02
    1. Properties:, dayofweek, time, time24

Day of week from Date - Date@DayOfWeek, Today etc

To get day of the week for any date add @DayOfWeek - [OrderDate] becomes [OrderDate@DayOfWeek] and the result will be "Thursday"

Day of week - when using a date that you want a day of week - eg [EventDate] 

  1. [EventDate@DayOfWeek] - will show day of the week.  
  2. Ie: [EventDate@DayOfWeek], [EventDate] will render - Tuesday, 17/05/2016

Tags that do not need a field

  1. [ Today] will return todays date and so will [ Now ]
  2. [ Today+1 ] will give tomorrow - etc using +number of days or - number of days

Sending User (person who sent the email) - "$"

For current user (all details) - list of fields - identified as $

  1. - ie [ $ChildEntity.FirstName ] - child entity = child of employee currently logged in - ie the person
  2. ie Host Company of Employee = [ $ParentEntity.Name ] = as host company is the parent of the employee

Global symbols that can be used anywhere regardless of what is being sent - "="

[=symbol] will look for a configuration entry with ‘symbol’ (Admin>config>Symbols config) Users can invent symbols and maintain them. They are per host company - however if a franchisee does not have a value the franchisor symbol will be found.

Image Removed

Example of use

Image Removed

We can add symbols you require:

[#symbol]

will look for a Session Temp Value (requires programming)

[property]

assuming no Field is found with name property, will try to reflect that property from the business object (a standard c# property)

example - Tour Booking has a link to a tour definition - which has a disclaimer. Tour booking has a property called "disclaimer"
  1. ie the person
  2. ie Host Company of Employee = [ $ParentEntity.Name ] = as host company is the parent of the employee

Global symbols that can be used anywhere regardless of what is being sent - "="

[=symbol] will look for a configuration entry with ‘symbol’ (Admin>config>Symbols config) Users can invent symbols and maintain them. They are per host company - however if a franchisee does not have a value the franchisor symbol will be found.

Image Added

Example of use

Image Added

We can add symbols you require:

[#symbol]

will look for a Session Temp Value (requires programming) - a value that is related to your current login

[property]

assuming no Field is found with name property, will try to reflect that property from the business object (a standard c# property)

examples

Tour Disclaimer

Tour Booking has a link to a tour definition - which has a disclaimer. Tour booking has a property called "disclaimer"

Tour Season

Tour Booking has a link to Season which has a text field. Use '[SeasonalMessage]' to include this message in an email linked to a Tour Booking

Here is the seasonal configuration ( Admin > General > Seasons ) and how to use it. Note that seasonal dates cannot overlap. To change a message - delete it and create a new one

Image Added

Lookups using $symbol

[$symbol]

will look at the HostActivity for symbol.  Useful if you want emails to come from the logged in user.

Complex Query Results

Complex Queries can be the result of a single symbol

  • an example of a complex query result is [InspectorOverview] when used with ERP.PropertyInspection - provides a list with details for an inspector of their inspections for the week.

...


  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.

...

  1. Upload the image into our system
  2. Give it a CodeCopy 
  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:CodeURL"/>

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

...