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

# Use Skill tool

> Use Skill creates ABBYY Vantage transactions for processing documents and returns transaction identifiers for downstream tools.

The **Use Skill** tool creates transactions for processing documents using an ABBYY Vantage skill. It is typically the first Vantage tool in an Alteryx workflow.

The tool supports two modes depending on the column passed in its **Input** anchor:

* **DirectoryPath mode** – Pass the location of a folder containing input files. For all files located directly in the folder, the tool creates one transaction in ABBYY Vantage. Pass multiple rows to create a separate transaction for each folder.
* **Files mode** – Pass the location of individual files and their parameters. This mode lets you set separate file parameters for each document in the transaction.

## Connection settings

The **Use Skill** tool includes the connection settings described in [Configure the connection](/vantage/connectors/alteryx/setup#configure-the-connection), plus an additional **Vantage Skill** setting for selecting the skill to use for document processing.

## Input anchor

| Column                              | Type       | Description                                                                                  |
| ----------------------------------- | ---------- | -------------------------------------------------------------------------------------------- |
| DirectoryPath                       | V\_WString | The location of the folder that contains the file(s) you want to process as one transaction. |
| Files                               | V\_WString | The location of the file(s) you want to process and their parameters.                        |
| Transaction Registration Parameters | V\_WString | A set of transaction registration parameters. This column is optional.                       |

### DirectoryPath mode

Pass a folder path in the **DirectoryPath** column. All files located directly in the specified folder are added to the transaction as one group. Files in subfolders are not included.

Pass multiple rows to create a separate transaction for each folder:

<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="Use Skill input table showing two rows with DirectoryPath values C:\Temp\Input and C:\Temp\Input2" width="193" height="60" data-path="images/vantage/developer/connectors/alteryx/use-skill-directory-path-input.png" />
</Frame>

### Files mode

Pass file paths and parameters in the **Files** column using the following format:

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

The semicolon character (`;`) acts as a separator between different files and between files and their parameters. Use `FileParamName` to set a named file parameter for the document.

For example, to add `Invoice_01.tif` and `Invoice_02.tif` to a transaction with **Created** and **Size** parameters for each document:

<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="Use Skill Files column input showing a single row with two file paths and their Created and Size parameters" width="831" height="46" data-path="images/vantage/developer/connectors/alteryx/use-skill-files-input.png" />
</Frame>

<Warning>
  Do not include `=` or `;` characters in file paths or registration parameter values, as these characters act as separators by default.
</Warning>

### Transaction registration parameters

Pass transaction-level parameters in the **Transaction Registration Parameters** column using the format:

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

Separate multiple parameters with a semicolon (`;`). For example, to pass the source type and 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="Use Skill input table with DirectoryPath and TransactionRegistrationParameters columns showing SourceType and PCname values" width="449" height="138" data-path="images/vantage/developer/connectors/alteryx/use-skill-registration-params-input.png" />
</Frame>

Transaction and file registration parameters are visible in Vantage Skill Monitor and are included in the exported JSON file:

<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 showing CreationTime, SourceFiles with file Id and Name, RegistrationParameters with SourceType and PCname, and Version fields" width="671" height="235" data-path="images/vantage/developer/connectors/alteryx/use-skill-json-params.png" />
</Frame>

## Output anchor

| Column        | Type       | Description                                                                                                                                                       |
| ------------- | ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| TransactionId | V\_WString | The identifier of the created transaction. This ID is passed to the **Get Status** and **Get Result** tools to get the transaction status and processing results. |
| isSuccess     | Bool       | Indicates whether the transaction was successfully created.                                                                                                       |
| Error         | V\_WString | Specifies the error message that occurred while creating a transaction.                                                                                           |

Output example:

<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="Use Skill output table showing two rows with TransactionId GUIDs, IsSuccess True, and Error Null" width="477" height="58" data-path="images/vantage/developer/connectors/alteryx/use-skill-output-example.png" />
</Frame>

<Note>
  ABBYY Vantage allows uploading transactions of up to 2 GB in size. To speed up document processing, keep individual file sizes to a maximum of 30 MB.
</Note>

## Related topics

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