# Stapelklasseneigenschaften OCR-Texterkennung

## Allgemeines

Die OCR Extraktion ist ein elementarer Teil der Squeeze Software. Dieser Kernbereich der Software ist mit verschiedenen Einstellungen versehen, die das Ergebnis der Extraktion tangieren. Im folgenden Artikel gehen wir auf die Besonderheiten und die Anforderungen der unterschiedlichen Eigenschaften ein.

#### Welche Arten der OCR unterstützt Squeeze?

Grundsätzlich unterscheiden wir im Kontext von Squeeze zwischen dem Einsatz einer OCR basierend auf den Ressourcen der lokalen Maschine und dem Einsatz eines Remote-OCR-Dienstes.

#### Was beinhaltet meine Standardversion von Squeeze? 

Im Auslieferungszustand ist Squeeze mit einer lokal verfügbaren OCR-Engine ausgestattet. Auf Kundenwunsch können unsere Berater bei einer Squeeze Installation ab der Version 2.4 eine Remote-OCR aktivieren, die mithilfe von AI bessere Ergebnisse liefern kann.

## Allgemeine Stapelklassen-Eigenschaften

#### OCREngine (ab Squeeze 2.4)

Wird diese Stapelklassen-Eigenschaft nicht konfiguriert greift automatisch die lokale OCR-Engine `ocrmypdf`.  
Je nach Spezifikation und Lizensierung ihres Squeeze-Systems können folgende Optionen für die OCREngine verwendet werden:

<table border="1" id="bkmrk-squeeze-version-opti" style="border-collapse: collapse; width: 100%; height: 116px;"><tbody><tr style="height: 29px;"><td style="width: 50%; height: 29px;">Squeeze Version</td><td style="width: 50%; height: 29px;">Optionen</td></tr><tr style="height: 10px;"><td style="width: 50%; height: 10px;">ab 2.4.0</td><td style="width: 50%; height: 10px;">`default`</td></tr><tr style="height: 28px;"><td style="width: 50%; height: 28px;">ab 2.4.0</td><td style="width: 50%; height: 28px;">`ai-ocr`</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">ab 2.5.0</td><td style="width: 50%; height: 29px;">`maxocr`</td></tr><tr><td style="width: 50%;">ab 2.6.0</td><td style="width: 50%;">`proxy-ocr`</td></tr></tbody></table>

##### Voraussetzungen:

- default:  
    
    - keine
- ai-ocr: 
    - um die Remote-AI-OCR zu verwenden ist es notwendig dass eine Internetverbindung auf dem System existiert und dass die Anmeldedaten von Ihrem Squeeze Berater konfiguriert werden.
- maxocr 
    - die konfigurierte Mandanten-Konfiguration/Server-Konfiguration für die [Dexpro Platform Integration](https://docs.squeeze.one/books/dexpro-platform/page/integration-in-squeeze "Integration in Squeeze").
    - die[ MaxOCR konfiguration](https://docs.squeeze.one/books/dexpro-platform/page/maxai-ocr "MaxOCR").
- proxy-ocr 
    - die [KI Proxy Konfiguration](https://docs.squeeze.one/books/squeeze-2-admin-handbuch/page/ki-proxy-konfiguration "KI Proxy Konfiguration")

## Stapelklassen-Eigenschaften für die lokale OCR Engine

#### OCRForce

Im Standard wird bei digitalen PDF´s der Textlayer genutzt und die Felderkennung darauf angewendet (`false`). Um aber eine OCR zu erzwingen ist dieser Schalter auf `true` zu setzen.

#### OCRLanguage

Im Standard werden die Sprachpakete Deutsch und Englisch verwendet. Für die deutsche Detektion wird der Wert `deu` eingetragen und für die englische Detektion der Wert `eng` eingetragen.

Hier können projektspezifisch auch weitere Sprachen oder abgewandelte Sprachpaket-Varianten angegeben werden, bei denen die OCR schneller/langsamer bzw. mit niedriger/höherer Qualität Ergebnisse liefert. Im folgenden eine Übersicht über die im Standard enthaltenen Sprachpakete:

<table border="1" id="bkmrk-squeeze-version-opti-0" style="border-collapse: collapse; width: 100%;"><tbody><tr><td style="width: 50%;">Squeeze Version</td><td style="width: 50%;">Optionen</td></tr><tr><td style="width: 50%;">vor 2.4.0</td><td style="width: 50%;">- deu
- eng

</td></tr><tr><td style="width: 50%;">ab 2.4.0</td><td style="width: 50%;">- deu, deu\_best, deu\_fast, deu\_std
- lat\_best, lat\_fast, lat\_std
- eng
- osd

</td></tr></tbody></table>

#### OCRPageLimit

Anzahl der auszulesenden Seiten im Dokument. Syntax n-m

Beispiel für Auslesung der ersten 3 Seiten: 1-3

#### PDFA-Conversion

Es wird ein PDFA kompatibles Dokument erzeugt. Eingabe 1|0 (`true`|`false`)

#### PDFProcessor

Hier gilt `PDFBox` als Standard. `PDFMiner` ist die Alternative .

#### PSM-Modes

Im Project bietet es sich an, die Modi 3, 4, 6 und 11 zu verwenden. Dabei gilt 3 als Standard.

<div id="bkmrk-3-standardeinstellun"><table border="1" style="border-collapse: collapse; width: 100%; height: 116px;"><tbody><tr style="height: 29px;"><td style="width: 4.44444%; height: 29px;">3</td><td style="width: 95.5555%; height: 29px;"><span class="enlighter-n1">Standardeinstellung liefert gute Ergebnisse.</span></td></tr><tr style="height: 29px;"><td style="width: 4.44444%; height: 29px;">4</td><td style="width: 95.5555%; height: 29px;"><span class="enlighter-text">Wortweise Segmentierung. Es wird nicht nach Zeilen geschaut sondern Worten. (verfügbar ab Version 2.0)</span></td></tr><tr style="height: 29px;"><td style="width: 4.44444%; height: 29px;">6</td><td style="width: 95.5555%; height: 29px;"><span class="enlighter-text">Gut für Positionsdaten. Hat aber Probleme bei Linien die sehr dicht am Text sind.</span></td></tr><tr style="height: 29px;"><td style="width: 4.44444%; height: 29px;">11</td><td style="width: 95.5555%; height: 29px;"><span class="enlighter-n1">Gut bei vielen Grafiken auf den Dokumenten.</span></td></tr></tbody></table>

</div>#### OCRRotationThreshold

Mit dieser Eigenschaft können Sie beeinflussen wie *agressiv* Seiten in der OCR gedreht werden. Nutzen Sie diesen Wert, wenn Dokumente falsch gedreht werden.

Geringe Werte führen dazu, dass mehr Dokumente gedreht werden. Die Software muss sich also nicht sehr sicher sein, dass eine Seite rotiert werden muss.

Hohe Werte führen dazu, dass Dokumente seltener gedreht werden, also nur wenn sich die Software sehr sicher ist, dass eine Seite rotiert werden muss.

Im Standard ist dieser Wert `9.0`

## Stapelklassen-Eigenschaften für die Remote-AI-OCR/MaxOCR/KI-Proxy Engine

<p class="callout info">Aktuell gibt es keine Möglichkeiten die Remote-AI-OCR zu beeinflussen. </p>

## Fragen und Antworten?

1. Ich habe die `ai-ocr/maxocr` als OCREngine Eigenschaft ausgewählt, jedoch funktioniert die Texterkennung nicht mehr ? 
    - Gehen Sie bitte Sicher das Ihr Squeeze Berater die notwendigen Anmeldedaten zur Aktivierung der Remote OCR hinterlegt hat.
2. Ich habe mit der Remote-AI-OCR ein Dokument verarbeitet, mehrere Dokumente liefen erfolgreich durch, jedoch bleibt dieses Dokument hängen. 
    - Aufgrund der begrenzten Ressourcen kann die AI-Remote-OCR maximal 100 Seiten pro Dokument verarbeiten. Überprüfen Sie daher die Anzahl der Seiten und nutzen bei nicht erfolgreicher Verarbeitung die lokale OCR.
3. Ich nutze die Remote-AI-OCR und und mein Dokument hat mehrere Seiten jedoch nicht mehr als 100 Seiten trotzdem hängt das Dokument in der Verarbeitungskette fest. 
    - Squeeze wartet insgesamt 3 Minuten auf die Verarbeitung des Dokumentes. Konnte der entfernte Dienst innerhalb dieser 3 Minuten das Dokument nicht verarbeiten, wird Squeeze eine Fehlermeldung mit einem Timeout Hinweis liefern. Schieben Sie das Dokument erneut über die technische Warteschlange in den Schritt "Texterkennung" Squeeze prüft in dem Fall ob das bereits hochgeladene Dokument verarbeitet wurde.