Skip to main content

Legacy OCR using your own ABBYY license key

warning

As of version 6.4.0+, you can use the Conversion Service with the Pdftools OCR Service. The configuration described on this page is legacy. If you are setting up a new OCR workflow, refer to Pdftools OCR Service for the current solution.

Install ABBYY​

Prerequisites

To use OCR in the Conversion Service, you need:

  • A Windows Server machine to install the ABBYY FineReader OCR Engine.
  • An ABBYY OCR license issued by Pdftools. Use the Contact form if you require a license.
  • The ABBYY FineReader Engine installer from the Pdftools Customer portal. The Conversion Service supports ABBYY FineReader Engine v11 and v12.

Install the OCR Engine on the Windows Server machine using the Pdftools ABBYY FRE installer.

After installation, activate your ABBYY license.

Activate ABBYY license​

There are two types of ABBYY licenses:

Online license​

ABBYY offers online licenses. If you purchased an online license through Pdftools, contact Pdftools support. Our support will guide you through the license activation process.

When you receive the online license, we will send you an email message forwarding ABBYY’s email. This email message includes a ZIP file (for example, SWATXXXXXXXX.zip) containing password.txt and SWATXXXXXXXXX.ActivationToken.

Standalone license​

Activate the standalone license using the following steps:

  1. Open the ABBYY License Manager.
  2. Click Activate License.
  3. Insert the ABBYY license key and complete activation.
note

If you have the online license type and try to activate it using these steps reserved for the standalone license type, your online license can be locked. In such a case, please contact Pdftools support to resolve the issue.

Summary​

Enable and configure OCR​

info

You can only activate OCR processing for the archive and conversion workflows.

The following steps explain how to activate and configure OCR in a profile:

  1. In the Conversion Service Configurator, go to Workflows & Profiles.

  2. Choose a profile where you want to activate the OCR, and then edit or duplicate this profile.

  3. Enable the OCR Settings processing toggle.

    The OCR Settings processing toggle enabled.

  4. Navigate to the now visible configuration section OCR Settings.

  5. In the OCR Settings section, click the Add Item button.

  6. Select the version of the ABBYY FineReader Engine you installed, and then click on Next.

  7. Confirm the values with Apply, or configure the OCR engine in more detail following the instructions in the following section.

Built-in documentation

For more information about the resulting page rendering configuration, such as the resolution, image processing, and text processing details, refer to the built-in documentation within the Conversion Service Configurator. To access built-in documentation, click the icon next to the OCR Settings configuration section header.

Conversion Service configurator built-in documentation

Configure ABBYY FineReader Engine​

Change the predefined profile for ABBYY FineReader Engine, add a custom profile, or configure languages the OCR scans for:

  1. In the Conversion Service Configurator, go to Workflows & Profiles.
  2. Choose the profile where you activated the OCR.
  3. Navigate to the configuration section OCR Settings.
  4. In the OCR Settings section, click the Add Item button.
  5. Select the version of the ABBYY FineReader Engine you installed, and then click on Next.
  6. Change the custom profile, predefined profile, or language that OCR scans for in the window Step 2: Configure Selected Engine. See the sections below for more information about each of these procedures.

Configure the ABBYY FineReader OCR Engine with the Conversion Service Configurator

info

To change a language the OCR must identify, use the internal name from Predefined Languages in ABBYY FineReader Engine in the ABBYY FineReader documentation.

tip

Review the following sections for more information about the configuration of the ABBYY FineReader PDF.

Predefined profile​

The ABBYY predefined OCR engine profiles are designed for specific use cases.

Profile NameDescription
DefaultThe default ABBYY profile.
Document Conversion (Accuracy)Optimized for accuracy. Convert documents into editable formats.
Document Conversion (Speed)Optimized for speed. Convert documents into editable formats.
Text Extraction (Accuracy)Optimized for accuracy. Extract text from documents.
Text Extraction (Speed)Optimized for speed. Extract text from documents.

For more information, see the Predefined profiles in the ABBYY documentation.

tip

Select the standard profile or the most suitable profile for your use case. Adjust individual configuration values to your needs using a custom profile.

Custom profile​

With a customized profile, you can adjust individual configuration options of the OCR Engine according to your requirements. Create your customized profile as an INI file and enter the path to this file in the custom profile field. The configuration values of the customized profile take precedence over the preset values of the selected predefined profile.

info

Pdftools integration of the ABBYY OCR Engine is custom. Some options (for example, PDFExportParams) do not affect the OCR result.

For more information about custom profiles, see User profiles in the ABBYY documentation.

Language configuration​

Configure all languages that appear in your documents to improve optical recognition accuracy.

Configure all languages included in the documents

The ABBYY FineReader Engine only recognizes characters that are used in the languages you configured. For example, if you only choose English, some special characters like German umlauts (äöü) are not identified correctly and can be identified as different letters (aou). Choose the languages used in the documents to avoid such mistakes.

See the Predefined Languages in ABBYY FineReader Engine in the ABBYY documentation.