REST API Support for Squared UC in Unity

REST API Support for Squared UC in Unity Connection 11. 5 EDCS-1554157 July 15, 2015 © 2013 Cisco System Inc. All rights reserved Cisco Confidential 1

Notice The information in this presentation is provided under Non. Disclosure agreement and should be treated as Cisco Confidential. Under no circumstances is this information to be shared further without the express consent of Cisco. Any roadmap item is subject to change at the sole discretion of Cisco, and Cisco will have no liability for delay in the delivery or failure to deliver any of the products or features set forth in this document. © 2013 Cisco System Inc. All rights reserved Cisco Confidential 2

v Introduction v CUPI API § Users query enhancement v CUMI API § 'USN' and 'UID Validity' information of supported mailbox folders § Message query support with USN 'greater than' search criteria © 2013 Cisco System Inc. All rights reserved Cisco Confidential 3

Release 11. 5 onwards, below enhancements have been incorporated: • CUPI API § Added support for searching of users based on ‘Corporate Email Address’ • CUMI API § § Added support for mailbox synchronization based on ‘USN’ and ‘UID Validity’ attributes Added support to search user messages with USN ‘greater than’ a given value © 2013 Cisco System Inc. All rights reserved Cisco Confidential 4

. © 2013 Cisco System Inc. All rights reserved Cisco Confidential 5

Enhanced CUPI API to allow searching of users based on "Corporate Email Address". Supported CUPI API Query Structures are : • http: //<connectionserver>/vmrest/users? query=(emailaddress is abc@cisco. com) • http: //<connectionserver>/vmrest/users? query=(emailaddress startswith abc@cisco. com) • http: //<connectionserver>/vmrest/users? query=(emailaddress isnotnull) • http: //<connectionserver>/vmrest/users? query=(emailaddress isnull) NOTE : If there are more than one user with the same ‘Corporate Email Address’, all users will be listed. © 2013 Cisco System Inc. All rights reserved Cisco Confidential 6

© 2013 Cisco System Inc. All rights reserved Cisco Confidential 7

. © 2013 Cisco System Inc. All rights reserved Cisco Confidential 8

To extend the functionality of mailbox folders, additional attributes will be returned on executing the mailbox query: • USN (Unique Sequence Number) • UID Validity (Unique Identifier Validity) – Creation time of mailbox. © 2013 Cisco System Inc. All rights reserved Cisco Confidential 9

Earlier response attributes: • URI • Display Name • Message Count © 2013 Cisco System Inc. All rights reserved Cisco Confidential 10

New attributes shown in the response below: • USN • UID Validity NOTE : Doing any operation on Inbox folder will impact the USN of both ‘Inbox’ and ‘Deleted’ folder. © 2013 Cisco System Inc. All rights reserved Cisco Confidential 11

Sending an HTTP GET Request to the URI, server generated response will be as shown below: © 2013 Cisco System Inc. All rights reserved Cisco Confidential 12

© 2013 Cisco System Inc. All rights reserved Cisco Confidential 13

© 2013 Cisco System Inc. All rights reserved Cisco Confidential 14

. © 2013 Cisco System Inc. All rights reserved Cisco Confidential 15

CUMI API has been extended to fetch the messages having USN greater than any given value. Supported CUMI API query structure for Inbox/Sent/Deleted folder is: • http: //<connectionserver>/vmrest/mailbox/folders/<mailboxfolder>/messages? userobjectid=<userobjectid>&<usngreaterthan= number> Sample query: • http: //<connectionserver>/vmrest/mailbox/folders/<inbox>/message s? userobjectid=<8790536 f-d 391 -4273 -843 dcbe 466 a 9 f 938>&usngreaterthan=<6> © 2013 Cisco System Inc. All rights reserved Cisco Confidential 16

Sending an HTTP GET Request to the URI, server generated response will be as shown below: © 2013 Cisco System Inc. All rights reserved Cisco Confidential 17

© 2013 Cisco System Inc. All rights reserved Cisco Confidential 18

© 2013 Cisco System Inc. All rights reserved Cisco Confidential 19

Find Troubleshooting tips at the below link: • http: //docwiki. cisco. com/wiki/Cisco_Unity_Connection_APIs_-_Troubleshooting © 2013 Cisco System Inc. All rights reserved Cisco Confidential 20

Doc Wiki Links: • http: //docwiki-dev. cisco. com/wiki/Cisco_Unity_Connection_Provisioning_Interface_(CUPI)_API_-User_API#Listing_Users_based_on_Email_Address • http: //docwikidev. cisco. com/wiki/Cisco_Unity_Connection_Messaging_Interface_%28 CUMI%29_API_-_Using_the_CUMI_API#Filtering © 2013 Cisco System Inc. All rights reserved Cisco Confidential 21

Thank you. © 2013 Cisco System Inc. All rights reserved Cisco Confidential 22