Send Email Plug-in
The Send Email plug-in enables you to send an email at a specified point within a workflow – for example, when an item requires approval or is approved. This plug-in can be used to send emails outside of the Evolve /Studio Manager environment.
The email is sent using SMTP details (Outbound SMTP Server, From Address, Use SSL, Do not use SSL, and SMTP port, etc.) and they are added at the Administration app level.
Properties
| Name | Description | Group Name | Modes |
|---|---|---|---|
| connectionname | The connection name used to connect to the database. It includes a drop-down list with the connections defined at the global or current app level. | Email To | Database |
|
senddelay |
The number of days to wait before sending the email. Example: Direct value: 1 (or any number defining number of days) Value from form field: [/my:myFields/my:field2] Value from solution field: [field1] |
Email Details | All |
| to |
The list of email addresses to which the email message will be sent. Use semicolons as email separators. Example: Direct value: abc@xyz.com; def@xyz.com Value from form field: [/my:myFields/my:field2] Value from solution field: [field1] |
Email To | Fixed |
| subject | The subject of the email message. If an email template is used in the body parameter, the subject will be selected from the email template and the contents of this parameter will be ignored. | Email Details | All |
| body |
The contents of the email message. The contents can be selected directly from this parameter or the user can provide the name of an email template defined at the global or app level. If an email template is defined, both the subject and the body will be selected from the defined email template. Example: Direct Value (Email content from this parameter): Test Email Content Direct value (Email contents from an email template): <p>$EmailTemplate.MyEmailTemplate here MyEmailTemplate is the email template name Value from form field: [/my:myFields/my:field2] Value from solution field: [field1] |
Email Details | All |
| query |
The query to run (on the database defined in the connectioname parameter) to determine recipients. A connection name must be configured for this option to work. It should return the email ID of the users to whom an email must be sent. Example: Direct value: Select User from dbo. TestUsers Where ID = 2 |
Email To | Database |
| includeitem | This flag indicates if the form should be included as an attachment. If set to True, the formview and format properties must be specified. | Attachment Details | All |
| formview | The name of the form which the recipient receives in the email. This works only if includeitem is set to True. | Attachment Details | All |
| includedatafile |
Specifies how the recipients will receive the Excel document (the data file) in the email. None – Excel document (data file) will not be sent in the email LinkToDataFile – Link to Excel document (data file) will be included in the email DataFileAsAttachment – Excel document (data file) will be included as attachment in the email. BothLinkAndAttachment – Excel document (data file) will be included as attachment to the email and as a link within the email. |
Attachment Details | All |
| format | The snapshot format of the form view attached to the email. | Attachment Details | All |
Example
Use the Send Email plug-in to keep participants in a workflow notified of tasks and events, such as when a task is overdue or when something requires approval.