Passer au contenu principal

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.

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

​
Propriétés de l’activité

GroupPropriétéTypeDescription
Connection SettingsSkill NameStringNom de la compétence de document Vantage.
InputExtracted DataStringAccepte une chaîne JSON contenant les données extraites. Transmettez à 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é, définissez la propriété Password ou Client Secret dans l’activité Vantage Scope (selon votre flux d’authentification) afin que le connecteur puisse récupérer la liste des compétences. Basculez vers la propriété Secure Password ou Secure Client Secret une fois votre workflow configuré — consultez Vantage Scope activity. Au moment de l’exécution, la propriété Extracted Data doit recevoir la valeur ExtractedData du DocumentResult renvoyé par Get Results pour la compétence de document pour laquelle cette activité Map Fields est configurée. Avant de transmettre les données à Map Fields :
  • Vérifiez que la compétence de document du document correspond à celle configurée dans Map Fields. Utilisez la propriété ClassName du DocumentResult pour identifier le type de document.
  • Pour que ClassName soit renseigné, configurez le mappage classe-compétence dans l’activité Extract de la Compétence de processus — le nom de la classe doit être identique au nom de la compétence de document.
Pour plus d’informations sur la configuration de l’activité Extract, consultez Map Document skills to classes. Pour associer des champs ABBYY Vantage à des variables UiPath :
1

Ouvrir l’activité Map Fields

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

Sélectionner une compétence de document

Développez la liste déroulante Skill Name et sélectionnez la compétence de document dont les valeurs des champs extraits doivent être enregistrées dans des variables UiPath.
Vous pouvez uniquement choisir une compétence de document.
3

Actualiser l’arborescence des champs

Cliquez sur le bouton Refresh. Une arborescence de champs s’affichera dans la colonne Vantage Extracted Field.
4

Associer un champ à une variable UiPath

Développez l’arborescence et cliquez sur le bouton Plus en regard du champ que vous souhaitez associer. Dans la colonne UiPath Variable, un nom et un type de variable UiPath apparaîtront. 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 variables 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 des variables 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 montrant l’arborescence Vantage Extracted Field et la colonne UiPath Variable
5

Associer les champs restants

Répétez l’étape précédente pour tous les autres champs que vous devez associer. Lors de la configuration du mappage, vous pouvez spécifier des variables UiPath existantes. Dans ce cas, assurez-vous que le type de vos variables correspond à celui recommandé dans le tableau ci-dessous.
6

Appliquer le mappage

Une fois les champs de votre document associés à des variables UiPath, cliquez sur Apply pour enregistrer les modifications. Désormais, lorsque l’activité Map Fields est appelée au moment de l’exécution, les valeurs des variables seront 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).
Le paramètre Skill Name accepte une variable UiPath String. La sélection d’une compétence de document dans la liste déroulante écrit la nouvelle valeur dans la variable. Les expressions et les références à d’autres variables ne sont 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
Groupe de coches (peut être obtenu sous forme de coches séparées)FieldList
GroupFieldList
Group (pour les groupes répétables)FieldList[]
TableFieldList[]
Les champs feuilles répétables (tels que Text) et les colonnes de tableau sont mappés sur String[]. Les groupes répétables, y compris ceux imbriqués dans d’autres groupes répétables, sont mappés sur FieldList[]. Au sein d’un groupe répétable, vous pouvez également mapper des champs enfants individuels sur des types simples.
Activité Map Fields affichant l’arborescence des Vantage Extracted Field et la colonne UiPath Variable avec les groupes mappés et les champs répétables

​
GroupItem

GroupItem est une structure contenant une instance d’un objet répétable (champ ou groupe de champs).
Méthode/PropriétéParamètreTypeDescription
KeysIEnumerable<string>Valeurs de clé. Chaque valeur correspond au nom d’un niveau d’imbrication spécifique.
ValuesIEnumerable<IReadOnlyList<FieldList>>Ensemble des valeurs des champs des 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. Si une valeur existe, retourne True et la valeur ; sinon, retourne False.
this[]Name: StringIReadOnlyList<FieldList>Retourne 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.

​
FieldList

FieldList est une structure qui correspond à un champ ou à un groupe de champs (champs répétables ou groupes répétables portant le même nom) et qui contient les valeurs (plusieurs instances sont possibles) des champs ou des groupes.
Méthode/PropriétéParamètreTypeDescription
ValuesIEnumerable<Object>Ensemble de valeurs scalaires de champ.
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: IntegerGroupItemRetourne le GroupItem avec les 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).
Pour plus d’informations sur le type de champ Group, consultez champ Group.

Vantage Scope activity

Transmettre les paramètres de connexion ABBYY Vantage aux activités Vantage imbriquées.

Use Skill activity

Créer une transaction Vantage pour traiter un document avec une compétence.

Get Results activity

Récupérer les résultats du traitement depuis ABBYY Vantage.