Versions Compared

Key

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

Only the following 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.

...

Use scanning to speed up line selection and reduce errors.

GS1 data type

...

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

Custom barcode format & Alternative data types

If you are scanning a custom barcode format.


See Select Line by custom barcode (lineSelection)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 details on the properties usedmore 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.

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.

Code Block
languagexml
titleRegular 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)


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")