You must first answer the context before answering the subsequent returned prompt. If no context is provided, the document cannot be refreshed, and the response of the PUT call contains the details about the context parameter.
Response body:
<parameters> <parameter optional="false" type="context"> <id>0</id> <name>Select a context</name> <answer constrained="true" type="text"> <info cardinality="Single"> <values> <value id="2">Reservations</value> <!-- possible values --> <value id="1">Sales</value> </values> <previous> <value id="1">Sales</value> <!-- previous value --> </previous> </info> <values> <value id="1">Sales</value> <!-- previous value --> </values> </answer> </parameter> </parameters>
In a second PUT call, an answer is provided to the context.
Request body:
<parameters> <parameter optional="false" type="context"> <id>0</id> <answer type="text"> <values> <value id="1">Sales</value> </values> </answer> </parameter> </parameters>
Once the context is resolved, the response of the PUT call contains the previous value for the second parameter of type prompt.
Response:
<parameters> <parameter optional="false" type="prompt"> <id>1</id> <name>Enter a value for Country:</name> <answer constrained="false" type="text"> <info cardinality="Single"> <previous> <value>France</value> </previous> </info> <values> <value>France</value> <!-- previous value --> </values> </answer> </parameter> </parameters>
In another PUT call, the context value and prompt response are given as inputs. Parameters could be in any order, provided that you give all the necessary parameters and their correct identifiers.
Request body:
<parameters> <parameter optional="false" type="context"> <id>0</id> <answer type="text"> <values> <value id="1">Sales</value> </values> </answer> </parameter> <parameter type="prompt"> <id>1</id> <answer type="text"> <values> <value>France</value> </values> </answer> </parameter> </parameters>
Response:
<success> <message>The resource of type 'document' with identifier '23535' has been successfully updated.</message> <id>23535</id> </success>