How to customize WorkflowGen notification subject lines?
Monday, March 2, 2009 at 09:15 Background
You can customize your email subject line for outgoing notifications. If you don’t, WorkflowGen dynamically generates one for you based on the following information: Process Name, Request #, Event, and Current Action Name (i.e. HELP_DESK #1440 - New action to assign: 4-OPERATION_LEVEL_1).
Solution
Since all notifications from WorkflowGen are generated from a template, these templates could be modified to explicitly specify a subject. Since the default email message templates (located in /wfgen/App_Data/Templates/Emails) are used system wide, any change to the templates may be reflected in any or all processes. This is why the default templates do not have explicit subject lines and rely on WorkflowGen to generate them.
If you plan on customizing your email subject line, best practice is to create a custom email template specific to a process. However if you choose to modify your default templates the process to do so is the same. Templates may be created in HTML or as plain text and may include WorkflowGen macros to display process specific information. For more information on how to create custom templates, please refer to the 'Custom Notification Templates' section of the WorkflowGen Administration documentation (http://community.workflowgen.com/downloads/documentation/workflowgen-51-documentation/).
To create a custom subject line in your template, simply add the keyword “SUBJECT:” followed by the text you wish to display as the first line of the template.
For example:
SUBJECT: This is my custom subject line.
WorkflowGen macros that are used within the email body can also be used within the subject line.
For example:
SUBJECT: <WF_PROCESS_INST_NAME> #<WF_PROCESS_INST_ID> - Request Pay Rate Change for <WF_PROCESS_INST_RELDATA_VALUE.EMP_FIRSTNAME> <WF_PROCESS_INST_RELDATA_VALUE.EMP_LASTNAME> - Request Closure
is rendered as:
PAY_RATE #1234 – Request Pay Rate Change for John Smith - Request Closure
Below is a sample custom email template with a custom subject line:
SUBJECT: Pay Rate Change Request for <WF_PROCESS_INST_RELDATA_VALUE.EMP_FIRSTNAME> <WF_PROCESS_INST_RELDATA_VALUE.EMP_LASTNAME> - Denied by Human Resources
<html>
<head>
<meta http-equiv=”Content-Type” content=”text/html; charset=UTF-8”>
<title>Pay Rate Change Request Denied by Human Resources</title>
<style type="text/css">
body
{
font-family:Arial, Helv;margin:0px;
}
.Header {width:100%;padding:0px;margin:0px;white-space:nowrap;border-bottom: solid 1px #D3D3D1;border-top: solid 1px #D3D3D1;}
.Header .Title {line-height:45px;padding-left:11px;font-size: 19px;color: #4C4C4C;font-weight: bold;font-family:Tahoma, Arial;text-align:left;backgroundcolor:#F9F9F9;filter:progid:DXImageTransform.Microsoft.Gradient(GradientType=0, StartColorStr='#FEFEFE', EndColorStr='#F4F4F4')}
.Content {border:0px;margin-left:40px;margin-top:10px;}
.Content .FieldLabel {font-size: 12px;font-weight:bold;text-align:right;}
.Content .FieldValue {font-size: 12px;font-weight:normal;text-align:left;color:#000000;}
.Content .FieldValue .Link {text-decoration:underline;color:#00309C;}
.Content .FieldValue .Link:hover {text-decoration:underline;}
.Content .FieldValue .Link:visited {color:#00309C;text-decoration:underline;}
.DataList {margin-left:40px;margin-top:15px;width:600px;font-size: 11px;border-style: solid;border-collapse:collapse;border-width: 1px 1px 1px 1px;border-color: #D5D5D5;}
.DataList .Header {font-weight:bold;color:#4C4C4C;padding: 3px;border-style: solid;border-width: 1px 1px 1px 1px;border-color: #D5D5D5;font-family:Tahoma;white-space: nowrap;padding-left:6px;text-align: left;background-color:#EAEAEA;filter:progid:DXImageTransform.Microsoft.Gradient(GradientType=0, StartColorStr='#FEFEFE', EndColorStr='#EAEAEA')}
.DataList .ListRow {height:22px;}
.DataList .ListRow .FieldLabel {font-size: 12px;color:#000000;background-color:#FFFFFF;font-weight: normal;width:250px;padding-left: 5px;border-collapse:collapse;border-style: solid;border-width: 0px 0px 1px 1px;border-color: #D5D5D5;}
.DataList .ListRow .FieldValue {font-size: 12px;color:#000000;text-align:right;padding-right:5px;background-color:#FFFFFF;border-style: solid;border-collapse:collapse;border-width: 0px 1px 1px 0px;border-color: #D5D5D5;}
.DataList .ListRow .FieldValue .Link {text-decoration:underline;color:#00309C;}
.DataList .ListRow .FieldValue .Link:hover {text-decoration:underline;}
.DataList .ListRow .FieldValue .Link:visited {color:#00309C;text-decoration:underline;}
.DataList .ListRowHighLight {height:22px;background-color:#FFF0E5;}
.DataList .ListRowHighLight .FieldLabel {font-size: 12px;color:#000000;font-weight: normal;width:250px;padding-left: 5px;border-collapse:collapse;border-style: solid;border-width: 0px 0px 1px 1px;border-color: #D5D5D5;}
.DataList .ListRowHighLight .FieldValue {font-size: 12px;color:#000000;text-align:right;padding-right:5px;border-style: solid;border-collapse:collapse;border-width: 0px 1px 1px 0px;border-color: #D5D5D5;}
.DataList .ListRowHighLight .FieldValue .Link {text-decoration:underline;color:#00309C;}
.DataList .ListRowHighLight .FieldValue .Link:hover {text-decoration:underline;}
.DataList .ListRowHighLight .FieldValue .Link:visited {color:#00309C;text-decoration:underline;}
</style>
</head>
<body>
<p>
Human Resources - Denial of Pay Rate Change
</p>
<table class="Header" cellpadding="0" cellspacing="0">
<tr>
<td class="Title"><WF_PROCESS_INST_NAME></td>
</tr>
</table>
<table class="Content">
<tr>
<td>
Human Resources Decision - Request Denied
</td>
</tr>
<tr>
<td class="FieldLabel">Date of Denial :</td>
<td class="FieldValue"><WF_SYSTEM_DATETIME></td>
</tr>
<tr>
<td class="FieldLabel">Action :</td>
<td class="FieldValue"><WF_ACTIVITY_INST_NAME></td>
</tr>
<tr>
<td class="FieldLabel">Description :</td>
<td class="FieldValue"><WF_ACTIVITY_INST_DESC></td>
</tr>
<tr>
<td class="FieldLabel">Link :</td>
<td class="FieldValue">
<a class="Link" href="<WF_LINK_ACTIVITY_INST_FORM>">View action</a>
</td>
</tr>
</table>
<p>
The "Pay Change Request" for <WF_PROCESS_INST_RELDATA_VALUE.EMP_FIRSTNAME> <WF_PROCESS_INST_RELDATA_VALUE.EMP_LASTNAME> with a Current Pay Rate of <WF_PROCESS_INST_RELDATA_VALUE.EMP_CURRENT_PAY_RATE> and a new Changed Pay Rate Request of <WF_PROCESS_INST_RELDATA_VALUE.EMP_REQUESTED_PAY_RATE>
has been denied by Human Resources.
</p>
<p>
The reasons for this denial are: <WF_PROCESS_INST_RELDATA_VALUE.HR_COMMENTS>
</p>
<p>
To discuss this denial with Human Resources, please contact your Human Resources representative <WF_PROCESS_INST_RELDATA_VALUE.HR_REP> at <WF_PROCESS_INST_RELDATA_VALUE.HR_REP_PHONE> or via email at <WF_PROCESS_INST_RELDATA_VALUE.HR_REP_EMAIL>.
</p>
</body>
</html>
RSS
Reader Comments