Sends a specified e-mail message to the visitors who have reached this point in the scenario. (See also the EmailNotify action.)

Examples:

Send e-mail with path My Web App:/en/email/ordershipped.jsp
Send e-mail with path My Web App:/en/email/welcome.jsp with Site
Gourmet Sausages
Logs In with Site Gourmet Sausages > Send Send e-mail with path
My Web App:/en/email/welcomeback.jsp with Site Event's Site

Note that the site can be set by the preceding event, as shown in the last example above.

Action Registry Tag

Value

action name

sendEmail

configuration component

/atg/scenario/configuration/SendEmailConfiguration

action execution policy

individual

action error response

delete

The SendEmail action has the following parameters:

Parameter

Required

Description

template

no

The path of the template to send. Corresponds to the ACC option Send email with Dynamo path…

Users specify the fully qualified path of the e-mail template to send. If the document is outside the Dynamo document root because it is part of a non-DAS J2EE application, they must specify the application context root manually.

This parameter reflects the way that users specified document paths in versions of ATG products before 6.0.0 and exists mostly for compatibility with those versions.

scenarioPathInfo

no

The path of the template to send. Corresponds to the ACC option Send email with path….

Users specify the path of the e-mail template to send by selecting the template in a document picker dialog box. The path is automatically prepended with either the application context root (if the template is part of a J2EE application) or a flag indicating that the template is located in the Dynamo document root.

ignoringContactFatigue

no

Allows you to override any daysContactFatigue or hoursContactFatigue settings in the TemplateEmailSender. These settings are used to prevent overexposure to mailings, but they can be overridden for important messages. See Avoiding E-Mail Fatigue.

site

no

(Multisite environments) The Web site to use as the context for the template. Corresponds to the ACC option Send email with path … with site…

SendEmail Configuration Component

The following example shows the default properties file for the SendEmailConfiguration component, which you use to define various settings for the SendEmail action.

# Version: $Change: 244651 $$DateTime: 2002/06/24 09:19:29 $
$class=atg.scenario.action.SendEmailConfiguration

defaultEmailInfo=/atg/scenario/DefaultTemplateEmailInfo
individualEmailSender=/atg/scenario/IndividualEmailSender
collectiveEmailSender=/atg/scenario/CollectiveEmailSender
webAppRegistry=/atg/registry/WebApplicationRegistry

These properties are described below.

Property

Description

defaultEmailInfo

The TemplateEmailInfo object that supplies the default information for all emails sent out by this action.

individualEmailSender

The TemplateEmailSender component used to send email in an individual context.

collectiveEmailSender

The TemplateEmailSender component used to send email in a collective context.

webAppRegistry

The registry of all Web applications that are on the J2EE server where Dynamo is running.

For information on configuring the TemplateEmailSender components for use with the SendEmail action, refer to Setting Up Scenario E-mail Sender Components.

Identifying Mailings Sent by a Single SendEmail Action

The batch_exec_id entry in the dps_mailing table contains a unique ID that corresponds to the SendEmail action responsible for initiating the mailing. You can use the batch_exec_id to group all mailings sent by the same SendEmail action, allowing you to identify them easily through the View Grouped display in the ATG Dynamo Server Admin Component Browser.