In this article
dropdown icon
Supported XML objects and URIs
    Supported XML objects
    Supported URIs
Add an XSI service to Cisco Unified CM
Subscribe to an XSI service
Add an XSI service as a line
Configure XML applications and services on Cisco Wireless Phone 9821 (Unified CM)
list-menuIn this article
list-menuFeedback?

Read this article for the supported XML objects, URIs, and the steps for configuring the XSI services on Unified CM. This Help article is for Cisco Wireless Phone 9821 registered to Cisco Unified Communications Manager (Unified CM).

XML Services Interface (XSI) is a protocol that allows communication between applications and the phone system. You can add your own XSI services to your phone using the supported XML objects and URIs. After subscribing the phone to the services, users can access all the configured services on the phone.

On Cisco Wireless Phone 9821, you can provision XSI services to various apps or buttons as follows.

  • Provision Directory services to the Contacts 9821 Contacts app icon app.
  • Provision Standard IP Phone Services (such as Extension Mobility) to the Apps 9821 Apps app icon app, the Applications 9821 Applications button button, or lines on a phone.

For more details about the XSI service configuration, see Cisco Unified IP Phone Services Application Development Notes.

Supported XML objects and URIs

See the following lists for the XML objects and URIs that Cisco Wireless Phone 9821 supports.

For more information about how to use the XML objects and URIs, see Cisco Unified IP Phone Services Application Development Notes.

Supported XML objects

  • CiscoIPPhoneMenu

  • CiscoIPPhoneText

  • CiscoIPPhoneInput

  • CiscoIPPhoneDirectory

  • CiscoIPPhoneImage

  • CiscoIPPhoneImageFile

  • CiscoIPPhoneGraphicMenu

  • CiscoIPPhoneGraphicFileMenu

  • CiscoIPPhoneIconMenu

  • CiscoIPPhoneIconFileMenu

  • CiscoIPPhoneExecute

  • CiscoIPPhoneResponse

  • CiscoIPPhoneError

  • CiscoIPPhoneStatus

  • CiscoIPPhoneStatusFile

Supported URIs

  • Key

  • Display

  • RTP

  • Play

  • XSI Audio path control

  • Device

  • Notify

  • Application

  • Init

  • QueryStringParam

  • Dial

  • EditDail

  • SendDigits

  • Viberate

  • Softkey

Add an XSI service to Cisco Unified CM

Before you can subscribe your phones to a service, configure the feature as an XML service first.

1

In Cisco Unified Communications Manager Administration, select Device > Device Settings > Phone Services.

2

Click Add New.

3

In the Service Name field, enter a name for the service.

4

In the Service URL field, enter the service URL.

Here are the example URLs for Extension Mobility and directory services:

  • Extension Mobility (EM):

    http://<CUCM IP Address>:8080/emapp/EMAppServlet?device=#DEVICENAME#

    For more setups for EM, see Extension Mobility.

  • Directories:

    Corporate directory: http://<CUCM IP Address>:8080/ccmip/xmldirectoryinput.jsp

    Personal address book: http://<CUCM IP Address>/ccmpd/pdCheckLogin.do?name=#DEVICENAME#

    Fast dial: http://<CUCM IP Address>/ccmpd/pfdGetList.do?name=#DEVICENAME#

CUCM IP Address is the IP address of the Cisco Unified Communications Manager where the XML service is activated and running. It can either be an IPv4 or an IPv6 address.

5

In the Service Category field, choose XML Service.

6

In the Service Type field, choose where the service is provisioned.

  • Standard IP Phone Service: Choose this option for standard IP phone services. Users can use the Apps 9821 Apps app icon app, the Applications 9821 Applications button button, or a line on the screen to access these services.
  • Directories: Choose this option for directory services. Users can use Contacts 9821 Contacts app icon app to access the directories.
  • Messages: This option does not take effect.
7

Select the Enable check box.

8

Click Save.

If you change the service URL, remove an IP Phone service parameter, or change the name of a phone service parameter for a phone service to which users are subscribed, you must click Update Subscriptions to update all currently subscribed users with the changes; otherwise, users must resubscribe to the service to rebuild the correct URL.

Subscribe to an XSI service

Before users can access the XSI services, you must subscribe their phones to the services.

Before you begin

The XSI services have been added to your phone system through Cisco Unified Communications Manager Administration.

1

Do one of the following actions in Cisco Unified Communications Manager Administration:

  • To subscribe service for a specific phone:

    Select Device > Phone, specify search criteria, click Find, and then select the phone which users will use.

  • To subscribe service for a group of phones:

    Select Device > Device Settings > Device Profile, specify search criteria, click Find, and then select the desired device profile.

2

From the Related Links drop-down list, select Subscribe/Unsubscribe Services, and then click Go.

3

From the Select a Service drop-down list, choose the desired service.

4

Click Next, and then Subscribe.

5

Click Save and close the popup window.

Add an XSI service as a line

You can add XSI services as lines on Cisco Wireless Phone 9821so that your users can access them easily by pressing the Select button.

Before you begin

Add and activate the XSI service and subscribe your phones to the service.

1

In Cisco Unified Communications Manager Administration, select Device > Phone, specify search criteria, click Find, and then choose the desired phone.

2

In the Association list on the left, click Add a new SURL.

If the Add a new SURL option is unassociated with the phone, click Modify Button Items and add the option to the phone button template before you proceed.

3

In the Configure Service URL Buttons window, select the desired service in the list and specify a label name for it.

4

Click Save and then close the window.

5

Click Save and Apply Config.

Was this article helpful?
Was this article helpful?