Create and manage email templates

You can create email templates that can be used in combination with job activities to send email notifications when specific job activities are performed.

Note:

You may need to modify custom roles to retrieve organization members' email addresses with ArcGIS Arcade expressions.

Create email templates

To create email templates, do the following:

  1. Access the Workflow Manager web app.
  2. Click the Design tab.

    The Design page appears.

    Note:

    The Design tab won't appear if you don’t have sufficient privileges.

  3. Click the Templates button Templates.
    Note:

    The Templates button won't appear if you don’t have sufficient privileges.

  4. Click the Email Templates tab.

    The Email Templates panel appears.

  5. Click Create New in the Email Templates panel.
  6. Provide a name for the email template in the Template Name text box.
  7. 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

    Email addresses and Arcade expressions

    user1@test.com;"arcadeExpression()";user3@test.com;"arcadeExpression()"

    One Arcade expression

    "arcadeExpression()"

    Multiple Arcade expressions

    "arcadeExpression()";"arcadeExpression()";"arcadeExpression()";"arcadeExpression()"

    Arcade expressions and email addresses

    "arcadeExpression()";user2@test.com;"arcadeExpression()";user4@test.com

    Note:

    At least one valid email address or Arcade expression must be provided in the To, CC, or BCC text box.

  8. 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. For example, jobName($job)+' is ready'.

  9. Type the message text for the email notification in the Body text box.

    You can also use the following example to provide a dynamic value for the body using Arcade expressions:

    
    '<b>'+jobName($job)+'</b>, created by <b>'+jobCreator($job)+'</b>, was closed on <b>'+Text(Date(jobEndDate($job)), 'dddd, MMMM D, Y')+'</b>.'
    Note:

    You must enable the HTML Notification option to use HTML tags in the email body field.

  10. Optionally, if your jobs include attachments, you can choose to include job attachments in the email notification using the following 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 folder names in the By Folder text box to specify the job attachment folders to include in the email notification.
    Note:

    If a job contains multiple attachments, they are sent as a single ZIP file and attachment folder structure is maintained.

  11. Optionally, type a job ID in the Preview Email text box and click Preview to preview the email.
    Note:

    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.

  12. Click Save to save the email template.

Edit email templates

To edit email templates, do the following:

  1. Access the Workflow Manager web app.
  2. Click the Design tab.

    The Design page appears.

    Note:

    The Design tab won't appear if you don’t have sufficient privileges.

  3. Click the Templates button Templates.
    Note:

    The Templates button won't appear if you don’t have sufficient privileges.

  4. Click the Email Templates tab.

    The Email Templates panel appears.

  5. 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 providing a search term in the Search Email Templates text box.

  6. Update the email template as necessary.
  7. Optionally, type a job ID in the Preview Email text box and click Preview to preview the email.
    Note:

    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.

  8. Click Save to save the changes.

Delete email templates

Deleting an email template is permanent and can’t be undone. To delete email templates, do the following:

  1. Access the Workflow Manager web app.
  2. Click the Design tab.

    The Design page appears.

    Note:

    The Design tab won't appear if you don’t have sufficient privileges.

  3. Click the Templates button Templates.
    Note:

    The Templates button won't appear if you don’t have sufficient privileges.

  4. Click the Email Templates tab.

    The Email Templates panel appears.

  5. 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 providing a search term in the Search Email Templates text box.

  6. Click More Actions More Actions and click Delete.

    A confirmation message appears.

  7. Click Yes to delete the email template or click No to cancel.

If you clicked Yes, the email template is deleted.