How can a message text be sent on a phone's display?

[cdnadmin]

This document was generated from CDN thread

Created by: Bruno Rosenberger on 18-02-2009 03:10:18 PM
I want alert a user by sending him a message on his Cisco IP Phone display. How can this be done with jtapi?

Subject: RE: How can a message text be sent on a phone's display?
Replied by: David Staudt on 18-02-2009 06:15:30 PM
The Terminal.sendData() method is available, which allows the application to send an XML object (compliant with the IP Phone Services API: http://developer.cisco.com/web/ipps/docs ) directly to the phone, which will rendered on the display.  From the JTAPI dev guide:
 
CiscoTerminal Method
               Applications can send an XSI object in the byte format to the Cisco Unified IP Phone through the
               CiscoTerminal interface method. The system limits the payload to 2000 bytes of data with this interface.
               CiscoTerminal must be in the <CODE>CiscoTerminal.REGISTERED</CODE> state; its Provider must
               be in the <CODE>Provider.IN_SERVICE</CODE> state. Successful response indicates that the data
               that was pushed has arrived at the phone. However, the application cannot receive any XML, including
               the CiscoIPPhoneResponse object from the push, back from the phone. If the application request is not
               successful, a PlatformException is thrown. Any request with more than 2000 bytes of data is rejected.
               public String sendData (String terminalData) throws InvalidStateException,
               MethodNotSupportedException;
               Before the application can make use of this feature, it must add TerminalObserver on the Terminal.

Subject: RE: How can a message text be sent on a phone's display?
Replied by: Scott McGrath on 07-07-2009 09:49:21 PM
Is there a place I can find the detail information of the xml that can be sent via this method, such like what types of data are supported and the formatting.
thanks a lot.

Subject: RE: How can a message text be sent on a phone's display?
Replied by: David Staudt on 08-07-2009 06:21:10 AM
The link mentioned above - http://developer.cisco.com/web/ipps/docs - has all the documentation and sample code available for the XML services API.