Page 3 - C O N T E N T S; Preface; Overview; New and Changed Information; CiscoIPPhone XML Objects
iii Cisco Unified IP Phone Services Application Development Notes OL-20949-01 C O N T E N T S Preface vii Overview vii Revision History vii Audience vii Cisco Developer Support Program vii Organization viii Related Documentation ix Obtaining Documentation and Submitting a Service Request i-ix Cisco ...
Page 4 - Component APIs; Internal URI Features
Contents iv Cisco Unified IP Phone Services Application Development Notes OL-20949-01 CiscoIPPhoneResponse 3-19 CiscoIPPhoneError 3-19 Custom Softkeys 3-19 XML Considerations 3-20 Mandatory Escape Sequences 3-21 XML Encoding 3-21 Application Event Handlers 3-22 C H A P T E R 4 Component APIs 4-1 App...
Page 5 - HTTP Requests and Header Settings; Troubleshooting Cisco Unified IP Phone; Cisco IP Phone Services; IP Phone Service Administration and Subscription
Contents v Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Application Management URIs 5-16 Init 5-16 Notify 5-16 Application 5-18 C H A P T E R 6 HTTP Requests and Header Settings 6-1 HTTP Client Requests (HTTP GET) 6-1 HTTP Server Requests (HTTP POST) 6-1 HTTP Header Sett...
Page 6 - DeviceListX Report; CiscoIPPhone XML Object Quick Reference; Cisco Unified IP Phone Services
Contents vi Cisco Unified IP Phone Services Application Development Notes OL-20949-01 User Service Subscription 9-4 C H A P T E R 10 DeviceListX Report 10-1 Benefits 10-2 Restrictions 10-2 Integration Considerations and Interoperability 10-2 Performance and Scalability 10-2 Security 10-3 Related Fea...
Page 7 - Revision History
vii Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Preface Overview Use this document with Cisco Unified Communications Manager, Release 7.1(3) to develop and deploy customized client services for the Cisco Unified IP Phones that support Cisco Unified Phone services. Becau...
Page 8 - Organization
viii Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Preface formalized process provides access to CDN Engineers who are an extension of the product technology engineering teams. CDN Engineers have access to the resources necessary to provide expert support in a timely mann...
Page 9 - Related Documentation; Obtaining Documentation and Submitting a Service Request
ix Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Preface Obtaining Documentation and Submitting a Service Request Related Documentation For more information about Cisco Unified IP Phones or Cisco Unified Communications Manager, refer to the following publications: Cisco U...
Page 10 - Cisco Product Security Overview
x Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Preface Obtaining Documentation and Submitting a Service Request Cisco Product Security Overview This product contains cryptographic features and is subject to United States and local country laws governing import, export, t...
Page 19 - Understanding Object Behavior
C H A P T E R 3-1 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 3 CiscoIPPhone XML Objects The following sections describe the general behavior and use of XML objects: • Understanding Object Behavior • XML Object Definitions • Custom Softkeys • XML Considerations • Applic...
Page 21 - XML Object Definitions; CiscoIPPhoneMenu
3-3 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Chapter 3 CiscoIPPhone XML Objects XML Object Definitions XML Object Definitions The following sections provide definitions and descriptions of each CiscoIPPhone XML object: • CiscoIPPhoneMenu • CiscoIPPhoneText • CiscoIPP...
Page 22 - CiscoIPPhoneText
3-4 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Chapter 3 CiscoIPPhone XML Objects XML Object Definitions When a menu is loaded, the phone behaves the same as for built-in phone menus. The user navigates through the list of menu items and eventually chooses one by using...
Page 23 - CiscoIPPhoneInput
3-5 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Chapter 3 CiscoIPPhone XML Objects XML Object Definitions CiscoIPPhoneInput When a Cisco Unified IP Phone receives an XML object of type CiscoIPPhoneInput , it constructs an input form and displays it. The user then enters...
Page 25 - Custom Directories; CiscoIPPhoneImage
3-7 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Chapter 3 CiscoIPPhone XML Objects XML Object Definitions </DirectoryEntry> </CiscoIPPhoneDirectory> Note For the directory listing, the Cisco Unified IP Phone displays the appropriate softkeys that are needed ...
Page 27 - CiscoIPPhoneImageFile
3-9 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Chapter 3 CiscoIPPhone XML Objects XML Object Definitions Example The following XML code defines a CiscoIPPhoneImage object that displays the sequence of pixels shown in Figure 3-3 as a graphic positioned at the center of ...
Page 29 - CiscoIPPhoneGraphicMenu; CiscoIPPhoneGraphicFileMenu
3-11 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Chapter 3 CiscoIPPhone XML Objects XML Object Definitions CiscoIPPhoneGraphicMenu Graphic menus serve the same purpose as text menus: they allow a user to select a URL from a list. Use graphic menus in situations when the...
Page 30 - CiscoIPPhoneIconMenu
3-12 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Chapter 3 CiscoIPPhone XML Objects XML Object Definitions Figure 3-5 shows the display of the CiscoIPPhoneGraphicFileMenu. Figure 3-5 CiscoIPPhoneGraphicFileMenu If the coordinates that are supplied in <TouchArea> t...
Page 32 - CiscoIPPhoneIconFileMenu; CiscoIPPhoneStatus
3-14 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Chapter 3 CiscoIPPhone XML Objects XML Object Definitions CiscoIPPhoneIconFileMenu This icon menu is similar to CiscoIPPhoneMenu , but it uses color PNG icons rather than grayscale CIP icons. Use icon menus in situations ...
Page 37 - CiscoIPPhoneResponse; CiscoIPPhoneError; Custom Softkeys
3-19 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Chapter 3 CiscoIPPhone XML Objects Custom Softkeys <ExecuteItem Priority=”1” URL=”http://server/textmessage.xml”/> </CiscoIPPhoneExecute> CiscoIPPhoneResponse The CiscoIPPhoneResponse object items provide mess...
Page 38 - XML Considerations
3-20 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Chapter 3 CiscoIPPhone XML Objects XML Considerations Note The <URLDown> tag can only contain Internal URIs—it cannot contain an HTTP URL. The “URL” in the name “URLDown” does not signify that an HTTP URL can be use...
Page 39 - Mandatory Escape Sequences
3-21 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Chapter 3 CiscoIPPhone XML Objects XML Considerations Note All CiscoIPPhone element names and attribute names are case sensitive. Mandatory Escape Sequences By XML convention, the XML parser also requires that you provide...
Page 40 - Application Event Handlers
3-22 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Chapter 3 CiscoIPPhone XML Objects Application Event Handlers Application Event Handlers The Application Manager API (see “Application” section on page 5-18 ) includes an Application Management Event Handler which is supp...
Page 43 - Application Management API; RTP Streaming API
C H A P T E R 4-1 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 4 Component APIs In addition to the primary phone XSI API, two additional component APIs are available: • Application Management API, page 4-1 • RTP Streaming API, page 4-1 Application Management API To addre...
Page 44 - Interaction Rules with Legacy RTP URI Streams
4-2 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Chapter 4 Component APIs RTP Streaming API Interaction Rules with Legacy RTP URI Streams The RTP Streaming API allows a full-duplex stream (mode=sendReceive) to be setup as a single stream request which simplifies the usag...
Page 46 - Error Schema
4-4 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Chapter 4 Component APIs RTP Streaming API </xs:element> <xs:element name="port" minOccurs="0"> <xs:simpleType> <xs:restriction base="xs:unsignedShort"> <xs:minInclusive v...
Page 47 - Examples; Errors and Responses
4-5 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Chapter 4 Component APIs RTP Streaming API Examples Start Media • Request HTTP POST /CGI/Execute <startMedia> <mediaStream onStopped=”Notify:http:server:80:path/page” receiveVolume=”50”> <type>audio</t...
Page 49 - Supported URIs by Phone Model
C H A P T E R 5-1 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 5 Internal URI Features Internal uniform resource identifiers (URIs) provide access to embedded phone features such as placing calls, playing audio files, and invoking built-in object features. These sections...
Page 50 - Device Control URIs; Key
5-2 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Chapter 5 Internal URI Features Device Control URIs Device Control URIs These sections describe the device control URIs: • Key • Display Key The Key URI allows a programmer to send an event that a key has been pressed. The...
Page 52 - Unsupported Key URIs and Alternate Options
5-4 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Chapter 5 Internal URI Features Device Control URIs Unsupported Key URIs and Alternate Options This section describes the unsupported Key URIs in the phone models and provides alternative options, if any, for the unsupport...
Page 53 - Display
5-5 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Chapter 5 Internal URI Features Device Control URIs Display The Display URI is available only on those Cisco Unified IP Phones that have a color backlight on the phone display, including the Cisco Unified IP Phone 7970G an...
Page 54 - XML Displayable Object URIs; SoftKey
5-6 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Chapter 5 Internal URI Features XML Displayable Object URIs XML Displayable Object URIs These sections describe the XML displayable object URIs: • SoftKey • QueryStringParam SoftKey You can execute native softkey functiona...
Page 55 - QueryStringParam
5-7 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Chapter 5 Internal URI Features XML Displayable Object URIs The new generation 8900 / 9900 series IP phones have the following enhancements to their display: • The positions of the sofkeys have been changed. Moving from le...
Page 57 - Multimedia URIs; RTP Streaming
5-9 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Chapter 5 Internal URI Features Multimedia URIs Multimedia URIs These sections describe the multimedia URIs: • RTP Streaming • Play • Vibrate RTP Streaming You can invoke RTP streaming via URIs in services. You can instruc...
Page 58 - RTPRx
5-10 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Chapter 5 Internal URI Features Multimedia URIs The user has no explicit mechanism for terminating the Rx URI stream independent of the call. Thus, if the Rx stream is not terminated automatically, it would continue to pl...
Page 59 - RTPTx; RTPMRx; RTPMTx
5-11 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Chapter 5 Internal URI Features Multimedia URIs RTPTx Use the RTPTx URI to instruct the phone to transmit a Unicast RTP stream or to stop transmitting Unicast or Multicast RTP streams. URI Formats RTPTx:i:p RTPTx:Stop Whe...
Page 60 - Play; Vibrate
5-12 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Chapter 5 Internal URI Features Multimedia URIs Play The Play URI downloads an audio file from the TFTP server and plays through the phone speaker. This same mechanism also plays ring files, and the format of the files is...
Page 61 - Telephony URIs; Dial
5-13 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Chapter 5 Internal URI Features Telephony URIs URI Format Vibrate:vibrateDuration:silenceDuration:count Where vibrateDuration = duration (in milliseconds) in which the vibrate state remains on. Value must be an integer ra...
Page 62 - EditDial; SendDigits
5-14 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Chapter 5 Internal URI Features Telephony URIs useAppUI = Specifies whether or not this application will be used as the user interface for this call. A value of true will cause the application to keep UI focus when the ca...
Page 64 - Application Management URIs; Init; Notify
5-16 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Chapter 5 Internal URI Features Application Management URIs Application Management URIs These sections describe the application management URIs: • Init • Notify • Application Init The Init URI allows an application to ini...
Page 66 - Application
5-18 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Chapter 5 Internal URI Features Application Management URIs HTTP POST /path/streamhandler?event=stopped HTTP/1.1 Accept: */* Authorization: Basic 8fh4hf7s7dhf Content-Type: application/x-www-form-urlencoded; charset=”UTF-...
Page 70 - HTTP Header Settings
6-2 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Chapter 6 HTTP Requests and Header Settings HTTP Header Settings The form that is posted should have a case-sensitive form field name called “XML” that contains the desired XML object. For any HTTP POST operation, the serv...
Page 71 - HTTP Refresh Setting
6-3 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Chapter 6 HTTP Requests and Header Settings HTTP Header Settings HTTP Refresh Setting The HTTP headers that are sent with any page from an HTTP server can include a Refresh setting. This setting comprises two parameters: a...
Page 72 - MIME Type and Other HTTP Headers; Audio Clips; Content Expiration Header Setting
6-4 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Chapter 6 HTTP Requests and Header Settings HTTP Header Settings MIME Type and Other HTTP Headers Although delivering pages with the proper MIME type and other formatting items is not difficult, it requires moderately in d...
Page 73 - Set-Cookie Header Setting
6-5 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Chapter 6 HTTP Requests and Header Settings HTTP Header Settings This functionality allows you to make the content of any page that is sent to the phone expire. When a user presses the Exit softkey, the user goes back to t...
Page 74 - HTTP Encoding Header Setting
6-6 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Chapter 6 HTTP Requests and Header Settings HTTP Header Settings HTTP Encoding Header Setting The encoding header controls language and character settings related to localization. Accept-Language Cisco Unified IP Phones po...
Page 75 - Identifying the Capabilities of IP Phone Clients; x-CiscoIPPhoneModelName
6-7 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Chapter 6 HTTP Requests and Header Settings Identifying the Capabilities of IP Phone Clients If 'charset' is not specified, the phones will use the default encoding for the currently configured user locale. So to avoid pos...
Page 76 - x-CiscoIPPhoneSDKVersion; Accept Header
6-8 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Chapter 6 HTTP Requests and Header Settings Accept Header x-CiscoIPPhoneSDKVersion This Cisco-proprietary header contains the version of the IP Phone Services SDK that the requesting phone supports. The HTTP header does no...
Page 77 - Accessing IP Phone Information
6-9 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Chapter 6 HTTP Requests and Header Settings Accessing IP Phone Information Accessing IP Phone Information Cisco Unified IP Phones have an embedded web server to provide a programming interface for external applications and...
Page 79 - Troubleshooting; Cisco Unified IP Phone; Troubleshooting Tips; XML Parsing Errors
C H A P T E R 7-1 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 7 Troubleshooting Cisco Unified IP Phone Service Applications This chapter contains the following sections: • Troubleshooting Tips • XML Parsing Errors • Error Messages Troubleshooting Tips The following tips...
Page 80 - Error Messages
7-2 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Chapter 7 Troubleshooting Cisco Unified IP Phone Service Applications Error Messages – CiscoIPPhoneMenu Object—If the field <Name> is missing for a <MenuItem> , the original parser would stop rendering from tha...
Page 81 - SDK Components
C H A P T E R 8-1 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 8 Cisco IP Phone Services Software Development Kit (SDK) The Cisco IP Phone Services Software Development Kit (SDK) contains everything that you require to create XML applications, including necessary documen...
Page 83 - Sample Services Requirements
8-3 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Chapter 8 Cisco IP Phone Services Software Development Kit (SDK) Sample Services Requirements – Speed Dials (JSP) – Group MWI (JSP) – AutoDialer (JSP) – PhotoDirectory (JSP) – CallerInfo (JSP) – PushAuthenticate (ASP) – Sc...
Page 85 - Accessing Phone Service Administration
C H A P T E R 9-1 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 9 IP Phone Service Administration and Subscription Cisco Unified Communications Manager administrators maintain the list of services to which users can subscribe. Administrators must use Cisco Unified Communi...
Page 86 - Adding a Phone Service
9-2 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Chapter 9 IP Phone Service Administration and Subscription Adding a Phone Service Example http:// <servername> /ccmuser/sample/sample.asp Where <servername> designates a fully qualified domain name or an IP add...
Page 87 - Defining IP Phone Service Parameters
9-3 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Chapter 9 IP Phone Service Administration and Subscription Defining IP Phone Service Parameters Defining IP Phone Service Parameters Each service can have a list of parameters. You can use these parameters, which are appen...
Page 88 - User Service Subscription
9-4 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Chapter 9 IP Phone Service Administration and Subscription User Service Subscription Tip If you change the service URL, remove a Cisco Unified IP Phone service parameter, or change the Parameter Name of a phone service par...
Page 90 - Benefits; Integration Considerations and Interoperability
10-2 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Chapter 10 DeviceListX Report Benefits • Device Pool • IP Address • Real-Time Information The completed list of data gets formatted into a simple XML object and gets returned in the HTTP Response to the developer. Benefit...
Page 92 - Troubleshooting DeviceListX Reports; Error Codes
10-4 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Chapter 10 DeviceListX Report Troubleshooting DeviceListX Reports <?xml version="1.0" encoding="iso-8859-1"?> <DeviceList> <Device t="" n="" d="" c="" p="...
Page 93 - Determining Problems With the Interface
10-5 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 Chapter 10 DeviceListX Report Troubleshooting DeviceListX Reports Error Message 1001 Too many simultaneous requests for Device List. Please wait at least 60 seconds and try again. Explanation When two or more clients atte...
Page 99 - Updated XML Parser and Schema Enforcement
B-1 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 A P P E N D I X B Cisco Unified IP Phone Services XML Schema File These sections provide details about the XML schema supported on Cisco Unified IP Phones: • Updated XML Parser and Schema Enforcement • CiscoIPPhone.xsd Upd...
Page 113 - I N D E X; Symbols
IN-1 Cisco Unified IP Phone Services Application Development Notes OL-20949-01 I N D E X Symbols << softkey 5-6 Numerics 8961 Color depth 3-10 Resolution 3-10 URIs supported 5-1, 5-3 XML Objects supported 2-1, 3-2 9951 Color depth 3-10 Reolution 3-10 URIs supported 5-1, 5-3 XML Objects support...