AgileApps Support Wiki Pre Release

Difference between revisions of "Email Templates"

From AgileApps Support Wiki
imported>Aeric
imported>Aeric
Line 1: Line 1:
'''[[File:GearIcon.png]] > Customize > Email Templates'''
'''Designer > -TBD- > Email Templates'''


==About Email Templates==
==About Email Templates==
''Email templates'' are used to carry on case-related communications. The ''variables'' they contain are replaced with case-specific data, to create a customized message. A large collection of templates have been predefined for use in a variety of circumstances. For example, one template is used to tell a customer that a new case has been created for an issue they reported, while another tells them when a Note has been added to their case. Β 
''Email templates'' are used to create an email-based conversation centered on a specific object record. The ''variables'' they contain are replaced with record data, to create a customized message. Β 


You can create new templates, and modify the ones that already exist.
You can create new templates, and modify the ones that already exist.
Line 9: Line 9:


===Creating or Editing an Email Template===
===Creating or Editing an Email Template===
# Go to '''[[File:GearIcon.png]] > Customize > Email Templates'''
# Click '''[New Email Template]''' or select an existing template
# Click '''[New Email Template]''' or select an existing template
# Fill in the information below
# Create the template content, use the Template Variable tool at the top of the page to insert placeholders into the template.
# Click '''[Save]'''
# Click '''[Save]'''


{{Tip|The easiest way to create your own template is to start by copying one that is close to what you want. That way, many of the variables you need are already in the template body.}}
{{Tip|The easiest way to create your own template is to start by copying one that is close to what you want. That way, many of the variables you need are already in the template body.}}


====Available Template Fields====
====Choosing Template Variables====
This section contains the ''Template Variable Tool''. It gives you variables to use in the template. Β 
The section at the top of the page gives you variables you can use in the template. The list may varies, depending on the type of template you're creating. Here are some of the standard categories:


The list varies, depending on the type of template you're creating:
:{| border="1" cellpadding="5" cellspacing="1"
:{| border="1" cellpadding="5" cellspacing="1"
| valign="top"Β  colspan="2" | '''Case Templates'''
| valign="top"Β  colspan="2" | '''Case Templates'''
|-
|-
| width="20px" |   ||
| width="20px" |   ||
* '''Case Fields -''' Fields containing case-specific information.
* '''User Fields -''' Fields pertaining to the current logged in user.
* '''User Fields -''' Fields pertaining to the current logged in user.
* '''Company Fields -''' Data from the [[Company Information]] settings
* '''Company Fields -''' Data from the [[Company Information]] settings
* '''Custom Variables -''' Special variables that are available to all templates. you can add to and modify, as needed.<br>(Some, like "Support Team Name", were created when ServiceDesk was installed.)
* '''Custom Variables -''' Special variables that are available to all templates. you can add to and modify, as needed.
* '''Current Note -''' Fields from the last note added to the case<br><hr style="height:4px; color:purple; background-color:purple; width:50%;">
::(Items below the line are loop variables that come from [[Related Records]]--records in other objects that are connected to the current case by a [[Lookup]] field.)
* '''Previous Notes -''' Fields from the list of notes that were added previously
{{Note|<br>Previous Notes variables are used in a Velocity template-language loop like this:
:Β  <tt>#foreach($item in </tt>'''$__previous_notes__'''<tt>)</tt><br>&nbsp; &nbsp;<tt>...$item.</tt>'''description'''<tt>...</tt><br><tt>#end</tt>}}
Β 
|-
| valign="top"Β  colspan="2" | '''Service Portal Invitations'''
|-
| &nbsp; ||
* '''User Fields -''' Fields pertaining to the current logged in user.
* '''Company Fields -''' Data from the [[Company Information]] settings
* '''Custom Variables -''' Special variables available to all templates that you can add to and modify, as needed.
Β 
|-
| valign="top" colspan="2" | '''SLA Notifications'''
|-
| &nbsp; ||
* '''Case Fields -''' Fields containing case-specific information.
* '''Task Fields -''' Fields pertaining to the Task associated with this [[Service Level Agreement]].<br>(A ''Task'' specifies the action that needs to be performed, and the deadline for it to occur.)
* '''Company Fields -''' Data from the [[Company Information]] settings
* '''Custom Variables -''' Special variables available to all templates that you can add to and modify, as needed.
Β 
|}
|}
'''To get a template variable:'''
'''To get a template variable:'''
Line 59: Line 33:
#: (For example, <tt>From Name:</tt>, <tt>From Email Address:</tt>, <tt>Subject:</tt>, or <tt>Message:</tt>.)
#: (For example, <tt>From Name:</tt>, <tt>From Email Address:</tt>, <tt>Subject:</tt>, or <tt>Message:</tt>.)


====Basic Information====
====Specifying Template Content====
;Basic Information:
:* '''Template Name -''' The name that appears in the list of templates.
:* '''Template Name -''' The name that appears in the list of templates.
:* '''Type -''' Specify the type of template, which determines where it can be used and which template variables are available.
:* '''Type -''' Specify the type of template, which determines where it can be used and which template variables are available.
Line 75: Line 50:
{{Tip|Most templates are set up to use the [[Email to Case]] mailbox as the "From" address. That way, replies to each message are automatically recorded as part of the Case.}}
{{Tip|Most templates are set up to use the [[Email to Case]] mailbox as the "From" address. That way, replies to each message are automatically recorded as part of the Case.}}


====Attachments====
;Attachments:
Choose one or more of the [[Document Templates]] you've created to encapsulate Case data. The document is generated from the data and attached to the message.
Choose one or more of the [[Document Templates]] you've created to encapsulate Case data. The document is generated from the data and attached to the message.

Revision as of 00:56, 22 March 2013

Designer > -TBD- > Email Templates

About Email Templates

Email templates are used to create an email-based conversation centered on a specific object record. The variables they contain are replaced with record data, to create a customized message.

You can create new templates, and modify the ones that already exist.

Working with Email Templates

Creating or Editing an Email Template

  1. Click [New Email Template] or select an existing template
  2. Create the template content, use the Template Variable tool at the top of the page to insert placeholders into the template.
  3. Click [Save]

Thumbsup.gif

Tip: The easiest way to create your own template is to start by copying one that is close to what you want. That way, many of the variables you need are already in the template body.

Choosing Template Variables

The section at the top of the page gives you variables you can use in the template. The list may varies, depending on the type of template you're creating. Here are some of the standard categories:

Case Templates
 
  • User Fields - Fields pertaining to the current logged in user.
  • Company Fields - Data from the Company Information settings
  • Custom Variables - Special variables that are available to all templates. you can add to and modify, as needed.

To get a template variable:

  1. Under Category select the kind of field you want to access.
    (The list varies, depending on the type of template.)
  2. Select the field you want.
    Otherwise, the template variable appears.
  3. Copy the name that appears in the Variable field, and paste it into one of the template fields.
    (For example, From Name:, From Email Address:, Subject:, or Message:.)

Specifying Template Content

Basic Information
  • Template Name - The name that appears in the list of templates.
  • Type - Specify the type of template, which determines where it can be used and which template variables are available.
  • Case Response - The template is used to notify the end user when a Case Worker has added a comment to a Case, or to send and automatic response when the end user has corresponded via Email to Case or Web to Case.
  • Service Portal Invitation Template - The template will be sent to a customer to invite them to the Service Portal.
  • SLA Notification Template - The template is used to send reminders and (re-)assignment announcements, as part of SLA processes.
  • From Name - The name that indicates the person or department the email came from. For example, "Company Support".
  • From Address - The email address that end-user replies will go to. (See the note below)
  • Subject - Subject for the message.
  • Message - Choose how you want to compose the message:
  • Use the WYSIWYG HTML Editor
  • Paste HTML code written in an external editor into the RAW HTML window
  • Write a Plain Text message

Thumbsup.gif

Tip: Most templates are set up to use the Email to Case mailbox as the "From" address. That way, replies to each message are automatically recorded as part of the Case.

Attachments

Choose one or more of the Document Templates you've created to encapsulate Case data. The document is generated from the data and attached to the message.