This action sends an email to the Teams channel. This appears as a notification in the Teams channel. If you have not already, you'll need to follow the steps in this article to enable the Teams API for NITRO in order to use this action.
Send Mail to Teams Channel action in designer workflow:
.
Send Mail to Teams Channel action in legacy workflow:
General Settings
Action Name: enter a name for this action
Action Description: Describe the action (for future reference)
Delay Execution: Set a time in milliseconds to delay the execution of this action
Send Email to Channel Settings
Select Teams Channel: let's you directly select the Team and channel. The "To" email address field is automatically filled out.
Specify Channel Email: In case you can't access the Team and/or channel you can directly add the channel's email address.
Below window will open:
Select 'Email Column' which consist of email address or select 'E-mail address or placeholder'
The address is found by clicking on the ellipsis (...) next to the channel name in Teams. Then click on Get Email Address to see the email address for the channel:
Specify Team and Channel Name: specify placeholder by clicking binocular icon to get unique team and channel name or you can directly provide team and channel name.
Note: Team and Channel Name that we are directly providing or getting by providing placeholder should exist in MS Teams.
Sample Example of directly providing Team and Channel name:
Sample Example of providing placeholder i Team and Channel Name
The workflow with above setting is executed on below item:
'Type of Purchase' value is 'Hardware' and 'Id -Team Channel' value is '9-Team Channel'. If these values exist in MS Teams, only then mail will be sent.
Check in workflow logs, that mail is sent or not as shown below:
"From" can hold only one user or email address
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.
Create 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.
Edit a Mail Template -- a template must be selected in the drop list in order to edit it.
Delete a Mail Template -- a template must be selected in the drop list in order to delete it.
Title: the name of the Template
Subject: the Subject of the email. This can have Placeholders in it.
Mail Body: the Body of the email, which can include rich-text formatting. 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 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.
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 |
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.
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.
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:
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.
 |