1. Potens.io
  2. Magnus
  3. Core Tasks

Articles > Email Task

Overview

For times when a product or company performance needs to be monitored on a daily/hourly basis the best option is to automate extraction of data and send the results in E-Mail to a group distribution.  Better yet is the ability to present the data in a visually meaningful way.  Access to HTML formatting is important along with being able to create templates where information is filled in when data is gathered.

Magnus features E-Mail Task which allows sending an E-Mail to recipients

E-Mail Task provides a way to distribute several types of notifications from presenting data to informing on status of workflow.  
The E-Mail body can be constructed in either Text or HTML along with inclusion of an attachment.  
Recipients can also be carbon copied or blind carbon copied on E-Mails.

Front Panel

01.2e.png

Flip Panel

02.png

Add Email Task

1. Under Add Task, select the desired position from the "Add to position" drop down list, then click +E-Mail. 
03.png

2. Provide Email Information: 
04.2e.png

Email Information Options

a. Subject:

i. This is the email subject.
ii. Parameters can be used.

b. To:

i. This is the email address list, delimited by comma, to send the email to.
ii. Parameters can be used.

c. Cc:

i. This is the email address list, delimited by comma, to cc the email to.
ii. Parameters can be used.

d. Bcc:

i. This is the email address list, delimited by comma, to bcc the email to.
ii. Parameters can be used.

e. Reply-to:

i. This is the comma delimited email address list of the reply-to attribute of the email.  It will be defaulted to the Workflow owner if not specified.
ii. Parameters can be used.

Email Body

1. This is the email body.
2. There are two options for the format of the body: Text or HTML 
05.png

3.Parameters can be used.
4. The body textbox can be expanded to a popup mode by clicking the icon 17.png.
5. Here is an example of an email body of text format:
06.png

6. Here is an example of an email body of HTML format:
07.png

 

Email Attachment

1. To send an attachment along with the email, click the link Attachment. 
08.png

2. There are three options for the type of attachment: Text, HTML, or GCS. 
09.png

3. This icon 20.png indicates that this Email task has attachment specified. 
sh6.png

Email Attachment of Text format

1. Select Text from the format drop down list. 
11.png

2. Specify the file name and file extension of the attachment file. Parameters can be used. 
12.png

3. Specify content of the attachment file. Parameters can be used. 
13.png

4. The content textbox can be expanded to popup mode by clicking the icon 17.png.

 

Email Attachment of HTML format

1. Select HTML from the format drop down list. 
14.png

2. Specify the file name of the attachment file. Parameters can be used. The file extension is always html. 
15.png

3. Specify content of the attachment file. Parameters can be used. 
16.png

4. The content textbox can be expanded to popup mode by clicking the icon 17.png.

 

Email Attachment from Google Cloud Storage

1. Select GCS from the format drop down list. 
18.png

2. Provide the path of the file from GCS. 
19.png

a. The path must be prefixed with gs://
b. The file must already exist in GCS.
c. User must have read permission to the file.
d. Parameters can be used.
e. Magnus does not support wild card pattern here. 
f. Up to 5 files from Google Cloud Storage can be attached.  
Any files beyond the fifth file will be automatically ignored and not attached to the email.  
To specify multiple files to be attached, provide a comma separated list, 
For example:
 gs://myBucket/data_20170801.csv,gs://myBucket/data_20170802.csv,gs://myBucket/data_20170803.csv
g. User can also specify to ignore error for any particular file by prefixing the file with ?.  
For example, 
    gs://myBucket/data_20170801.csv,?gs://myBucket/data_20170802.csv,gs://myBucket/data_20170803.csv
If for whatever reason, the file data_20170802.csv failed to be downloaded from Google Cloud Storage, that file will be ignored, and the Email Task will not be flagged as failed

3. User can choose to generate Signed URLs for the GCS files instead of attaching the files to email.  This Signed URL feature is supported only when the workflow is executed by registered service account.  Please contact your admins for setup service account with HMAC access .

Signed URL is a url that provides limited permission and time to make a request.  Signed URL contains authentication information in the query string, allowing users without credentials to perform specific action on a resource.

Anyone provided with the resulting signed urls can view or download the gcs files within a time limit, and without needing to sign into Google.
mceclip0.png

  • Check Signed URL(s)
  • For Collect Items, select a custom record parameter to store the resulting Signed URLs
  • Set expiration for the Signed URLs. Once expired, the Signed URLs are no longer usable.  The max expiration is 7 days.
  • To use the Signed URLs, you can reference them in the email body via the record parameter.  Example:
    mceclip1.png

 

Limitations

  1. Email attachment size cannot exceed 25 MB.

  2. The number of attachment from GCS cannot exceed 5 files.