Customizing an email template

You can you can clone and customize the out-of-box email templates to include information that is specific to your business requirements. For more information, refer the following topics:

Out-of-box email templates

BMC Remedyforce provides out-of-the-box email templates that are available in your organization at Remedyforce Administration > Configure Email > Email Templates. You can clone and customize these email templates to suit your business requirements.

The following table lists the objects and their out-of-box templates.

BMC recommends that you first clone and then edit the out-of-the-box email templates. If you receive an error message when cloning a BMC Remedyforce out-of-the-box email template, see Resolving an error with cloning a BMC Remedyforce email template.

You can customize the fields that are used in the templates to display the information of your choice in the email message. You can include the fields that are available for the objects. Select the object in the Related to Type field while creating an email template. For more information, see Creating an email template. Use the API Names field to obtain the values of these fields in the email templates. To see a list of fields available for an object, navigate to Setup > Create > Objects or Remedyforce Administration > Manage Objects > Create and Edit Objects. The list of fields that you can use in an email template is displayed in the Custom Fields & Relationships section.

Including additional information after selecting an email template

Staff members can add additional information while composing an email for a selected email template. To support inclusion of additional information, you must perform the following actions:

• On the Remedyforce Administration > Configure Email > Email Conversation Settings page, select the Allow staff members to add additional information in the email sent using templates check box.

• Include the Additional_email_information field in the email templates using the following syntax.

  {!relatedto.BMCServiceDesk__Additional_email_information__c}

When you include the Additional_email_information field in the email templates, additional content added by a staff member is also saved along with the content from the email template. The following image shows the content of the email template and additional content that is saved after including this field. 

Viewing emails

Users can access the saved email message from the Action History section of a record. In the Action History section, a link is provided to a record created in the <Record> History object (replace Record with Incident, Change Request, Problem, or Task).

The saved email message is shown in the Note field.

 Note the following points about how information is displayed in Notes:

• All URLs are displayed as links.
• Image link is not displayed.
• Text formatting (such as bold and italics) is not retained.

To show image from image links and text formatting, add the RichTextNote field to the page layout of the <Record> History object.

Viewing fields of a related object

To refer to the fields of a related object for which a lookup or Master Detail data type exists in an object, use the following syntax.

{relatedto.<namespace of organization><Field Name of the 
lookup field>__r.<API Name of the field of the related object>}

The following table provides examples of the syntax that you can use for different objects.

To add the logo and signature to an email template

You can customize an email template by adding your company logo and signature to it.

1. Navigate to Setup > Email > My Templates.
   If you have enabled the improved Setup user interface in your Salesforce organization, navigate to My Settings > Email > Email Templates. For more information about the improved Setup user interface, see the Salesforce Help.
2. In the Email Template Name column, click the template to which you want to add the logo and email signature.
3. Click the appropriate option for the type of template:
   • Visualforce template: Click Edit Template.
   • Custom or HTML template: Click Edit HTML version.

4. Add the URL of the image by using the appropriate HTML tags.
   For example, if you are adding an image named companylogo.gif, you must add the following code:
   <a href="company URL"> <img border="0" src="companylogo.gif" width="250" height="42" alt="company name"></img></a><br/><br/>

   In this example, you would replace company URL, companylogo.gif, and company name with your company URL, path to the image file, and your company name.
   You can replace the image link with an externally hosted image link or the link that you received when you upload a document to Salesforce. For more information about how to upload a logo image as a document in Salesforce, see To upload an image as a document in Salesforce.

5. Add the HTML content of the signature at the bottom of the email template content. For example:

   <div align="left">
   <table border="0" cellpadding="4" cellspacing="0" width="500" id="table3">
   <tr>
   <td width="250">
   <b>{!$User.FirstName} {!$User.LastName}</b>
   <br/>{!$User.Title}
   <br/>BMC Software
   <br/>phone: {!$User.Phone}
   <br/>fax: {!$User.Fax}
   </td>
   </tr>
   </table>
   </div>

   In this example, the User.FirstName, User.LastName, User.Title, User.Phone, User.Fax fields are related to the logged on user and are populated by Salesforce while sending the email message.

   You can modify the alignment, size, position of the text, font, images as required.

To upload an image as a document in Salesforce

1. Click the Documentstab.

   Note

   If the Documents tab is not visible, click the All Tabs tab (the plus icon) and click Documents.

2. In the Recent Documents section, click New.
3. In the 1. Enter details section, in the Document Name field, type a document name.
   The Document Unique Name field is populated with the value from the Document Name field, and the spaces in the Document Name field are replaced by underscores. If you want to use the file name, leave Document Name field blank. The file name appears automatically when you upload the file.
4. To make this image available in HTML email templates without requiring a Salesforce.com user name and password, select the Externally Available Image check box.
5. From the Folder list, select a folder.
6. (Optional) In the Description field, type a description of the image.
7. (Optional) In the Keywords field, type the keywords, that can be used as search criteria.
8. To browse to the location where the image that you want to upload is located, in the 2. Select the File section, click Browse.
9. Select the required image and click Open.
10. Click Save.
11. Right-click the image and click Copy Image URL or Copy Link Location depending on the type of browser.
    This URL is the unique image ID of the uploaded document. This URL is used to embed the image in the email template. For example, https://c.ap1.content.force.com/servlet/servlet.ImageServer?id=015900000019GMA&oid=00D90000000kimY&lastMod=1364543146000

Resolving an error with cloning a BMC Remedyforce email template

When cloning a BMC Remedyforce out-of-the-box email template, you might receive the following error message:

Error: Invalid Data.
Review all error messages below to correct your data.
Component c:srminputdisplay does not exist (Related field: Markup)

To resolve this issue, edit the BMC Remedyforce email template and replace "c:" in the following string with "BMCServiceDesk:"

Original string:

<c:SRMInputDisplay RequestNumber="{!relatedto.BMCServiceDesk__FKRequestDetail__c}" />

Modified string:

<BMCServiceDesk:SRMInputDisplay RequestNumber="{!relatedto.BMCServiceDesk__FKRequestDetail__c}" />

After saving the modifications, you can clone the BMC Remedyforce email template. For information about cloning an email template, see the Salesforce Help .

The email listener searches for the Ref:# keyword in the subject or body of the email message and interprets the message by considering the following points:

• If the keyword is same or different in the subject and body of the email message, the information provided in the subject of the email message is used.
• If the keyword is present only in the subject or body of the email message, the information provided in the subject or body of the email message is used.

For more information about configuring your Email server, see the documentation of your Email server.

Related topic

Searching for matching incidents