Description

Global converters defindes in start.cfg will be active in the entire app, all the time.

So make sure to use it for identifiable barcodes i.e. with fixed lengths, to ensure the converter will only be triggered when intended.

Local converters can be made in application.cfg

Barcode converters are configured using Mobile Configuration File

Page-specific converter

When you want custom barcodes only to handled on a specific page.

• Configured using "Application.cfg"

Global converter

When you want custom barcodes to be handled in the entire app.

• Configured using "start.cfg"

Example, page-specific: Code39 converted to GS1 Item on Receive Lines

Since AI91 is regarded as "Item No." but without the length constraint of AI01, this can be used for many 1D (linear) barcodes like Code39 or Code128.

In this example the data is 14 char, but can be arbritary length since AI91 allows for this.

Image Added

<page id="ReceiveLines" type="OrderLines" icon="mainmenureceive">
  <title defaultValue="@{PageReceiveOrderLinesTitle}"/>
  <orderLinesConfiguration suggestQuantity="true" verifySingleScanRegistrations="false" actionOnEmptyList="ClosePage">
    <service id="Receive"/>
    <list listId="OrderLines"/>
    <...>
    <scanToSelectBehaviour gs1SearchTerm="Item" behaviour="Auto">
      <converter expression="^(\d{1,14})$" expressionAis="91"/>
    </scanToSelectBehaviour>
  </orderLinesConfiguration> 
...

Example, Global: Custom barcode converted into four AI's

Different positions of a barcode value, is broken into several "AI". See table below.

...
<scanner>
  <type>internal</type>
    <converter enabled="true" type="custom2gs1">
      <!-- BluCom -->
      <customConfiguration expression="^64(\w{1,8})(\d{1,4})(\d{1,3})(\w{1,10})$" expressionAis="10,37,92,91"/>
    </converter>
...

Mapping table 

Note: See Register with Encoded Barcode (GS1) for a list of default AI's.

Online

Editor

Use an online editor to test your regular expressions.

Example

https://regex101.com/ to construct a RegEx.

• Regular expression: ^(\d{1,6})(\d{1,5})$
• Test string: 11111122222

Legacy: Windows Handheld Embedded

...
<type>internal</type>          
  <converter enabled="false" type="pm2ean128" />
    <!--First and up to 20 character-->
    <filter enabled="true">
      <regex>^.{0,20}</regex> 
    </filter>
...

Related articles

See also