Deeptija: 1 revision

2012-06-14T10:14:04Z

1 revision

← Older revision

Revision as of 10:14, 14 June 2012

Suniaror: /* About HTML Notification Templates */

2012-06-03T09:09:36Z

About HTML Notification Templates

New page

'''Links to Other API pages:''' [[Cisco_Unity_Connection_APIs]]
{| align="right" border="1"
|align="center"|'''CUPI Guide Contents'''
|-
|[[Cisco Unity Connection Provisioning Interface (CUPI) API|API Overview ]]<br>[[Cisco Unity Connection Provisioning Interface (CUPI) API -- Index of All CUPI Documentation|Index of All CUPI Documentation]]
|}

__TOC__

== About HTML Notification Templates ==

In Cisco Unity Connection 9.0(1) and later, the administrator can use the CUPI APIs for template listing, viewing, creation, selection, and deletion. The settings from the template get applied to the notifications as they are sent. The administrator can create any number of the HTML-based templates and can further assign those templates for use to specific HTML-based notification devices.

== Listing of HTML Notification Templates ==

The following is an example of the GET request that lists all the notification templates
<pre>
GET https://<connection-server>/vmrest/notificationtemplates
</pre>

The following is an example of the response from the above *GET* request and the actual result will depend upon the information has been provided by you.

<pre>
New Template

Test Template

OK
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<NotificationTemplates total="2">
<NotificationTemplate>
<URI>/vmrest/notificationtemplates/f265c517-ec77-4b7c-9520-be007b8410c4</URI>
<NotificationTemplateID>f265c517-ec77-4b7c-9520-be007b8410c4</NotificationTemplateID>
<NotificationTemplateName>New Template</NotificationTemplateName>
</NotificationTemplate>
<NotificationTemplate>
<URI>/vmrest/notificationtemplates/cd684c05-c8e6-4897-8d79-73da5a36290</URI>
<NotificationTemplateID>cd684c05-c8e6-4897-8d79-73da5a36290</NotificationTemplateID>
<NotificationTemplateName>Test Template</ NotificationTemplateName>
</NotificationTemplate>
</NotificationTemplates>
</pre>

== Viewing of HTML Notification Templates ==

The following is an example of the GET request that lists the specific notification template represented by the provided value of notification template id:
<pre>
GET https://<connection-server>/vmrest/notificationtemplates/<notificationtemplateid>
</pre>
The following is an example of the response from the above *GET* request and the actual result will depend upon the information has been provided by you.

<pre>
Test Template

OK
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<NotificationTemplate>
<URI>/vmrest/notificationtemplates/cd684c05-c8e6-4897-8d79-73da5a36290</URI>
<NotificationTemplateID>cd684c05-c8e6-4897-8d79-73da5a36290</NotificationTemplateID>
<NotificationTemplateName>Test Template</NotificationTemplateName>
<Content><![CDATA[<HTML><TITLE>Notification</TITLE><BODY><H3>There is a voice message for you. </H3>
<BR>Please click on following link to access voice message.%MESSAGE_MINI_PLAY%<H4><I>
Disclaimer: This email may contain confidential and
privileged material for the sole use of the intended recipient.</I></H4></BODY></HTML>]]>
</Content>
</NotificationTemplate>
</pre>

== Creating the HTML Notification Templates ==

The following is an example of the POST request that creates a notification template

<pre>

POST https://<connection-server>/vmrest/notificationtemplates:
</pre>
<pre>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<NotificationTemplate>
<NotificationTemplateName>New Template</ NotificationTemplateName>
<Content>![CDATA[<HTML><TITLE>Notification</TITLE><BODY><H3>There is a voice message for you.</H3><BR>Please click on following
link to access voice message.%MESSAGE_MINI_PLAY%<H4> <br> Message Status : <img src="%MESSAGE_STATUS%" /> <br> <I>%Disclaimer%
By using custom variable : This email may contain confidential and privileged material
for the sole use of the intended recipient.</I></H4></BODY></HTML>]]</Content>
</NotificationTemplate>
</pre>

The following is an example of the response from the above *Post* request.
<pre>
/vmrest/notificationtemplates/a1876b36-1095-488b-b810-20554ff51c42
</pre>

== Updating the HTML Notification Templates ==

The following is an example of the PUT request that allows you to update the content of the notification template by mentioning the notification template ID

<pre>
PUT https://<connection-server>/vmrest/notificationtemplates/<notificationtemplateid>
</pre>

<pre>

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<NotificationTemplate>
<NotificationTemplateName>Test Template</ NotificationTemplateName>
<Content>![CDATA[<HTML><TITLE>Notification</TITLE><BODY><H3>There is a voice message for you. </H3>
<BR>Please click on following link to access voice message.%MESSAGE_MINI_PLAY%<H4><I>
Disclaimer: This email may contain confidential and
privileged material for the sole use of the intended recipient.</I></H4></BODY></HTML>]]
</Content>
</NotificationTemplate>
</pre>

The output for this request returns the successful response code.

== Deleting the HTML Notification Templates ==

The following is an example of the DELETE request that deletes a specific notification template where you need to mention the notification template ID:
<pre>
DELETE https://<connection-server>/vmrest/notificationtemplates/<notificationtemplateid
</pre>
The output for this request returns the successful response code.

== Listing Template Subscribership for the HTML Notification Templates ==

The following is an example that lists the subscribership for a particular notification template. Using this API the administrator will be able to view list of subscribers who are using a specific notification template.

<pre>
GET /vmrest/notificationtemplates/<notificationtemplateid>/subscribers

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Users total=”2”>
<User><URI>/vmrest/users/24cb82fc-5153-4c3f-abc7-ef442b27b4e9</URI></User>
<User><URI>/vmrest/users/8117171c-a633-4ecf-b847-d6d15db41818</URI></User>
</Users>
</pre>

[[Category:Cisco Unity Connection Provisioning Interface (CUPI) API]]

Cisco Unity Connection Provisioning Interface (CUPI) API -- HTML Notification Templates - Revision history

Deeptija: 1 revision

Suniaror: /* About HTML Notification Templates */