Differences

This shows you the differences between two versions of the page.

--- transformations:sendemail [2018/01/11 21:21] – created dmitry
+++ transformations:sendemail [2021/07/15 12:54] (current) – craigt
@@ Line 1: / Line 1: @@
-===== Send email =====
+{{ transformations:SendEmailAction.png}}
+====== SEND EMAIL ======
+Category: Workflow / External\\
-Category: Workflow / Advanced
+\\
+=====Description=====
+This action sends an email to one or multiple recipients. Optionally, it can be configured to attach a file,\\ or insert an HTML table.
-This transformation allows sending emails with attachments.
+\\
+=====Use cases=====
+Automate the sending of processed results to the recipient automatically as an attached file or embedded HTML table.
-It is possible to send the message to multiple recipients. In this case the recepients' email addresses must be separated with commas.
+\\
+=====Action settings=====
+^ Setting  ^ Description  ^
+|Connector<sup>*</sup>|Select or create a connector to an email service such as MS Exchange or Gmail to send email through.|
+|Send to<sup>*</sup>|Enter the email recipient(s). In the case of multiple recipients separate their email addresses with commas.|
+|Cc<sup>*</sup>|The CC email recipient(s). In the case of multiple recipients separate their email addresses with commas.\\  Access this option using the down arrow at the left of the "Send to" field, above.|
+|Bcc<sup>*</sup>|Enter the BCC email recipient(s). In the case of multiple recipients separate their email addresses with commas.\\ Access this option using the down arrow at the left of the "Send to" field, above.|
+|Subject<sup>*</sup>|Enter the message subject.|
+|Plain text / HTML  |Select the message body format.  See the table below for additional options in HTML mode.|
+|Message<sup>*</sup>|Enter the body text of email message. Parameter names can be included using curly braces to personalize the email.|
+|Attach file<sup>*</sup>|Enter or browse to the fully qualified path and file to be attached. The file size must be less than 20MBytes.|
+<sup>*</sup> Setting can be specified using a [[:parameters|parameter]].\\
-The message body can be formatted as HTML. Also project parameters can be dynamically inserted into the message body, or subject.
+\\
+====HTML mode settings====
+^ Settings ^ Description ^
+|Insert input dataset| Insert the input dataset of the action as a plain HTML table. See [[https://community.easymorph.com/t/how-to-send-email-with-kpi-metrics-as-html-table/2176|See example]].  |
+|Footer<sup>*</sup>|Enter an additional text block at the bottom of the message body. Parameters names can be included using curly braces.|
+<sup>*</sup> Setting can be specified using a [[:parameters|parameter]].\\
+\\
+=====Remarks=====
+Note that the fields for "CC" and "BCC" recipients are hidden when empty by default. They can be enabled using the mode selector at the left of the "Send to" field.
+\\
+====Multiple attachments====
+When multiple files need to be attached, use the [[transformations:filecommand|File command]] action to zip them into one file first. Then specify the path to the zip-archive in the properties of the "Send email" action
+\\
+=====Community examples=====
+  * [[https://community.easymorph.com/t//466/1|Sending an email notification when project fails]] ([[https://community.easymorph.com/uploads/short-url/8MVDPxoPY14RwNbwTFKOzYgrbCD.morph|Project]]; Module: //Main//; Group: //Conditional derivation//; Table: //When failure - Send an email//; Action position: //2//)
+\\
+=====See also=====
+  * [[transformations:fetchemail|Fetch email]]
+  * [[:connectors|Connectors]]