Activité Map Fields

L’activité Map Fields associe les valeurs des champs extraites par ABBYY Vantage à des variables UiPath, avec des correspondances de type pour le texte, les dates, les coches, les groupes et les tableaux.

L’activité Map Fields est généralement la dernière activité Vantage d’un workflow UiPath. Elle récupère les Données extraites de Get Results et associe les champs individuels à des variables UiPath que les activités en aval peuvent utiliser. Vous définissez le mappage dans le panneau Designer.

​

Propriétés de l’activité

Group	Propriété	Type	Description
Connection Settings	Skill Name	String	Nom de la compétence de document Vantage.
Input	Extracted Data	String	Accepte 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.

​

Mettre en correspondance des champs avec des variables UiPath

L’activité Map Fields ne peut être utilisée qu’à l’intérieur d’une activité Vantage Scope configurée.

​

Avant le mappage

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, effectuez les vérifications suivantes :

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

​

Associer les champs

1. Définir les identifiants

   Dans l’activité Vantage Scope, définissez la propriété Password ou Client Secret, selon votre mode d’authentification. Cela permet au connecteur de récupérer la liste des compétences. Une fois le workflow configuré, passez à la propriété Secure Password ou Secure Client Secret. Pour plus d’informations, consultez l’activité Vantage Scope.

2. Charger les compétences disponibles

   Ouvrez l’activité Map Fields dans le panneau Designer. Cliquez sur le bouton situé à droite de la liste déroulante Skill Name.

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

4. Actualiser l’arborescence des champs

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

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

   
6. Associer les champs restants

   Répétez l’étape précédente pour tous les autres champs que vous devez associer. Vous pouvez spécifier des variables UiPath existantes. Dans ce cas, assurez-vous que le type de la variable correspond à celui recommandé dans le tableau Field type mapping.

7. 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 sont créées dans la séquence la plus proche de l’activité Map Fields (par exemple, dans un 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.

​

Mappage des types de champs

Le tableau suivant montre quel type de variable UiPath correspond à chaque type de champ ABBYY Vantage :

Type de champ ABBYY Vantage	Type de variable UiPath
Text	String
Date	String
Number	String
Money	String
Barcode	String
Checkmark	Boolean
Groupe de coches (peut être obtenu sous forme de coches séparées)	FieldList
Group	FieldList
Group (pour les groupes répétables)	FieldList[]
Table	FieldList[]

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.

​

GroupItem

GroupItem est une structure contenant une instance d’un objet répétable (champ ou groupe de champs).

Méthode/Propriété	Paramètre	Type	Description
Keys		IEnumerable<string>	Valeurs de clé. Chaque valeur correspond au nom d’un niveau d’imbrication spécifique.
Values		IEnumerable<IReadOnlyList<FieldList>>	Ensemble des valeurs des champs des niveaux d’imbrication.
Count		Integer	Nombre de champs imbriqués.
ContainsKey	Key: String	Boolean	Indique si un champ imbriqué existe.
TryGetValue	Key: String, Value: IReadOnlyList<FieldList>	Boolean	Indique si une valeur existe. Si une valeur existe, retourne True et la valeur ; sinon, retourne False.
this[]	Name: String	IReadOnlyList<FieldList>	Retourne la valeur du champ imbriqué spécifié.
Find	Name: String	IEnumerable<FieldList>	Recherche tous les champs imbriqués, à n’importe quel niveau d’imbrication, portant le nom spécifié.
Filter	Predicate: (Name: String, Node: FieldList) => Boolean	IEnumerable<FieldList>	Recherche tous les champs imbriqués, à n’importe quel niveau d’imbrication, qui satisfont le prédicat.
Descendents	NameItems: 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). Elle contient les valeurs de ces champs ou groupes, et plusieurs instances sont possibles.

Méthode/Propriété	Paramètre	Type	Description
Values		IEnumerable<Object>	Ensemble de valeurs scalaires de champ.
Count		Integer	Nombre de GroupItems imbriqués.
Find	Name: String	IEnumerable<FieldList>	Recherche tous les champs imbriqués, à n’importe quel niveau d’imbrication, portant le nom spécifié.
Filter	Predicate: (Name: String, Node: FieldList) => Boolean	IEnumerable<FieldList>	Recherche tous les champs imbriqués, à n’importe quel niveau d’imbrication, qui satisfont le prédicat.
this[]	Num: Integer	GroupItem	Retourne le GroupItem avec les champs imbriqués (le cas échéant) correspondant au numéro du paramètre num.

Le processus d’exemple 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.

​

Rubriques connexes

• Vantage Scope activity
• Use Skill activity
• Get Results activity