Step 4: Create workflow email templates

A workflow is a sequence of steps describing the life cycle of a document. In AODocs, each workflow step is called a workflow state.

For each workflow state, library administrators can configure workflow emails: action emails and notification emails. Learn more: Configure workflow notifications.

This article explains how to create custom templates for your workflow emails. Custom email templates are created at the library level and can be used in any of the workflows in your library.

Access the list of email templates
Create email templates
Configure email templates
Placeholders to customize workflow emails

Access the list of email templates

1. Open the library administration interface.

2. Select Workflows in the left panel, then select the Email templates tab. The list contains any custom templates you have already configured and the default email templates:

  • Default action email
  • Default action reminder email (not yet usable)
  • Default notification email

Note: You can't modify the default email templates.

For examples of action and notification emails, see Configure workflow notifications.

image01.png


Create email templates

1. In the list of email templates, press the Add button.

2. In the Create new template pop-up:

  • select the type of email template to create

Note: Select either Action or Notification because you can't yet configure Action reminder notifications in workflows.

  • enter a name for your template
  • if required, enter a description

3. Press Create.

Tip: Alternatively, you can select Clone next to a default template and adapt it as required. 

image02.png


Configure email templates

1. Open the email template settings by pressing its name in the list of templates.

2. Define the sender of the email notification.

3. Define the subject of the email notification.

4. Define the body of your email in the Content section.You can include:

Note: You can't copy-paste a placeholder with a link from one Notifications configuration pop-up to another. You must configure the link placeholder manually.

Tip: If you’ve written the content of your emails in a spreadsheet and you’re copy-pasting an entire cell, the content of your email will display some HTML code related to the format of the spreadsheet. To make sure no formatting HTML code is displayed, check the source code of your text using the Tools menu.

image03.png

5. Select the type of layout:

  • Default layout

image04.png

  • No layout

Tip: Select No layout if you want to completely customize the design of your emails.

image05.png

6. Press Save.


Placeholders to customize workflow emails

You can customize the sender, subject and content of workflow emails using the following placeholders in your email configuration:

Placeholders

Definitions

${documentInfo}

The list of the system properties of the document:

  • Library
  • Document class
  • Date of creation
  • Document creator
  • Date of the last modification
  • Last update author

${documentProperties}

The list of the custom properties of a document.

Hidden properties are not listed.

${documentAttachments}

The list of attachments with their links in AODocs.

${documentRelations}

The list of the related documents grouped by relation type.

${documentId}

The ID of the document.

${documentTitle}

The title of the document.

${documentState}

The current state of the document.

${documentActions}

Workflow buttons available for the validators of the document. If used, validators can directly approve or reject a document from the action email they receive.

This placeholder isn’t available for notification emails.

${libraryName}

The name of the library which the document belongs to.

${documentLink}

The link to the document in AODocs labeled with the name of the document.

${documentUrl}

The URL to open the document in AODocs in view mode.

${documentEditUrl}

The URL to open the document in AODocs in edit mode.

${documentDescription} or ${richText}

The description of the document.

${document:fieldName}

The value of a document's property. For document properties of type URL, it corresponds to the URL.

For example, for the property named "Invoice amount", you can use the placeholder ${document:Invoice amount} in the notification or action email.

${document:fieldName:displayText}

The display text (without a clickable link) of a document property of type URL.

${document:fieldName:link}

The display text (with a clickable link) of a document property of type URL, if display text is defined.

The URL (with a clickable link) of a document property of type URL, if display text isn't defined.

${comment}

The comment entered by the user who performed the last workflow action.

${latestComment}

The last comment entered during previous workflow transitions.

${allComments}

All the comments made during the workflow transitions.

${parallelComments}

All the comments made on the latest completed parallel workflow transition.

${initialAuthor}

The name of the user who has created the document.

${updateAuthor}

The name of the last user who has updated the document.

${class}

The document class which the document belongs to.

${workflow}

The workflow which the document belongs to.

${lastModified}

The date of the last update made to the document.

${stateChangeDate}

The date of when the document changed its state.

${creationDate}

The creation date of the document.

${currentVersionName}

The name of the current version.

${currentVersionDescription}

The description of the current version.

Was this article helpful? 0 out of 0 found this helpful
If you didn’t find what you were looking for, don’t hesitate to leave a comment!
Have more questions? Submit a request

Comments

0 comments

Please sign in to leave a comment.