Versions Compared

Key

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

Only the following GS1 data types are supported: (Android App version 1.5.7)

  • Item No.
  • Serial No.
  • Lot No.

Description

Excerpt

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

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 when the configuration setting "behavior" is = "User", to select from.


How to set it up

This is changed in set up using Mobile Configuration FileFiles.

Step 1: Enable

...

ScanToSelectBehaviourType

...

See the example below.

...

Step 2:

...

Set properties (optional)

  • gs1SearchTerm
  • orderFilterGs1AIbehaviorbehavior
  • converter

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


Example

Code Block
languagexml
<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.

...

Code Block
languagexml
titleRegular Expression
^(\w{1,20})\s"  

Step 2: Enable "ScanToSelectBehaviourType"

This is changed in Mobile Configuration FileFiles.

See the example below.

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

...

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



See also

Filter by label (Content by label)
showLabelsfalse
showSpacefalse
sorttitle
reversetrue
excerptTypesimple
cqllabel = "mobileapp" and label in ("lineselection","scantoselectbehaviour")

...