KB00007045: Batch Error with RECOSTAR_HOCR Plugin


In Ephesoft Transact 4.5.X.X, 2019.1, and 2019.2, a batch error occurs while running the RECOSTAR_HOCR plugin. The error message says, “Uncaught Exception in readOCR method. Exception occurred while process PDF page for EText.”

This occurs when the batch class RECOSTAR_HOCR plugin parameter has Use EText Recostar Project File  set to Automatically. However, the same batch processes successfully when Use EText Recostar Project File is set to Never OR Use EText Recostar Project File is set to Always. The issue is caused by the third-party IText API.


Ephesoft Support recommends upgrading the version of IText from 5.4.1 to 5.5.12.

  1. Log in to the Customer Portal Downloads page

Note: A customer portal account will be required to access this page.

  1. Locate and download the following hotfix: ITEXT 5.5.12 Library Upgrade.
  2. Stop the Ephesoft Transact server.
  3. Download and extract HOTFIX_EEN-24034_2019.1_ItextUpgrade_18Oct_2019.zip to a temporary location on your system.
  4. Navigate to the following directory: [EPHESOFT_HOME]\Application\WEB-INF\lib\
  5. Create a backup and delete the following:
    • itextpdf-5.4.1.jar
    • itext-pdfa-5.4.1.jar
    • itext-xtra-5.4.1.jar.
  1. Copy the extracted files listed below to the following directory: [EPHESOFT_HOME]\Application\WEB-INF\lib\
    • itextpdf-5.5.12.jar
    • itext-pdfa-5.5.12.jar
    • itext-xtra-5.5.12.jar
    • commons-imaging-1.0-SNAPSHOT.jar
  1. Start the Ephesoft Transact server.