Aastra Telecom 41-001343-02 IP Phone User Manual


 
Operational Features
5-244 41-001343-02 REV04 – 05.2014
For more information about creating XML configuration scripts and for XML script examples, see the Aastra XML Devel-
oper’s Guide.
Configuring the Phone to use XML
You can configure the phone to request the XML objects you create by configuring specific parameters via the configura-
tion files or the Aastra Web UI.
Users can access XML applications via softkeys configured on the IP phones. The phone performs an HTTP GET on the
URI configured in the Aastra Web UI or configuration files.
You configure the following parameters for object requests:
xml application URI
xml application title
The xml application URI is the application you are loading into the IP phone.
The xml application title is the name of the XML application that displays on the Services menu in the IP Phone UI (as
option #4).
XML Get Timeout
The IP phone has a parameter called, “xml get timeout” that allows you to specify a timeout value, in seconds, that the
phone waits for the far side to return a response after accepting the HTTP GET connection. If the far side accepts the GET
connection but never returns a response, it blocks the phone until it is rebooted. If you enter a value greater than 0 for
this parameter, the phone times out and will not be blocked.
For more information about configuring this parameter, see Appendix A, the section, “XML Settings” on page A-114.
XML Push Requests
In addition to initiating a request to an XML application from a softkey, an HTTP server can push an XML object to the
phone via HTTP Post. When the phone sees a PUSH request containing an XML object, it tries to authenticate the
request. It does so by checking the IP address or host name of the requesting host against a list of trusted hosts (or
domain names) configured via the Aastra Web UI (parameter called XML Push Server List) or the configuration files
(parameter called xml application post list). If the request is authenticated, the XML object is handled by the IP phone
accordingly, and displays the information to the screen.
Note:
The HTTP Post must contain HTTP packets that have an "xml" line in the message body. For more information about
adding "xml" lines in HTTP packets, see the Aastra XML Developer’s Guide.