Sending Email Using Scripts or Hooks

If you’re creating a pipeline, the preferred method of sending an email is to use the SendMail pipelet. However, to create an OC API hook to send email or send email from inside a script, use the dw.net.mail class to construct an email and send it. Use dw.net.mail with the new dw.util.Template class to construct an email using an ISML template.

Differences Between Sending Email Via dw.net.Mail and the SendMail Pipelet

With dw.net.Mail you must set the subject, mail body, and the to, cc, or bcc. If you don’t, the invocation of mail.send() fails with an IllegalArgumentException.
Any tags provided in a template for to, from, subject, or other fields are ignored and not used. Only the values provided by the dw.net.Mail.set* arguments are used to generate an email.
Although a variable called pdict is accessible from within the ISML template, it isn’t the Pipeline Dictionary. Pipeline Dictionary default data, such as Session, isn’t accessible.
The Mail.send() returns the OK status if the email is successfully queued to the internal mailing queue, or ERROR if the email couldn’t be queued. The email itself is placed on the mail queue asynchronously, meaning that it isn’t sent if there’s a problem with the mail server.

Creating Mail with Plain String Content

The following script uses the dw.net.Mail setter methods to create an email using only simple strings.

1importPackage( dw.net );
2importPackage( dw.system );
3
4function sendMail() {
5
6     var mail: Mail = new dw.net.Mail();
7     mail.addTo("to@example.org");
8     mail.setFrom("from@example.org");
9     mail.setSubject("Example Email");
10     // sets the content of the mail as plain string
11     mail.setContent("plain string");
12     mail.send();
13}

Creating Mail with Static Content and Header Information

The following script uses the dw.net.Mail setter methods to create an email with an HTML body and header information.

1importPackage( dw.net );
2importPackage( dw.system );
3
4function sendMail() {
5
6     var mail: Mail = new dw.net.Mail();
7     mail.addTo("to@example.org");
8     mail.setFrom("from@example.org");
9     mail.setSubject("Example Email");
10     // sets the content of the mail as plain string
11     mail.setContent(“
12         <html>
13         <head><title>Welcome</title></head>
14         <body><b>Thank you</b> for registering at our shop!</body>
15         </html>”,“text/html”,“UTF-8”);
16
17     mail.send();
18}

Creating Mail Based on a Template

The following script uses the dw.net.Mail setter methods to create an email and send it to the internal mail queue.

Because mail can be sent outside the scope of a Pipeline Dictionary, we can’t rely on using Pipeline Dictionary access. Although the pdict variable is still available, it isn’t the Pipeline Dictionary. All data within a Pipeline Dictionary is only available if it’s within the parameter map at rendering time.

Template

A simple template with some customized content for a specific user.

Access parameters created in the parameter map in the script through <isprint value="${param.parameter}">, as this name reflects the type of object one is working with.

1<iscontent type="text/html" charset="UTF-8">
2
3<html>
4<head><title>${Resource.msg('user.passwordemail.001','user',null)}</title></head>
5<body>
6 <div style="font-family: Verdana, Geneva, Arial, Helvetica, sans-serif; font-size: x-small; color: Black;">
7 ${Resource.msg('user.passwordemail.002','user',null)}&nbsp;<isprint value="${param.customer}">&nbsp;${Resource.msg('global.symbol.comma','global',null)}
8 <br/><br/>
9 ${Resource.msg('user.passwordemail.004','user',null)}&nbsp;<isprint value="${pdict.resetPassword}">${Resource.msg('global.symbol.period','global',null)}
10 <br/>
11 ${Resource.msg('user.passwordemail.006','user',null)} <a href="${URLUtils.https(false, 'Login-Show')}">${Resource.msg('user.passwordemail.007','user',null)}</a> ${Resource.msg('user.passwordemail.008','user',null)}
12 <br />
13 ${Resource.msg('user.passwordemail.009','user',null)}
14 <br /><br />
15 &nbsp;
16 </div>
17</body>
18</html>

Salesforce B2C Commerce Script

This script:

Creates a parameter map, which holds all parameters required to render the template.
Specifies and renders a template with the given parameter map
Creates a mail object and a mail body, using the MIME encoded text generated by rendering the template in the previous step.

1importPackage( dw.net );
2importPackage( dw.value );
3importPackage( dw.util );
4importPackage( dw.system );
5
6function sendMail() {
7     var template: Template = new dw.util.Template(“myTemplate.isml”);
8
9     var o: Map = new dw.util.HashMap();
10     o.put("customer","User");
11     o.put("resetPassword","reset");
12
13     var text: MimeEncodedText = template.render(o);
14
15     var mail: Mail = new dw.net.Mail();
16     mail.addTo("to@example.org");
17     mail.setFrom("from@example.org");
18     mail.setSubject("Example Email");
19     mail.setContent(text);
20     mail.send();
21
22}