Table of Contents

Customize

It is possible to customize the look of email messages sent by the DV2000. This customization uses a set of files called Templates which it uses to format the email message. While these files can be modified by anybody using any standard text editor, it the doing so should be handled with caution.

Template features:

Template Files

The product ships with several default templates located in c:\vs\templates. These files will be copied to c:\vs\vmuser when they are first used. Files located in c:\vs\templates should not be modified.

All custom templates should be placed into c:\vs\vmuser. If a template file exists in the mailbox folder it will take precedence.

Naming Convention

File names are formatted for specific uses. The format is defined as <USE><LANGUAGE>TEMPLATE.<FORMAT>.

Example:

VM101TEMPLATE.TXT

Fields

FieldDescription
<USE>Defines what the template should be used for.
<LANGUAGE>DV2000 language number the file is to be used for.
<FORMAT>TXT for text based and HTML for html based email messages.

Use Types

USEPREFIX
E911 Emergency Alert body template.
E911S Emergency Alert subject template.
VM Voice message body template.
VMS Voice message subject template.
CDCall data body template.
CDS Call data subject template.
WU Failed wakeup call body template.
WUS Failed wakeup call subject template.

Language

Used to specify the language the template is designed for. The language of the mailbox is used to determine this value. If the language of the mailbox does not exist, the system will use 101 (US English).

NUMBERLANGUAGE
101US English
102UK English
201Spanish
301Japanese
401French, FR
402French, CA
501Portuguese, BR
601German
701Italian
801Arabic
901Chinese, Mandarin
902Chinese, Cantonese
1001Thai
1101Swahili
1201Korean
1301Russian
1401Turkish

Template Syntax

Files are technically simple text files containing specific keywords and loop modifiers. A template is loaded each time a message is processed.

Rules

Keywords

The following table shows the keywords available, description of what it is used for and a sample output.

KEYWORDDESCRIPTIONEXAMPLE
${first_name}First nameJohn
${from}Who is the message fromJohn Smith
${from_first}First name of sender mailbox.Jane
${from_last}Last name of sender mailbox.Doe
${from_mailbox}Senders mailbox number.560
${date}Date and time.2010/04/18 at 10:34:56 pm
${description}Mailbox description.Holiday Mailbox
${extension}Mailbox extension.7560
${received}Date and time message was received.2010/04/18 at 10:34:56 pm
${sent}Date and time message was sent.2010/04/18 at 10:34:56 pm
${last_name}Last name.Smith
${length}Length of the message in time.10 seconds
${mailbox}Mailbox number.540
${message_type}Type of message.VeMail
${mif}Used to place the MIF phrase used for reply-to-delete.
${time} Time.10:34:45 pm
${total_length}Total length of time for the entire message.3 seconds
${part_number}What part of the message this is.
${port}Port number message was sent for. Used only for call data.3
${priority}Priority of the message.Urgent or Private
${to}Who the message is to.John Smith
${to_first}Receivers first name.John
${to_last}Receivers last name.Smith
${to_mailbox}Receivers mailbox number.540

Loops

Loops provide a way for the template system to use the same block of text for repeated information. For example a list of all the attachments in a message use the same template block but will be repeated over and over in the final output therefore creating a list. Currently loops are only supported for the voice message body template and only consist of two loop types. These are reply-to-delete and detail. A loop is defined by BEGIN and END followed by the loop modifier. This modifier is then used as a parent for a standard keyword.

Example:

<!-- BEGIN detail -->Part ${part_number}:
          To: ${detail.to_first} ${detail.to_last} (${detail.to_mailbox})
        From: ${detail.from_first} ${detail.from_last} (${detail.from_mailbox})
  Created By: ${detail.created_by} ${detail.by_first} ${detail.by_last}
        Sent: ${detail.sent}
    Received: ${detail.received}
      Length: ${detail.length}
<!-- END detail -->

Samples

Subject Line

VMS101TEMPLATE.TXT

VMS101TEMPLATE.TXT
${priority} ${message_type} from ${from}

Text Body

VM101TEMPLATE.TXT
From: ${from_first} ${from_last}
Mailbox: ${from_mailbox}
<!-- BEGIN replytodelete -->
To delete this message from your voice mailbox, reply with original message body.
${mif}
<!-- END replytodelete -->
          To: ${to_first} ${to_last} (${to_mailbox})
        From: ${from_first} ${from_last} (${from_mailbox})
  Created By: ${created_by} ${by_first} ${by_last}
        Sent: ${sent}
    Received: ${received}
Total Length: ${total_length}
 
Detail
------------------------------------------------------------------------------
<!-- BEGIN detail -->Part ${part_number}:
          To: ${detail.to_first} ${detail.to_last} (${detail.to_mailbox})
        From: ${detail.from_first} ${detail.from_last} (${detail.from_mailbox})
  Created By: ${detail.created_by} ${detail.by_first} ${detail.by_last}
        Sent: ${detail.sent}
    Received: ${detail.received}
      Length: ${detail.length}
<!-- END detail -->
------------------------------------------------------------------------------

HTML Body

VM101TEMPLATE.HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" "http://www.w3.org/TR/REC-html40/loose.dtd">
<html>
 
<head></head>
 
<body style="padding: 0; margin: 0; color: #000000; font-family: 80% Verdana, Arial, Helvetica, sans-serif; font-size: small;">
 
  <div style="margin: 3px; background-color: #00; border: 2px solid #000; padding: 5px; width: 98%;">
 
    <table>
      <tr>
        <td>
          <img alttext="logo" src="cid:logo" border="0">
        </td>
        <td>
          <div style="color: Black; font-family: 'Verdana'; font-weight: bold;">From: ${from_first} ${from_last}</div>
          <div style="color: Black; font-family: 'Verdana'; font-weight: bold; font-size: x-small;">Mailbox: ${from_mailbox}</div>
 
 
          <!-- BEGIN replytodelete -->
          <div style="font-size: xx-small;">To delete this message from your voice mailbox,<br>reply with original message body.</div>
          <div style="font-size: xx-small; display: none;">${mif}</div>
          <!-- END replytodelete -->
 
        </td>
      </tr>
    </table>
    <hr>
    <table width="100%" align="center">
      <tr>
        <td style="background-color: #ebf3ff; text-align: right; width: 30%;" bgcolor="#ebf3ff" align="right">To:</td>
        <td style="background-color: #ebf3ff; text-align: left;" bgcolor="#ebf3ff" align="left">${to_first} ${to_last} (${to_mailbox})</td>
      </tr>
      <tr>
        <td style="background-color: #ffffff; text-align: right; width: 30%;" bgcolor="#ffffff" align="right">From:</td>
        <td style="background-color: #ffffff; text-align: left;" bgcolor="#ffffff" align="left">${from_first} ${from_last} (${from_mailbox})</td>
      </tr>
      <tr>
        <td style="background-color: #ebf3ff; text-align: right; width: 30%;" bgcolor="#ebf3ff" align="right">Created By:</td>
        <td style="background-color: #ebf3ff; text-align: left;" bgcolor="#ebf3ff" align="left">${created_by} ${by_first} ${by_last}</td>
      </tr>
      <tr>
        <td style="background-color: #ffffff; text-align: right; width: 30%;" bgcolor="#ffffff" align="right">Sent:</td>
        <td style="background-color: #ffffff; text-align: left;" bgcolor="#ffffff" align="left">${sent}</td>
      </tr>
      <tr>
        <td style="background-color: #ebf3ff; text-align: right; width: 30%;" bgcolor="#ebf3ff" align="right">Received:</td>
        <td style="background-color: #ebf3ff; text-align: left;" bgcolor="#ebf3ff" align="left">${received}</td>
      </tr>
      <tr>
        <td style="background-color: #ffffff; text-align: right; width: 30%;" bgcolor="#ffffff" align="right">Total Length:</td>
        <td style="background-color: #ffffff; text-align: left;" bgcolor="#ffffff" align="left">${total_length}</td>
      </tr>
    </table>
    <div>Detail</div>
    <table width="100%" align="center" style="font-size: xx-small;">
      <th style="background-color: #3d80df; text-align: center; color: #ffffff;" bgcolor="#3d80df" align="center">To</th>
      <th style="background-color: #3d80df; text-align: center; color: #ffffff;" bgcolor="#3d80df" align="center">From</th>
      <th style="background-color: #3d80df; text-align: center; color: #ffffff;" bgcolor="#3d80df" align="center">Sent</th>
      <th style="background-color: #3d80df; text-align: center; color: #ffffff;" bgcolor="#3d80df" align="center">Created By</th>
      <th style="background-color: #3d80df; text-align: center; color: #ffffff;" bgcolor="#3d80df" align="center">Received</th>
      <th style="background-color: #3d80df; text-align: center; color: #ffffff;" bgcolor="#3d80df" align="center">Length</th>
 
 
      <tr>
        <!-- BEGIN detail -->
        <td align="center">${detail.to_first} ${detail.to_last} (${detail.to_mailbox})</td>
        <td align="center">${detail.from_first} ${detail.from_last} (${detail.from_mailbox})</td>
        <td align="center">${detail.sent}</td>
        <td align="center">${detail.created_by} ${detail.by_first} ${detail.by_last}</td>
        <td align="center">${detail.received}</td>
        <td align="center">${detail.length}</td>
      </tr>
      <!-- END detail -->
    </table>
    <hr>
    <div style="color: Silver; font-size: xx-small;">
      Provided by: <a href="http://www.duvoice.com" style="color: Silver; font-size: xx-small;">DuVoice</a> VeMail.
    </div>
 
  </div>
 
</body>
 
</html>