Select Line by scan (scanToSelectBehaviour)

Description

Filter or Select Order Line based on a scanned value in Encoded Barcode (GS1)

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

Behavior

Depending on the barcode and configuration the app will either:

A: Select the Line is automatically 

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

B: Ask the user to select from a reduced list

The user is presented with a list of matching lines when the configuration setting "behavior" is = "User"

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
• orderFilterGs1AI
• behavior

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.