Courier email notification templates
Most of the Courier notifications that are transmitted can be defined in the Courier template itself. The Courier email notifications that are sent to the sender of the transmissions when transmissions are completed, overdue, or canceled can be customized.
All FileHold System email notification templates are stored in resource files (.resx). The email messages are sent using HTML format which allows to prepare more readable information for users. Each of template can contain replacement fields that are described below and are replaced to appropriate values during email processing.
You should be skilled with XML, HTML, and CSS coding in order to use the information in this knowledge article. FileHold professional services are available for any customer that would like changes made to their email notifications. Modifying Courier email notification templates is not covered by FileCare.
When you upgrade FileHold from one version to another you should apply any notification customizations to the newly upgraded version when the upgrade is complete otherwise the default product notifications will be used.
Notification areas
There are several areas that have a separate notification for users. Notice that a key name of replacement field should be placed in [ ] signs and there should not be any space or white character between them, i.e. [KeyName]
Courier notifications
All text and templates for this area are stored in: C:\Program Files\FileHold Systems\Application Server\LibraryManager\App_GlobalResources\WorkflowNotification.resx
Templates
There are email templates specified in the resource file. The email notifications are sent to the sender of the transmission only. The actions for each template are listed below the template name.
- EasyEmailBodyInformationWorkflow
- Transmission Canceled
- Transmission Completed
- EasyEmailBodyInformationWorkflowDue
- Task overdue
- EasyEmailSubject - template for a subject of email message
- EasyEmailBodyHeader - template for a header of email message
- EasyEmailBodyFooter - template for a footer of email message
- EmailBodyActionComment - template to include participant comments and feedback attachments in the notification emails.
- EasyEmailBodyInformationWorkflowRecipients - template for Courier initiators.
These templates should be prepared in HTML format with CSS styles with the exception of the EasyEmailSubject template. CSS formatting should be included inline with the HTML to ensure the formatting is presented in a uniform way in a wide variety of email clients. The following is an example. The CSS is bold.
<td width="25%" style="width:150px; border: solid 1px #000000; padding: 3px 3px; border-right: none;">
Workflow
</td>
The resource file is an XML file, so you cannot directly insert HTML code. All HTML characters that conflict with XML formatting characters must be escaped. The code snippet above would be written as follows inside the resource file.
<td width="25%" style="width:150px; border: solid 1px #000000; padding: 3px 3px; border-right: none;">
Workflow
</td>
Keys
The following keys can be used in the template messages. The level describes the place in the notification where the information is valid: the overall notification or the individual action. The action level is only useful in the body of the notification. For example, a notification email can contain many action types for one or more workflows. As a result the workflow name would not be useful in the subject of the email.
Key name | Description | Level | Samples |
---|---|---|---|
ActionType | Name of the action that have been performed. | Action | Transmission Completed, Transmission Canceled, Transmission Overdue |
InitialDocumentName | Name of a document related to the transmission. | Not used |
|
DueDate | Due date of the action | Action |
|
WorkflowStatus | Text describing the transmission status. | Action | Viewed, Not Submitted For Approval, Pending Approval, Approved, Not Approved, Approval Postponed, Completed |
WorkflowName | Name of a transmission. | Action | The value can be defined when the transmssion is initiated if the workflow template allows it. |
NumberNotification | Number of transmission notifications that have been included in the one email message. | Notification |
|
ActionDate | Date when a task has been performed. | Action |
|
Transmission Link | Link to the Courier transmission report. | Action |
|
NotificationType | Text describing the notification frequency. | Notification | Daily Summary, Immediately, Weekly Summary |