Difference between revisions of "Activity:SendEmail (Activity)"

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

Latest revision as of 13:40, 15 February 2018

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
Example

Description

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.

Sending 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"

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"}}

@@ Line 1: / Line 1: @@
+The SendEmail Activity sends an Email via SMTP, using a server it connects to. It also supports attachments, HTML bodies and Email templates.
+= Description =
 {{ActivityInfoBox
 | title = Send Email
@@ Line 9: / Line 12: @@
 | version = 2.1.15+
 }}
-The SendEmail Activity sends an Email via SMTP, using a server it connects to. It also supports attachments, HTML bodies and Email templates.
-==Arguments==
+===Arguments===
 {| class="wikitable sortable" | width = "50%"
 |-
@@ Line 22: / Line 24: @@
 | Body|| {{String_MSDN}}|| In || The body text of the Email
 |- align="left"
-| BodyTemplateFilePath|| {{String_MSDN}}|| In || Path to the template to be used
+| BodyTemplateFilePath|| {{String_MSDN}}|| In || Path to the template to be used; backslashes must be escaped
 |- align="left"
 | Cc|| {{String_MSDN}}|| In || A ';' separated list of copy recipients
@@ Line 40: / Line 42: @@
 | Subject|| {{String_MSDN}}|| In || The subject of the Email
 |- align="left"
-| TestDropPath|| {{String_MSDN}}|| In || A path to write the Email to as a file, instead of sending it
+| TestDropPath|| {{String_MSDN}}|| In || A path to write the Email to as a file, instead of sending it; backslashes must be escaped
 |- align="left"
 | TestMailTo|| {{String_MSDN}}|| In || A test recipient to send the Email to; will overrule the ''To'' argument if set
@@ Line 53: / Line 55: @@
 |}
-==Usage==
+[[Category:Activities|SendEmail (Activity)]]
+===Usage===
 This activity is typically used to send Emails during the execution of a workflow.
@@ Line 59: / Line 63: @@
 {{Hint|Sending is always asynchronous, so this activity will not block the execution of the workflow}}
-==Example==
+=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.
@@ Line 71: / Line 74: @@
 |- align="left"
 | Body|| With kind regards from your Workflow!
+|- align="left"
+| -or-||
+|- align="left"
+| BodyTemplateFilePath|| C:\\MyTemplates\\TemplateBody.txt
 |- align="left"
 | Cc|| <source lang = "vbnet">"TESTCC <testcc@augmensys.com>; whobert@augmensys.com"</source>
@@ Line 94: / Line 101: @@
 | Tokens||<source lang = "vbnet">new System.Collections.Generic.Dictionary(Of String, String) From {{"?NAME?", "Joe"},{"?SENDER?","Doe"}}</source>
 |}
+{{Activity/End}}
 ==See also==
 * [[Workflow Designer]]
- [[Category:Activities]]
+[[Category:Activities|SendEmail (Activity)]]