Anilve at 17:50, 15 April 2012

2012-04-15T17:50:48Z

← Older revision		Revision as of 17:50, 15 April 2012
Line 1:		Line 1:
-	~~'''Links to Other API pages:''' [[Cisco_Unity_Connection_APIs]]~~	+	{\| border="1" class="wikitable"
-	{\| ~~align="right"~~ border="1"	+
-	~~\|align~~="~~center~~"~~\|'''CUPI for End Users Guide Contents'''~~	+
	\|-		\|-
-	~~\|[[Cisco Unity Connection Provisioning Interface (CUPI) API~~ -~~- For End Users\|API Overview ]]<br>[[Cisco Unity Connection Provisioning Interface~~ (~~CUPI) API -- For End Users -- Basics~~, ~~Voice Name~~, ~~Greetings \|Basics, Voice Name, Greetings ]]<br>[[Cisco Unity Connection Provisioning Interface (CUPI~~) ~~API -- For End Users -- Unified Messaging Accounts~~ \|~~Unified Messaging Accounts ]]<br>~~[[~~Cisco Unity Connection Provisioning Interface~~ (CUPI) ~~API~~ -- ~~For End Users -- Alternate Devices~~ \|~~Alternate Devices ]]<br>[[Cisco Unity Connection Provisioning Interface (~~CUPI~~) API -- For~~ End Users -- Directory \|Directory ]]<br>[[Cisco Unity Connection Provisioning Interface (CUPI) API -- For End Users -- Enabling and Disabling Greetings \|Enabling and Disabling Greetings ]]<br>[[Cisco Unity Connection Provisioning Interface (CUPI) API -- For End Users -- Location \|Location ]]<br>[[Cisco Unity Connection Provisioning Interface (CUPI) API -- For End Users -- Private Lists \|Private Lists ]]<br>[[Cisco Unity Connection Provisioning Interface (CUPI) API -- For End Users -- SMTP Proxy Addresses \|SMTP Proxy Addresses ]]<br>[[Cisco Unity Connection Provisioning Interface (CUPI) API -- For End Users -- System Configuration \|System Configuration ]]<br>[[Cisco Unity Connection Provisioning Interface (CUPI) API -- For End Users -- Transfer Options \|Transfer Options ]]	+	! style="background-color: rgb(255, 215, 0);" \| '''Back to:''' [[Cisco_Unity_Connection_Provisioning_Interface_(CUPI)_API_--_For_End_Users\|CUPI for End Users Overview ]]
	\|}		\|}

Gscorbin: 1 revision

2010-12-14T00:05:09Z

1 revision

← Older revision

Revision as of 00:05, 14 December 2010

Gscorbin at 23:02, 13 December 2010

2010-12-13T23:02:34Z

New page

'''Links to Other API pages:''' [[Cisco_Unity_Connection_APIs]]
{| align="right" border="1"
|align="center"|'''CUPI for End Users Guide Contents'''
|-
|[[Cisco Unity Connection Provisioning Interface (CUPI) API -- For End Users|API Overview ]] [[Cisco Unity Connection Provisioning Interface (CUPI) API -- For End Users -- Basics, Voice Name, Greetings |Basics, Voice Name, Greetings ]] [[Cisco Unity Connection Provisioning Interface (CUPI) API -- For End Users -- Unified Messaging Accounts |Unified Messaging Accounts ]] [[Cisco Unity Connection Provisioning Interface (CUPI) API -- For End Users -- Alternate Devices |Alternate Devices ]] [[Cisco Unity Connection Provisioning Interface (CUPI) API -- For End Users -- Directory |Directory ]] [[Cisco Unity Connection Provisioning Interface (CUPI) API -- For End Users -- Enabling and Disabling Greetings |Enabling and Disabling Greetings ]] [[Cisco Unity Connection Provisioning Interface (CUPI) API -- For End Users -- Location |Location ]] [[Cisco Unity Connection Provisioning Interface (CUPI) API -- For End Users -- Private Lists |Private Lists ]] [[Cisco Unity Connection Provisioning Interface (CUPI) API -- For End Users -- SMTP Proxy Addresses |SMTP Proxy Addresses ]] [[Cisco Unity Connection Provisioning Interface (CUPI) API -- For End Users -- System Configuration |System Configuration ]] [[Cisco Unity Connection Provisioning Interface (CUPI) API -- For End Users -- Transfer Options |Transfer Options ]]
|}

__TOC__

== About Alternate Devices ==

The level of access a user has to his or her Alternate Devices (or Alternate Extensions) is determined by the user's class of service. The four levels of access are:

* No access
* Read access to administrator-defined alternate devices only
* Read/Write access to user-defined alternate devices only
* Full access (read access to administrator-defined alternate devices and read/write access to user-defined alternate devices)

== Listing and Viewing ==

To retrieve a list of one's alternate devices, use the GET method with URI /vmrest/user/alternatedevices. Note that only alternate devices visible to the user (determined by the user's access level defined in his or her Class of Service) are returned. In the example below, the user has full access to his or her alternate devices, and the GET request yields a response that indicates the user has three alternate devices, two of which are administrator-defined and one user-defined:

<pre>
GET http://<connection-server>/vmrest/user/alternatedevices
</pre>

The following is the response from the GET request above:

<pre>
200
OK
<?xml version="1.0" encoding="UTF-8"?>
<AlternateDevices total="3">
<AlternateDevice>
<URI>/vmrest/user/alternatedevices/e14bc9ef-57af-401c-a826-3e7603a36106</URI>
<DisplayName>Alt Ext</DisplayName>
<DtmfAccessId>3232</DtmfAccessId>
<ObjectId>e14bc9ef-57af-401c-a826-3e7603a36106</ObjectId>
<UserDefined>false</UserDefined>
</AlternateDevice>
<AlternateDevice>
<URI>/vmrest/user/alternatedevices/4960bf32-6c4e-4a6a-97e1-dfe2858f89a6</URI>
<DisplayName>Work Fax</DisplayName>
<DtmfAccessId>0329</DtmfAccessId>
<ObjectId>4960bf32-6c4e-4a6a-97e1-dfe2858f89a6</ObjectId>
<UserDefined>false</UserDefined>
</AlternateDevice>
<AlternateDevice>
<URI>/vmrest/user/alternatedevices/2d7e426d-4e43-4d5e-8c3e-eb498856dcfc</URI>
<DisplayName>User-Defined Home Phone</DisplayName>
<DtmfAccessId>5551234</DtmfAccessId>
<ObjectId>2d7e426d-4e43-4d5e-8c3e-eb498856dcfc</ObjectId>
<UserDefined>true</UserDefined>
</AlternateDevice>
</AlternateDevices>
</pre>

To retrieve a specific Alternate Device by its object ID:

<pre>
GET http://<connection-server>/vmrest/user/alternatedevices/2d7e426d-4e43-4d5e-8c3e-eb498856dcfc
</pre>

The following is the response from the GET request above:

<pre>
200
OK
<?xml version="1.0" encoding="UTF-8"?>
<AlternateDevice>
<DisplayName>User-Defined Home Phone</DisplayName>
<DtmfAccessId>5551234</DtmfAccessId>
<ObjectId>2d7e426d-4e43-4d5e-8c3e-eb498856dcfc</ObjectId>
<UserDefined>true</UserDefined>
</AlternateDevice>
</pre>

== Searching ==

To retrieve only the user-defined alternate devices or only the administrator-defined ones, append the query parameter "userDefined=true" or "userDefined=false" respectively. For example, the following GET returns only the administrator-defined devices (assuming the user has access to administrator-defined devices):

<pre>
GET http://<connection-server>/vmrest/user/alternatedevices?userDefined=false
</pre>

The following is the response from the GET request above:

<pre>
200
OK
<?xml version="1.0" encoding="UTF-8"?>
<AlternateDevices total="2">
<AlternateDevice>
<URI>/vmrest/user/alternatedevices/e14bc9ef-57af-401c-a826-3e7603a36106</URI>
<DisplayName>Alt Ext</DisplayName>
<DtmfAccessId>3232</DtmfAccessId>
<ObjectId>e14bc9ef-57af-401c-a826-3e7603a36106</ObjectId>
<UserDefined>false</UserDefined>
</AlternateDevice>
<AlternateDevice>
<URI>/vmrest/user/alternatedevices/4960bf32-6c4e-4a6a-97e1-dfe2858f89a6</URI>
<DisplayName>Work Fax</DisplayName>
<DtmfAccessId>0329</DtmfAccessId>
<ObjectId>4960bf32-6c4e-4a6a-97e1-dfe2858f89a6</ObjectId>
<UserDefined>false</UserDefined>
</AlternateDevice>
</AlternateDevices>
</pre>

== Creating ==

To create a new Alternate Device, use the POST method. The only required field for creating an alternate device is the DtmfAccessId. In addition to the DtmfAccessId, you can also specify the device's Display Name. For example, assuming a user's Class of Service allows access to user-defined Alternate Devices, the user can create a new one as follows:

<pre>
POST http://<connection-server>/vmrest/user/alternatedevices

<AlternateDevice>
<DisplayName>New Device</DisplayName>
<DtmfAccessId>1001</DtmfAccessId>
</AlternateDevice>
</pre>

The following is the response from the POST request above:

<pre>
201
Created
/vmrest/user/alternatedevices/f4fd32c2-e6b7-48ff-8836-4ac2c100f9fc
</pre>

== Updating and Deleting ==

Users are not allowed to update or delete administrator-defined alternate devices. They can, however, update or delete user-defined ones, assuming their Class of Service allows them access to user-defined alternate devices.

For example, to change the DtmfAccessId of the user-defined alternate device in the Creating example above, use the PUT method as follows:

<pre>
PUT http://<connection-server>/vmrest/user/alternatedevices/f4fd32c2-e6b7-48ff-8836-4ac2c100f9fc

<AlternateDevice>
<DtmfAccessId>1002</DtmfAccessId>
</AlternateDevice>
</pre>

Similarly, to delete this user-defined alternate device, use the DELETE method as follows:

<pre>
DELETE http://<connection-server>/vmrest/user/alternatedevices/f4fd32c2-e6b7-48ff-8836-4ac2c100f9fc
</pre>

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

Cisco Unity Connection Provisioning Interface (CUPI) API -- For End Users -- Alternate Devices - Revision history

Anilve at 17:50, 15 April 2012

Gscorbin: 1 revision

Gscorbin at 23:02, 13 December 2010