Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • ToBin / FromBin
  • Lot number
  • Tote
  • Serial number
  • Quantity

...

How to set it up

In the mobile configuration:

Add the "<validation>" tag in the service section, to enable the validators needed. Each required element needs to be enabled and have a document type set.
Besides that, the "includeCollectedValues" attribute dictates whether previously gathered steps should be added to the request

Code Block
languagexml
<service id="Pick" type="Order" orderType="Pick">
  <validation>
    <lotNumberValidation online="true" documentName="ValidateLotNumber" includeCollectedValues="true"/>
    <serialNumberValidation online="true" documentName="ValidateSerialNumber"/>
    <fromBinValidation online="true" documentName="ValidateFromBin"/>
    <toBinValidation online="true" documentName="ValidateToBin"/>
    <toteValidation online="true" documentName="ValidateTote"/>
    <quantityValidation online="true" documentName="ValidateQuantity"/>
  </validation>
</service>

...


OnlineValidation Request

ItemNumber, lineNumber and orderBackendId are always included, followed by the step setup for validation, and previously gathered steps if setup to do so.

Code Block
languagexml
titleXML Example
<?xml version="1.0" encoding="utf-8"?>
<request name="ValidateLotNumber" created="2021-12-14T11:22:30+01:00" xmlns="http://schemas.microsoft.com/Dynamics/Mobile/2007/04/Documents/Request">
  <requestData name="ValidateLotNumber">
    <itemNumber>TF-003</itemNumber>
    <lineNumber>20000</lineNumber>
    <orderBackendId>RE000160</orderBackendId>
    <lotNumber>ScannedLotNumber</lotNumber>
  </requestData>
</request>

...

The online validation responses should look as follows.

Code Block
languagexml
titleXML Example
<?xml version="1.0" encoding="UTF-8"?>
<response xmlns="http://schemas.microsoft.com/Dynamics/Mobile/2007/04/Documents/Response" messageid="07E64DA6-2335-40C1-83DB-5C40E3043083" status="Completed">
  <responseData xmlns="http://schemas.taskletfactory.com/MobileWMS/BaseDataModel" />
</response>

...

The request and response will look the same as the specific validation types.

...

Response for Type and quantity

The generic online validator does have an extra feature when it comes to the TypeAndQuantity step stype, which allows the backend to return a new displayname for the scanned value.
So instead of e.g. displaying a serial number, the item number or a human readable name can be displayed on the control.
Notice that the display value (TypeDisplay) needs to contain all the information.

Code Block
languagexml
titleXML Example
<?xml version="1.0" encoding="UTF-8"?>
<response xmlns="http://schemas.microsoft.com/Dynamics/Mobile/2007/04/Documents/Response" messageid="28AEF07E-2629-46F4-B935-AB6207DC3FFC" status="Completed">
  <responseData xmlns="http://schemas.taskletfactory.com/MobileWMS/BaseDataModel">
    <TypeKey>TF-002</TypeKey>
    <TypeDisplay>TF-002 - Intense Orange</TypeDisplay>
  </responseData>
</response>

...

  • AllowEdit - Allows the user to edit the value in the quantity step.
  • ApplyDirectly - Hides the quantity step all together.
  • VerifyOnly - Disables the quantity step, allowing the user to see, but not edit it.


Code Block
languagexml
titleXML Example
<?xml version="1.0" encoding="UTF-8"?>
<response xmlns="http://schemas.microsoft.com/Dynamics/Mobile/2007/04/Documents/Response" messageid="EA9FD6AF-78C6-47DE-82CE-3EB789FAFE64" status="Completed">
  <responseData xmlns="http://schemas.taskletfactory.com/MobileWMS/BaseDataModel">
    <LotNumberInformation xmlns="http://schemas.taskletfactory.com/MobileWMS/WarehouseInquiryDataModel">
      <Quantity>5</Quantity>
      <ValueInteractionPermission>ApplyDirectly</ValueInteractionPermission>
    </LotNumberInformation>
  </responseData>
</response>

...

The response should look as follows:

Code Block
languagexml
titleXML Example
<?xml version="1.0" encoding="UTF-8"?>
<response xmlns="http://schemas.microsoft.com/Dynamics/Mobile/2007/04/Documents/Response" messageid="6972D4AF-1829-43FE-B0FB-C37B3249E689" status="Completed">
  <responseData xmlns="http://schemas.taskletfactory.com/MobileWMS/BaseDataModel">
    <registrationCollectorConfiguration xmlns="http://schemas.microsoft.com/Dynamics/Mobile/2007/04/Documents/Response">
      <steps>
        <add inputType="Text" id="10" name="MyCustomStep1" autoForwardAfterScan="true" header="MySerialSteps1" defaultValue="" editable="true" optional="false" primaryInputMethod="Scan" />
        <add inputType="Text" id="20" name="MyCustomStep2" autoForwardAfterScan="true" header="MySerialSteps2" defaultValue="" editable="true" optional="false" primaryInputMethod="Scan" />
      </steps>
    </registrationCollectorConfiguration>
  </responseData>
</response>

...