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

# Actividad Map Fields

> La actividad Map Fields asigna valores de campos extraídos de ABBYY Vantage a variables de UiPath, con asignaciones de tipos para texto, fechas, marcas de verificación, grupos y tablas.

La actividad **Map Fields** suele ser la última actividad de Vantage en un flujo de trabajo de UiPath: toma los **Extracted Data** de **Get Results** y asigna campos individuales a variables de UiPath que pueden usar las actividades posteriores. La asignación se define en el panel **Designer**.

<div id="activity-properties">
  ## Propiedades de la actividad
</div>

| Grupo                     | Propiedad      | Tipo     | Descripción                                                                                                                                                                                                                                                      |
| ------------------------- | -------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Configuración de conexión | Skill Name     | `String` | El nombre del Skill de documento de Vantage.                                                                                                                                                                                                                     |
| Input                     | Extracted Data | `String` | Acepta una cadena JSON que contiene los datos extraídos. Pase a esta propiedad el valor de la propiedad `ExtractedData` del `DocumentResult` específico recibido en la **Actividad Get Results**. Para pasar valores entre propiedades, use variables de UiPath. |

<Warning>
  La actividad Map Fields solo puede usarse dentro de una Vantage Scope activity configurada.
</Warning>

Al configurar la actividad, establezca la propiedad **Password** o **Client Secret** en la Vantage Scope activity (según el flujo de autenticación que utilice) para que el conector pueda recuperar la lista de skills. Cambie a la propiedad **Secure Password** o **Secure Client Secret** una vez que su workflow esté configurado; consulte la [Vantage Scope activity](/es/vantage/connectors/uipath/activities/vantage-scope).

<div id="before-you-map">
  ### Antes de asignar
</div>

En tiempo de ejecución, la propiedad **Extracted Data** debe recibir el valor `ExtractedData` del `DocumentResult` que **Get Results** devolvió para el Skill de documento para el que está configurada esta actividad Map Fields.

Antes de pasar los datos a Map Fields:

* Confirme que el Skill de documento del documento coincide con el configurado en Map Fields. Use la propiedad `ClassName` del `DocumentResult` para identificar el tipo de documento.
* Para que se rellene `ClassName`, configure la asignación de clase a skill en la Actividad Extract de la Habilidad de proceso; el nombre de la clase debe ser igual al nombre del Skill de documento.

Para obtener más información sobre la configuración de la Actividad Extract, consulte [Map Document skills to classes](/es/vantage/documentation/skill-designer/process/extract-activity).

Para asignar campos de ABBYY Vantage a variables de UiPath:

<Steps>
  <Step title="Abra la actividad Map Fields">
    Abra la actividad **Map Fields** en el panel **Designer** y haga clic en el botón situado a la derecha de la lista desplegable de **Skill Name** para cargar la lista de skills disponibles.
  </Step>

  <Step title="Seleccione un Skill de documento">
    Expanda la lista desplegable **Skill Name** y seleccione el Skill de documento cuyos valores de campo extraídos deben guardarse en variables de UiPath.

    <Note>
      Solo puede elegir un Skill de documento.
    </Note>
  </Step>

  <Step title="Actualice el árbol de campos">
    Haga clic en el botón **Refresh**. Se mostrará un árbol de campos en la columna **Vantage Extracted Field**.
  </Step>

  <Step title="Asigne un campo a una variable de UiPath">
    Expanda el árbol y haga clic en el botón **Plus** junto al campo que desea asignar. En la columna **UiPath Variable**, aparecerán el nombre y el tipo de una variable de UiPath. De forma predeterminada, el nombre de la variable será el mismo que el nombre del campo de Vantage, pero puede cambiarlo si es necesario.

    <Warning>
      Asegúrese de que los nombres de las variables de UiPath especificados en la actividad Map Fields coincidan con la convención de nomenclatura de variables configurada en su proceso de UiPath. Si los nombres de las variables no siguen las reglas de nomenclatura, se mostrarán con un símbolo de advertencia en la lista de variables de UiPath. Para obtener más información sobre Variables Naming Convention, consulte la [documentación de 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="Actividad Map Fields que muestra el árbol Vantage Extracted Field y la columna UiPath Variable" width="1102" height="1346" data-path="images/vantage/developer/connectors/uipath/map-fields-activity.jpg" />
    </Frame>
  </Step>

  <Step title="Asigne los campos restantes">
    Repita el paso anterior con los demás campos que necesite asignar. Puede especificar variables de UiPath ya existentes; en ese caso, asegúrese de que el tipo de la variable coincida con el recomendado en la tabla siguiente.
  </Step>

  <Step title="Aplique la asignación">
    Después de asignar los campos del documento a variables de UiPath, haga clic en **Apply** para guardar los cambios. Cuando la actividad **Map Fields** se invoque en tiempo de ejecución, los valores de las variables se completarán con los datos extraídos.
  </Step>
</Steps>

<Note>
  Las variables de UiPath especificadas se crearán en la Sequence más cercana a la actividad Map Fields (por ejemplo, en Flowchart).
</Note>

<Note>
  El parámetro **Skill Name** acepta una variable `String` de UiPath. Al seleccionar un Skill de documento de la lista desplegable, el nuevo valor se escribe en la variable. No se admiten expresiones ni referencias a otras variables.
</Note>

<div id="field-type-mapping">
  ## Asignación de tipos de campo
</div>

La siguiente tabla muestra qué tipo de variable de UiPath corresponde a cada tipo de campo de ABBYY Vantage:

| Tipo de campo de ABBYY Vantage                                                               | Tipo de variable de UiPath |
| -------------------------------------------------------------------------------------------- | -------------------------- |
| Text                                                                                         | `String`                   |
| Date                                                                                         | `String`                   |
| Number                                                                                       | `String`                   |
| Money                                                                                        | `String`                   |
| Barcode                                                                                      | `String`                   |
| Checkmark                                                                                    | `Boolean`                  |
| Grupo de marcas de verificación (puede obtenerse como marcas de verificación independientes) | `FieldList`                |
| Group                                                                                        | `FieldList`                |
| Group (para grupos repetibles)                                                               | `FieldList[]`              |
| Table                                                                                        | `FieldList[]`              |

<Note>
  Los campos hoja repetibles (como `Text`) y las columnas de tabla se asignan a `String[]`. Los grupos repetibles, incluidos los anidados dentro de otros grupos repetibles, se asignan a `FieldList[]`. Dentro de un grupo repetible, también puede asignar campos secundarios individuales a tipos 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="Actividad Map Fields que muestra el árbol Vantage Extracted Field y la columna UiPath Variable con grupos asignados y campos repetibles" width="1308" height="920" data-path="images/vantage/developer/connectors/uipath/map-fields-groups.jpg" />
</Frame>

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

`GroupItem` es una estructura que contiene una instancia de un objeto repetible (campo o grupo de campos).

| Method/Property | Parameter                                               | Type                                    | Description                                                                                                        |
| --------------- | ------------------------------------------------------- | --------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| Keys            |                                                         | `IEnumerable<string>`                   | Valores de clave. Cada valor es el nombre de un nivel de anidación específico.                                     |
| Values          |                                                         | `IEnumerable<IReadOnlyList<FieldList>>` | Conjunto de valores de campo de los niveles de anidación.                                                          |
| Count           |                                                         | `Integer`                               | Número de campos anidados.                                                                                         |
| ContainsKey     | `Key: String`                                           | `Boolean`                               | Especifica si existe un campo anidado.                                                                             |
| TryGetValue     | `Key: String, Value: IReadOnlyList<FieldList>`          | `Boolean`                               | Especifica si existe un valor. Si existe, devuelve `True` y el valor; en caso contrario, devuelve `False`.         |
| this\[]         | `Name: String`                                          | `IReadOnlyList<FieldList>`              | Devuelve el valor del campo anidado especificado.                                                                  |
| Find            | `Name: String`                                          | `IEnumerable<FieldList>`                | Busca todos los campos anidados de cualquier nivel de anidación con el nombre especificado.                        |
| Filter          | `Predicate: (Name: String, Node: FieldList) => Boolean` | `IEnumerable<FieldList>`                | Busca todos los campos anidados de cualquier nivel de anidación que cumplan el predicado.                          |
| Descendents     | `NameItems: Params String[]`                            | `IEnumerable<FieldList>`                | Busca todos los campos anidados de cualquier nivel de anidación cuyo nombre coincida con el parámetro `nameItems`. |

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

`FieldList` es una estructura que corresponde a un campo o grupo de campos (campos repetibles o grupos repetidos con el mismo nombre) y contiene los valores (puede haber varias instancias) de los campos o grupos.

| Method/Property | Parameter                                               | Type                     | Description                                                                                              |
| --------------- | ------------------------------------------------------- | ------------------------ | -------------------------------------------------------------------------------------------------------- |
| Values          |                                                         | `IEnumerable<Object>`    | Conjunto de valores escalares de campo.                                                                  |
| Count           |                                                         | `Integer`                | Número de GroupItems anidados.                                                                           |
| Find            | `Name: String`                                          | `IEnumerable<FieldList>` | Busca todos los campos anidados de cualquier nivel de anidación con el nombre especificado.              |
| Filter          | `Predicate: (Name: String, Node: FieldList) => Boolean` | `IEnumerable<FieldList>` | Busca todos los campos anidados de cualquier nivel de anidación que cumplan el predicado.                |
| this\[]         | `Num: Integer`                                          | `GroupItem`              | Devuelve el `GroupItem` con campos anidados (si los hay) en la posición indicada por el parámetro `num`. |

<Tip>
  El Sample Process proporciona un ejemplo de uso de una variable de tipo `FieldList[]` (la columna Description de la tabla LineItems se muestra en los mensajes de registro).
</Tip>

Para obtener más información sobre el tipo de campo Group, consulte [campo Group](/es/vantage/documentation/skill-designer/document/adding-fields/group).

<div id="related-topics">
  ## Temas relacionados
</div>

<CardGroup cols={3}>
  <Card title="Vantage Scope activity" icon="cube" href="/es/vantage/connectors/uipath/activities/vantage-scope">
    Pasar la configuración de conexión de ABBYY Vantage a las actividades de Vantage anidadas.
  </Card>

  <Card title="Use Skill activity" icon="play" href="/es/vantage/connectors/uipath/activities/use-skill">
    Crear una transacción de Vantage para procesar un documento con una skill.
  </Card>

  <Card title="Get Results activity" icon="circle-down" href="/es/vantage/connectors/uipath/activities/get-results">
    Obtener los resultados del procesamiento de ABBYY Vantage.
  </Card>
</CardGroup>
