Cisco Unified MeetingPlace Release 8.0 -- Customizing Email Notifications for Cisco Unified MeetingPlace

From DocWiki

(Difference between revisions)
Jump to: navigation, search
m (About Email Notification Templates and Language Property Files)
m (Notification Items)
 
(One intermediate revision not shown)
Line 309: Line 309:
|
|
$cisco_ReOccuringConference
$cisco_ReOccuringConference
 +
 +
|-
 +
|
 +
 +
Recurring monthly by day of week meeting
 +
|
 +
$cisco_DayInWeek
 +
 +
|-
 +
|
 +
 +
Recurring weekly/biweekly meetings
 +
|
 +
$cisco_Sun
 +
 +
$cisco_Mon
 +
 +
$cisco_Tue
 +
 +
$cisco_Wed
 +
 +
$cisco_Thu
 +
 +
$cisco_Fri
 +
 +
$cisco_Sat
 +
 +
|-
 +
|
 +
 +
Recurring meetings daily/weekdays - maximum number of days that meeting can reoccur
 +
|
 +
$cisco_NumDays
 +
 +
|-
 +
|
 +
 +
Recurring monthly by day meetings - day in month (e.g. 24)
 +
|
 +
$cisco_DayInMonth
 +
 +
|-
 +
|
 +
 +
Recurring monthly by day/monthly by day of week meetings - number of occurrences of recurring meeting
 +
|
 +
$cisco_NumMonths
 +
 +
|-
 +
|
 +
 +
Recurring weekly/biweekly meetings - number of occurrences of recurring meeting
 +
|
 +
$cisco_NumOccurences
 +
 +
|-
 +
|
 +
 +
URL to browser test depending on Cisco Unified MeetingPlace configuration - browser test not required for WebEx meetings
 +
|
 +
$cisco_TestBrowser
|}
|}

Latest revision as of 23:11, 12 December 2012

Main page: Cisco Unified MeetingPlace, Release 8.0

Up one level: Configuration



Contents

About Email Notification Templates and Language Property Files

Email notification templates specify which information to include in the email notifications. The templates also determine the order and formatting used to present the specified information.


Although email notification templates are editable, they are designed to be language-independent by containing tags instead of actual email message content. Each tag is translated by the Cisco Unified MeetingPlace mail system into the text defined in editable language property files. A unique language property file is available for each language you install and enable on the Cisco Unified MeetingPlace server.


Topics in this section include:


How the Mail System Works

The Cisco Unified MeetingPlace mail system uses the following process to send email notifications to users:

  1. The mail system selects the appropriate template, depending on the type of email notification that is required. The templates are listed in Table: Email Notification Templates.
  2. The mail system identifies the tags in the template
    1. Plain text in the template is left as plain text in the email notification.
    2. A dollar sign ($) indicates the beginning of a tag that is replaced by the definition in the language property file. For example:
      $notify_to_join_meeting
    3. A space or the end of a line indicates the end of a tag.
  3. The mail system checks which language property file to use, depending on the Language configured in the user profile of the email recipient.
  4. The mail system creates the email notification by translating the tags in the template to the matching tag definitions in the language property file:
    1. An equal (=) sign indicates the beginning of a tag definition. For example:
      notify_to_join_meeting = To join the meeting
    2. The end of a line indicates the end of a tag definition.
    3. For each match, the mail system replaces the tag with the content defined in the language property file.
    4. If there is no match, the tag is included in the email notification, including the dollar sign ($).
    5. Tag definitions can contain tags that are defined by other system components, such as the system scheduler. For example:
      notify_details=The meeting details are:
      notify_id=ID: $cisco_MTGID
    The scheduler component typically defines tags that appear on the scheduling page of the web user portal, such as the name of the meeting owner, meeting subject, and start time.
  5. The mail system sends the completed email notification to the SMTP server.


Related Topics


Example of Editing an Email Notification Template and a Language Property File

This example shows how to do the following:

  1. Add a new tag, called $custom_greeting, to an email notification template.
  2. Define the tag in a language property file.


Note: If you enable multiple languages on your system, you must define new tags in all language property files.


This sample shows the placement of the new tag at the beginning of an email notification template:

$custom_greeting

$notify_meeting_subject $notify_meeting_name

$notify_date_time $notify_when

$notify_dur $notify_duration

$notify_frequency $notify_recur_pattern


This sample shows the definition of the new tag in the U.S. English language property file:

##############################################

## English (USA) language property file ##

##############################################

## ALL TEMPLATES

notify_title=Cisco Unified MeetingPlace meeting notification

$custom_greeting=Good day. You have been invited to the following meeting:

notify_details=The meeting details are:

notify_mtg_id=Meeting ID:

notify_meeting_id=$cisco_MTGID

notify_id=ID: $cisco_MTGID


Related Topics


Notification Items

The following table provides a list of notification items and tags that are commonly used by Cisco Unified MeetingPlace for Outlook and SMTP notifications.


Notification Item Notification Tag

Meeting ID

$cisco_MTGID

Click-to-attend link

$cisco_CtaUrl

Dial-in number

$cisco_DialIn

Meeting name

$cisco_TextName

Password

$cisco_Password

Meeting type

$cisco_MeetingType

Meeting template

$cisco_MeetingTemplate

Scheduler

$cisco_SchedulerFirstName

$cisco_SchedulerLastName

Current meeting date

$cisco_Month

$cisco_Day

$cisco_Year

Previous meeting date

$cisco_Orig_Month

$cisco_Orig_Day

$cisco_Orig_Year

Current meeting time

$cisco_Hour

$cisco_Min

$cisco_AMPM

$cisco_TimeZone

Previous meeting time

$cisco_Orig_Hour

$cisco_Orig_Min

$cisco_Orig_AMPM

$cisco_TimeZone

Scheduler phone

$cisco_SchedulerTelephone

Scheduler e-mail

$cisco_SchedulerEmail

Cisco Unified MeetingPlace phone number

$cisco_DID_Telephone

Alternate phone number 1

$cisco_Alt_Telephone

Label for alternate phone number 1

$cisco_Alt_Telephone_Label1

Alternate phone number 2

$cisco_Alt_Telephone2

Label for alternate phone number 2

$cisco_Alt_Telephone_Label2

Alternate phone number 3

$cisco_Alt_Telephone3

Label for alternate phone number 3

$cisco_Alt_Telephone_Label3

Duration

$cisco_DurHours

$cisco_DurMins

Recurrence pattern

$cisco_ReOccuringConference

Recurring monthly by day of week meeting

$cisco_DayInWeek

Recurring weekly/biweekly meetings

$cisco_Sun

$cisco_Mon

$cisco_Tue

$cisco_Wed

$cisco_Thu

$cisco_Fri

$cisco_Sat

Recurring meetings daily/weekdays - maximum number of days that meeting can reoccur

$cisco_NumDays

Recurring monthly by day meetings - day in month (e.g. 24)

$cisco_DayInMonth

Recurring monthly by day/monthly by day of week meetings - number of occurrences of recurring meeting

$cisco_NumMonths

Recurring weekly/biweekly meetings - number of occurrences of recurring meeting

$cisco_NumOccurences

URL to browser test depending on Cisco Unified MeetingPlace configuration - browser test not required for WebEx meetings

$cisco_TestBrowser


Related Topics

How to Customize Email Notifications


Editing Templates for Email Notifications

Before You Begin
  • If you plan to modify any language property files while editing email notification templates, we recommend that you first save a copy of the existing language property files, in case you want to return to the previous versions. See the Downloading a Language Property File.
  • Tags are case-sensitive.
  • As you edit the email notification templates, keep track of whether you add any tags that begin with $cisco_, because these changes will not take effect until after a system restart.
  • See the Example of Editing an Email Notification Template and a Language Property File.


Restrictions
  • You cannot customize email notification templates for a single user. Template changes affect all system-generated email notifications.
  • Email notification graphics cannot be modified or replaced. Also, new graphics cannot be added to email notifications.
  • The HTML editor has these restrictions:
    • Only Internet Explorer enables you to view and edit the HTML output. All supported browsers enable you to view and edit the HTML source.
    • Only Internet Explorer provides the HTML-formatting toolbar.
    • In the HTML-formatting toolbar, use the Background Color button to modify the background color of text. To instead modify the background color of table cells or the entire page, use an external HTML editor, or manually edit the HTML source by selecting the View HTML Source button (<>).
  • The HTML templates display only the size and location of each graphic. The actual graphics cannot be previewed through the Administration Center and are displayed only in actual email notifications.
  • (Microsoft Outlook front-end integration) Only one email notification template, plain-text NotifySchedule, is used for the Microsoft Outlook calendar notifications.
  • (Microsoft Outlook back-end integration) HTML-formatted Microsoft Outlook calendar notifications will not include any graphics.
  • If you upgrade your system from an earlier release, the system compares the email template version information of the previous installation with the current installation. If the email template version information is the same, the system does not overwrite the customized email templates.
If the email template version information is different or if there is no version information from the previous installation, the system overwrites all custom email notification templates and replaces them with the standard email notification templates for the later release.
You can access the current email templates through System Configuration > Email Notifications > Email Notification Templates or go to /opt/cisco/meetingplace/var/mail/res/email_templates.
The system copies all of the previous notification templates to a backup directory: /opt/cisco/meetingplace/var.<version> /mail/res/email_templates, where <version> identifies the earlier Cisco Unified MeetingPlace release, for example, 8.0.0.40.


Procedure
  1. Sign in to the Administration Center.
  2. Select System Configuration > Email Notifications > Email Notification Templates.
  3. Using Table: Basic and Advanced Master Template Editing Functionality, decide whether to use the basic editing page or the advanced editing page to edit the email notification master templates.


Table: Basic and Advanced Master Template Editing Functionality
Editing Functionality Basic Advanced

Template selection

Yes

Yes

Format selection between HTML and text

Yes

Yes

Language selection

-

Yes

HTML editor (1)

Yes

Yes

Language property file editor

-

Yes

Preview

Yes

Yes


Footnote 1: See the Restrictions for the HTML editor.

4. Select Edit Templates (Basic) or Edit Templates (Advanced).
5. Using Table: Email Notification Templates, select which template you want to modify.


Table: Email Notification Templates
Template Description

DSTChange

Notifies the owners of meetings that need to be rescheduled due to a daylight saving time change to the Application Server.

EmailBlast

Sends one or all user groups an email message from the system administrator. Typically used to inform users of maintenance tasks that might affect their ability to use Cisco Unified MeetingPlace. See Sending Email Blasts from Cisco Unified MeetingPlace module.

NotifyCancel


SMTPNotifyCancel

Notifies the meeting owner and invitees that a single-occurrence meeting was cancelled or that one occurrence of a recurring meeting was cancelled.

NotifyCancelAll


SMTPNotifyCancelAll

Notifies the meeting owner and invitees that all occurrences of a recurring meeting were cancelled.

NotifyReSchedule


SMTPNotifyReSchedule

Notifies the meeting owner and invitees that the meeting was rescheduled.

NotifySchedule


SMTPNotifySchedule

Notifies the meeting owner and invitees of a new scheduled meeting.

NotifyScheduleRes

Not used in this release.


The templates whose names begin with "SMTP" are for notifications that are sent to users whose profiles specify the email type as SMTP. The SMTP templates include more meeting details than the non-SMTP templates. This is because non-SMTP email notifications are used by integrated clients (such as Microsoft Outlook) which display some of the meeting details (such as the start time and duration) elsewhere in the client user interface.
For templates that have both SMTP and non-SMTP versions, you must modify both versions to keep them consistent with each other. Otherwise, users might receive different information about the same meeting, depending on the Email type and format setting in each user profile.
6. Select which format (HTML or text) you want to modify.
You must modify both the HTML and plain text formats to keep them consistent with each other. Otherwise, users might receive different information about the same meeting, depending on the Email type and format setting in each user profile.
7. Modify the template. See these topics:
8. To preview the template, select Preview.
9. Close the preview window when finished.
10. Select Save to save your template changes.
11. Repeat Step 5 through Step 10 for any other template versions (SMTP, non-SMTP) and formats (HTML, text) as required for consistency.
12. If you added any tags that begin with "$cisco_", then you need to restart the system to make those changes take effect:
Note: A system restart terminates all existing call connections. Proceed only during a scheduled maintenance period or during a period of extremely low usage.
  1. Sign in to the CLI of the Application Server.
  2. Enter mpx_sys restart.
Related Topics

Editing Language Property Files

Language property files define the text translations of tags used in email notification templates.


Before You Begin


Restrictions
  • You cannot customize language property files or email notification templates for a single user. These changes affect all system-generated email notifications.


Procedure
  1. Sign in to the Administration Center.
  2. Select System Configuration > Email Notifications > Email Notification Templates > Edit Language Property Files.
  3. Choose the language property file to edit.
  4. Modify the language property file.
  5. Select Save.


Related Topics


What To Do Next

Because the same tags are used in multiple templates, you should preview all templates after editing a language property file. See the Editing Templates for Email Notifications.


Downloading a Language Property File

This task is useful for saving a copy of a working language property file before you edit it, in case you decide to revert to the previous version. You can also download a language property file to your PC, modify it using a text editor such as WordPad, and then upload the language property file to Cisco Unified MeetingPlace.


Procedure
  1. Sign in to the Administration Center.
  2. Select System Configuration > Email Notifications > Email Notification Templates > Download Language Property File.
  3. Choose the language property file to download.
  4. Select Download.
  5. Select Open or Save.
    If you are prompted with an Open With dialog box, choose a text editor, such as WordPad.


Related Topics


Uploading a Language Property File

Performing this task is useful if you edit the language property file and decide to revert to a previously downloaded language property file. You can also upload a language property file that you modified on your PC.


Before You Begin
  • Uploaded language property files must have the exact same case-sensitive filename as an existing language property file on the system. For example, the U.S. English language property file name is Templates_en_US.properties.
  • To see the valid filename of a language property file, complete Step 1 through Step 4 in the Downloading a Language Property File. The filename appears in the File Download window.


Procedure
  1. Sign in to the Administration Center.
  2. Select System Configuration > Email Notifications > Email Notification Templates > Upload Language Property File.
  3. Select the language.
  4. Select Browse, find the language property file, and select Open.
  5. Select Upload.


Related Topics

Rating: 1.0/5 (1 vote cast)

Personal tools