Passer au contenu principal
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.

Exigences système

Système d’exploitation

  • 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

Au moins 2,5 Go de RAM sont recommandés pour un jeu de données contenant environ 500 000 fournisseurs

Compatibilité logicielle

  1. ABBYY FlexiCapture Connect peut être utilisé avec ABBYY FlexiCapture Application Server Release 3 ou version ultérieure
  2. .NET Framework 4.6.1 ou version ultérieure est requis

Configuration

Pour configurer ABBYY FlexiCapture Connect, veuillez suivre les étapes ci-dessous.
Nous vous recommandons d’utiliser votre compte de service lorsque vous suivez les instructions de cette section.
  1. Téléchargez et exécutez le fichier FlexiCapture_Connect_Installer_*.msi** depuis https://www.abbyy.com/flexicapture-downloads/cloud/. Remarque : si ABBYY FlexiCapture Connect est déjà installé et que vous mettez à jour une version existante, veillez à créer une copie de sauvegarde du fichier config.json. Vous trouverez ce fichier dans C:\Program Files (x86)\ABBYY FlexiCapture Connect\config.json.
  2. Modifiez le fichier config.json selon vos besoins (voir la section Explication du fichier de configuration ci-dessous).
  3. Testez 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 affichant un journal détaillé s’ouvrira.
  4. Redémarrez ABBYY FlexiCapture Connect.

Explication du fichier de configuration

{
"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.
  1. Paramètres généraux
    • url – L’URL du tenant (p. ex. https://europe.flexicapture.com).
    • tenant – Le nom du tenant.
    • user – Le nom d’utilisateur du compte de service. Remarque : Pour pouvoir importer et exporter des documents, le compte tenant doit être configuré en tant qu’External User. Pour pouvoir synchroniser des jeux de données, le compte tenant doit avoir soit le rôle Administrator, soit les rôles Project Settings Editor et External User. Par défaut, tous les projets seront accessibles au compte tenant. Ce comportement peut être modifié en ajustant les droits d’accès accordés à des rôles utilisateur spécifiques. Pour plus de détails, voir Configuration des rôles utilisateur et des droits d’accès.
    • password – Le mot de passe du compte de service.
    • projects – Cette section contient les paramètres de chaque projet, notamment les paramètres d’importation et d’exportation des documents ainsi que les paramètres de synchronisation des jeux de données.
  2. Paramètres du projet
    • 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.
  3. Paramètres d’importation
    • directory – Le chemin d’accès au dossier à partir duquel les documents seront importés.
    • fileMask – Un 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 (les paramètres du projet seront utilisés). Pour activer cette fonction, l’option Automatically when Document Definition is applied doit d’abord être sélectionnée dans le projet ABBYY FlexiCapture. Remarque : Un nouveau lot est créé à chaque importation de fichiers. Le nom du lot contiendra la date et l’heure actuelles.
    • period et schedule – Planification des tâches. La propriété period spécifie la fréquence à laquelle la tâche doit être démarrée (par exemple, “period”: “00:02:30” démarrera la tâche toutes les deux minutes et demie). La propriété schedule spécifie l’heure à laquelle la tâche doit être démarrée (par exemple, “schedule”: [ “09:00:00”,“19:00:00” ] démarrera la tâche chaque jour à 9:00 et à 19:00). Remarque : Les propriétés period et schedule peuvent être définies indépendamment l’une de l’autre.
  4. Paramètres d’export
    • directory – Le chemin d’accès au dossier dans lequel les fichiers exportés seront stockés. Remarque : Lors de l’exportation des documents, un dossier est créé pour chaque lot du projet se trouvant actuellement à l’étape « Traité ». Ces dossiers de destination porteront les mêmes noms que leurs lots respectifs et contiendront tous les résultats du traitement. Si un dossier de destination est supprimé, le programme en créera un nouveau portant le même nom et y placera les résultats du traitement.
    • period et schedule – Planification des tâches. La propriété period spécifie la fréquence à laquelle la tâche doit être démarrée (par exemple, “period”: “00:02:30” démarrera la tâche toutes les deux minutes et demie). La propriété schedule spécifie l’heure à laquelle la tâche doit être démarrée (par exemple, “schedule”: [ “09:00:00”,“19:00:00” ] démarrera la tâche chaque jour à 9:00 et à 19:00), Remarque : Les propriétés period et schedule peuvent être définies indépendamment l’une de l’autre.
  5. Paramètres de la définition de document
    • 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.
  6. Paramètres de synchronisation des jeux de données
  1. Lors de la synchronisation des jeux de données, les jeux de données actuels seront remplacés par les nouveaux. 2) Tous les enregistrements existants modifiés par un opérateur de vérification par modification, ajout ou suppression de valeurs seront enregistrés et synchronisés, tandis que tous les nouveaux enregistrements ajoutés manuellement seront supprimés et ne seront donc pas synchronisés. 3) Pour les très grands jeux de données, la synchronisation peut prendre plusieurs heures.
  • name – Le nom du jeu de données.
    • file – Le chemin d’accès au fichier CSV contenant les données de référence exportées depuis le système ERP. Remarque : La première ligne du fichier CSV doit contenir les noms des champs du jeu de données, séparés par des virgules. Toutes les valeurs contenant des virgules doivent être placées entre guillemets doubles.
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 et schedule – Planification de la tâche. La propriété period indique à quelle fréquence la tâche est lancée (par exemple, “period”: “00:02:30” lance la tâche toutes les deux minutes et demie). La propriété schedule indique l’heure à laquelle la tâche doit être lancée (par exemple, “schedule”: [ “09:00:00”,“19:00:00” ] lance la tâche chaque jour à 9 h et à 19 h). Remarque : Les propriétés period et schedule peuvent être définies indépendamment l’une de l’autre.

Utiliser Windows Vault pour stocker les identifiants du compte de service

Les identifiants du compte de service peuvent être stockés soit dans le fichier config.json du répertoire du service ABBYY FlexiCapture Connect, soit, de façon plus sécurisée, dans Windows Vault. Pour plus d’informations, veuillez consulter ici ou ici. Pour permettre à ABBYY FlexiCapture Connect de récupérer les identifiants du compte de service à partir de Windows Vault, suivez les étapes suivantes :
  1. Créez un nouveau compte Windows (ou choisissez un compte Windows existant).
  2. Exécutez cmd.exe sous le compte Windows nouvellement créé (ou sous le compte Windows existant choisi à l’étape 1), puis exécutez cette commande : cmdkey /generic:https://europe.flexicapture.com#tenant /user:userName /password:p@ssword, où https://europe.flexicapture.com#tenant combine l’URL d’ABBYY FlexiCapture et le nom du tenant.
  3. Supprimez le nom d’utilisateur et le mot de passe du fichier config.json situé dans le répertoire du service ABBYY FlexiCapture Connect.
  4. Ouvrez le Windows Service Manager (services.msc) et configurez ABBYY FlexiCapture Connect pour qu’il se lance sous le même compte Windows que celui sélectionné à l’étape 2 :
    1. Dans les propriétés de Services, ouvrez ABBYY FlexiCapture Connect.
    2. Dans l’onglet Log On, sélectionnez This account et saisissez les identifiants de votre compte Windows.
Pour supprimer des identifiants de Windows Vault :
  1. Ouvrez Credential Manager.
  2. Dans l’onglet Windows Credentials, développez les identifiants que vous souhaitez supprimer, puis cliquez sur Remove.

Configuration de l’export

Pour utiliser ABBYY FlexiCapture Connect afin d’exporter des fichiers depuis ABBYY FlexiCapture Cloud, modifiez votre projet comme indiqué ci-dessous.
  1. Dans l’onglet General de la boîte de dialogue <project> Properties, assurez-vous que le champ Export root path est vide (voir Propriétés du projet pour plus de détails).
  1. Dans la boîte de dialogue Export Settings, indiquez le chemin d’export relatif au chemin racine spécifié dans l’onglet General de la boîte de dialogue <project> Properties. Comme ce chemin racine a été laissé vide, indiquez le répertoire sans le chemin racine complet.
L’option If file exists sera 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.

Limitations

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

Résolution des problèmes

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. Veuillez vérifier le fichier config.json pour repérer toute incohérence ou omission. Si l’erreur persiste, veuillez contacter le support technique ABBYY. Le support technique pourra vous demander à la fois votre fichier config.json et le fichier journal.