Send Mail

<< Click to Display Table of Contents >>

Navigation:  NITRO™ Workflows > Configuring Workflows > Workflow Actions >

Send Mail

Send Mail

This action allows you to send notifications, alerts, and other emails using mail templates created within the NITRO Workflows app. These mail templates are used in this Send Mail action only and are not used elsewhere in NITRO Studio..

 

Send Mail Action in Designer workflow:

 Send Mail Action

Send Mail Action in Legacy workflow:

 Send Mail action in legacy workflow

               
General Settings                                

         Action Name: enter a name for this Send Mail action

         Action Description: enter description for this Send Mail action

         Mail Template: see section 'Mail Template' explained below

       Delay Execution: to delay the sending of the email, enter a number from 1 to 30 to indicate the number of  seconds to delay sending.        
Mail Format: supports three mail format. default format is Html.

Html: This is the default format.HTML allows you to create messages by using different fonts, colors, and formatting options. You can also embed pictures directly within the message.        

Plain Text: Plain text format doesn’t support bold or italic text, colored fonts, or other formatting. Pictures cannot be displayed within the message body, but you can include them as attachments.

Plain Text - Strip Html: Strip HTML removes all HTML tags and gives plain text.

               Mail Format

 

Recipients        

To select recipients,  click the buttons after the text boxes. Select the recipients from the Select Users box that comes up.

"To", "Cc", and "Bcc" - can hold multiple names.

"From" - can hold only one user or email address.

"Reply-To" - can hold only one user or email address

"Never send to" -- use to indicate users or email addresses to never send this email to.

Note: in NITRO Workflows, we cannot support [Me] placeholder as workflows do not run in user context

Select Users

Note: Support %% syntax in send mail recipients to support functions.

Sample Example:

Sample Example

Mail Templates

Use the "Mail Template" dropdown list to select a mail template. If no mail templates have been configured in the NITRO Workflow app, click the Create button to create a mail template. The Edit and Delete buttons can be used to edit or delete an existing NITRO Workflow mail template.

 

clip0528Create a Mail Template -- Note that the mail templates created here apply only to the NITRO Workflows app and are not used elsewhere in NITRO Studio.

clip0529Edit a Mail Template -- a template must be selected in the drop list in order to edit it.

clip0530Delete a Mail Template -- a template must be selected in the drop list in order to delete it.

Mail Template Image 1

Mail Template Image 2

 

 

 

Name: provide the name of the Template.

Priority: Select the importance(Priority) of mail from the dropdown.

Subject: provide the subject of the email. This can have Placeholders in it.

Mail Body: specify the body(main Text) of the email, which can include rich-text formatting. In mail body sender canspecify the main purpose of email.This can have Placeholders in it.

Include updated columns: any columns that have been updated will be included in the email.

Exclude update columns: do not include the updated columns designated in the box.

 The format to identify the excluded columns is: [[Column internal name || Column display name]]

 for multiple columns: [[Column1 internal name||Column1 display name]] [[Column2 internal name||Column2 display name]] ... (etc.)

Highlight updated columns: any updated columns that are included in the email will be highlighted.

Insert attachments/documents: Enabling this setting will allow you to insert columns, attachments and documents and will enable the “All attachments” default setting

 

All Attachments: It will include all attachments in the mail.

 

       Attachment columns: Select one or more text type columns, or select NITRO Attachments.

 

       File name regular expression: Filter attachments/documents using regular expressions.

Example: To match all pdf files with word Agreement in their name specify: .*Agreement.*.pdf

 

       Matching file extensions: Filter attachments/documents by matching file extensions.

Example: pdf;docx

 

Insert File Attachments: Select this option to Insert SharePoint file(s) from library by clicking '+' button

Site URL: Select site URL from dropdown

Library: dropdown will show all library of selected site in above step. Select library from which you want to attach file.

File: Select file name (from the selected library in above step) that you want to attach in the email.

 

Insert files

 

Insert Lookup Column Attachments: To insert attachments from lookup column, click 'Add' button. A window will pop up

Select lookup column from dropdown. 'All attachments' is by default selected. this will include all attachments of selected lookup column in email.

 

 

All attachment of Lookup

If you don't want to include all attachments of lookup column then deselect 'All attachments'. following columns will be visible after deselecting 'All attachments'

 

       Attachment columns: Select one or more text type columns, or select NITRO Attachments.

 

       File name regular expression: Filter attachments/documents using regular expressions.

Example: To match all pdf files with word Agreement in their name specify: .*Agreement.*.pdf

 

       Matching file extensions: Filter attachments/documents by matching file extensions.

Example: pdf;docx

 

Lookup column Attachment

 

Insert Report as Attachments: Select this option to insert report as attachment in email. From dropdown user can select report to attach with email.

To configure reports, please use the Crow Canyon NITRO Reports App. Report will be attached to the email only for 'scheduled report' type of workflows.

Insert Reports

 

 

Do not send mail if view/report doesn't have any data: Select this option to don't send mail if none of the view placeholders or reports have any item.

 

Do not send email

 

PLACEHOLDERS

List columns and links can be added to subject and body of template. List views can be added to body for 'secheduled report' type of workflows.

Select the list columns and links from 'Placeholders' option available on the right side of mail template and click "Add to Subject" or "Add to Body" buttons below the 'Placeholders' to put the selected list columns(placeholders) in the corresponding place.

 

The placeholders include Site and Item information as well as all the fields in the list where this mail template is being created.

 

"Site Link", "List Link", "item Link", and "Edit Item Link" will put a clickable URL in the email. "Site Title", "List Title", and "Item Title" will put the name as text, not as a clickable link.

 

Here is an example Template with placeholders in it:

 

send mail example

 

To insert query list item link in mail template, please refer this article Query list item link in mail template