Using Replaceable Parameters in Email Templates
Workflow Manager 2020
In addition to adding notification variables to email templates, as described in Using Notification Variables in Email Templates, administrators also have the option of performing advanced customization by inserting replaceable parameters which will be replaced with data before an email is sent.
| • | Replaceable Field Delimiters |
| • | Predefined Replaceable Values |
| • | Using Data Items As Replaceable Values |
Replaceable parameters fields are delineated with the characters %%# and #%%. You need to surround both predefined replaceable parameters and data items from the template (as described in Using Data Items As Replaceable Values) with these delimiters.
The following items are predefined for use in email templates:
|
Replaceable value |
Replaced with... |
|
AMS_Application.ApplicationLName |
The name of the workflow request. |
|
AMS_Application.DueDate |
The date the workflow request is due to be completed. |
|
AMS_Application.NewIssues |
The number of issues raised for the workflow request which are not yet responded to. |
|
AMS_Application.TotalIssues |
The total number of issues raised for the workflow request. |
|
AMS_Application.UploadBy |
The account name of the person who submitted the workflow request. |
|
AMS_Application.UploadDate |
The date the workflow request was submitted. |
If you are creating a notification message related, for example, to the installation of an application, and wish to show information specific to that application, follow the below example:
<html>
<body>
<table>
<tr>
<td>
The application %%#AMS_Application.ApplicationLName#%%
has been requested for installation by
%%#AMS_Application.UploadBy#%%. Please note that the due
date for this request to be completed is %%#AMS_Application.DueDate#%%.
</td>
</tr>
</table>
</body>
</html>
More predefined values can be made available by populating the AMS_CViews_Fields table. In particular, the chEmailField and chEmailQuery columns both need to be populated for a predefined value to work.
Using Data Items As Replaceable Values
All of the data items that are defined in a template are available for use in email notification messages. For these values, simply put the name of the data item between the delimiters %%# and #%%. The following example shows how to use some of these data fields:
<html>
<body>
<table>
<tr>
<td>
Data Values for %%#AMS_Application.ApplicationLName#%%
<br>
Version Number: %%#Version (major.minor.patch)#%%
Description: %%#Description#%%
Application Type: %%#Application Type#%%
Application Size (megabytes): %%#Application Size (megabytes)#%%
Is License Management Required?: %%#Is License Management Required?#%%
Media Type: %%#Media Type#%%
Number of Users: %%#Number of Users#%%
</td>
</tr>
</table>
</body>
</html>
See Also