Zum Hauptinhalt springen
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

Betriebssystem

  • Windows 10
  • Windows 11
  • Windows Server 2012 + Desktop Experience
  • Windows Server 2012 R2 + Desktop Experience
  • Windows Server 2016 + Desktop Experience
  • Windows Server 2019 + Desktop Experience
  • Windows Server 2022 + Desktop Experience

RAM

Empfohlen werden mindestens 2,5 GB RAM für einen Datensatz mit etwa 500.000 Lieferanten

Softwarekompatibilität

  1. ABBYY FlexiCapture Connect kann mit ABBYY FlexiCapture Application Server Release 3 oder neuer verwendet werden
  2. .NET Framework 4.6.1 oder neuer ist erforderlich

Einrichtung

Um ABBYY FlexiCapture Connect zu konfigurieren, befolgen Sie bitte die unten aufgeführten Schritte.
Wir empfehlen, bei den Anweisungen in diesem Abschnitt Ihr Servicekonto zu verwenden.
  1. Laden Sie die Datei FlexiCapture_Connect_Installer_*.msi** von https://www.abbyy.com/flexicapture-downloads/cloud/ herunter und führen Sie sie aus. Hinweis: Wenn ABBYY FlexiCapture Connect bereits installiert ist und Sie eine vorhandene Version aktualisieren, erstellen Sie unbedingt eine Sicherungskopie der Datei config.json. Sie finden diese Datei unter C:\Program Files (x86)\ABBYY FlexiCapture Connect\config.json.
  2. Passen Sie die Datei config.json an Ihre Anforderungen an (siehe den Abschnitt Erläuterung der Konfigurationsdatei weiter 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 geöffnet.
  4. Starten Sie ABBYY FlexiCapture Connect neu.

Aufbau der Konfigurationsdatei

{
"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" ]
}
]
}
]
}
]
}
Die Abschnitte einer typischen Konfigurationsdatei werden im Folgenden beschrieben.
  1. Allgemeine Einstellungen
    • url – Die URL des Mandanten (z. B. https://europe.flexicapture.com).
    • tenant – Der Name des Mandanten.
    • user – Der Benutzername des Servicekontos. Hinweis: Um Dokumente importieren und exportieren zu können, muss das Mandantenkonto als External User eingerichtet sein. Um Datensätze synchronisieren zu können, muss das Mandantenkonto entweder über die Rolle Administrator oder über die Rollen Project Settings Editor und External User verfügen. Standardmäßig hat das Mandantenkonto Zugriff auf alle Projekte. Dies kann durch Anpassen der Zugriffsrechte für bestimmte Benutzerrollen geändert werden. Weitere Informationen finden Sie unter Einrichten von Benutzerrollen und Zugriffsrechten.
    • password – Das Kennwort des Servicekontos.
    • projects – Dieser Abschnitt enthält Einstellungen für einzelne Projekte, z. B. Parameter für den Dokumentimport und -export sowie für die Synchronisierung von Datensätzen.
  2. Projekteinstellungen
    • name – Projektname.
    • import – Dieser Abschnitt wird zum Importieren von Dokumenten verwendet.
    • export – Dieser Abschnitt wird zum Exportieren von Dokumenten verwendet.
    • templates – Dieser Abschnitt wird zum Synchronisieren von Datensätzen verwendet.
  3. Importeinstellungen
    • directory – Der Pfad zum Ordner, aus dem Dokumente importiert werden.
    • fileMask – Ein Datei- und Ordnerfilter. Die Platzhalter * und ? werden unterstützt.
    • settings – Batch-Registrierungsparameter.
    • createDocument – Mögliche Werte sind ForEachFile (erstellt für jede importierte Datei ein separates Dokument) oder Automatically (es werden die Projektparameter verwendet). Um diese Funktion zu aktivieren, muss zunächst die Option Automatically when Document Definition is applied im ABBYY FlexiCapture-Projekt ausgewählt werden. Hinweis: Bei jedem Dateimport wird ein neuer Batch erstellt. Der Name des Batchs enthält das aktuelle Datum und die aktuelle Uhrzeit.
    • period und schedule – Aufgabenzeitplan. Die Eigenschaft period gibt an, wie oft die Aufgabe gestartet werden soll (zum Beispiel startet "period": "00:02:30" die Aufgabe alle zweieinhalb Minuten). Die Eigenschaft schedule gibt die Uhrzeit an, zu der die Aufgabe gestartet werden soll (zum Beispiel startet "schedule": [ "09:00:00","19:00:00" ] die Aufgabe täglich um 9:00 Uhr und um 19:00 Uhr). Hinweis: Die Eigenschaften period und schedule können unabhängig voneinander festgelegt werden.
  4. Exporteinstellungen
    • directory – Der Pfad zum Ordner, in dem exportierte Dateien gespeichert werden. Hinweis: Beim Exportieren von Dokumenten wird für jeden Batch im Projekt, der sich aktuell in der Phase „Processed“ befindet, ein Ordner erstellt. Diese Zielordner haben 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.
    • period und schedule – Aufgabenzeitplan. Die Eigenschaft period gibt an, wie oft die Aufgabe gestartet werden soll (zum Beispiel startet "period": "00:02:30" die Aufgabe alle zweieinhalb Minuten). Die Eigenschaft schedule gibt die Uhrzeit an, zu der die Aufgabe gestartet werden soll (zum Beispiel startet "schedule": [ "09:00:00","19:00:00" ] die Aufgabe täglich um 9:00 Uhr und um 19:00 Uhr), Hinweis: Die Eigenschaften period und schedule können unabhängig voneinander festgelegt werden.
  5. Einstellungen der Dokumentdefinition
    • name – Der Name der Dokumentdefinition, auf die sich der jeweilige Abschnitt bezieht.
    • datasets – Die Parameter für die Datensatzsynchronisierung der Dokumentdefinition.
  6. Einstellungen für die Datensatzsynchronisierung
  1. Bei der Synchronisierung von Datensätzen werden die vorhandenen Datensätze durch neue ersetzt. 2) Vorhandene Datensätze, die ein Verifizierungsoperator durch Bearbeiten, Hinzufügen oder Löschen von Werten geändert hat, werden gespeichert und synchronisiert. Neue Datensätze, die manuell hinzugefügt wurden, werden dagegen gelöscht und daher nicht synchronisiert. 3) Bei sehr großen Datensätzen kann die Synchronisierung mehrere Stunden dauern.
  • name – Der Name des Datensatzes.
    • file – Der Pfad zur CSV-Datei, die die aus dem ERP-System exportierten Stammdaten enthält. Hinweis: Die erste Zeile der CSV-Datei muss die durch Kommas getrennten Namen der Datensatzfelder enthalten. Werte, die Kommas enthalten, müssen in doppelte Anführungszeichen gesetzt werden.
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
  • period und schedule – Zeitplan für die Aufgabe. 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 Uhrzeit an, zu der die Aufgabe gestartet wird (zum Beispiel startet "schedule": [ "09:00:00","19:00:00" ] die Aufgabe täglich um 9:00 Uhr und um 19:00 Uhr). Hinweis: Die Eigenschaften period und schedule können unabhängig voneinander festgelegt werden.

Windows Vault zum Speichern der Anmeldedaten des Servicekontos verwenden

Die Anmeldedaten des Servicekontos können entweder in der Datei config.json im Serviceverzeichnis von ABBYY FlexiCapture Connect oder – sicherer – in Windows Vault gespeichert werden. Weitere Informationen finden Sie hier oder hier. Gehen Sie wie folgt vor, damit ABBYY FlexiCapture Connect die Anmeldedaten des Servicekontos aus Windows Vault abrufen kann:
  1. Erstellen Sie ein neues Windows-Konto (oder wählen Sie ein vorhandenes Windows-Konto aus).
  2. Führen Sie cmd.exe unter dem neu erstellten Windows-Konto (oder unter dem vorhandenen Windows-Konto, das Sie in Schritt 1 ausgewählt haben) aus und geben Sie folgenden Befehl ein: cmdkey /generic:https://europe.flexicapture.com#tenant /user:userName /password:p@ssword. Dabei ist https://europe.flexicapture.com#tenant eine Kombination aus der ABBYY FlexiCapture-URL und dem Namen des Mandanten.
  3. Löschen Sie den Benutzernamen und das Kennwort aus der Datei config.json, die sich im Serviceverzeichnis von ABBYY FlexiCapture Connect befindet.
  4. Öffnen Sie den Windows Service Manager (services.msc) und konfigurieren Sie ABBYY FlexiCapture Connect so, dass es unter demselben Windows-Konto gestartet wird, das Sie in Schritt 2 ausgewählt haben:
    1. Öffnen Sie in den Eigenschaften von Services ABBYY FlexiCapture Connect.
    2. Wählen Sie auf der Registerkarte Log On die Option This account aus und geben Sie die Anmeldedaten Ihres Windows-Kontos ein.
So entfernen Sie Anmeldedaten aus Windows Vault:
  1. Öffnen Sie Credential Manager.
  2. 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. Vergewissern Sie sich auf der Registerkarte Allgemein im Dialogfeld <project> Eigenschaften, dass das Feld Stammverzeichnis für den Export leer ist (weitere Informationen finden Sie unter Projekteigenschaften).
  1. Geben Sie im Dialogfeld Exporteinstellung den Exportpfad relativ zum Stammverzeichnis an, das auf der Registerkarte Allgemein im Dialogfeld <project> Eigenschaften angegeben ist. Da dieses Stammverzeichnis leer ist, geben Sie das Verzeichnis ohne den eigentlichen 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 bitte die Datei config.json auf Unstimmigkeiten oder fehlende Angaben. Wenn der Fehler weiterhin besteht, wenden Sie sich bitte an den technischen Support von ABBYY. Der technische Support benötigt möglicherweise sowohl Ihre Datei config.json als auch die Protokolldatei.