c03.fm
A31003-S2000-R102-16-7620, 02/2016
Provisioning Service, Developer’s Guide
41
Nur für den internen Gebrauch
Basic Communication Procedures
Provisioning Service Driven Interaction
3.6
Provisioning Service Driven Interaction
To initiate an interaction with the phone, the provisioning service must send an HTML-based
contact-me message to the phone’s contact-me URI. In turn the phone will send a response
with
solicited
as a
ReasonForContact
. For the corresponding XML schema, please refer
to Section 3.6.3.2, "XML Data Exchange".
3.6.1
Start an Interaction: Contact-me
The main purpose of the contact-me message is to allow the phone to decide when to send a
response. If the provisioning service is acting as a web server, this initial message is required,
as the service must be contacted by the phone, which acts as a web client. For details about
the structure of a contact-me message, see Section 1.4.4.2, "Contact-me Messages".
If the phones and the provisioning service reside in different networks or subnets, which are
separated by a firewall and/or NAT, it may be impossible for the provisioning service to send a
contact-me message. To solve this problem, the phone can be configured so that it periodically
polls the provisioning service, or a special proxy, for new messages. For further information,
please refer to Section 1.4.4.3, "Polling Request To Bridge A Firewall" and Section 3.1.2.2,
"Provisioning Service Located Behind A Firewall".
3.6.2
End an Interaction: CleanUp
An interaction is terminated when the phone receives a CleanUp message from the provision-
ing service. Together with the CleanUp message, the provisioning service should also invali-
date the HTTPS session. See the following example:
<DLSMessage xsi:schemaLocation="http://www.siemens.com/DLS"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://www.siemens.com/DLS">
<Message nonce="9A6439F4E323CDB19283E40459828B56">
<Action>CleanUp</Action>
</Message>
</DLSMessage>
When sending a ’send-solicited’ with the CleanUp message as response to a ’busy’ state mes-
sage of the phone, the phone is forced to contact automatically the provisioning service when
it switches to ’idle’ state. See also Section 3.7.3, "Contact-Me during Busy State".
<DLSMessage xsi:schemaLocation="http://www.siemens.com/DLS"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://www.siemens.com/DLS">
<Message nonce="9A6439F4E323CDB19283E40459828B56">
<Action>CleanUp</Action>
<ItemList>
<Item name="send-solicited">true</Item>
