Passer au contenu principal
ABBYY Vantage propose des compétences Content IQ qui vous permettent de transformer du contenu non structuré en informations structurées et exploitables grâce à la classification et à l’extraction, ainsi que de traiter des types de documents spécifiques comme les factures, les commandes, les formulaires W2, et bien plus encore. ABBYY Vantage Connector for UiPath vous permet d’intégrer des compétences ABBYY Vantage dans votre workflow UiPath.

​
Exigences système

Vous aurez besoin d’un compte ABBYY Vantage pour configurer et exécuter votre processus. ABBYY Vantage Connector for UiPath peut s’exécuter sur les systèmes d’exploitation suivants :
  • Windows 10
  • Windows Server 2016
  • Windows Server 2019
Le connecteur ne peut pas s’exécuter sur des ordinateurs équipés de Windows Server 2012 R2, de Windows 8.1 ou d’un système d’exploitation antérieur.
Le connecteur pour UiPath peut être utilisé avec :
  • ABBYY Vantage 2.3.2 ou version ultérieure
  • UiPath Enterprise Edition 2023.8.0
  • Community Edition 2023.4.4 ou version ultérieure
Les composants externes suivants doivent être installés :
  • Microsoft .NET Framework 4.8.1
  • Microsoft .NET 8
Nous vous recommandons de convertir les projets Windows-legacy en projets compatibles avec Windows, car le mode de compatibilité hérité n’est plus pris en charge. Pour savoir comment convertir les projets Windows-legacy en projets Windows, consultez Conversion des projets Windows-legacy en projets Windows.

​
Installation du connecteur

ABBYY Vantage Connector for UiPath est un ensemble d’activités qui s’exécutent côté UiPath dans le workflow défini par l’utilisateur. Les activités sont fournies sous forme de package NuGet. Pour installer le package :
  1. Exécutez ABBYYVantageConnectorForUiPath.<version>.exe et suivez les instructions de l’assistant d’installation. Pendant l’installation, indiquez le dossier d’installation du connecteur. Par défaut, il est défini sur C:\Program Files\ABBYY Vantage Connector for UiPath.
  2. Dans UiPath Studio, ouvrez un projet existant ou créez-en un nouveau.
  3. Dans le ruban, cliquez sur Manage Packages dans l’onglet Design : Ruban UiPath affichant le bouton Manage Packages dans l’onglet Design
  4. Assurez-vous que la source de packages nuget.org est activée. Cette source est requise pour installer certaines dépendances du package du connecteur.
    Si vous disposez déjà d’une source de packages configurée et souhaitez l’utiliser, ignorez l’étape 5.
  5. Accédez à l’onglet Settings de la fenêtre Manage Packages et créez une nouvelle source de packages : a. Saisissez un nom pour la nouvelle source de packages. b. Indiquez le chemin d’accès au dossier dans lequel vous souhaitez placer les packages NuGet du connecteur. c. Cliquez sur Add pour confirmer les paramètres. Ruban UiPath affichant le bouton Manage Packages dans l’onglet Design La nouvelle source de packages s’affiche dans la zone User defined package sources et dans le volet gauche de la fenêtre Manage Packages. Fenêtre Manage Packages affichant Abbyy.UiPath.Vantage.Activities sélectionné pour l’installation
  6. Copiez tous les packages NuGet de ABBYY Vantage Connector for UiPath du dossier d’installation vers le dossier de votre source de packages. Les packages NuGet se trouvent dans le sous-dossier UiPath Activities du dossier d’installation créé à l’étape 1 (l’emplacement par défaut est C:\Program Files\ABBYY Vantage Connector for UiPath\UiPath Activities). Une fois les packages NuGet du connecteur ajoutés à la source de packages disponible, vous pouvez installer le package du connecteur dans les dépendances du projet.
  7. Dans la fenêtre Manage Packages, accédez à la section All Packages et procédez comme suit : a. Cliquez sur la catégorie de source de packages nouvellement créée. b. Sélectionnez Abbyy.UiPath.Vantage.Activities dans la liste des packages disponibles et cliquez sur Install. La fenêtre License Acceptance affiche les conditions de licence de chaque package tiers que vous installez. c. Cliquez sur View License pour lire les conditions de licence. d. Cliquez sur I Accept pour accepter les conditions de licence et installer les packages. Enfin, cliquez sur Save. Fenêtre Manage Packages affichant Abbyy.UiPath.Vantage.Activities sélectionné pour l’installation
  8. Une fois installées, les activités Vantage apparaissent dans la section ABBYY Vantage de la liste des activités disponibles pour votre projet : Panneau Activities affichant la section ABBYY Vantage avec les activités Vantage Scope, Use Skill, Get Results et Map Fields Pour obtenir des instructions détaillées sur l’installation de packages, consultez le UiPath Studio Guide.

​
Convertir des projets Windows-legacy en projets Windows

Nous vous recommandons de convertir les projets Windows-legacy en projets Windows.
Pour convertir le projet vers la compatibilité Windows, vous devez mettre à niveau la version du ABBYY Vantage Connector for UiPath. Pour ce faire, effectuez toutes les étapes de la section Installation du Connector, à l’exception de l’étape 5.
La compatibilité par défaut des nouveaux projets est désormais Windows. Pour convertir des projets Windows-legacy vers la compatibilité Windows, vous devez effectuer la procédure suivante pour chaque projet en compatibilité Windows-legacy :
  1. Dans UiPath Studio, ouvrez le projet Windows-legacy.
  2. Cliquez sur le lien Convert to Windows dans le message qui s’affiche sous le ruban.
Ruban UiPath avec la bannière Convert to Windows et la boîte de dialogue Convert to Windows La boîte de dialogue Convert to Windows s’ouvre. Ruban UiPath avec la bannière Convert to Windows et la boîte de dialogue Convert to Windows
  1. Indiquez comment le projet Windows-legacy doit être converti en projet Windows :
    • Pour créer une copie du projet actuel en compatibilité Windows tout en conservant le projet Windows-legacy d’origine, sélectionnez Create a new project. Saisissez le nom du projet, son emplacement souhaité et, si nécessaire, une description pour le nouveau projet.
    • Pour mettre à jour le projet existant et le convertir en projet compatible Windows, désélectionnez l’option Create a new project. Si vous désélectionnez cette option, il ne sera pas possible d’annuler les modifications apportées au projet.
  2. Cliquez sur Convert. Pour plus d’informations sur la conversion de projets Windows-legacy vers la compatibilité Windows, consultez le UiPath Studio Guide.

​
Utilisation des activités ABBYY Vantage dans un workflow UiPath

Le ABBYY Vantage Connector for UiPath permet à votre workflow d’envoyer des images de documents à ABBYY Vantage et de les traiter à l’aide d’une compétence disponible. Pour afficher les compétences disponibles, créer vos propres compétences ou modifier des compétences existantes, utilisez ABBYY Vantage Skill Catalog ou ABBYY Vantage Skill Designer. Pour plus d’informations sur la configuration des compétences, reportez-vous au guide ABBYY Vantage Skill Designer. Le ABBYY Vantage Connector for UiPath fournit les activités suivantes pour utiliser ABBYY Vantage : Pour ajouter une activité au processus UiPath, faites glisser l’activité depuis le panneau Activities de UiPath Studio vers le panneau Designer. Une fois l’activité ajoutée au processus, vous devrez renseigner les champs dans le panneau Properties. Vous pouvez également renseigner certaines propriétés dans le panneau Designer. Pour plus de détails sur les propriétés des activités, consultez les sections ci-dessous. Le ABBYY Vantage Connector for UiPath est fourni avec un processus d’exemple qui montre comment utiliser les activités ABBYY Vantage dans votre workflow. Pour plus d’informations, consultez le processus d’exemple pour les activités ABBYY Vantage.

​
Vantage Scope Activity

L’activité Vantage Scope transmet les paramètres de connexion d’ABBYY Vantage aux autres activités Vantage. Elle sert également de conteneur pour les autres activités Vantage. Toutes les autres activités ABBYY Vantage doivent être placées dans l’activité Vantage Scope.
L’activité Vantage Scope permet de configurer l’authentification à l’aide des flux Resource Owner Password Credentials Flow et Client Credentials Flow. Si vous configurez un fournisseur d’identité externe dans Vantage, le seul flux d’authentification pris en charge sera Client Credentials Flow.

​
Propriétés de l’activité

GroupePropriétéTypeDescription
Paramètres de connexionType d’octroi d’autorisationIEnumerable<AuthorizationGrantType>Le type d’octroi utilisé pour l’autorisation : ResourceOwnerPassword ou ClientCredentials
Paramètres de connexionMot de passeStringLe mot de passe utilisé pour se connecter à ABBYY Vantage.
Paramètres de connexionMot de passe sécuriséSecureStringLe mot de passe sécurisé utilisé pour se connecter à ABBYY Vantage.
Paramètres de connexionURL du serveurStringL’adresse du serveur ABBYY Vantage.
Paramètres de connexionTenantStringLe nom du tenant ABBYY Vantage ou son identifiant. Important ! Cette propriété n’est requise que si l’utilisateur dont les identifiants sont utilisés pour se connecter au serveur ABBYY Vantage est enregistré dans plusieurs tenants (plus d’un) sur le serveur. Le nom du tenant se trouve sur la page de connexion à Vantage dans votre navigateur lors de la saisie du mot de passe.
Paramètres de connexionNom d’utilisateurStringL’adresse e-mail de l’utilisateur utilisée pour se connecter à ABBYY Vantage.
Paramètres proxy (facultatif)Activer le proxyBooleanPermet d’utiliser un serveur proxy pour acheminer les requêtes HTTP.
Paramètres proxy (facultatif)URL du serveurStringL’adresse du serveur proxy (par ex. http://127.0.0.1:8080).
Paramètres proxy (facultatif)Nom d’utilisateurStringLe nom d’utilisateur utilisé pour se connecter au serveur proxy.
Paramètres proxy (facultatif)Mot de passeStringLe mot de passe utilisé pour se connecter au serveur proxy.
Paramètres proxy (facultatif)Mot de passe sécuriséSecureStringLe mot de passe sécurisé utilisé pour se connecter au serveur proxy.
Paramètres client de l’API publique Vantage (facultatif)ID clientStringIdentifiant de l’application Vantage.
Paramètres client de l’API publique Vantage (facultatif)Secret clientStringClé sécurisée de l’application Vantage.
Paramètres client de l’API publique Vantage (facultatif)Secret client sécuriséSecureStringClé sécurisée de l’application Vantage sous forme de chaîne sécurisée.
Le mot de passe de l’utilisateur Vantage, le mot de passe proxy et le secret client dans les paramètres client peuvent être définis dans l’activité Scope, soit dans un paramètre de type chaîne, soit dans le paramètre correspondant de type SecureString. Un mot de passe de type String est stocké en texte brut dans le fichier de projet XAML et n’est pas sécurisé. Un mot de passe String est recommandé uniquement lors de la configuration des activités Use Skill et Map Fields pour obtenir une liste de compétences, ou pour déboguer votre processus UiPath. Une fois le processus entièrement configuré :
  • Si vous utilisez le flux Resource Owner Password Credentials, supprimez la propriété Password de l’activité Vantage Scope et configurez la propriété Secure Password.
  • Si vous utilisez le flux Client Credentials, supprimez la propriété Client Secret de l’activité Vantage Scope et configurez la propriété Secure Client Secret.
Nous vous recommandons d’utiliser les assets UiPath Orchestrator pour stocker vos identifiants de manière sécurisée. Dans ce cas, le mot de passe peut être récupéré depuis Orchestrator à l’aide de l’activité Get Credential et transmis à l’activité Vantage Scope via une variable. Pour plus de détails sur l’activité Get Credential, consultez les guides officiels UiPath.
Le même type de mot de passe doit être utilisé pour les paramètres de connexion, les paramètres proxy et les paramètres client.
Lorsque vous créez un client dans ABBYY Vantage, configurez les éléments suivants dans la section OAuth 2.0 Flows Settings des paramètres client, selon le type d’octroi utilisé :
  • Flux Resource Owner Password Credentials :
    • Activez l’option Allow Resource Owner Password Credentials Flow.
  • Flux Client Credentials :
    • Activez l’option Allow issuing refresh tokens to refresh access tokens.
    • Activez l’option Allow client credentials flow.
    • Sélectionnez les rôles requis avec lesquels l’application se connectera à Vantage en cliquant sur Manage Roles.
    Si vous devez sélectionner dans la liste un ou plusieurs rôles associés à des compétences, sélectionnez également les compétences autorisées pour ces rôles.
Champs à renseigner pour le flux Resource Owner Password Credentials : Champs de l’activité Vantage Scope pour le flux Resource Owner Password Credentials
Si toutes les propriétés des paramètres du client de l’API publique de Vantage sont vides, le client ABBYY Vantage par défaut est utilisé.
Champs à renseigner pour le flux Client Credentials : Champs de l’activité Vantage Scope pour le flux Client Credentials

​
Paramètres du proxy

Vous pouvez configurer les requêtes du connecteur à l’exécution pour qu’elles transitent par un serveur proxy. Les types d’authentification proxy suivants sont pris en charge : Basic, NTLM, authentification par IP et proxy transparent. Pour utiliser un proxy, sélectionnez l’activité Vantage Scope. Dans le groupe de propriétés Proxy Settings (optional), définissez la propriété Enable Proxy sur "true", puis indiquez l’adresse de votre serveur proxy dans la propriété Server URL. Si vous utilisez l’authentification Basic, indiquez les identifiants de connexion au proxy dans les propriétés Username et Password / Secure Password. Si vous utilisez l’authentification NTLM, les champs Username et Password sont facultatifs. Si les champs Username et Password sont vides, les identifiants de l’utilisateur sous lequel le processus UiPath s’exécute seront utilisés.

​
Activité Use Skill

L’activité Use Skill crée une transaction pour traiter un document à l’aide d’une compétence ABBYY Vantage. Un identifiant unique de la transaction est ensuite renvoyé dans la propriété de sortie ID de transaction.

​
Propriétés de l’activité

GroupPropriétéTypeDescription
Paramètres de connexionSkill NameStringLe nom de la compétence Vantage.
EntréeInput FilesIReadOnlyDictionary<String,InputFile>Une collection Dictionary dans laquelle String correspond au nom du fichier et InputFile à la classe qui décrit le fichier d’entrée. Remarque : avant d’ajouter des fichiers au dictionnaire, assurez-vous que des valeurs uniques sont transmises au paramètre String. Vous ne pouvez pas ajouter plusieurs fichiers au dictionnaire Input Files si le même nom est transmis dans le paramètre String.
EntréeTransaction Registration ParametersIReadOnlyDictionary<String,String>Une collection Dictionary de paramètres d’enregistrement de transaction permettant de transmettre la clé et la valeur de chaque paramètre.
SortieID de transactionGuidIdentifiant de la transaction créée. Cet ID est ensuite utilisé comme propriété d’entrée ID de transaction de l’activité Get Results pour obtenir l’état de la transaction et les résultats du traitement.
Propriétés de la classe InputFile :
NameTypeDescription
fileStreamStreamLe contenu du fichier qui sera transmis à ABBYY Vantage. Vous pouvez transmettre comme valeur de cette propriété le flux d’un fichier stocké sur un disque local (par exemple, System.IO.File.OpenRead("D:\images\Invoice1.pdf")).
index (facultatif)IntegerL’indice du fichier dans la transaction.
fileRegistrationParameters (facultatif)IReadOnlyDictionary<String,String>Une collection Dictionary de paramètres d’enregistrement du fichier permettant de transmettre la clé et la valeur de chaque paramètre.
L’activité Use Skill ne peut être utilisée qu’à l’intérieur d’une activité Vantage Scope configurée.
Lors de la configuration de l’activité Use Skill, procédez comme suit selon le flux d’authentification utilisé :
  • Resource Owner Password Credentials Flow — Spécifiez la propriété Password de l’activité Vantage Scope pour obtenir la liste des compétences disponibles. Une fois votre workflow UiPath configuré, envisagez de remplacer la propriété Password par Secure Password.
  • Client Credentials Flow — Spécifiez la propriété Client Secret de l’activité Vantage Scope pour obtenir la liste des compétences disponibles. Une fois votre workflow UiPath configuré, envisagez de remplacer la propriété Client Secret par Secure Client Secret.
Pour plus de détails, consultez la section Vantage Scope Activity. Interface utilisateur de l’activité Vantage Scope Cliquez sur le bouton situé à droite de la liste déroulante sous Skill Name pour obtenir la liste des compétences. Développez ensuite la liste déroulante Skill Name et sélectionnez la compétence que vous souhaitez utiliser pour le traitement des documents.
Nous vous recommandons de réduire la taille des fichiers volumineux à 30 Mo ou moins afin d’accélérer le traitement des documents.
Dans le paramètre Skill Name de l’activité Use Skill, vous pouvez utiliser une variable UiPath de type String pour stocker le nom de la compétence. Lors de la sélection d’une compétence via la liste déroulante de l’activité dans le panneau de conception, la compétence nouvellement sélectionnée est enregistrée dans la variable spécifiée. Vous pouvez stocker directement le nom de la compétence dans la variable. Les expressions ou références à d’autres variables dans la valeur de la variable ne sont actuellement pas prises en charge.

​
Activité Get Results

L’activité Get Results permet de récupérer les résultats du traitement dans ABBYY Vantage.

​
Propriétés de l’activité

GroupPropriétéTypeDescription
EntréeID de transactionGuidIdentifiant de la transaction. Transmettez à cette propriété la valeur obtenue dans la propriété de sortie ID de transaction de l’activité Use Skill.
EntréeSupprimer la transactionBooleanIndique si la transaction terminée doit être supprimée, qu’elle ait réussi ou non. La valeur par défaut est FALSE, ce qui signifie que la transaction n’est pas supprimée.
SortieRésultats des documentsIEnumerable<DocumentResult>Collection des documents de résultat après traitement.
SortieLien de relectureStringLien vers le client de relecture manuelle ABBYY Vantage, dans lequel les résultats de la transaction peuvent être examinés (ce lien ne peut être obtenu que si la Compétence de processus utilisée contient une activité Review).
SortieStatut de la transactionTransactionStatusStatut de la transaction. Les statuts suivants sont possibles : "New", "Processing", "Review", "Processed". En fonction du statut reçu, vous pouvez configurer votre processus UiPath pour exécuter une logique différente. Par exemple, si la transaction a le statut "Processing", attendez quelques secondes, puis relancez l’activité.
Lorsque vous utilisez une compétence de classification, une Compétence de document ou une compétence OCR, tous les fichiers d’entrée de la transaction sont assemblés en un seul document. Lorsque vous utilisez une Compétence de processus, plusieurs documents de résultat peuvent être obtenus. Par défaut, dans une Compétence de processus, un document distinct est créé dans ABBYY Vantage pour chaque fichier d’entrée ajouté à la transaction. Les documents peuvent appartenir à différentes classes, mais ils seront tous traités dans une seule transaction. Vous pouvez également définir vos propres paramètres d’assemblage des documents à l’aide de l’Assemble Activity dans la Compétence de processus. Ainsi, chaque document de la transaction aura ses propres résultats de traitement. Le paramètre de sortie Document Results de l’activité Get Results reçoit les résultats du traitement de tous les documents de la transaction sous forme d’une collection d’instances de la classe DocumentResult. Propriétés de la classe DocumentResult :
NameTypeDescription
DocumentIdStringIdentifiant du document.
ClassificationConfidencesIEnumerable<ClassificationConfidence>Collection de valeurs de confiance de classification. Liste de toutes les classes disponibles dans la compétence de classification appliquée au document, ainsi que de leurs valeurs de confiance de classification.
ClassNameStringClasse du document déterminée d’après les résultats de classification.
ExtractedDataStringChaîne JSON contenant les données extraites. Remarque : pour une Compétence de processus, cette propriété peut être obtenue si l’option Values, metadata, and field structure for each document est activée dans l’Output Activity.
IsClassificationConfidentBooleanLa classe résultante est considérée comme déterminée avec un niveau de confiance suffisant si cette valeur est TRUE.
ResultFilesIReadOnlyDictionary<String,Stream>Collection des fichiers de résultat après traitement.
DocumentFullTextStringCalque de texte intégral d’un document capturé par ABBYY Vantage. Remarque : si la configuration de la compétence ne contient pas de paramètre d’export du texte intégral, cette propriété contiendra la valeur par défaut suivante : L’export TXT n’a pas été configuré dans les paramètres de la compétence ABBYY Vantage. Veuillez activer l’export TXT dans la compétence sélectionnée. L’export TXT n’est disponible que pour les compétences OCR ou de traitement.
Tous les paramètres répertoriés sont regroupés dans un DocumentResult distinct dans la collection Document Results. Même s’il n’y a qu’un seul document de sortie, ses paramètres de sortie seront disponibles dans le premier DocumentResult de la collection Document Results.
Propriétés de la classe ClassificationConfidence :
NameTypeDescription
ClassNameStringClasse de document Vantage.
ConfidenceIntLe degré de confiance indiquant que le document appartient à cette classe. Les valeurs possibles vont de 0 à 100.
L’activité Get Results ne peut être utilisée qu’à l’intérieur d’une activité Vantage Scope configurée.
Si le traitement de la transaction s’est terminé avec succès (c.-à-d. Transaction Status = "Processed"), les résultats seront enregistrés dans les propriétés de sortie. Si la transaction est toujours en cours de traitement (c.-à-d. Transaction Status = "New" / "Processing"), attendez quelques secondes, puis relancez l’activité Get Results. Le cas particulier où Transaction Status = "Review" est décrit ci-dessous. Les résultats obtenus par l’activité Get Results varient selon la compétence appliquée au document :
  • Compétence de classification (p. ex. Vantage Classifier) :
    • Statut de la transaction
    • Résultats des documents (pour chaque DocumentResult) : DocumentId, ClassificationConfidences, ClassName, IsClassificationConfident, ResultFiles (fichier JSON contenant les données des résultats de classification)
  • Compétence de document (p. ex. Invoice US) :
    • Statut de la transaction
    • Résultats des documents (pour chaque DocumentResult) : DocumentId, ExtractedData, ResultFiles (les résultats seront contenus dans deux fichiers JSON : le premier contient toutes les données du document, le second contient les valeurs des champs extraits et les erreurs de règle, et se termine par _fields.json)
  • compétence OCR :
    • Statut de la transaction
    • Résultats des documents (pour chaque DocumentResult) : DocumentId, ResultFiles (ces fichiers seront renvoyés selon l’export configuré dans la compétence OCR), DocumentFullText (si l’export au format TXT est activé dans la compétence)
  • Compétence de processus : Si une Compétence de processus comprend une activité Classify et une activité Extract, les résultats ci-dessus seront obtenus à la fois pour une compétence de classification et une Compétence de document. Si une Compétence de processus comprend plusieurs activités Classify ou Extract, les résultats correspondront aux dernières activités de chaque type. Si une Compétence de processus comprend plusieurs activités Classify ou Extract, les résultats correspondront aux dernières activités de chaque type. Si l’option PDF est activée dans la boîte de dialogue Exported Data Settings d’une activité Output d’une Compétence de processus, les résultats contiendront le fichier JSON avec les résultats de l’extraction ainsi que l’image du document exportée dans un fichier PDF avec un calque de texte. Pour chaque document de la transaction, le paramètre DocumentFullText sera renvoyé si l’export au format TXT est activé dans la compétence. Une Compétence de processus peut également contenir une activité Review. Lors de l’utilisation d’une telle compétence pour le traitement des documents, le traitement peut être suspendu si le document nécessite une relecture manuelle. Dans ce cas, l’activité Get Results obtiendra les résultats suivants :
    • Statut de la transaction = "Review"
    • Lien de relecture
    Une fois la relecture manuelle et le traitement de la transaction terminés, vous pouvez obtenir les résultats ci-dessus en appelant de nouveau l’activité Get Results.
Le traitement de la transaction peut échouer pour plusieurs raisons (par exemple, un fichier d’entrée peut être corrompu ou son format peut ne pas être pris en charge par ABBYY Vantage). Dans ce cas, l’activité Get Results lèvera une exception.

​
Activité Map Fields

L’activité Map Fields permet d’enregistrer les valeurs des champs extraits dans des variables UiPath. Vous pouvez associer des champs ABBYY Vantage à des variables UiPath dans le volet Designer.

​
Propriétés de l’activité

GroupePropriétéTypeDescription
Paramètres de connexionSkill NameStringNom de la compétence de document Vantage.
EntréeExtracted DataStringAccepte une chaîne JSON contenant les données extraites. Affectez à cette propriété la valeur de la propriété ExtractedData du DocumentResult concerné reçu dans l’activité Get Results. Pour transmettre des valeurs entre les propriétés, utilisez des variables UiPath.
L’activité Map Fields ne peut être utilisée qu’à l’intérieur d’une activité Vantage Scope configurée.
Lors de la configuration de l’activité Map Fields, procédez comme suit selon le flux d’authentification utilisé :
  • Resource Owner Password Credentials Flow — Spécifiez la propriété Password de l’activité Vantage Scope pour obtenir la liste des compétences disponibles. Une fois votre workflow UiPath configuré, envisagez de remplacer la propriété Password par Secure Password.
  • Client Credentials Flow — Spécifiez la propriété Client Secret de l’activité Vantage Scope pour obtenir la liste des compétences disponibles. Une fois votre workflow UiPath configuré, envisagez de remplacer la propriété Client Secret par Secure Client Secret.
Pour plus de détails, consultez la section Vantage Scope Activity.
Lors de l’exécution, la propriété Extracted Data de l’activité Map Fields doit recevoir la valeur de la propriété ExtractedData du DocumentResult concerné reçu dans l’activité Get Results contenant les données extraites par la compétence de document pour laquelle l’activité Map Fields a été configurée. Après réception des données extraites, vérifiez si le nom de la compétence de document appliquée au document correspond au nom de la compétence de document pour laquelle l’activité Map Fields a été configurée et, si c’est le cas, transmettez les données extraites à Map Fields. Pour obtenir le type de document, vous pouvez utiliser la propriété de sortie ClassName du DocumentResult concerné reçu dans l’activité Get Results. Pour transmettre le type de document à ce paramètre, dans l’activité Extract de la Compétence de processus, configurez le mappage de la classe avec la compétence de document à utiliser pour le traitement des documents. Lors du mappage, il est nécessaire de respecter la condition selon laquelle le nom de la classe est identique au nom de la compétence de document sélectionnée.
Pour mapper les champs ABBYY Vantage à des variables UiPath, effectuez les étapes suivantes :
  1. Ouvrez l’activité Map Fields dans le panneau Designer et cliquez sur le bouton situé à droite de la liste déroulante sous Skill Name pour obtenir la liste des compétences disponibles.
  2. Développez la liste déroulante Skill Name et sélectionnez la compétence de document dont les valeurs de champ extraites doivent être enregistrées dans des variables UiPath.
    Vous pouvez uniquement choisir une compétence de document.
  3. Cliquez sur le bouton Refresh. Une arborescence de champs s’affiche dans la colonne Vantage Extracted Field.
  4. Développez l’arborescence et cliquez sur le bouton Plus à côté du champ que vous souhaitez mapper. Dans la colonne UiPath Variable, un nom et un type de variable UiPath apparaissent. Par défaut, le nom de la variable sera identique à celui du champ Vantage, mais vous pouvez le modifier si nécessaire.
    Assurez-vous que les noms de variable UiPath spécifiés dans l’activité Map Fields correspondent à la convention de nommage des variables configurée dans votre processus UiPath. Si les noms de variable ne respectent pas les règles de nommage, ils s’afficheront avec un symbole d’avertissement dans la liste des variables UiPath. Pour en savoir plus sur la convention de nommage des variables, consultez la documentation UiPath.
    Activité Map Fields affichant l’arborescence Vantage Extracted Field et la colonne UiPath Variable
  5. Répétez l’étape précédente pour tous les autres champs à mapper. Lors de la configuration du mappage, vous pouvez spécifier des variables UiPath déjà existantes. Dans ce cas, assurez-vous que le type de vos variables correspond à celui recommandé dans le tableau ci-dessous.
  6. Une fois vos champs de document mappés à des variables UiPath, cliquez sur Apply pour enregistrer les modifications. Désormais, lorsque l’activité Map Fields est appelée à l’exécution, les valeurs des variables sont renseignées avec les données extraites.
Les variables UiPath spécifiées seront créées dans la séquence la plus proche de l’activité Map Fields (par exemple, dans Flowchart).
Dans le paramètre Skill Name de l’activité Map Fields, vous pouvez utiliser une variable UiPath de type String pour stocker le nom de la compétence. Lorsque vous sélectionnez une compétence dans la liste déroulante de l’activité, dans le panneau de conception, la compétence nouvellement sélectionnée est écrite dans la variable spécifiée. Vous pouvez aussi stocker directement le nom de la compétence dans la variable. Les expressions ou les références à d’autres variables dans la valeur de cette variable ne sont actuellement pas prises en charge. Le tableau ci-dessous indique à quel type de variable UiPath correspond chaque type de champ ABBYY Vantage :
Type de champ ABBYY VantageType de variable UiPath
TextString
DateString
NumberString
MoneyString
BarcodeString
CheckmarkBoolean
Checkmark group (can be obtained as separated checkmarks)FieldList
GroupFieldList
Group (for repeatable groups)FieldList[]
TableFieldList[]
Les colonnes de tableau ainsi que les champs répétitifs sont mappés à des variables UiPath de type String[]. Tous les champs répétitifs et les champs qui font partie d’un groupe répétitif (ou tout autre champ répétitif et groupe répétitif au sein de groupes répétitifs) sont mappés à des variables UiPath de type FieldList[]. Il est également possible de mapper les objets enfants de ce groupe à des variables d’autres types simples.
Activité Map Fields affichant l’arborescence des champs extraits de Vantage et la colonne UiPath Variable Propriétés de la classe GroupItem : GroupItem est une structure qui contient une instance d’un objet répétitif (champ ou groupe de champs).
Method/PropertyParameterTypeDescription
KeysIEnumerable<string>Valeurs de clé. Chaque valeur correspond au nom d’un niveau d’imbrication spécifique.
ValuesIEnumerable<IReadOnlyList<FieldList>>Ensemble des valeurs de champ pour les différents niveaux d’imbrication.
CountIntegerNombre de champs imbriqués.
ContainsKeyKey: StringBooleanIndique si un champ imbriqué existe.
TryGetValueKey: String, Value: IReadOnlyList<FieldList>BooleanIndique si une valeur existe. S’il y en a une, renvoie True et la valeur ; sinon, renvoie False.
this[]Name: StringIReadOnlyList<FieldList>Renvoie la valeur du champ imbriqué spécifié.
FindName: StringIEnumerable<FieldList>Recherche tous les champs imbriqués, à n’importe quel niveau d’imbrication, portant le nom spécifié.
FilterPredicate: (Name: String, Node: FieldList) => BooleanIEnumerable<FieldList>Recherche tous les champs imbriqués, à n’importe quel niveau d’imbrication, qui satisfont le prédicat.
DescendentsNameItems: Params String[]IEnumerable<FieldList>Recherche tous les champs imbriqués, à n’importe quel niveau d’imbrication, dont le nom correspond au paramètre nameItems.
Propriétés de la classe FieldList : FieldList est une structure qui correspond à un champ ou à un groupe de champs (champs répétitifs ou groupes répétitifs portant le même nom) et qui contient les valeurs (plusieurs instances possibles) des champs ou des groupes.
Method/PropertyParameterTypeDescription
ValuesIEnumerable<Object>Ensemble des valeurs de champ scalaires.
CountIntegerNombre de GroupItems imbriqués.
FindName: StringIEnumerable<FieldList>Recherche tous les champs imbriqués, à n’importe quel niveau d’imbrication, portant le nom spécifié.
FilterPredicate: (Name: String, Node: FieldList) => BooleanIEnumerable<FieldList>Recherche tous les champs imbriqués, à n’importe quel niveau d’imbrication, qui satisfont le prédicat.
this[]Num: IntegerGroupItemRenvoie le GroupItem avec champs imbriqués (le cas échéant) correspondant au numéro du paramètre num.
Le Sample Process fournit un exemple d’utilisation d’une variable de type FieldList[] (la colonne Description du tableau LineItems est affichée dans les messages du journal).

​
Étapes suivantes

Consultez l’exemple de processus inclus dans le connecteur UiPath ou les notes de version.