Skip to main content
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, plus an additional Vantage Skill setting for selecting the skill to use for document processing.

Input anchor

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:
Use Skill input table showing two rows with DirectoryPath values C:\Temp\Input and C:\Temp\Input2

Files mode

Pass file paths and parameters in the Files column using the following format:
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:
Use Skill Files column input showing a single row with two file paths and their Created and Size parameters
Do not include = or ; characters in file paths or registration parameter values, as these characters act as separators by default.

Transaction registration parameters

Pass transaction-level parameters in the Transaction Registration Parameters column using the format:
Separate multiple parameters with a semicolon (;). For example, to pass the source type and computer name:
Use Skill input table with DirectoryPath and TransactionRegistrationParameters columns showing SourceType and PCname values
Transaction and file registration parameters are visible in Vantage Skill Monitor and are included in the exported JSON file:
JSON output showing CreationTime, SourceFiles with file Id and Name, RegistrationParameters with SourceType and PCname, and Version fields

Output anchor

Output example:
Use Skill output table showing two rows with TransactionId GUIDs, IsSuccess True, and Error Null
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.