Aastra Telecom 41-001343-02 Configuring the Phone to use XML, XML Get Timeout, XML Push Requests

Operational Features

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.

5-244 41-001343-02 REV04 – 05.2014