Notifications configured in Cloud Studio are triggered by an operation action or kicked off from a script. Email notifications can be used to automatically send an email on the success or failure of an operation or on the calling of a script.
If instead you want to configure an email notification that triggers when a Private Agent goes down or your Harmony password is about to expire, see Notifications (Management Console).
For other ways to configure email notifications in Cloud Studio, see Ways to Send Email.
Creating or Editing an Email Notification
Email notifications can be created or edited from the project pane, the operation settings, or a script.
New email notifications are created with the default name New Email. Subsequent new notifications with default names are appended with an incremented number in parentheses.
After creating an email notification or opening an existing email notification to edit, see Configuring an Email Notification later on this page for configuration.
An existing notification can be edited from the project pane's Components tab using the View/Edit option on an email notification component (see Component Actions Menu in Project Pane Components Tab).
You can also create or edit email notifications from the Actions tab of the operation Settings, which can be accessed from these locations:
- The project pane's Workflows tab (see Component Actions Menu in Project Pane Workflows Tab).
- The project pane's Components tab (see Component Actions Menu in Project Pane Components Tab).
- The design canvas (see Component Actions Menu in Design Canvas).
Once the operation Settings screen is open, select the Actions tab. Select the Condition, and for the Action select Send Email Notification. To create a new email notification, click the link to Create New Email Notification to open the email notification configuration screen:
To edit an existing email notification, make sure you have Send Email Notification selected as the Action. Then in the Email Notification dropdown, hover over the existing notification and click the edit icon email notification configuration screen.to open the
You may want to use a script that can be configured on the operation to include advanced logic for when to send the email notification. For example, to check for a specific code or error state, you might use a script to provide more control over what happens when you have an error.
Within the script editor, open the Notifications tab of the script component palette:
To create a new email notification, click Add New:
If you already have an email notification you would like to edit, click the existing notification name, such as "Error Email," as shown here:
Email Notifications Actions Menu
Each of these menu actions is available:
- View/Edit: Opens the email notification configuration screen for you to configure the notification. For details, see Configuring an Email Notification later on this page.
- Cut: Places a copy of the email notification on your clipboard and deletes the original email notification from the project (see Component Reuse).
- Copy: Places a copy of the email notification on your clipboard (see Component Reuse).
- Duplicate: Creates a new, unreferenced email notification using the same configuration as the original email notification (see Component Reuse).
- Deploy: Shows these menu actions:
- Rename: Positions the cursor on the email notification name for you to make any edits as necessary.
- View Dependencies: Changes the view in the project pane to display any other parts of the project that the email notification is dependent on (see Component Dependencies, Deletion, and Removal).
- Add to Group: Opens a dialog to create a new custom group or to add the email notification to an existing group (see Component Groups).
- Delete: Permanently deletes the email notification (see Component Dependencies, Deletion, and Removal).
- Remove: Removes references to the email notification by operation actions on the design canvas (see Component Dependencies, Deletion, and Removal).
Configuring an Email Notification
This section covers the configuration of an email notification. After this is done, you can configure an email to be sent on success or failure of an operation (see Operation Actions) or add the notification to a script (see Script Types and Creation).
When you create a new or edit an existing email notification, the email notification configuration screen opens:
- Email Notification Name: Enter a name for the email notification. The name must be unique for each email notification and must not contain forward slashes (
/) or colons (
- SMTP Email Server(s): Enter at least one SMTP server that you want to use to send the email. If entering multiple SMTP servers, use a comma to separate each one. The servers are tried in the order that they are specified until one is found to accept the message.
To Email Address(es): Enter at least one email address to receive the email. If entering multiple recipients, use a comma to separate each one.
- From Email Address: Enter the email address that you want the email to appear from when the recipient(s) read the email.
Optional Settings: Click to expand additional optional settings:
- Use SSL/TLS: Select the checkbox to encrypt the email using SSL/TLS protocol.
- CC Email Address(es): Enter one or more email addresses to receive a copy of the email. If entering multiple copied recipients, use a comma to separate each one.
- BCC Email Address(es): Enter one or more email addresses to receive a blind copy of the email. If entering multiple blind-copied recipients, use a comma to separate each one.
- Reply to Email Address: Enter the email address that you want replies to be sent to by default. This may be useful if you send the email from a common account but want replies to go to a personal email account.
- Use Authentication: Select the checkbox if the SMTP server requires authentication. On selecting this option, the Account and Password fields below become enabled for you to enter your authentication credentials.
Subject and Message: Enter the subject and body to use for the email. To use global variables, project variables, or Jitterbit variables in the Message, enter them manually or begin by typing an open square bracket
[into the field to display a list of existing variables to choose from.
TIP: You can use HTML in the Message. Variables can be used inside HTML tags using square brackets, as demonstrated with the variable
- Test: Click to send a test email using the configuration. Sending a test email is recommended to ensure the configuration works properly and as expected. If variables are used in the configuration, you may need to specify a default value to use for testing purposes (see Variables).
- Save: Click to save and close the email notification configuration.
Discard Changes: After making changes, click to close the configuration without saving changes. A message asks you to confirm that you want to discard changes.
Adding an Email Notification to an Operation or Script
Sending an email notification can be added to an operation as an action to take on success or failure of the operation, or can be added to a script to run using advanced logic on when to send the email. This is configured either from the operation settings or from within a script.
Open the operation settings for an existing operation and select the Actions tab. Then configure the operation action as follows:
- In the first dropdown, select the appropriate condition of the operation that should trigger the action (On Success or On Fail).
- In the second dropdown, select Send Email.
- In the third dropdown, select the configured email notification.
- Click Add Action to add the email notification to the operation.
For a more detailed explanation of options, see Operation Actions.
Linked email notifications are displayed directly on the design canvas connected to the operation they are associated with:
Within a script written in Jitterbit Script, open the Notifications tab of the script component palette:
To add a notification and the function needed to execute it, use the
SendEmailMessage() function and the notification reference as a function argument. For additional details, see Notifications in Jitterbit Script.