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

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

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](/fr/vantage/connectors/uipath/activities/vantage-scope).

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

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

Pour associer des champs ABBYY Vantage à des variables UiPath :

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

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

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

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

Le tableau ci-dessous 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) et qui contient les valeurs (plusieurs instances sont possibles) des champs ou des groupes.

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

<CardGroup cols={3}>
  <Card title="Vantage Scope activity" icon="cube" href="/fr/vantage/connectors/uipath/activities/vantage-scope">
    Transmettre les paramètres de connexion ABBYY Vantage aux activités Vantage imbriquées.
  </Card>

  <Card title="Use Skill activity" icon="play" href="/fr/vantage/connectors/uipath/activities/use-skill">
    Créer une transaction Vantage pour traiter un document avec une compétence.
  </Card>

  <Card title="Get Results activity" icon="circle-down" href="/fr/vantage/connectors/uipath/activities/get-results">
    Récupérer les résultats du traitement depuis ABBYY Vantage.
  </Card>
</CardGroup>