> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

<Frame>
  <img src="https://mintcdn.com/abbyy/IFr-A2MDVJd80FDs/images/flexi-capture/FlexiCaptureConnect_scheme.png?fit=max&auto=format&n=IFr-A2MDVJd80FDs&q=85&s=d3744fbf6a31a0223b8389e17f541a66" alt="Diagramm, das zeigt, wie ABBYY FlexiCapture Connect auf einem Windows-Server ausgeführt wird und über eine Firewall über Port 443 mit ABBYY FlexiCapture Cloud verbunden ist." width="900" height="304" data-path="images/flexi-capture/FlexiCaptureConnect_scheme.png" />
</Frame>

<div id="system-requirements">
  ## Systemanforderungen
</div>

| 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.                           |

<div id="setup">
  ## Einrichtung
</div>

So konfigurieren Sie ABBYY FlexiCapture Connect:

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

<Steps>
  <Step title="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/](https://www.abbyy.com/flexicapture-downloads/cloud/) herunter und führen Sie sie aus.

    <Note>
      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.
    </Note>
  </Step>

  <Step title="Ändern Sie die Konfigurationsdatei">
    Passen Sie die Datei `config.json` an Ihre Anforderungen an (siehe [Erläuterung der Konfigurationsdatei](#configuration-file-explained) unten).
  </Step>

  <Step title="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.
  </Step>

  <Step title="Starten Sie den Service neu">
    Starten Sie ABBYY FlexiCapture Connect neu.
  </Step>
</Steps>

<div id="configuration-file-explained">
  ## Erklärung der Konfigurationsdatei
</div>

Eine typische Konfigurationsdatei sieht so aus:

```json theme={null}
{
  "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.

<div id="general-settings">
  ### Allgemeine Einstellungen
</div>

* **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.

<Info>
  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](/de/flexi-capture/admin-guide/roles-setup).
</Info>

<div id="project-settings">
  ### Projekteinstellungen
</div>

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

<div id="import-settings">
  ### Importeinstellungen
</div>

* **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).

<Note>
  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.
</Note>

<a id="exportsettings" />

<div id="export-settings">
  ### Exporteinstellungen
</div>

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

<Note>
  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.
</Note>

<div id="document-definition-settings">
  ### Einstellungen der Dokumentdefinition
</div>

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

<div id="data-set-synchronization-settings">
  ### Einstellungen für die Datensatzsynchronisierung
</div>

* **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.

<Note>
  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.
</Note>

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

```text theme={null}
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
```

<div id="store-service-account-credentials-in-windows-vault">
  ## Anmeldedaten des Servicekontos im Windows Vault speichern
</div>

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](https://support.microsoft.com/en-us/help/4026814/windows-accessing-credential-manager) und [cmdkey](https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/cmdkey).

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

<Steps>
  <Step title="Ein Windows-Konto erstellen oder auswählen">
    Erstellen Sie ein neues Windows-Konto oder wählen Sie ein vorhandenes Windows-Konto aus.
  </Step>

  <Step title="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:

    ```text theme={null}
    cmdkey /generic:https://europe.flexicapture.com#tenant /user:userName /password:p@ssword
    ```
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.

    <Frame>
      <img src="https://mintcdn.com/abbyy/IFr-A2MDVJd80FDs/images/flexi-capture/FlexiCaptureConnect_WinCred1.png?fit=max&auto=format&n=IFr-A2MDVJd80FDs&q=85&s=cca7fc73ceac5af4a0846539bef88f3c" alt="Screenshot der Registerkarte „Log On“ in den Eigenschaften des Service ABBYY FlexiCapture Connect, wobei „This account“ ausgewählt ist und die Anmeldedaten des Windows-Kontos eingegeben wurden." width="1208" height="889" data-path="images/flexi-capture/FlexiCaptureConnect_WinCred1.png" />
    </Frame>
  </Step>
</Steps>

So entfernen Sie Anmeldedaten aus dem Windows Vault:

<Steps>
  <Step title="Credential Manager öffnen">
    Öffnen Sie **Credential Manager**.
  </Step>

  <Step title="Die Anmeldedaten entfernen">
    Erweitern Sie auf der Registerkarte **Windows Credentials** die Anmeldedaten, die Sie entfernen möchten, und klicken Sie auf **Remove**.

    <Frame>
      <img src="https://mintcdn.com/abbyy/IFr-A2MDVJd80FDs/images/flexi-capture/FlexiCaptureConnect_WinCred2.png?fit=max&auto=format&n=IFr-A2MDVJd80FDs&q=85&s=7be7120f4e81b22d617ab0b37e605d77" alt="Screenshot der Registerkarte „Windows Credentials“ im Credential Manager, mit erweiterten Anmeldedaten und verfügbarer Option „Remove“." width="1243" height="890" data-path="images/flexi-capture/FlexiCaptureConnect_WinCred2.png" />
    </Frame>
  </Step>
</Steps>

<div id="set-up-export">
  ## Export einrichten
</div>

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

<Steps>
  <Step title="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](/de/flexi-capture/project-settings/project-properties).

    <Frame>
      <img src="https://mintcdn.com/abbyy/IFr-A2MDVJd80FDs/images/flexi-capture/FlexiCaptureConnect_Export1.png?fit=max&auto=format&n=IFr-A2MDVJd80FDs&q=85&s=dc787f30b73139624a9130b26223d198" alt="Screenshot der Registerkarte „Allgemein“ im Dialogfeld „<project> Properties“, in dem das Feld „Export root path“ leer ist." data-og-width="526" width="526" data-og-height="594" height="594" data-path="images/flexi-capture/FlexiCaptureConnect_Export1.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/abbyy/IFr-A2MDVJd80FDs/images/flexi-capture/FlexiCaptureConnect_Export1.png?w=280&fit=max&auto=format&n=IFr-A2MDVJd80FDs&q=85&s=54cfeb41b0d1d595ab4497995e4aa752 280w, https://mintcdn.com/abbyy/IFr-A2MDVJd80FDs/images/flexi-capture/FlexiCaptureConnect_Export1.png?w=560&fit=max&auto=format&n=IFr-A2MDVJd80FDs&q=85&s=b6e36ea31717d0681e1cb62f2e49e73e 560w, https://mintcdn.com/abbyy/IFr-A2MDVJd80FDs/images/flexi-capture/FlexiCaptureConnect_Export1.png?w=840&fit=max&auto=format&n=IFr-A2MDVJd80FDs&q=85&s=c5645eeaa033013dd5172f6586c3b66c 840w, https://mintcdn.com/abbyy/IFr-A2MDVJd80FDs/images/flexi-capture/FlexiCaptureConnect_Export1.png?w=1100&fit=max&auto=format&n=IFr-A2MDVJd80FDs&q=85&s=fd976d1013c967188dbc5f0ec3449fc4 1100w, https://mintcdn.com/abbyy/IFr-A2MDVJd80FDs/images/flexi-capture/FlexiCaptureConnect_Export1.png?w=1650&fit=max&auto=format&n=IFr-A2MDVJd80FDs&q=85&s=835c1af517bfbbe0acea1c8d6b4d9cf2 1650w, https://mintcdn.com/abbyy/IFr-A2MDVJd80FDs/images/flexi-capture/FlexiCaptureConnect_Export1.png?w=2500&fit=max&auto=format&n=IFr-A2MDVJd80FDs&q=85&s=e701ecf00c38ad0a69feeda72d874da5 2500w" />
    </Frame>
  </Step>

  <Step title="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.

    <Frame>
      <img src="https://mintcdn.com/abbyy/IFr-A2MDVJd80FDs/images/flexi-capture/FlexiCaptureConnect_Export2.png?fit=max&auto=format&n=IFr-A2MDVJd80FDs&q=85&s=adddc5bc4a06839a5e101018c83a442d" alt="Screenshot des Dialogfelds „Export Settings“, in dem der Exportpfad relativ zu einem leeren Stammpfad angegeben ist." width="526" height="509" data-path="images/flexi-capture/FlexiCaptureConnect_Export2.png" />
    </Frame>
  </Step>
</Steps>

<Note>
  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.
</Note>

<div id="limitations">
  ## Einschränkungen
</div>

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.

<div id="troubleshooting">
  ## Fehlerbehebung
</div>

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.
