Jump to: navigation, search

SendEmail (Activity)


The SendEmail Activity sends an Email via SMTP, using a server it connects to. It also supports attachments, HTML bodies and Email templates.

[edit]

Description

Send Email
Name SendEmail
Purpose Send an Email via SMTP
Category ControlFlow
Returns True if successful
Version 2.1.15+

Arguments

Argument Type Direction Purpose
Attachments Collection<Attachment> In A list of attachments
Bcc String In A ';' separated list of blind copy recipients
Body String In The body text of the Email
BodyTemplateFilePath String In Path to the template to be used; backslashes must be escaped
Cc String In A ';' separated list of copy recipients
EnableSsl Boolean In True if the SMTP server requires SSL encryption, false if not
From String In The Email Address to send from
Host String In The name or the IP-Address of the SMTP server
Password String In The password used for authentication on the SMTP server
Port Integer In The port to use for SMTP connection; default is 25
Result Boolean Out Returns True on success, false on error
Subject String In The subject of the Email
TestDropPath String In A path to write the Email to as a file, instead of sending it; backslashes must be escaped
TestMailTo String In A test recipient to send the Email to; will overrule the To argument if set
To String In A ';' separated list of recipients
Tokens Dictionary<String, String> In A list of keywords and replacements when using templates
UseHTML Boolean In True to create the Email in HTML format, false to use plain text
Password String In The user name used for authentication on the SMTP server

Usage

This activity is typically used to send Emails during the execution of a workflow.

IC Hint square.pngSending is always asynchronous, so this activity will not block the execution of the workflow

Example

Send an EMail with the number of MetaClasses that derive (direct and indirect) from the MetaClass of a given object. Use a (fictional) Gmail account.

SendEmail used in the larger example "Export and send MetaClasses"
SendEmail used in the larger example "Export and send MetaClasses"
Argument Value
Attachments
New System.Collections.ObjectModel.Collection(Of System.Net.Mail.Attachment) From {new System.Net.Mail.Attachment(fileName)}
Body With kind regards from your Workflow!
-or-
BodyTemplateFilePath C:\\MyTemplates\\TemplateBody.txt
Cc
"TESTCC <testcc@augmensys.com>; whobert@augmensys.com"
EnableSsl True
From
"UBIK Workflow <ubikworkflow@gmail.com>"
Host smtp.gmail.com
Password pAsSwOrD
Port 587
Subject
"Derivates of " + UBIKObject.Name + ": " + UBIKObject.MetaClass.AllDerivates.Count.ToString()
To
"John Doe <john.doe@augmensys.com"
UseHTML True
User ubikworkflow@gmail.com
Tokens
new System.Collections.Generic.Dictionary(Of String, String) From {{"?NAME?", "Joe"},{"?SENDER?","Doe"}}


See also