Select Line by scan (scanToSelectBehaviour)

Description

Filter or Select Order Line based on a scanned value.

Use case

Use scanning to speed up line selection and reduce errors.

Data types and Selection priority

Item No.
1. ItemBarcode
  1. Barcodes that uniquely identifies the Item
  2. Optionally also identifies the "Variant" and "Unit of Measure"
Lot No.
Serial No

These line values are part of the Order Lines GetOrderLines Response.

Encoded Barcode (GS1) will usually contain one or more data types: See section below for non-GS1 barcodes

Behavior

Depending on the barcode and configuration the app will either:

A: Select the Line automatically (behavior=Auto)

The app was able to work out the correct line from the barcode

B: Ask the user to select from a reduced list (behavior=User)

Multiple lines were found. The user is presented with a list of matching lines, to select from.

How to set it up

This is set up using Mobile Configuration File.

Step 1: Enable ScanToSelectBehaviourType

See the example below.

Step 2: Set properties (optional)

gs1SearchTerm
behavior
converter

See the example below and Order Lines Mobile Configuration for more information.

Example

<page id="ReceiveLines" type="OrderLines" icon="mainmenureceive">
  <title defaultValue="@{PageReceiveOrderLinesTitle}"/>
    <orderLinesConfiguration  suggestQuantity="true" verifySingleScanRegistrations="false" actionOnEmptyList="ClosePage">
      <service id="Receive"/>
      <list listId="OrderLines"/>
      <viewRegistrations title="@{OrderLinesRegistrationMenuItem}" navigateTo="ViewRegistrations" enabled="true"/>
      <deleteOrderRegistrations title="@{OrderLinesDeleteAllOrderRegistrationsMenuItem}" enabled="true"/>
      <extraInformationConfiguration stepSorting="ById"/>
      <onOrderPosted clearOrderLevelRegistrations="true"/>
      <scanToSelectBehaviour gs1SearchTerm="All" behaviour="Auto"/>    <-----------------------------
  </orderLinesConfiguration>
..

Support for custom barcode formats (Non-GS1)

If your barcode is non-GS1, you can use a converter like to identify the values you need.

Step 1: Define Regular Expression

We will use a Barcode converter to extract the part of the barcode we want.

Format: "SerialNumber MoreBarcodeValues"

Example: SN100000000000000001 ABC123

Note the "space" character after the serial number.

The expression must read the first 20 characters before that space character.

Regular Expression

^(\w{1,20})\s"

Step 2: Enable "ScanToSelectBehaviourType"

This is changed in Mobile Configuration File.

See the example below.

See also Order Lines Mobile Configuration for details on the properties used.

Step 3: Define Converter and AI (GS1 Application Identifier)

Insert the regular expression and direct it to AI21 (Serial Number)

Example

<page id="PickLines" type="OrderLines" icon="mainmenupick">
  <orderLinesConfiguration>
    <scanToSelectBehaviour gs1SearchTerm="Item" behaviour="Auto">     <------------
      <converter expression="^(\w{1,20})\s" expressionAis="21"/>      <------------
    </scanToSelectBehaviour>                                          <------------
  <..>