Spezielle Funktionen von ABBYY FlexiLayout Studio für das Erstellen zusätzlicher FlexiLayouts

1. Öffnen Sie einen Stapel mit erkannten Rechnungen in ABBYY FlexiCapture
2. Erstellen Sie ein neues Projekt in ABBYY FlexiLayout Studio. Wählen Sie im Hauptmenü Tools → Stapel zu FlexiLayout Studio exportieren → Neues FLS-Projekt erstellen....

Hinweis. Dieser Befehl ist nur verfügbar fürABBYY FlexiCapture Projekte, die auf Ihrem Computer gespeichert sind. Nutzen Sie eine verteilte Version von ABBYY FlexiCapture und das Projekt ist auf dem Server gespeichert, muss es zuerst durch Klicken auf Projekt exportieren... im Menü Projekt auf Ihren Computer heruntergeladen werden.

Hinweis. Der Suffix des ABBYY FlexiLayout Studio-Projekts gibt die Version der Dokumentdefinition zum Zeitpunkt der Projekterstellung an.

Das von Ihnen soeben erstellte ABBYY FlexiLayout Studio-Projekt enthält alle Dokumente aus dem ABBYY FlexiCapture-Stapel und die Regionen der Felder, die während der Erkennung in ABBYY FlexiCapture in der Form eines Referenzlayouts erfasst wurden.

Um einem zusätzlichen FlexiLayout ein Feld hinzuzufügen, muss ein Block für dieses Feld erstellt und dessen Suchelement festgelegt werden.

Die Felder in der Dokumentdefinition müssen einzigartige Namen besitzen. Das bedeutet:

• Zur Beschreibung der Suchlogik für ein Feld muss ein Block mit einem einzigartigen Namen erstellt werden.
• Zur Änderung der Suchlogik für ein Feld, das bereits in der Dokumentdefinition vorhanden ist, muss ein Block mit demselben Namen erstellt werden.

Wenn Sie die an einem zuätzlichen FlexiLayout vorgenommenen Änderungen an einem neuen Bild testen möchten, können Sie Ihre ABBYY FlexiCapture Stapel in ein vorhandenes Rechnungsprojekt in ABBYY FlexiLayout Studio exportieren. Um Ihre Stapel zu exportieren, klicken Sie auf Tools → Stapel zu FlexiLayout Studio exportieren → Hinzufügen zu vorhandenem FLS-Projekt....

• Sie können die Stapel ABBYY FlexiCapture nur in die ABBYY FlexiLayout Studio-Projekte exportieren, die durch die Auswahl von Tools → Export Batch to FlexiLayout Studio → Neues FLS-Projekt erstellen....
• Wenn Sie einen ABBYY FlexiCapture Stapel zu ABBYY FlexiLayout Studio exportieren, wird für diesen Stapel in ABBYY FlexiLayout Studio ein neuer Stapel erstellt.
• Enthält die neue Dokumentdefinition mehr Felder als die für das ABBYY FlexiLayout Studio-Projekt verwendete Dokumentdefinition, enthält das Exportprotokoll eine Warnung für jedes Zusatzfeld.
• Damit das Progamm die Zusatzfelder exportiert, fügen Sie für jedes Zusatzfeld einen Block mit dem gleichen Namen im Knoten CommonBlockRegions zur Struktur SearchElements hinzu.

Sie finden eine Beispielanfrage im Element "DataSetRequestSample". Dieses Element ist standardmäßig deaktiviert.

Functionen

Syntax:

• Der Pfad zur Dokumentdefinition und der Name des Datensatzes werden bei der Arbeit mit einem FlexiLayout in ABBYY FlexiLayout Studio für den Zugriff auf den Datensatz verwendet.
• Nachdem ein kompiliertes FlexiLayout einer Dokumentdefinition in ABBYY FlexiCapture hinzugefügt wurde, wird beim Zugriff auf den Datensatz nur dessen Name verwendet.
• connectionString Format:

"dbtype=FCDataset;fcTemplate=path_to_Document_Definition;datasetName=name_of_Data_Set;"

Hinweis. Teile des Pfads müssen durch doppelte umgekehrte Schrägstriche getrennt werden "\\"

• searchFields
  Array der Namen der Spalten, aus denen die Werte abgerufen werden sollen.
• searchCriteria
  Array aus Spalten-Eintrags-Paaren, gibt alle Werte zurück, wenn leer.
• Enthält eine Anfrage mehrere Werte für ein Feld, verwenden Sie den Operator OR
• Enthält eine Anfrage mehrere Werte, wobei jeder davon nur einem Feld entspricht, verwenden Sie den Operator AND
• Enthält eine Anfrage mehrere Werte für ein Feld und Werte für mehrere Felder, verwenden Sie den Operator OR, um mehrere Werte für ein Feld zu trennen, und den Operator AND für die Verbindung von Werten für verschiedene Felder.

Suchen nach Zeilen von einer Spalte aus einer externen Datenbank in einem Bild

1. Mit FieldNamesOfFCDataset erhalten Sie eine Liste der Spalten, sortiert in aufsteigender Reihenfolge ihrer Indexnummern.
2. Bestimmen Sie die Indexnummer der Spalte, in der Daten gefunden werden sollen.
3. Erstellen Sie aus dem Datensatz ein Array von Bedingungen für die Filterung von Daten.
4. Geben Sie die Indexnummern der Spalte und die Filterbedingungen an SearchTextFromFCDataSet weiter (oder an RegularExpressionFromFCDataSet, wenn reguläre Ausdrücke verwendet werden müssen).

Dieser Code wird automatisch generiert, sobald ein erkannter Stapel von ABBYY FlexiCapture exportiert wird

Ein Bild nach Einträgen aus mehreren Spalten einer externen Datenbank durchsuchen

Da die Suchparameter bei jedem Aufruf der Funktion SearchTextFromFCDataSet ersetzt werden, ist der mehrmalige Aufruf dieser Funktion sinnlos. Aber es gibt eine Lösung: Sie können Zeichenfolgen von einer externen Datenbank abrufen und diese an die Funktion SearchText weiterleiten. Der Aufruf dieser Funktion fügt den String den vorhandenen Suchparametern hinzu, anstatt diese zu ersetzen.

Führen Sie dafür die folgenden Schritte aus:

1. Erstellen Sie ein Array aus Namen der Spalten, in denen Daten gesucht werden sollen.
2. Erstellen Sie ein Array von Filterbedingungen für die Filterung von Daten aus dem Datensatz.
3. Bestimmen Sie die Menge von Einträgen, die bei der Verwendung der Funktion RecordCountOfFCDataset zurückgegeben werden.
4. Bereiten Sie mithilfe der Funktion PrepareRecordsetOfFCDataset die Abfragedaten vor.
5. Durchsuchen Sie alle Einträge und finden Sie mithilfe der Methode RecordOfFCDataset das Array für jeden Eintrag.
6. Geben Sie den Wert der einzelnen Elemente im Array an die Funktion SearchText weiter.

Zusätzliche Überlegungen im Umgang mit komplexen Spalten

• Die Funktion FieldNamesOfFCDataset gibt ein Array zurück, in dem der Name der komplexen Spalte mehrmals auftritt. Die Anzahl der Vorkommen entspricht der Anzahl der Spalteninstanzen in einer codierten externen Datenbank.
  Beispiel: {VendorId, VATID, Name, Name, Name, City}. In diesem Falle enthält die externe Datenbank 3 Spalten für die eine komplexe Spalte im Datensatz Name.
• Enthält SearchCriteria eine Bedingung für ein Feld, das der komplexen Spalte entspricht (wie im Beispiel oben), wird diese Bedingung für die Überprüfung aller dieser Spalteninstanzen verwendet.
• Enthält searchFields eine Bedingung für ein Feld, das der komplexen Spalte entspricht (wie im Beispiel oben), enthält das Ergebnis das Array aus Werten jeder Spalteninstanz.
  Beispielsweise, wenn Sie für {VendorId, VATID, Name, Name, Name, City} anfordern:

searchFields = { VATID, Name, City}, werden Sie erhalten
{VATID_value, Name_valueInColumn1, Name_valueInColumn2, Name_valueInColumn3, City_value}
          

• Sie erhalten eine Liste der Spalten, die durch die Weitergabe des Arrays searchFields an die Funktion FieldNamesOfFCDataset zurückgegeben wird.

Sie können mithilfe der in der Dokumentation für ABBYY FlexiLayout-Studio beschriebenen zwei Standardfunktionen Anfragen an eine XML-Datei mit FlexiLayout-Einstellungen stellen:

StringArray ReadFromXML(String filename, String xPathQuery)
String ReadSingleStringFromXML(String filename, String xPathQuery)
          

Das Element XMLSettingsSample enthält Beispielcode, der eine Liste von Schlüsselwörtern aus der Datei KeywordsCustom.xml ausliest. Diese Datei finden Sie im Unterordner Einstellungen des ABBYY FlexiLayout Studio-Projektordners.

Diese Datei muss sich in den Unterordnern des ABBYY FlexiLayout Studio-Projektordners befinden, wenn diese bei der Arbeit mit einem FlexiLayout in ABBYY FlexiLayout Studio verwendet werden soll. Der Pfad zu dieser Datei ist relativ zur ABBYY FlexiLayout Studio-Projektdatei.

Laden Sie ein kompiliertes FlexiLayout in eine Dokumentdefinition in ABBYY FlexiCapture und verwenden es als zusätzliches FlexiLayout, wird die XML-Datei im Ordner Vorlagen abgelegt, wo sie dann bearbeitet werden kann. Wird das FlexiLayout angewendet, verwaltet das Programm den Zugriff auf diese Datei automatisch.