How to Send an Automatic Email when Workflow Errors

Question

How to Add an Event to Send an Automatic Email when Workflow Errors

Configure a workflow to send an email when a workflow errors on the server or with Desktop Automation.
 Prerequisites

* Alteryx Designer* All versions

* Alteryx Server* All versions

* SMTP settings

Procedure

* In the Workflow - Configuration pane, click "Events".
* Ensure the checkbox "Enable Events" is checked.
* Click "Add" > Send Email

* In the "Run Event When" dropdown, select "After Run with Errors"
* Configure SMTP host name for your organization
* Configure the port:

* Port 25, when None is selected via Encryption.
* Port 465, when SSL/TLS is selected via Encryption.
* Port 587, when STARTTLS is selected via Encryption.

* Select the Encryption: None, SSL/TLS, or START/TLS.
* If you want to authenticate the event, check the Authentication box, and provide a valid Username and Password.
* Enter the "From" email address; the email address the message will be sent from.
* Enter the "To" email address. This will be the recipient of the email that describes which workflow was disabled, along with any errors associated. This email can be whoever makes the most sense in your use case, whether it be a System Administrator, the workflow owner, or any other valid email address.
* Enter the text to appear in the subject line. The values surrounded by percent (%) signs indicate dynamic values that will be pulled from the workflow results.
* Add any necessary attachments.
* Enter the text to appear in the body of the email.
* Click "OK".

That's it! The workflow will now send notification emails to a chosen email address in the event a workflow is disabled. This can help alleviate the pain point of not knowing when or why a workflow was disabled.

image.png Additional Resources

* Workflow Events
* Email Events to Notify on Start or Finish

londonhanson · Answer

The above workflow link for Dynamic events has expired. Please use this one:

https://drop.alteryx.com/public/file/4sgBb-FjCUWSnBcdwOyngQ/AddEmailEventDynamic.yxmd

londonhanson · Answer

@salbol1 However, if you're looking to implement a single password solution, we would suggest utilizing our new Data Connection Manager (DCM) with the Email Tool or Send Email Events. DCM is centralized storage for credentials and data sources, which allows you to update a password for many workflows from a single location.

londonhanson · Answer

Hi @salbol1,

Thanks for reaching out. I have consulted with my colleagues and after some testing, we discovered the following:

* If the SMTP password is inserted directly in the workflow XML, escaping as necessary, upon the workflow being opened in Designer the value will be hashed. The event successfully executes.
* If the SMTP password is inserted directly in the workflow XML, escaping as necessary, upon the workflow being executed via command line (AlteryxEngineCmd.exe) the value remains plaintext. The event successfully executes.