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

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

<div id="activity-properties">
  ## Propriétés de l’activité
</div>

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

<div id="map-fields-to-uipath-variables">
  ## Mettre en correspondance des champs avec des variables UiPath
</div>

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

<div id="before-you-map">
  ### Avant le mappage
</div>

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](/fr/vantage/documentation/skill-designer/process/extract-activity).

<div id="map-the-fields">
  ### Associer les champs
</div>

<Steps>
  <Step title="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](/fr/vantage/connectors/uipath/activities/vantage-scope).
  </Step>

  <Step title="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**.
  </Step>

  <Step title="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.

    <Note>
      Vous pouvez uniquement choisir une compétence de document.
    </Note>
  </Step>

  <Step title="Actualiser l’arborescence des champs">
    Cliquez sur le bouton **Refresh**. Une arborescence de champs s’affichera dans la colonne **Vantage Extracted Field**.
  </Step>

  <Step title="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.

    <Warning>
      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](https://docs.uipath.com/).
    </Warning>

    <Frame>
      <img src="https://mintcdn.com/abbyy/Km9nwnkPeY8_wARd/images/vantage/developer/connectors/uipath/map-fields-activity.jpg?fit=max&auto=format&n=Km9nwnkPeY8_wARd&q=85&s=76f740256ad1baec40fdc56c7faebec7" alt="Activité Map Fields montrant l’arborescence Vantage Extracted Field et la colonne UiPath Variable" width="1102" height="1346" data-path="images/vantage/developer/connectors/uipath/map-fields-activity.jpg" />
    </Frame>
  </Step>

  <Step title="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](#field-type-mapping).
  </Step>

  <Step title="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.
  </Step>
</Steps>

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.

<div id="field-type-mapping">
  ## Mappage des types de champs
</div>

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[]`           |

<Note>
  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.
</Note>

<Frame>
  <img src="https://mintcdn.com/abbyy/Km9nwnkPeY8_wARd/images/vantage/developer/connectors/uipath/map-fields-groups.jpg?fit=max&auto=format&n=Km9nwnkPeY8_wARd&q=85&s=103c1a0f62e25c81d3636f855b18813b" alt="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" width="1308" height="920" data-path="images/vantage/developer/connectors/uipath/map-fields-groups.jpg" />
</Frame>

<div id="groupitem">
  ### GroupItem
</div>

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

<div id="fieldlist">
  ### FieldList
</div>

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

<Tip>
  Le [processus d’exemple](/fr/vantage/connectors/uipath/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).
</Tip>

Pour plus d’informations sur le type de champ Group, consultez [champ Group](/fr/vantage/documentation/skill-designer/document/adding-fields/group).

<div id="related-topics">
  ## Rubriques connexes
</div>

* [Vantage Scope activity](/fr/vantage/connectors/uipath/activities/vantage-scope)
* [Use Skill activity](/fr/vantage/connectors/uipath/activities/use-skill)
* [Get Results activity](/fr/vantage/connectors/uipath/activities/get-results)