Basic Communication Procedures
Nur für den internen Gebrauch
A31003-S2000-R102-16-7620 02/2016
46
Provisioning Service, Developer’s Guide
c03.fm
Provisioning Service Driven Interaction
3.6.4
Modify Phone Settings
To modify settings on the phone, that is, to write data items to the phone, the provisioning ser-
vice sends a message with
Action
set to
WriteItems
. The items in question are sent to the
phone in a similar fashion as described for reading data items (see Section 3.6.3.2, "XML Data
Exchange").
3.6.4.1
Message Flow
Please note that step 6 and 7 are optional.
>
When the phone is in a call, it will not accept a
WriteItems
action. Instead, it will
reply with a message stating it is in
busy
status. Example:
<WorkpointMessage xsi:schemaLocation="http://www.siemens.com/
DLS" xmlns="http://www.siemens.com/DLS" xmlns:xsi="http://
www.w3.org/2001/XMLSchema-instance">
<Message nonce="957AE6C2E40C0E916B7CD5636480F171" max-
Items="-1" fragment="final">
<ReasonForContact status="busy"
action="WriteItems">reply-to</ReasonForContact>
</Message>
</WorkpointMessage>
When the provisioning service sends a CleanUp with a ’send-solicited’ item, the
phones reaction will be to schedule an automatic solicited connection to the provi-
sioning service when the busy condition is cleared (>=V3R3). See also Section
3.7.3, "Contact-Me during Busy State".
When sending a CleanUp without a ’send-solicited’ item, the phone will not inform
the provisioning service when it has returned to idle state, so the provisioning service
will have to resend the request periodically.
Phone
Provisioning Service
1
HTTP Request
Contact-me (HTML)
2
HTTP Response
Acknowledged (HTML)
3
HTTPS Request:
Reason for contact: solicited
<Basic data items>