ABBYY FlexiCapture Connect

Installieren und konfigurieren Sie ABBYY FlexiCapture Connect, den Windows-Service, der Dokumente importiert und exportiert sowie Datensätze mit Cloud-Projekten synchronisiert.

ABBYY FlexiCapture Connect wird als Windows-Service ausgeführt und ermöglicht es Nutzern, Dokumente in ABBYY FlexiCapture Cloud-Projekte zu importieren, Dokumente aus ABBYY FlexiCapture Cloud-Projekten zu exportieren und Datensätze zu synchronisieren.

​

Systemanforderungen

Anforderung	Details
Betriebssystem	Windows 10, Windows 11 oder Windows Server 2012, 2012 R2, 2016, 2019, 2022 oder 2025 (jeweils mit Desktop Experience).
RAM	Für einen Datensatz mit ungefähr 500.000 Vendors werden mindestens 2,5 GB empfohlen.
Softwarekompatibilität	ABBYY FlexiCapture Application Server Release 3 oder höher; .NET Framework 4.6.1 oder höher.

​

Einrichtung

So konfigurieren Sie ABBYY FlexiCapture Connect:

Wir empfehlen, für die Anweisungen in diesem Abschnitt Ihr Servicekonto zu verwenden.

1. Laden Sie das Installationsprogramm herunter und führen Sie es aus

   Laden Sie die Datei FlexiCapture_Connect_Installer_*.msi von https://www.abbyy.com/flexicapture-downloads/cloud/ herunter und führen Sie sie aus.

   Wenn ABBYY FlexiCapture Connect bereits installiert ist und Sie eine vorhandene Version aktualisieren, erstellen Sie eine Backup-Kopie der Datei config.json, die sich unter C:\Program Files (x86)\ABBYY FlexiCapture Connect\config.json befindet.

2. Ändern Sie die Konfigurationsdatei

   Passen Sie die Datei config.json an Ihre Anforderungen an (siehe Erläuterung der Konfigurationsdatei unten).

3. Testen Sie die neue Konfiguration

   1. Pausieren Sie den ABBYY FlexiCapture Connect Service.
   2. Führen Sie die Datei ABBYY.FlexiCapture.Connect.exe aus. Ein Konsolenfenster mit einem detaillierten Protokoll wird angezeigt.
4. Starten Sie den Service neu

   Starten Sie ABBYY FlexiCapture Connect neu.

​

Erklärung der Konfigurationsdatei

Eine typische Konfigurationsdatei sieht so aus:

{
  "url": "https://europe.flexicapture.com/",
  "tenant": "testtenant",
  "user": "user1",
  "password": "password1",
  "projects": [
    {
      "name": "project1",
      "import": {
        "directory": "C:\\HotFolder\\Import",
        "fileMask": "*",
        "settings": {
          "region": "US",
          "verification_type": "NoVerification",
          "export_format": "Xml"
        },
        "createDocument": "ForEachFile",
        "period": "00:01:00",
        "schedule": [ "12:00:00", "06:00:00" ]
      },
      "export": {
        "directory": "C:\\HotFolder\\Export",
        "period": "00:01:00",
        "schedule": [ "12:00:00" ]
      },
      "templates": [
        {
          "name": "template",
          "datasets": [
            {
              "name": "DataSet",
              "file": "C:\\HotFolder\\DataSets\\DataSet.csv",
              "period": "00:01:00",
              "schedule": [ "12:00:00" ]
            }
          ]
        }
      ]
    }
  ]
}

Im Folgenden werden die Abschnitte einer typischen Konfigurationsdatei beschrieben.

​

Allgemeine Einstellungen

• url — Die URL des Mandanten (zum Beispiel https://europe.flexicapture.com).
• tenant — Der Name des Mandanten.
• user — Der Benutzername des Servicekontos.
• password — Das Kennwort des Servicekontos.
• projects — Enthält Einstellungen für einzelne Projekte, z. B. für den Dokumentimport und -export sowie für die Synchronisierung von Datensätzen.

Um Dokumente zu importieren und zu exportieren, richten Sie das Mandantenkonto als External User ein. Für die Synchronisierung von Datensätzen benötigt das Mandantenkonto entweder die Rolle Administrator oder sowohl Project Settings Editor als auch External User. Standardmäßig hat das Mandantenkonto Zugriff auf alle Projekte; Sie können dies ändern, indem Sie die Zugriffsrechte für bestimmte Benutzerrollen anpassen. Weitere Informationen finden Sie unter Benutzerrollen und Zugriffsrechte einrichten.

​

Projekteinstellungen

• name — Projektname.
• import — Einstellungen für den Dokumentimport.
• export — Einstellungen für den Dokumentexport.
• templates — Einstellungen für die Synchronisierung von Datensätzen.

​

Importeinstellungen

• directory — Der Pfad zum Ordner, aus dem Dokumente importiert werden.
• fileMask — Ein Datei- und Ordnerfilter. Die Platzhalter * und ? werden unterstützt.
• settings — Registrierungsparameter des Batchs.
• createDocument — Mögliche Werte sind ForEachFile (erstellt für jede importierte Datei ein separates Dokument) oder Automatically (verwendet Projektparameter). Um diese Funktion zu nutzen, wählen Sie zunächst im ABBYY FlexiCapture-Projekt die Option Automatisch, wenn Document Definition angewendet wird aus.
• period und schedule — Aufgabenzeitplan. Die Eigenschaft period gibt an, wie oft die Aufgabe gestartet wird (zum Beispiel startet "period": "00:02:30" die Aufgabe alle zweieinhalb Minuten). Die Eigenschaft schedule gibt die Zeiten an, zu denen die Aufgabe gestartet wird (zum Beispiel startet "schedule": [ "09:00:00", "19:00:00" ] die Aufgabe täglich um 9:00 und 19:00 Uhr).

Bei jedem Dateimport wird ein neuer Batch erstellt. Der Batch-Name enthält das aktuelle Datum und die aktuelle Uhrzeit. Die Eigenschaften period und schedule können unabhängig voneinander festgelegt werden.

​

Exporteinstellungen

• directory — Der Pfad zum Ordner, in dem exportierte Dateien gespeichert werden.
• period und schedule — Der Aufgabenzeitplan, der genauso angegeben wird wie in den Importeinstellungen.

Wenn Dokumente exportiert werden, wird für jeden Batch im Projekt, der sich derzeit in der Stufe „Processed“ befindet, ein Ordner erstellt. Diese Zielordner tragen dieselben Namen wie die jeweiligen Batches und enthalten alle Verarbeitungsergebnisse. Wenn ein Zielordner gelöscht wird, erstellt das Programm einen neuen Ordner mit demselben Namen und legt die Verarbeitungsergebnisse dort ab. Die Eigenschaften period und schedule können unabhängig voneinander festgelegt werden.

​

Einstellungen der Dokumentdefinition

• name — Der Name der Dokumentdefinition, auf die sich der jeweilige Abschnitt bezieht.
• datasets — Die Parameter für die Datensatzsynchronisierung der Dokumentdefinition.

​

Einstellungen für die Datensatzsynchronisierung

• name — Der Name des Datensatzes.
• file — Der Pfad zur CSV-Datei, die die aus dem ERP-System exportierten Stammdaten enthält. Die erste Zeile der CSV-Datei muss die durch Kommas getrennten Namen der Datensatzfelder enthalten, und alle Werte, die Kommas enthalten, müssen in doppelte Anführungszeichen gesetzt werden.
• period und schedule — Zeitplan für die Aufgabe, auf die gleiche Weise angegeben wie bei den Importeinstellungen.

Bei der Synchronisierung von Datensätzen:

• Die aktuellen Datensätze werden durch die neuen ersetzt.
• Alle vorhandenen Datensätze, die von einem Verifizierungsoperator geändert wurden (durch Bearbeiten, Hinzufügen oder Löschen von Werten), werden gespeichert und synchronisiert, während alle manuell hinzugefügten neuen Datensätze gelöscht und nicht synchronisiert werden.
• Bei sehr großen Datensätzen kann die Synchronisierung mehrere Stunden dauern.

Das folgende Beispiel zeigt eine CSV-Datei für einen “Vendors”-Datensatz mit einem Vendor, der mehrere IBANs hat:

Id,Name,Street,City,ZIP,CountryCode,VATID,IBAN,IBAN,BusinessUnitId
1,MacWay,9 Route d'Eschau,Illkirch-Graffenstaden,67411,FR,1A345678901,FR1420041010050500012M02606,FR7630006000011234567890189,1
2,Bottled Water Ltd,Mary Ann St,Cardiff,CF102EN,GB,123456789,GB29NWBK60161331926819,,2
3,CCcompany Ltd.,2 Wilkins Grove,Welwyn Garden City,AL86JS,GB,234567890,GB27BOFI90212729823529,,3
4,MANZANA solutions,"Calle de la Botanica, 15",Madrid,28000,ES,E73895722,ES9121000418450200051332,,4

​

Anmeldedaten des Servicekontos im Windows Vault speichern

Die Anmeldedaten des Servicekontos können entweder in der Datei config.json im Service-Verzeichnis von ABBYY FlexiCapture Connect oder, sicherer, im Windows Vault gespeichert werden. Weitere Informationen finden Sie in der Microsoft-Dokumentation zu Credential Manager und cmdkey.

So aktivieren Sie, dass ABBYY FlexiCapture Connect die Anmeldedaten des Servicekontos aus dem Windows Vault abruft:

1. Ein Windows-Konto erstellen oder auswählen

   Erstellen Sie ein neues Windows-Konto oder wählen Sie ein vorhandenes Windows-Konto aus.

2. Die Anmeldedaten mit cmdkey registrieren

   Führen Sie cmd.exe unter diesem Windows-Konto aus und führen Sie den folgenden Befehl aus, wobei https://europe.flexicapture.com#tenant eine Kombination aus der ABBYY FlexiCapture-URL und dem Mandantennamen ist:

   cmdkey /generic:https://europe.flexicapture.com#tenant /user:userName /password:p@ssword
   
3. Die Anmeldedaten aus der Konfigurationsdatei entfernen

   Löschen Sie den Benutzernamen und das Kennwort aus der Datei config.json, die sich im Service-Verzeichnis von ABBYY FlexiCapture Connect befindet.

4. Den Service unter dem Windows-Konto ausführen

   Starten Sie Windows Service Manager (services.msc) und konfigurieren Sie ABBYY FlexiCapture Connect so, dass es unter demselben Windows-Konto ausgeführt wird, das Sie im zweiten Schritt ausgewählt haben:

   1. Öffnen Sie in den Eigenschaften von Services ABBYY FlexiCapture Connect.
   2. Wählen Sie auf der Registerkarte Log On This account aus und geben Sie die Anmeldedaten Ihres Windows-Kontos ein.

   

So entfernen Sie Anmeldedaten aus dem Windows Vault:

1. Credential Manager öffnen

   Öffnen Sie Credential Manager.

2. Die Anmeldedaten entfernen

   Erweitern Sie auf der Registerkarte Windows Credentials die Anmeldedaten, die Sie entfernen möchten, und klicken Sie auf Remove.

   

​

Export einrichten

Um ABBYY FlexiCapture Connect zum Exportieren von Dateien aus ABBYY FlexiCapture Cloud zu verwenden, passen Sie Ihr Projekt wie unten beschrieben an.

1. Den Export-Stammpfad leeren

   Stellen Sie auf der Registerkarte Allgemein im Dialogfeld <project> Properties sicher, dass das Feld Export root path leer ist. Weitere Informationen finden Sie unter Projekteigenschaften.

   
2. Einen relativen Exportpfad angeben

   Geben Sie im Dialogfeld Export Settings den Exportpfad relativ zum Stammpfad an, der auf der Registerkarte Allgemein im Dialogfeld <project> Properties angegeben ist. Da Sie diesen Stammpfad leer gelassen haben, geben Sie das Verzeichnis ohne den exakten Stammpfad an.

   

Die Option If file exists wird ignoriert. Wenn Dateien aus ABBYY FlexiCapture Cloud über ABBYY FlexiCapture Connect exportiert werden, wird für jedes neue Dokument eine neue Datei erstellt.

​

Einschränkungen

Die aktuelle Version von ABBYY FlexiCapture Connect hat die folgenden Einschränkungen:

• Es können nur Datensätze mit bis zu etwa 500.000 Einträgen synchronisiert werden.
• Während der Aktualisierung eines Datensatzes können Benutzer auf den Webstationen keine Vendors nachschlagen.
• Die aktuelle Version erkennt keine Hot Folder-Importprofile, die auf Projekteinstellungen basieren.
• ABBYY FlexiCapture Connect exportiert Dokumente aus allen auf dem Server verfügbaren Batches. Die Projekteinstellungen wirken sich nicht auf den Namen des Zielverzeichnisses aus, das immer denselben Namen wie der ursprüngliche Batch trägt.
• ABBYY FlexiCapture Connect kann nur einen Batch als Ganzes exportieren. Das bedeutet, dass die Dokumente auch dann nicht separat exportiert werden, wenn Sie in den Workflow-Einstellungen des Projekts die Option Auf alle Dokumente in einem Batch warten deaktivieren.
• Die aktuelle Version kann die Ergebnisse aller Dokumente in einem Batch nicht in eine einzige Datei exportieren. Für jedes Dokument aus dem Batch wird im Exportverzeichnis eine separate Datei erstellt.
• Die aktuelle Version kann die Ergebnisse aller Batches nicht in eine einzige Datei exportieren. Für jedes Dokument aus jedem Batch wird im Exportverzeichnis eine separate Datei erstellt.
• Die Größe importierter und exportierter Dateien ist auf 199 MB begrenzt.
• Proxyserver werden nicht unterstützt.

​

Fehlerbehebung

Wenn ein Fehler auftritt, überprüfen Sie zunächst die Protokolldatei, die Sie unter %LocalAppData%\ABBYY\FlexiCapture\Connect\Logs finden. Fehler können auch durch falsche oder unvollständige Einstellungen in der Konfigurationsdatei verursacht werden. Prüfen Sie daher die Datei config.json auf Unstimmigkeiten oder fehlende Angaben.

Wenn der Fehler weiterhin besteht, wenden Sie sich an den technischen Support von ABBYY, der möglicherweise sowohl Ihre Datei config.json als auch die Protokolldatei benötigt.