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

# Herramienta Use Skill

> Use Skill crea transacciones de ABBYY Vantage para procesar documentos y devuelve identificadores de transacción para las herramientas posteriores.

La herramienta **Use Skill** crea transacciones para procesar documentos mediante una Vantage Skill de ABBYY. Normalmente es la primera herramienta de Vantage en un workflow de Alteryx.

La herramienta admite dos modos, según la columna que se pase en su anclaje **Input**:

* **Modo DirectoryPath**: se indica la ubicación de una carpeta con los archivos de entrada. La herramienta crea una única transacción en ABBYY Vantage con todos los archivos que se encuentren directamente en esa carpeta. Pase varias filas para crear una transacción independiente por cada carpeta.
* **Modo Files**: se indica la ubicación de cada archivo y sus parámetros. Este modo permite definir parámetros de archivo distintos para cada documento de la transacción.

<div id="connection-settings">
  ## Configuración de conexión
</div>

La herramienta **Use Skill** incluye la configuración de conexión descrita en [Configurar la conexión](/es/vantage/connectors/alteryx/setup#configure-the-connection), además de un ajuste adicional, **Vantage Skill**, para seleccionar el skill que se utilizará en el procesamiento de documentos.

<div id="input-anchor">
  ## Anclaje de entrada
</div>

| Columna                             | Tipo       | Descripción                                                                                                      |
| ----------------------------------- | ---------- | ---------------------------------------------------------------------------------------------------------------- |
| DirectoryPath                       | V\_WString | La ubicación de la carpeta que contiene el archivo o los archivos que desea procesar como una única transacción. |
| Files                               | V\_WString | La ubicación del archivo o los archivos que desea procesar y sus parámetros.                                     |
| Transaction Registration Parameters | V\_WString | Un conjunto de parámetros de registro de la transacción. Esta columna es opcional.                               |

<div id="directorypath-mode">
  ### Modo DirectoryPath
</div>

Indique una ruta de carpeta en la columna **DirectoryPath**. Todos los archivos ubicados directamente en la carpeta especificada se añaden a la transacción como un solo grupo. Los archivos de las subcarpetas no se incluyen.

Indique varias filas para crear una transacción independiente por cada carpeta:

<Frame>
  <img src="https://mintcdn.com/abbyy/GYXzQ7h3X_sAg5P7/images/vantage/developer/connectors/alteryx/use-skill-directory-path-input.png?fit=max&auto=format&n=GYXzQ7h3X_sAg5P7&q=85&s=30e3a667bc8ff9d27a9bcd805bb88158" alt="Tabla de entrada de Use Skill que muestra dos filas con los valores de DirectoryPath C:\Temp\Input y C:\Temp\Input2" width="193" height="60" data-path="images/vantage/developer/connectors/alteryx/use-skill-directory-path-input.png" />
</Frame>

<div id="files-mode">
  ### Modo Files
</div>

Indique las rutas de los archivos y los parámetros en la columna **Files** con el siguiente formato:

```text theme={null}
File="<absolute filepath>";<FileParamName>="<file parameter value>"
```

El carácter de punto y coma (`;`) actúa como separador entre distintos archivos y entre los archivos y sus parámetros. Utilice `FileParamName` para definir un parámetro de archivo con nombre para el documento.

Por ejemplo, para agregar `Invoice_01.tif` e `Invoice_02.tif` a una transacción con los parámetros **Created** y **Size** para cada documento:

<Frame>
  <img src="https://mintcdn.com/abbyy/GYXzQ7h3X_sAg5P7/images/vantage/developer/connectors/alteryx/use-skill-files-input.png?fit=max&auto=format&n=GYXzQ7h3X_sAg5P7&q=85&s=3c7ca70ee2c54daefe186aeb9d76f3b6" alt="Entrada de la columna Files de Use Skill que muestra una única fila con dos rutas de archivo y sus parámetros Created y Size" width="831" height="46" data-path="images/vantage/developer/connectors/alteryx/use-skill-files-input.png" />
</Frame>

<Warning>
  No incluya los caracteres `=` ni `;` en las rutas de archivo ni en los valores de los parámetros de registro, ya que estos caracteres actúan como separadores de forma predeterminada.
</Warning>

<div id="transaction-registration-parameters">
  ### Parámetros de registro de la transacción
</div>

Indique los parámetros de nivel de transacción en la columna **Transaction Registration Parameters** con el siguiente formato:

```text theme={null}
TransactionParamName="transaction parameter value"
```

Separe varios parámetros con un punto y coma (`;`). Por ejemplo, para pasar el tipo de origen (source type) y el nombre del equipo (computer name):

<Frame>
  <img src="https://mintcdn.com/abbyy/GYXzQ7h3X_sAg5P7/images/vantage/developer/connectors/alteryx/use-skill-registration-params-input.png?fit=max&auto=format&n=GYXzQ7h3X_sAg5P7&q=85&s=77f2dbb14cd794492560862a0a2375cb" alt="Tabla de entrada de Use Skill con las columnas DirectoryPath y TransactionRegistrationParameters que muestran los valores SourceType y PCname" width="449" height="138" data-path="images/vantage/developer/connectors/alteryx/use-skill-registration-params-input.png" />
</Frame>

Los parámetros de registro de la transacción y del archivo se pueden ver en el Skill Monitor de Vantage y se incluyen en el archivo JSON exportado:

<Frame>
  <img src="https://mintcdn.com/abbyy/GYXzQ7h3X_sAg5P7/images/vantage/developer/connectors/alteryx/use-skill-json-params.png?fit=max&auto=format&n=GYXzQ7h3X_sAg5P7&q=85&s=421473524f4afc17d9de0474d9cf6fe6" alt="JSON output que muestra CreationTime, SourceFiles con el Id y el Name del archivo, RegistrationParameters con SourceType y PCname, y los campos Version" width="671" height="235" data-path="images/vantage/developer/connectors/alteryx/use-skill-json-params.png" />
</Frame>

<div id="output-anchor">
  ## Anclaje de salida
</div>

| Columna       | Tipo       | Descripción                                                                                                                                                                                |
| ------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| TransactionId | V\_WString | El identificador de la transacción creada. Este ID se pasa a las herramientas **Get Status** y **Get Result** para obtener el estado de la transacción y los resultados del procesamiento. |
| isSuccess     | Bool       | Indica si la transacción se creó correctamente.                                                                                                                                            |
| Error         | V\_WString | Especifica el mensaje de error que se produjo al crear una transacción.                                                                                                                    |

Ejemplo de salida:

<Frame>
  <img src="https://mintcdn.com/abbyy/GYXzQ7h3X_sAg5P7/images/vantage/developer/connectors/alteryx/use-skill-output-example.png?fit=max&auto=format&n=GYXzQ7h3X_sAg5P7&q=85&s=d76126f3002f8673bf8173da283c4891" alt="Tabla de salida de Use Skill que muestra dos filas con GUID de TransactionId, IsSuccess True y Error Null" width="477" height="58" data-path="images/vantage/developer/connectors/alteryx/use-skill-output-example.png" />
</Frame>

<Note>
  ABBYY Vantage permite cargar transacciones de hasta 2 GB de tamaño. Para agilizar el procesamiento de documentos, procure que cada archivo no supere los 30 MB.
</Note>

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

* [Herramienta Get Status](/es/vantage/connectors/alteryx/tools/get-status)
* [Herramienta Get Result](/es/vantage/connectors/alteryx/tools/get-result)
* [Herramienta Parse Fields](/es/vantage/connectors/alteryx/tools/parse-fields)
