Email Task Properties

Email Task

Property

UI Field Name

Description

Specifications

Required

Mutually Exclusive With

attachLocalFile

Attach Local File

Specification for whether or not a local file is attached.

Specification for whether or not a local file is attached.

N


bccRecipients

Bcc

Email address of the party being sent a blind (hidden) copy of the email, if any.

Use commas to separate multiple recipients. Variables and functions are supported.

N


body

Body

Text of the email message.

Variables and functions are supported. If both the email template and the email task contain text in the body, the text is appended.

N


ccRecipients

Cc

Email address of the party being sent a copy of the email, if any.

Use commas to separate multiple recipients. Variables and functions are supported.

N


connection

Email Connection

Name of an Email Connection.

An Email Connection specifies information about an email server. If you specify both an Email template and an Email connection, the Email connection overrides the Email Connection specified by the Email template.

Y
(unless an Email
template is specified)


localAttachmentsPath

Local Attachments Path

Location of Local Attachments for the connected Node.


N

localAttachment

Local Attachment

Name of the file(s) to attach.


N

replyTo

Reply-To

Email address of the sender.

Use commas to separate multiple recipients. Variables and functions are supported.

N


report

Report

Report to attach to this email; if reportVar is specified, report is ignored.

Reports do not have to be unique by Title. However, reports with the same Title must be unique per Visibility: per User, per Group, and per Everyone.
 
Therefore, when specifying a report reference, both the Title and Visibility must be specified.
 
To define a report reference for a report with Title XYZ that is visible to user john.doe, you would specify:

<report>
      <title>XYZ</title>
      <userName>john.doe</userName>
      <groupName />
</report>

 
To define a report reference for a report with Title XYZ that is visible to group Operators, you would specify:

<report>
      <title>XYZ</title>
      <userName />
      <groupName>Operators</groupName>
</report>

 
To define a report reference for a report with title XYZ that is visible to Everyone, you would specify:

<report>
      <title>XYZ</title>
      <groupName />
      <userName />
</report>

N

reportVar

reportVar

Report Variable

Name of a variable that will be resolved at run time to the name of the Report to use.


N

report

subject

Subject

Subject line of the email.

Variables and functions are supported.

N


template

Email Template

Name of an Email Template

An Email Template allows you to specify standard recipients and text for outgoing emails. Every Email Template specifies an Email connection. If you do not specify an Email template, you must specify an Email connection. If you specify both an Email template and an Email connection, the Email server specified by the Email connection overrides the Email server specified in the Email template. (Any information specified in an Email task overrides what is specified in an Email Template.)

N


templateVar

Email Template Variable

Name of a variable that will be resolved at run time to the name of an Email Template to use.

Format: ${variable name}.

N


toRecipients

To

Email address of the recipient.

Use commas to separate multiple recipients. Variables and functions are supported.

N