> ## 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.
# Release notes for the Alteryx connector
> Version history, new features, bug fixes, known issues, and limitations for the ABBYY Vantage Connector for Alteryx.
This page lists the new features, changes, and known issues in each release of the ABBYY Vantage Connector for Alteryx, starting with the most recent version.
## About this release
This release restores compatibility with Alteryx Designer 2024.2 and later, which ships a newer version of Newtonsoft.Json (v13) than the version the connector previously bundled (v12). It also adds support for [client credentials authentication](/vantage/developer/authentication/client-credentials), required for ABBYY Vantage 3.0.
## Compatibility updates
* **Alteryx Designer 2024.2 and later** – Updated the connector's Newtonsoft.Json dependency from v12 to v13 to match the version shipped by Alteryx. The connector now bundles its own `Newtonsoft.Json.dll` rather than relying on the version provided by the Alteryx host process, eliminating the assembly version mismatch that caused `System.IO.FileLoadException` on startup in Alteryx 2024.2+.
* **ABBYY Vantage 3.0** – Updated the Vantage Public API client (`Abbyy.Integration.Vantage.Shared.PublicApi`) to support ABBYY Vantage 3.0. The `Abbyy.Integration.JsonExport.Contract` dependency has also been rebuilt against the updated dependency versions.
* **.NET Framework 4.8** – Minimum required .NET Framework version updated from 4.7.2 to 4.8.
## Upgrade procedure
Run `ABBYYVantageConnectorForAlteryx.3.0.5.x64.3.0.5.exe`.
After installation completes, open `C:\Program Files\ABBYY Vantage Connector for Alteryx` and double-click `Abbyy.Alteryx.Vantage.Connector.yxi`.
The tool installer loads within Alteryx Designer. Click **Install** to finish installing the new version. The installer copies the connector files into the folder `\Alteryx\Tools\Vantage`, where `ProgramDataFolder` is the folder containing the Alteryx program data files. Depending on the installation type, this can be:
* `%APPDATA%\Alteryx\Tools\Vantage` – if you are installing the connector for the current user only
* `%PROGRAMDATA%\Alteryx\Tools\Vantage` – if you are installing the connector for all users
Depending on your installation type, the default Alteryx installation folder is either `C:\Program Files\Alteryx\` or `C:\Users\\AppData\Local\Alteryx\`.
Copy the connector files from the ProgramData folder into the Alteryx installation folder:
1. Go to the `\Alteryx\Tools\Vantage` folder created by the installer in the previous step.
2. Copy all files from the `\Alteryx\Tools\Vantage\bin` folder into the `bin` folder in the Alteryx installation folder.
3. Copy the file from the `\Alteryx\Tools\Vantage\plugin` folder into the `bin\Plugins` folder in the Alteryx installation folder.
Restart Alteryx Designer to ensure the changes have been applied.
Open your workflow. ABBYY Vantage 3.0 requires [client credentials authentication](/vantage/documentation/tenant-admin/tenant-management/configure-client), so create a new client ID and secret, and then update the **Use Skill** and **Get Result** tools. Set **Authorization** to **Client Credentials**, fill in the **Client ID** and **Client secret** fields, and then save and re-run the workflow to confirm the new configuration works.
## About this release
The ABBYY Vantage Connector for Alteryx provides tools in the Alteryx data analysis studio. Developers can use this connector to add OCR, data extraction, and document classification functionality to Alteryx process analytics.
## New features
| Reference | Description |
| --------- | -------------------------------------------------------------- |
| CONN-2428 | Upload more than one file in a single transaction. |
| CONN-2333 | Support for the OCR skill. |
| CONN-896 | Support for the Process skill. |
| CONN-1584 | Multi-tenant compatibility. |
| CONN-2415 | Support for repeatable non-table fields. |
| CONN-557 | Support for file collection processing, improving performance. |
## Fixes
| Reference | Description |
| --------- | ------------------------------------------------------------- |
| CONN-2921 | Error opening the connector's documentation from the toolbar. |
| CONN-2908 | Credentials not used from individual tools. |
| CONN-2906 | Non-Unicode strings not supported. |
| CONN-1492 | Incorrect rounding of integers. |
| CONN-2389 | Transactions are automatically deleted. |
| VD-338 | TLS 1.3 support. |
## Known issues
| Reference | Description |
| -------------------- | ------------------------------------------------------------------------------------------- |
| CONN-2835 | Authorization fails when the Vantage tenant is configured to use SSO. |
| CONN-2882, CONN-2881 | `Could not find file` in StartTransactionTool when using `;` or `=` in the Files parameter. |
| CONN-2918 | Error when requesting an access token from a tenant with special characters. |
| CONN-2922 | Skill names do not always refresh. |
## Limitations
1. **Backward compatibility with previous connector versions is not supported.** All Alteryx workflows that used old ABBYY Vantage tool versions will break, and Alteryx shows an error instead of the ABBYY Vantage tool. Add new tools to the Alteryx workflow and configure them again. A detailed description of the new input and output parameters is available in this documentation. The connector ships with sample processes that show how to configure all new features.
2. **All rows passed on the tool's input are processed successively, not in parallel.** For example, if several folders are passed on the **Use Skill** input, the **Use Skill** tool launches the transaction for the first folder, and only after that transaction is launched does it launch the second transaction, one by one.
3. **Limitation for the output folder for the Get Result tool.** The absolute folder path must not be longer than 260 characters, including the transaction folder and document folder names created by the **Get Result** tool (36 characters for each).
4. **The timeout cannot be increased.** Each tool has a timeout for processing one row of the input data table. By default, the timeout value is 30 minutes (the average time required to upload the maximum file size allowed by Vantage).
5. **Parse Fields tool limitations:**
* **Parse Fields** does not return any fields if **Values only** JSON is enabled in the Process Skill output settings. Use only the full JSON file as input for **Parse Fields**.
* **Parse Fields** does not return field values if the input JSON is from a Classification Skill. As a workaround, use the embedded Alteryx **Parse JSON** tool to extract classification data or other data from the result JSON.
## Deprecated features
There are no deprecated features.
## Upgrade procedure
To upgrade the ABBYY Vantage Connector for Alteryx to a newer version, perform one of the following actions depending on the installation type:
* Delete the `%APPDATA%\Alteryx\Tools\Vantage` folder if the connector was installed for the current user.
* Delete the `%PROGRAMDATA%\Alteryx\Tools\Vantage` folder if the connector was installed for all users.
After that, install the new version as described in [Install the Alteryx connector](/vantage/connectors/alteryx/install).