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

> Installez et configurez ABBYY FlexiCapture Connect, le service Windows qui importe et exporte des documents et synchronise des jeux de données avec les projets Cloud.

ABBYY FlexiCapture Connect s’exécute en tant que service Windows et permet aux utilisateurs d’importer des documents dans des projets ABBYY FlexiCapture Cloud, d’exporter des documents à partir de projets ABBYY FlexiCapture Cloud et de synchroniser des jeux de données.

<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="Schéma montrant ABBYY FlexiCapture Connect s’exécutant sur un serveur Windows, se connectant à ABBYY FlexiCapture Cloud via un pare-feu sur le port 443." width="900" height="304" data-path="images/flexi-capture/FlexiCaptureConnect_scheme.png" />
</Frame>

<div id="system-requirements">
  ## Exigences système
</div>

| Exigence                 | Details                                                                                                                 |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------------- |
| Système d’exploitation   | Windows 10, Windows 11 ou Windows Server 2012, 2012 R2, 2016, 2019, 2022 ou 2025 (tous avec Desktop Experience).        |
| RAM                      | Il est recommandé de disposer d’au moins 2,5 Go pour un jeu de données contenant environ 500 000 fournisseurs.          |
| Compatibilité logicielle | serveur d’applications ABBYY FlexiCapture Release 3 ou version ultérieure ; .NET Framework 4.6.1 ou version ultérieure. |

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

Pour configurer ABBYY FlexiCapture Connect :

<Note>
  Nous vous recommandons d’utiliser votre compte de service pour suivre les instructions de cette section.
</Note>

<Steps>
  <Step title="Télécharger et exécuter le programme d’installation">
    Téléchargez et exécutez le fichier `FlexiCapture_Connect_Installer_*.msi` à l’adresse [https://www.abbyy.com/flexicapture-downloads/cloud/](https://www.abbyy.com/flexicapture-downloads/cloud/).

    <Note>
      Si ABBYY FlexiCapture Connect est déjà installé et que vous mettez à jour une version existante, créez une copie de sauvegarde du fichier `config.json`, situé dans `C:\Program Files (x86)\ABBYY FlexiCapture Connect\config.json`.
    </Note>
  </Step>

  <Step title="Modifier le fichier de configuration">
    Modifiez le fichier `config.json` selon vos besoins (voir [Explication du fichier de configuration](#configuration-file-explained) ci-dessous).
  </Step>

  <Step title="Tester la nouvelle configuration">
    1. Mettez en pause le service ABBYY FlexiCapture Connect.
    2. Exécutez le fichier `ABBYY.FlexiCapture.Connect.exe`. Une fenêtre de console contenant un log détaillé s’ouvre.
  </Step>

  <Step title="Redémarrer le service">
    Redémarrez ABBYY FlexiCapture Connect.
  </Step>
</Steps>

<div id="configuration-file-explained">
  ## Explication du fichier de configuration
</div>

Un fichier de configuration type se présente ainsi :

```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" ]
            }
          ]
        }
      ]
    }
  ]
}
```

Les sections d’un fichier de configuration type sont décrites ci-dessous.

<div id="general-settings">
  ### Paramètres généraux
</div>

* **url** — L’URL du tenant (par exemple, `https://europe.flexicapture.com`).
* **tenant** — Le nom du tenant.
* **user** — Le nom d’utilisateur du compte de service.
* **password** — Le mot de passe du compte de service.
* **projects** — Contient les paramètres propres à chaque projet, tels que les paramètres d’importation de documents, les paramètres d’exportation et les paramètres de synchronisation des jeux de données.

<Info>
  Pour importer et exporter des documents, configurez le compte du tenant en tant qu’**External User**. Pour synchroniser les jeux de données, le compte du tenant doit disposer soit du rôle **Administrator**, soit des rôles **Project Settings Editor** et **External User**. Par défaut, tous les projets sont accessibles au compte du tenant ; vous pouvez modifier cela en ajustant les droits d’accès accordés à des rôles d’utilisateur spécifiques. Pour plus d’informations, consultez [Configurer les rôles utilisateur et les droits d’accès](/fr/flexi-capture/admin-guide/roles-setup).
</Info>

<div id="project-settings">
  ### Paramètres du projet
</div>

* **name** — Nom du projet.
* **import** — Cette section sert à importer des documents.
* **export** — Cette section sert à exporter des documents.
* **templates** — Cette section sert à synchroniser des jeux de données.

<div id="import-settings">
  ### Paramètres d’importation
</div>

* **directory** — Chemin du dossier à partir duquel les documents sont importés.
* **fileMask** — Filtre de fichiers et de dossiers. Les caractères génériques `*` et `?` sont pris en charge.
* **settings** — Paramètres d’enregistrement du lot.
* **createDocument** — Les valeurs possibles sont `ForEachFile` (crée un document distinct pour chaque fichier importé) ou `Automatically` (utilise les paramètres du projet). Pour utiliser cette fonction, sélectionnez d’abord l’option **Automatically when Document Definition is applied** dans le projet ABBYY FlexiCapture.
* **period** et **schedule** — Planification de tâche. La propriété `period` indique à quelle fréquence la tâche démarre (par exemple, `"period": "00:02:30"` démarre la tâche toutes les deux minutes et demie). La propriété `schedule` indique les heures de démarrage de la tâche (par exemple, `"schedule": [ "09:00:00", "19:00:00" ]` démarre la tâche chaque jour à 9:00 et 19:00).

<Note>
  Un nouveau lot est créé à chaque importation de fichiers. Le nom du lot contient la date et l’heure actuelles. Les propriétés **period** et **schedule** peuvent être définies indépendamment l’une de l’autre.
</Note>

<a id="exportsettings" />

<div id="export-settings">
  ### Paramètres d’exportation
</div>

* **directory** — Le chemin d’accès au dossier où sont stockés les fichiers exportés.
* **period** et **schedule** — planification de tâche, définie de la même manière que pour les paramètres d’importation.

<Note>
  Lors de l’exportation des documents, un dossier est créé pour chaque lot du projet actuellement à l’étape « Traité ». Ces dossiers de destination portent le même nom que les lots correspondants et contiennent tous les résultats du traitement. Si un dossier de destination est supprimé, le programme en crée un nouveau portant le même nom et y place les résultats du traitement. Les propriétés **period** et **schedule** peuvent être définies indépendamment l’une de l’autre.
</Note>

<div id="document-definition-settings">
  ### Paramètres de la définition de document
</div>

* **name** — Le nom de la définition de document liée à la section concernée.
* **datasets** — Les paramètres de synchronisation des jeux de données pour la définition de document.

<div id="data-set-synchronization-settings">
  ### Paramètres de synchronisation du jeu de données
</div>

* **name** — Le nom du jeu de données.
* **file** — Le chemin du fichier CSV contenant les données de référence exportées depuis le système ERP. La première ligne du fichier CSV doit contenir les noms des champs du jeu de données séparés par des virgules, et toute valeur contenant une virgule doit être placée entre guillemets doubles.
* **period** et **schedule** — Planification de tâche, spécifiée de la même manière que pour les paramètres d'importation.

<Note>
  Lors de la synchronisation des jeux de données :

  * Les jeux de données actuels sont remplacés par les nouveaux.
  * Tous les enregistrements existants modifiés par un opérateur de vérification (par modification, ajout ou suppression de valeurs) sont enregistrés et synchronisés, tandis que tous les nouveaux enregistrements ajoutés manuellement sont supprimés et ne sont pas synchronisés.
  * Pour les très grands jeux de données, la synchronisation peut prendre plusieurs heures.
</Note>

L'exemple suivant montre un fichier CSV du jeu de données "Vendors" contenant un fournisseur avec plusieurs IBAN :

```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">
  ## Stocker les identifiants du compte de service dans Windows Vault
</div>

Les identifiants du compte de service peuvent être stockés soit dans le fichier `config.json` situé dans le répertoire du service ABBYY FlexiCapture Connect, soit, de façon plus sécurisée, dans Windows Vault. Pour plus d’informations, consultez la documentation Microsoft sur [Credential Manager](https://support.microsoft.com/en-us/help/4026814/windows-accessing-credential-manager) et [cmdkey](https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/cmdkey).

Pour permettre à ABBYY FlexiCapture Connect de récupérer les identifiants du compte de service depuis Windows Vault :

<Steps>
  <Step title="Créer ou choisir un compte Windows">
    Créez un nouveau compte Windows ou choisissez un compte Windows existant.
  </Step>

  <Step title="Enregistrer les identifiants avec cmdkey">
    Exécutez `cmd.exe` sous ce compte Windows, puis exécutez la commande suivante, où `https://europe.flexicapture.com#tenant` correspond à la combinaison de l’URL ABBYY FlexiCapture et du nom du tenant :

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

  <Step title="Supprimer les identifiants du fichier de configuration">
    Supprimez le nom d’utilisateur et le mot de passe du fichier `config.json` situé dans le répertoire du service ABBYY FlexiCapture Connect.
  </Step>

  <Step title="Exécuter le service sous le compte Windows">
    Lancez **Windows Service Manager** (`services.msc`) et configurez ABBYY FlexiCapture Connect pour qu’il s’exécute sous le même compte Windows que celui sélectionné à la deuxième étape :

    1. Dans **Services**, ouvrez les propriétés de **ABBYY FlexiCapture Connect**.
    2. Dans l’onglet **Log On**, sélectionnez **This account** et saisissez les identifiants de votre compte Windows.

    <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="Capture d’écran de l’onglet Log On dans les propriétés du service ABBYY FlexiCapture Connect, avec This account sélectionné et les identifiants du compte Windows saisis." width="1208" height="889" data-path="images/flexi-capture/FlexiCaptureConnect_WinCred1.png" />
    </Frame>
  </Step>
</Steps>

Pour supprimer des identifiants de Windows Vault :

<Steps>
  <Step title="Ouvrir Credential Manager">
    Ouvrez **Credential Manager**.
  </Step>

  <Step title="Supprimer l’identifiant">
    Dans l’onglet **Windows Credentials**, développez l’identifiant à supprimer, puis cliquez sur **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="Capture d’écran de l’onglet Windows Credentials dans Credential Manager, avec un identifiant développé et l’option Remove disponible." width="1243" height="890" data-path="images/flexi-capture/FlexiCaptureConnect_WinCred2.png" />
    </Frame>
  </Step>
</Steps>

<div id="set-up-export">
  ## Configurer l’export
</div>

Pour utiliser ABBYY FlexiCapture Connect afin d’exporter des fichiers depuis ABBYY FlexiCapture Cloud, modifiez votre projet comme décrit ci-dessous.

<Steps>
  <Step title="Vider le chemin d’export racine">
    Dans l’**onglet Général** de la boîte de dialogue **Propriétés de \<project>**, assurez-vous que le champ **chemin d’export racine** est vide. Pour plus d’informations, consultez [Propriétés du projet](/fr/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="Capture d’écran de l’onglet Général de la boîte de dialogue Propriétés du projet, avec le champ chemin d’export racine vide." width="526" height="594" data-path="images/flexi-capture/FlexiCaptureConnect_Export1.png" />
    </Frame>
  </Step>

  <Step title="Spécifier un chemin d’export relatif">
    Dans la boîte de dialogue **paramètres d’exportation**, spécifiez le chemin d’export par rapport au chemin racine indiqué dans l’**onglet Général** de la boîte de dialogue **Propriétés de \<project>**. Comme ce chemin racine est vide, indiquez le répertoire sans inclure le chemin racine complet.

    <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="Capture d’écran de la boîte de dialogue paramètres d’exportation, avec le chemin d’export spécifié par rapport à un chemin racine vide." width="526" height="509" data-path="images/flexi-capture/FlexiCaptureConnect_Export2.png" />
    </Frame>
  </Step>
</Steps>

<Note>
  L’option **If file exists** est ignorée. Lorsque des fichiers sont exportés depuis ABBYY FlexiCapture Cloud via ABBYY FlexiCapture Connect, un nouveau fichier est créé pour chaque nouveau document.
</Note>

<div id="limitations">
  ## Limitations
</div>

La version actuelle d’ABBYY FlexiCapture Connect présente les limitations suivantes :

* Seuls les jeux de données contenant environ 500 000 enregistrements au maximum peuvent être synchronisés.
* Lors de la mise à jour d’un jeu de données, les utilisateurs ne pourront pas rechercher de fournisseurs sur les stations Web.
* La version actuelle ne reconnaît pas les profils d’importation Hot Folder basés sur les paramètres du projet.
* ABBYY FlexiCapture Connect exportera les documents de tous les lots disponibles sur le serveur. Les paramètres du projet n’auront aucun effet sur le nom du répertoire de destination, qui portera toujours le même nom que le lot source.
* ABBYY FlexiCapture Connect ne peut exporter qu’un lot entier, ce qui signifie que si vous désactivez l’option **Wait for all documents in a batch** dans les Workflow Settings du projet, les documents ne seront toujours pas exportés séparément.
* La version actuelle ne peut pas exporter les résultats de tous les documents d’un lot dans un seul fichier. Un fichier distinct est créé dans le répertoire d’exportation pour chaque document du lot.
* La version actuelle ne peut pas exporter les résultats de tous les lots dans un seul fichier. Un fichier distinct est créé dans le répertoire d’exportation pour chaque document de chaque lot.
* La taille des fichiers importés et exportés est limitée à 199 Mo.
* Les serveurs proxy ne sont pas pris en charge.

<div id="troubleshooting">
  ## Résolution des problèmes
</div>

Si vous rencontrez une erreur, consultez d’abord le fichier journal, que vous trouverez dans `%LocalAppData%\ABBYY\FlexiCapture\Connect\Logs`. Les erreurs peuvent également être dues à des paramètres incorrects ou incomplets définis dans le fichier de configuration, alors vérifiez le fichier `config.json` pour repérer toute incohérence ou omission.

Si l’erreur persiste, contactez le support technique ABBYY, qui pourra vous demander à la fois votre fichier `config.json` et le fichier journal.