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

# Alteryx コネクタのリリースノート

> ABBYY Vantage Connector for Alteryx のバージョン履歴、新機能、バグ修正、既知の問題、および制限事項。

このページでは、ABBYY Vantage Connector for Alteryx の各リリースにおける新機能、変更点、既知の問題を、最新バージョンから順に掲載しています。

<Update label="3.0.5" description="2026">
  <div id="about-this-release">
    ## このリリースについて
  </div>

  このリリースでは、Alteryx Designer 2024.2 以降との互換性を回復しました。これらのバージョンには、コネクタがこれまでバンドルしていた Newtonsoft.Json (v12) よりも新しい v13 が同梱されています。また、ABBYY Vantage 3.0 で必要となる[クライアント資格情報による認証](/ja/vantage/developer/authentication/client-credentials)にも対応しました。

  <div id="compatibility-updates">
    ## 互換性に関する更新
  </div>

  * **Alteryx Designer 2024.2 以降** – Alteryx が同梱するバージョンに合わせて、コネクタの Newtonsoft.Json 依存関係を v12 から v13 に更新しました。コネクタは Alteryx のホストプロセスが提供するバージョンに依存せず、独自の `Newtonsoft.Json.dll` をバンドルするようになり、Alteryx 2024.2 以降の起動時に `System.IO.FileLoadException` を引き起こしていたアセンブリバージョンの不一致が解消されました。
  * **ABBYY Vantage 3.0** – ABBYY Vantage 3.0 に対応するため、Vantage Public API クライアント (`Abbyy.Integration.Vantage.Shared.PublicApi`) を更新しました。`Abbyy.Integration.JsonExport.Contract` 依存関係も、更新後の依存バージョンに合わせて再ビルドしています。
  * **.NET Framework 4.8** – 必要な .NET Framework の最小バージョンを 4.7.2 から 4.8 に更新しました。

  <div id="upgrade-procedure">
    ## アップグレード手順
  </div>

  <Steps>
    <Step title="セットアップファイルを実行する">
      `ABBYYVantageConnectorForAlteryx.3.0.5.x64.3.0.5.exe` を実行します。
    </Step>

    <Step title="カスタムツールパッケージを実行する">
      インストールが完了したら、`C:\Program Files\ABBYY Vantage Connector for Alteryx` を開き、`Abbyy.Alteryx.Vantage.Connector.yxi` をダブルクリックします。
    </Step>

    <Step title="新しいバージョンをインストールする">
      Alteryx Designer 内でツールのインストーラーが読み込まれます。**Install** をクリックして新しいバージョンのインストールを完了します。インストーラーは、コネクタのファイルを `<ProgramDataFolder>\Alteryx\Tools\Vantage` フォルダーにコピーします。`ProgramDataFolder` は、Alteryx のプログラムデータファイルが格納されているフォルダーです。インストールの種類に応じて、次のいずれかになります。

      * `%APPDATA%\Alteryx\Tools\Vantage` – 現在のユーザーのみを対象にコネクタをインストールする場合
      * `%PROGRAMDATA%\Alteryx\Tools\Vantage` – すべてのユーザーを対象にコネクタをインストールする場合
    </Step>

    <Step title="コネクタのファイルを Alteryx にコピーする">
      <Info>
        インストールの種類に応じて、既定の Alteryx インストールフォルダーは `C:\Program Files\Alteryx\` または `C:\Users\<UserName>\AppData\Local\Alteryx\` のいずれかになります。
      </Info>

      コネクタのファイルを ProgramData フォルダーから Alteryx のインストールフォルダーにコピーします。

      1. 前の手順でインストーラーが作成した `<ProgramDataFolder>\Alteryx\Tools\Vantage` フォルダーに移動します。
      2. `<ProgramDataFolder>\Alteryx\Tools\Vantage\bin` フォルダー内のすべてのファイルを、Alteryx インストールフォルダー内の `bin` フォルダーにコピーします。
      3. `<ProgramDataFolder>\Alteryx\Tools\Vantage\plugin` フォルダー内のファイルを、Alteryx インストールフォルダー内の `bin\Plugins` フォルダーにコピーします。
    </Step>

    <Step title="Alteryx Designer を再起動する">
      変更を反映させるため、Alteryx Designer を再起動します。
    </Step>

    <Step title="クライアント資格情報による認証に切り替える">
      ワークフローを開きます。ABBYY Vantage 3.0 では[クライアント資格情報による認証](/ja/vantage/documentation/tenant-admin/tenant-management/configure-client)が必要なため、新しい Client ID とクライアントシークレットを作成し、**Use Skill** ツールと **Get Result** ツールを更新します。**Authorization** を **Client Credentials** に設定し、**Client ID** と **Client secret** フィールドを入力したうえで、ワークフローを保存して再実行し、新しい設定が正しく動作することを確認します。
    </Step>
  </Steps>
</Update>

<Update label="2.0" description="December 2022">
  <div id="about-this-release-2">
    ## このリリースについて
  </div>

  ABBYY Vantage Connector for Alteryx は、Alteryx のデータ分析スタジオ上でツールを提供します。開発者はこのコネクタを使用して、Alteryx のプロセス分析に Optical Character Recognition (OCR)、データ抽出、ドキュメント分類の機能を追加できます。

  <div id="new-features">
    ## 新機能
  </div>

  | Reference | Description                      |
  | --------- | -------------------------------- |
  | CONN-2428 | 1 つのトランザクションで複数のファイルをアップロードできます。 |
  | CONN-2333 | OCR skill のサポート。                 |
  | CONN-896  | Process skill のサポート。             |
  | CONN-1584 | マルチテナント対応。                       |
  | CONN-2415 | 繰り返し可能な非テーブル field のサポート。        |
  | CONN-557  | ファイルコレクション処理のサポートによるパフォーマンス向上。   |

  <div id="fixes">
    ## 修正
  </div>

  | Reference | Description                                 |
  | --------- | ------------------------------------------- |
  | CONN-2921 | ツールバーからコネクタの Documentation を開く際にエラーが発生する問題。 |
  | CONN-2908 | 個々のツールから credentials が使用されない問題。             |
  | CONN-2906 | 非 Unicode 文字列がサポートされない問題。                   |
  | CONN-1492 | 整数の丸め処理が正しくない問題。                            |
  | CONN-2389 | トランザクションが自動的に削除される問題。                       |
  | VD-338    | TLS 1.3 のサポート。                              |

  <div id="known-issues">
    ## 既知の問題
  </div>

  | Reference            | Description                                                                               |
  | -------------------- | ----------------------------------------------------------------------------------------- |
  | CONN-2835            | Vantage テナントが SSO を使用するように構成されている場合、認可が失敗します。                                             |
  | CONN-2882, CONN-2881 | Files parameter に `;` または `=` を使用すると、StartTransactionTool で `Could not find file` が発生します。 |
  | CONN-2918            | 特殊文字を含む tenant から access token を要求するとエラーが発生します。                                           |
  | CONN-2922            | Skill 名が常に更新されるとは限りません。                                                                   |

  <div id="limitations">
    ## 制限事項
  </div>

  1. **以前のコネクタバージョンとの下位互換性はサポートされません。** 旧バージョンの ABBYY Vantage ツールを使用していた Alteryx ワークフロー はすべて動作しなくなり、Alteryx では ABBYY Vantage ツールの代わりにエラーが表示されます。Alteryx ワークフロー に新しいツールを追加し、改めて構成してください。新しい入力パラメーターおよび出力パラメーターの詳細は、この Documentation に記載されています。コネクタには、すべての新機能の構成方法を示す sample process が同梱されています。

  2. **ツールの入力に渡されたすべての row は、並列ではなく順次処理されます。** 例えば、**Use Skill** の入力に複数のフォルダーが渡された場合、**Use Skill** ツールはまず最初のフォルダーのトランザクションを開始し、そのトランザクションが開始された後に 2 番目のトランザクションを開始する、というように 1 つずつ処理します。

  3. **Get Result ツールの出力フォルダーに関する制限。** 絶対フォルダーパスは、**Get Result** ツールが作成するトランザクションフォルダー名およびドキュメントフォルダー名 (それぞれ 36 文字) を含めて、260 文字を超えてはなりません。

  4. **タイムアウトは延長できません。** 各ツールには、入力データテーブルの 1 row を処理するためのタイムアウトがあります。既定のタイムアウト値は 30 分です (Vantage で許可される最大ファイルサイズのアップロードに必要な平均時間) 。

  5. **Parse Fields ツールの制限事項:**
     * Process Skill の出力設定で **Values only** JSON が有効になっている場合、**Parse Fields** は fields を返しません。**Parse Fields** の入力には、完全な JSON ファイルのみを使用してください。
     * 入力 JSON が Classification Skill から出力されたものである場合、**Parse Fields** は field values を返しません。回避策として、Alteryx に組み込まれている **Parse JSON** ツールを使用して、結果 JSON から分類データやその他のデータを抽出してください。

  <div id="deprecated-features">
    ## 廃止された機能
  </div>

  廃止された機能はありません。

  <div id="upgrade-procedure-2">
    ## アップグレード手順
  </div>

  ABBYY Vantage Connector for Alteryx を新しいバージョンにアップグレードするには、インストールの種類に応じて次のいずれかの操作を実行します。

  * コネクタを現在のユーザー向けにインストールした場合は、`%APPDATA%\Alteryx\Tools\Vantage` フォルダーを削除します。
  * コネクタをすべてのユーザー向けにインストールした場合は、`%PROGRAMDATA%\Alteryx\Tools\Vantage` フォルダーを削除します。

  その後、[Install the Alteryx connector](/ja/vantage/connectors/alteryx/install) の説明に従って新しいバージョンをインストールします。
</Update>