Barcode Recognition Setup

1) Setup an extractFromBarcode rule on the appropriate node
2) Install the Softek SDK. You can download the latest version from:
Windows SDK v8.1.2 - Ensure you use V8.1.2 only
Linux SDK v8.3.1

For a list of all versions go to Bardecode, although a different license may need to be loaded via the License property. A license and XML file can be specified in the "Advanced" section of the extractFromBarcode rule by adding the lines
LicenseKey=<license here>
xml=/opt/PT_ID_NO.xml

Linux: Copy the barcode_linux.tar.gz file to the destination host and run the following commands:
gzip -d barcode_linux.tar.gz
tar -xf barcode_linux.tar
In the resultant bardecoder_8_3_1 directory, sudo ./configure.sh

Libraries need to be copied to /usr/lib/ on Linux installations. Below is a list of the libraries which need to be copied:

• java/Softek/Barcode.class
• java/Softek/Barcode.java
• lib/bardecode.a
• lib/libbardecode.so
• lib/libbardecode_jni.so

Windows: Install the EXE file, e.g. C:\Softek812
Set the System Path environment variable to include the bin directory, e.g. C:\Softek812\bin

Once the Softek Barcode Reader software has been installed, restart PaperTrail then setup the extractFromBarcode node rule

Once the above has been completed, an extractFromBarcode node rule can be configured in PaperTrail.

• Filter: filename.toLowerCase().endsWith('.pdf')
• Barcode Index: The text index to save the barcode value in barcode_value
• Failed / Passed Index: Boolean indexes (optional) to flag if the extract failed / passed barcode_failed / barcode_read
• Advanced: Enter the xml path (see below for format of the xml file) and license here
  xml=/opt/Papertrail/barcode.xml - Linux
  xml=C:\\Softek812\\barcode.xml - Windows
  LicenseKey=mylicensekey - Refer to LastPass Infrastructure Card

The next node rule will be extractFromIndex, targeting your Barcode Index barcode_value

• Filter: indexes.containsKey('barcode_value') && barcode_value!= '' && barcode_value!= null
• Use the regex to extract the barcode_value into separate indexes
• Important: Once added, navigate to the /web/portal interface and select the node where you have the rule set. Click the drop-down menu at the node name > Rules. Edit the extractFromIndex rule and set the event to Document.update_index

An XML file in the following format can be created to configure specific properties:

<xml version='1.0' encoding='iso-8859-1'>
    <SoftekBarcode>
        <Properties>
            <AllowDuplicateValues>1</AllowDuplicateValues>
            <BarcodesAtTopOfPage>0</BarcodesAtTopOfPage>
            <BitmapResolution>200</BitmapResolution>
            <CodabarMaxVariance>20</CodabarMaxVariance>
            <Code128Lenient>0</Code128Lenient>
            <Code25Checksum>0</Code25Checksum>
            <Code25MinOccurrenceLength>5</Code25MinOccurrenceLength>
            <Code39Checksum>0</Code39Checksum>
            <Code39MaxRatioPcnt>0</Code39MaxRatioPcnt>
            <Code39NeedStartStop>1</Code39NeedStartStop>
            <ColorChunks>1</ColorChunks>
            <ColorProcessingLevel>2</ColorProcessingLevel>
            <ColorThreshold>0</ColorThreshold>
            <ConvertUPCEToEAN13>1</ConvertUPCEToEAN13>
            <DataMatrixAutoUTF8>1</DataMatrixAutoUTF8>
            <DataMatrixFinderGapTolerance>6</DataMatrixFinderGapTolerance>
            <Despeckle>0</Despeckle>
            <Encoding>3</Encoding>
            <ErrorCorrection>0</ErrorCorrection>
            <ExtendedCode39>1</ExtendedCode39>
            <FastScanLineJump>25</FastScanLineJump>
            <FixedLengthCode25>0</FixedLengthCode25>
            <GammaCorrection>100</GammaCorrection>
            <LineJump>1</LineJump>
            <MaxBarcodesPerPage>0</MaxBarcodesPerPage>
            <MaxLength>999</MaxLength>
            <MaxThreads>0</MaxThreads>
            <MedianFilter>0</MedianFilter>
            <MedianFilterLevel>1</MedianFilterLevel>
            <MedianFilterBias>5</MedianFilterBias>
            <MinSeparation>180</MinSeparation>
            <MinLength>4</MinLength>
            <MinOccurrence>2</MinOccurrence>
            <MinResyncs>3</MinResyncs>
            <MinSpaceBarWidth>0</MinSpaceBarWidth>
            <MinThresholdDiff>30</MinThresholdDiff>
            <MultipleRead>1</MultipleRead>
            <NoiseReduction>0</NoiseReduction>
            <PageNo>1</PageNo>
            <PatchCodeMinOccurrence>30</PatchCodeMinOccurrence>
            <Pattern></Pattern>
            <Pdf417AutoUTF8>1</Pdf417AutoUTF8>
            <Pdf417Debug>0</Pdf417Debug>
            <Pdf417ChannelMode>0</Pdf417ChannelMode>
            <PDF417MacroEscapeBackslash>1</PDF417MacroEscapeBackslash>
            <PdfBpp>8</PdfBpp>
            <PdfDpi>300</PdfDpi>
            <PdfImageExtractOptions>0</PdfImageExtractOptions>
            <PdfImageOnly>1</PdfImageOnly>
            <PdfImageRasterOptions>0</PdfImageRasterOptions>
            <PdfMaxMem>32</PdfMaxMem>
            <Photometric>0</Photometric>
            <PrefOccurrence>5</PrefOccurrence>
            <QRCodeAutoUTF8>1</QRCodeAutoUTF8>
            <QRCodeBWAutoMedianFilter>1</QRCodeBWAutoMedianFilter>
            <QRCodeFinderTolerance>0</QRCodeFinderTolerance>
            <QuietZoneSize>0</QuietZoneSize>
            <QuotedPrintableCharSet>0</QuotedPrintableCharSet>
            <QRCodeReadInverted>1</QRCodeReadInverted>
            <ReadCodabar>1</ReadCodabar>
            <ReadCode128>1</ReadCode128>
            <ReadCode25ni>1</ReadCode25ni>
            <ReadCode25>1</ReadCode25>
            <ReadCode39>1</ReadCode39>
            <ReadCode93>1</ReadCode93>
            <ReadDatabar>1</ReadDatabar>
            <ReadDataMatrix>0</ReadDataMatrix>
            <ReadEAN8>1</ReadEAN8>
            <ReadEAN13>1</ReadEAN13>
            <ReadMicroPDF417>0</ReadMicroPDF417>
            <ReadNumeric>0</ReadNumeric>
            <ReadPatchCodes>0</ReadPatchCodes>
            <ReadPDF417>0</ReadPDF417>
            <ReadQRCode>1</ReadQRCode>
            <ReadShortCode128>0</ReadShortCode128>
            <ReadUPCA>1</ReadUPCA>
            <ReadUPCE>1</ReadUPCE>
            <ReportUnreadBarcodes>0</ReportUnreadBarcodes>
            <RotateBy45IfNoBarcode>0</RotateBy45IfNoBarcode>
            <SkewedLinear>1</SkewedLinear>
            <ResyncChars>2</ResyncChars>
            <ResyncRows>10</ResyncRows>
            <ScanDirection>15</ScanDirection>
            <ShortCode128MinLength>2</ShortCode128MinLength>
            <SkewLineJump>9</SkewLineJump>
            <SkewTolerance>0</SkewTolerance>
            <ShowCheckDigit>0</ShowCheckDigit>
            <ShowCodabarStartStop>1</ShowCodabarStartStop>
            <SkewSpeed>3</SkewSpeed>
            <TwoDTimeOutPcnt>80</TwoDTimeOutPcnt>
            <TimeOut>30000</TimeOut>
            <UseFastScan>1</UseFastScan>
            <UseOldCode128Algorithm>0</UseOldCode128Algorithm>
            <UseRunCache>1</UseRunCache>
            <UseScaledFaxCoords>1</UseScaledFaxCoords>
            <UseOverSampling>0</UseOverSampling>
            <WeightLongerBarcodes>1</WeightLongerBarcodes>
        </Properties>
    </SoftekBarcode>
</xml>

Supported Barcodes

• Codabar also known as Code 2 of 7, Codeabar, Ames Code, NW-7 and Monarch (ReadCodabar)
• Code 128 Symbol Sets A, B and C (ReadCode128)
• Code 128 Short Format (ReadShortCode128)
• Code 2 of 5 Datalogic (ReadCode25ni)
• Code 2 of 5 Iata1 (ReadCode25ni)
• Code 2 of 5 Iata2 (ReadCode25ni)
• Code 2 of 5 Industrial (ReadCode25ni)
• Code 2 of 5 Interleaved (ReadCode25)
• Code 2 of 5 Matrix (ReadCode25ni)
• Code 3 of 9 (ReadCode39)
• Code 3 of 9 Extended (ReadCode39 and ExtendedCode39)
• Code 93 (ReadCode93)
• EAN-8, European Article Number/International Article Number (ReadEAN8)
• EAN-13 and UPC-A, European Article Number/International Article Number (ReadEAN13)
• GS1-128, UCC-128, EAN-128 (ReadCode128)
• GS1-Databar (please see 2-D section below)
• Patch Code Symbols (ReadPatchCodes)
• UPC-A, Universal Product Code (ReadEAN13 and ReadUPCA)
• UPC-E, Universal Product Code (ReadUPCE)
• QR-Code (ReadQRCode)
• Data Matrix ECC200 sizes 8x8 to 144x144 (ReadDataMatrix)
• GS1-Databar
• Micro-PDF-417 (ReadMicroPDF417)
• PDF-417, Portable Data File (ReadPDF417)

Properties