sendEmail

Sends an email.

Syntax

Basic:

<syntaxhighlight lang="java" enclose="div">

Functions.sendEmail(String objectName, String recordId,

         String to, String cc, String subject, String body, 
         String attachmentTemplateIdList, String attachmentIdList);

</syntaxhighlight>

with Bcc:

<syntaxhighlight lang="java" enclose="div">

Functions.sendEmail(String objectName, String recordId,

         String to, String cc, String Bcc, String subject, String body, 
         String attachmentTemplateIdList, String attachmentIdList);

</syntaxhighlight>

with TenantContext:

<syntaxhighlight lang="java" enclose="div">

Functions.sendEmail(String objectName, String recordId,

         String to, String cc, String subject, String body, 
         String attachmentTemplateIdList, String attachmentIdList, 
         TenantContext context);

</syntaxhighlight>

Parameters

objectName

The name of the object the email relates to, or the objectId. This field is required, and must be a non-empty string.

recordId

The identifier of the record the message relates to. This field can be an empty string ("").

to

A list of comma-separated email addresses

cc

A list of comma separated email addresses

subject

A descriptive text string

body

The contents of the email message (static text).

attachmentTemplateIdList

A list of comma-separated Document Template identifiers. The template variables are evaluated at run time, their values are substituted, and the resulting documents are then sent as attachments.

Note:
Do not choose a template based on a JSP page for use as an attachment.
Learn more: JSP Attachment Deprecation

attachmentIdList

A list of comma-separated document identifiers to send as attachments

context

An optional TenantContext Object used to send an email using a user-alias in another tenancy.

Considerations

• You can use this method to send attachments with data from the record using one or more Document Templates.

• In order for the template variables to be populated, the document template ID passed to the API must be defined in the object that is specified in the first parameter - objectID

• Successful execution of the call adds an entry in the 'Activity History' section of the record that is specified in the second parameter - recordID.

• The values specified in the 'to' and 'cc' fields can be retrieved using requestParams object.

• Direct email addresses can also be passed as a string in the API parameters.

• In order to send email to multiple addresses with multiple attachments specify the various values in a comma-separated string.

Return

Result object

Example

This example calls sendMail for a contact.

<syntaxhighlight lang="java" enclose="div"> String contactID = ""; String attachmentIdList = ""; String attachmentTemplateIdList = ""; // Some code to populate contactID. // Some code to populate attachmentIdList. // Populate the attachmentTemplateIdList with template ID of the Document Template Result sendEmailResult = Functions.sendEmail("CONTACT", contactID, "joe.smith@acme.com,mark.smith@acme.com", "cc.smith@xyz.com", "Some subject", "Hello, This email was sent from the Java API", attachmentTemplateIdList, attachmentIdList); </syntaxhighlight>