This functionality enables an opened registration collector to expand with new steps, based on the response from the backend.
Requirement
Android App version 1.5.7
Currently this is only available on Unplanned Item Registration and Lookup -pages with a registration collector/steps.
Post - Append steps
When posting from a registration collector on an Unplanned Item Registration or Lookup page, new steps can be returned that will be appended to the current registration collector.
<?xml version="1.0" encoding="UTF-8"?>
<response xmlns="http://schemas.microsoft.com/Dynamics/Mobile/2007/04/Documents/Response" messageid="26A6D333-A724-41B3-97A9-7C1FCAC0CEDD" status="Completed">
<description />
<responseData xmlns="http://schemas.taskletfactory.com/MobileWMS/BaseDataModel">
<registrationCollectorConfiguration xmlns="http://schemas.microsoft.com/Dynamics/Mobile/2007/04/Documents/Response">
<steps>
<add id="10" name="FromBin" inputType="Text" header="@{RegistrationCollectorFromBinHeader}" label="'{FromBin}'" defaultValue="{FromBin}" helpLabel="@{RegistrationCollectorFromBinHelpLabel}" optional="false" primaryInputMethod="Scan"/>
<add id="20" name="ToBin" inputType="Text" header="@{RegistrationCollectorToBinHeader}" label="'{ToBin}'" defaultValue="{ToBin}" helpLabel="@{RegistrationCollectorToBinHelpLabel}" optional="false" primaryInputMethod="Scan" />
<add id="31" name="ExpirationDate" inputType="Date" header="@{RegistrationCollectorExpirationDateHeader}" label="Expiration Date" optional="false" helpLabel="@{RegistrationCollectorExpirationDateHelpLabel}"/>
</steps>
</registrationCollectorConfiguration>
</responseData>
</response>
New steps appended
The steps returned will be appended to the current registration collector and the first newly added step will be the active step. The steps will be grouped by the post they where returned by.
Notice that only the steps will be added to the current registration collector. This means that other configuration returned like e.g scanBehaviourWhenRegisteringQuantity defined on the registrationCollectorConfiguration, will not affect the registration collector.
Changes in previous steps - Removal of steps
If a change is being made in a step, then all steps after that step will be removed if they have been added by another post or in other words belongs to another group.
Post - New message id
When posting again a new messageid will be created every time.
Common usage
- As an alternative to collecting a value in the Header, which determines what other Steps to collect. You can collect the value as a Step and based on the value then append the appropriate steps
- As an alternative to Linked Steps (linkedElement and linkColumn)