Select Line by scan (scanToSelectBehaviour)

Owned by Johannes Sebastian Nielsen
Last updated: Oct 25, 2021
2 min read

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

  1. Item No.
    1. ItemBarcode
      1. Barcodes that uniquely identifies the Item
      2. Optionally also identifies the "Variant" and "Unit of Measure"
  2. Lot No.
  3. 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 Files.

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 Files.

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>                                          
  <..>



See also