You can create email templates that can be used in combination with job activities to send email notifications when specific job activities are performed.
Create email templates
To create email templates, do the following:
- Access the Workflow Manager web app.
- Click the Design tab.
The Design page appears.
Note:
If you don't have sufficient privileges, the Design tab is not available.
- Click Templates
.Note:
If you don’t have sufficient privileges, Templates
is not available. - Click the Email Templates tab.
The Email Templates panel appears.
- Click Create New in the Email Templates panel.
- Provide a name for the email template in the Template Name text box.
- Type email addresses separated by a semicolon in the To, CC, and BCC text boxes as necessary, or use an ArcGIS Arcade expression to create a dynamic list of recipients.
One email address
user1@test.com
Multiple email addresses
user1@test.com;user2@test.com;user3@test.com;user4@test.com
One Arcade expression
"GetUser($CurrentPortal, JobOwner($Job))['Email']"
Multiple Arcade expressions
"GetUser($CurrentPortal, JobOwner($Job))['Email']";"GetUser($CurrentPortal)['Email']";"GetUser($CurrentPortal, LastRunner($Job, 'f50d740d-cc04-9296-4ce3-181e82604465'))['Email']"
Email addresses and Arcade expressions
user1@test.com;"GetUser($CurrentPortal, JobOwner($Job))['Email']";user3@test.com;"GetUser($CurrentPortal)['Email']"
One username
JDoe
One group ID
7dr6de56442840ccbf49b3f869f49b27
Multiple usernames
JDoe;KSmith;MFields
One Arcade expression
"GetUser($CurrentPortal, jobOwner($job))['username']"
Multiple Arcade expressions
"GetUser($CurrentPortal, jobOwner($job))['username']";"jobCreator($job)";"lastRunner($job, '8b107614-c6dc-20b3-c232-e03bf7c007bc')"
Usernames and Arcade expressions
JDoe;"GetUser($CurrentPortal, jobOwner($job))['username']";KSmith;"lastRunner($job, '8b107614-c6dc-20b3-c232-e03bf7c007bc')"
Note:
At least one valid email address or Arcade expression must be provided in the To, CC, or BCC text box.
Tip:
Click This input supports Arcade Expressions
and choose an ArcGIS Arcade expression to add it to its associated text box. - Type a subject for the email notification in the Subject text box.
You can also use ArcGIS Arcade expressions to provide a dynamic value for the subject. If the subject contains plain text and Arcade expressions, format the text as follows:
JobName($Job) + 'is ready' - Type the message text for the email notification in the Body text box.
You can also use ArcGIS Arcade expressions to provide a dynamic value for the body.
If the body contains plain text and Arcade expressions, format the text as follows:
'<b>' + JobName($Job) + '</b>, created by <b>' + JobCreator($Job) + '</b>, was started on <b>' + Text(Date(JobStartDate($Job)), 'dddd, MMMM D, Y') + '</b>.'Note:
You must enable the HTML Notification option to use HTML tags in the Body text box.
- Optionally, if your job contains attachments, include them in your email notification using the options under Include Attachments:
- None—Don't include job attachments in the email notification.
- All—Include all job attachment folders in the email notification.
- By Folder—Type a comma-separated list of job attachment folder names in the By Folder text box to specify the job attachment folders to include in the email notification.
Note:
Job attachment folders are contained in the workflow item and are not file system paths.
Note:
If a job contains multiple attachments, they are sent as a single .zip file and the job's attachment folder structure is maintained.
- Optionally, click Preview email to preview the email.
Note:
If the email contains a job-specific Arcade expression, you must provide a valid job ID in the Preview Email text box before you can preview the Arcade expression. If the email contains an Arcade expression for the output value of a step, the step must be completed before you can preview the output value.
The Email Preview window appears with a list of recipients and a preview of the subject and body.
- Click Save to save the email template.
Edit email templates
To edit email templates, do the following:
- Access the Workflow Manager web app.
- Click the Design tab.
The Design page appears.
Note:
If you don't have sufficient privileges, the Design tab is not available.
- Click Templates .
Note:
If you don’t have sufficient privileges, Templates
is not available. - Click the Email Templates tab.
The Email Templates panel appears.
- Click the name of the email template you want to edit in the Email Templates panel.
Tip:
You can filter the list of email templates in the Email Templates panel by typing a search term in the Search Email Templates text box.
- Update the email template as necessary.
- Optionally, click Preview email to preview the email.
Note:
If the email contains a job-specific Arcade expression, you must provide a valid job ID in the Preview Email text box before you can preview the Arcade expression. If the email contains an Arcade expression for the output value of a step, the step must be completed before you can preview the output value.
The Email Preview window appears with a list of recipients and a preview of the subject and body.
- Click Save to save the changes.
Delete email templates
Deleting an email template is permanent and can’t be undone. To delete priorities, do the following:
- Access the Workflow Manager web app.
- Click the Design tab.
The Design page appears.
Note:
If you don't have sufficient privileges, the Design tab is not available.
- Click Templates .
Note:
If you don’t have sufficient privileges, Templates
is not available. - Click the Email Templates tab.
The Email Templates panel appears.
- Click the name of the email template you want to delete in the Email Templates panel.
Tip:
You can filter the list of email templates in the Email Templates panel by typing a search term in the Search Email Templates text box.
- Click the More Actions button
and click Delete.A confirmation message appears.
- Click Yes to delete the email template or click No to cancel.