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.

Using an Encoded Barcode (GS1) containing one or more of the following data types:

• Item No.
• Lot No.
• Serial No

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 changed in Mobile Configuration File.

Step 1: Enable "ScanToSelectBehaviourType"

See the example below.

Steps 2: Optionally set the related properties: 

• gs1SearchTerm
• behavior
• converter

See Order Lines Mobile Configuration 

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.

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

Step 2: Enable "ScanToSelectBehaviourType"

This is changed in Mobile Configuration File.

See example below.

See aslo 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)

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

See also

• Page:
  Select, Add or Refresh Order Lines by Scan (LineSelection) — Select, Add or Refresh Lines by scanning
• Page:
  Select Line by scan (scanToSelectBehaviour) — Filter or Select Order Line based on a scanned value.