1. Home
  2. Transact
  3. Features and Functions
  4. Administrator Role and Features
  5. Modules and Plugins
  6. Page Process Module
  7. Advanced Barcode Reader Plugin

Advanced Barcode Reader Plugin


In this document, you will learn how to configure the ADVANCED_BARCODE_READER plugin for document classification and extraction.

Use Cases

Advanced barcode classification and extraction is useful when:

  • You are classifying or extracting data from documents with multiple barcodes on a single page.
  • You are classifying or extracting data from documents with both 1D and 2D barcodes.
  • You are looking for an alternative to RecoStar Fixed Form barcode extraction.


This section outlines the prerequisites required to perform advanced barcode classifying or extraction.

  1. You will need a batch class with at least one document type and index field. For detailed steps, refer to the following articles:
  2. You will need to add the ADVANCED_BARCODE_READER plugin to the Page Process module for your batch class.
  3. If you are performing barcode extraction, you will need to add the ADVANCED_BARCODE_EXTRACTION plugin to the Extraction module for your batch class.
  4. You will need to set the Document Assembler plugin to Barcode classification or Automatic classification. See Document Assembler Plugin for more information.
  5. For Barcode classification to work, you will also need to configure a Document Type with the exact name that the barcode value will output.

Note: For more information on managing plugins, refer to Module and Plugin Configuration.

Note: To use the RecoStar barcode method, RECOSTAR_HOCR Plugin must be added to the workflow.


The advanced barcode plugins use the advanced barcode engine, which allows you to have more control over the classification and extraction results in certain scenarios.

We recommend using the advanced barcode plugins over the standard barcode plugins is recommended if your documents have multiple barcodes on a single page.

Configure Advanced Barcode Reader Plugin

This section provides information on how to configure the ADVANCED_BARCODE_READER plugin. This plugin only needs to be configured once per batch class.

To navigate to the plugin:

  1. Go to the Batch Class Management page.
  2. Select your batch class and click Open.
  3. Go to Modules > Page Process > ADVANCED_BARCODE_READER.

Figure 1. Reader Plugin Configuration

Configure the plugin. The following are the configurable properties for this plugin.

Configurable property Options Description
Reader Switch
  • ON
  • OFF
This switch enables or disables barcode classification.
Barcode Confidence Number (0-100) This is the confidence threshold for barcode classification.

Ephesoft Transact will filter out barcode results that have a confidence value less than this specified threshold.

Barcode Methods The available options vary by operating system:


  1. Zxing
  2. Bytescout
  3. RecoStar


  1. Zxing
  2. Bytescout
  3. Nuance
  4. RecoStar
Use this property to drag and drop the default barcode engines in order of priority.

Ephesoft Transact will attempt classification using the engine that is listed as first priority. If Transact can not classify the document using the first Barcode Method that is listed, then Transact will proceed down the list until extraction is successful. Once a barcode is extracted, other engines with lower priorities are ignored.

Note: You can delete a barcode engine by right-clicking the name and selecting Delete.

Use All barcode Tools
  • ON
  • OFF
This switch enables or disables using all barcode methods.
Barcode Region
  • Barcode Type
  • Whole Page
  • Top Left
  • Top Right
  • Bottom Left
  • Bottom Right
Use this property to specify the zone on the page from which the barcode should be located.

Note: Performance and accuracy will increase if a smaller region is specified.

This option is available for 2020.1.06 and above.

Note: In Ephesoft Transact 2019.1 and below, using the RecoStar engine has a limitation in which the RecoStar plugin thread only allows the usage of one license. The limitation of one thread applies when there is a license for up to 8 cores, which may cause slow processing when using the Page Process module. This does not affect Ephesoft Transact 2019.2 and above.


You can test the plugin configuration in the Plugin Configuration screen.

    1. With the plugin configured, click Select Files or drag-and-drop test files to the Upload Files section.
    2. Click Test Barcode. The results will appear in the Test Barcode Results pane.
    3. If you are satisfied with the results, select Deploy to save your changes and deploy the new workflow.

Note: If you receive the message “No Results found for Barcode Extraction”, you may need to lower the Barcode Confidence, or select a different Barcode Type.

Was this article helpful to you? Yes 1 No