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

# リリースノート

> Microsoft Power Automate 用 ABBYY Vantage Connector のリリースノート

<Update label="2.0" description="リリースノート">
  ## 変更点

  ✓ `public-schema.json` の名前を `schema-vantage-transactions-api.json` に変更し、用途をより明確にしました (Parse JSON アクションで使用) 。

  ✓ `ABBYY-Vantage.swagger.json` の名前を `ABBYY-Vantage-ProcessingAPI.swagger.json` に変更し、Processing API 用であることを明確にしました。

  ✓ 古いフロー例を削除し、更新版の Invoice フロー例を追加しました。

  ✓ PDF ガイドとリリースノートを削除し、この Documentation サイトへ移動しました。

  ✓ コネクタのアイコンとして任意で使用できる `Vantage-Square-icon.png` の Vantage ロゴを追加しました。

  ## 1.3 から 2.0 へのアップグレード

  1. **Custom Connectors** でコネクタを見つけます。**...** メニューをクリックし、**Update from OpenAPI file** を選択します。

  2. Connector Settings で次の更新を行います。

     **General tab:**

     * \[任意] 新たに追加された Vantage アイコンを使用して、コネクタのアイコンをアップロードします。
     * **Host** がご利用の Vantage リージョンと一致していることを確認します。

     **Security tab:**

     * **Client Id** と **Client Secret:** Power Automate では、これらの値を再入力する必要があります。取得するには、Vantage テナントを開いて 公開 API クライアント に移動します。クライアントシークレットがない場合は、新しいものを生成してください。
     * **Authorization URL**、**Token URL**、および **Refresh URL:** これらの値は、Vantage テナント ID を含むように更新することをお勧めします。これにより、Vantage 2.7 から 3.0 以降へ移行する際の接続の問題を減らせます。URL の例: `https://vantage-us.abbyy.com/auth2/c5a3cc2f-853e-43f5-890c-b5ab2024e7b8/connect/authorize`。
     * **Scope:** `openid permissions global.wildcard offline_access` に設定されていることを確認してください。以前の値 `publicapi:all` は、現在は無効です。

  <Note>
    ページ上部の **Update connector** をクリックして変更を保存します。
  </Note>

  3. **Test** タブで、以前の接続を使用するか、**New connection** を選択してアカウントを再認証します。`ListAllAvailableSkills` 操作を選択し、**Test operation** をクリックします。レスポンスに `Status (200)` と表示されれば、設定は完了です。

  4. Power Automate のフローを確認し、正しく機能することをテストします。
</Update>

<Update label="1.3" description="リリースノート">
  ## このリリースについて

  このリリースでは、Vantage Public API のリフレッシュトークンがサポートされ、接続を最大 30 日間維持できるようになりました。

  <Note>
    30 日が経過すると、client は再認証する必要があります。これは既知の制限事項です。
  </Note>

  ## アップグレード手順

  1. Power Automate で **Data > Custom connectors** に移動し、ABBYY Vantage カスタム コネクタを編集します。

  2. コネクタ エディターで **Security** タブに移動し、**Edit** をクリックします。

       <img src="https://mintlify.s3.us-west-1.amazonaws.com/abbyy/images/vantage/developers/connectors/ms-powerautomate/screen_security_edit.png" alt="OAuth 2.0 authentication type の下にある Edit ボタンを示すコネクタ エディターの Security タブ" />

  3. 編集モードに入るとクリアされるフィールドに入力します。
     * **Client ID:** `ABBYY.PowerAutomate`
     * **Client secret:** `Vezu_jgEw8kFi1ugXb66s2buh6ZC1M-Uf9`
     * **Refresh URL:** Token URL と同じ endpoint — `https://<vantage_server_address>/auth2/connect/token`

  4. **Scope** フィールドに `offline_access` を追加し、次のようにします。
     `openid permissions publicapi:all offline_access`

       <img src="https://mintlify.s3.us-west-1.amazonaws.com/abbyy/images/vantage/developers/connectors/ms-powerautomate/screen_security_oauthsettings.png" alt="Client ID、Client secret、Authorization URL、Token URL、Refresh URL、Scope の各フィールドが入力された OAuth 2.0 security settings" />

  5. **Update connector** をクリックします。

       <img src="https://mintlify.s3.us-west-1.amazonaws.com/abbyy/images/vantage/developers/connectors/ms-powerautomate/screen_security_updateconnector.png" alt="Update connector ボタンが強調表示されたコネクタ エディターのツールバー" />

  6. **Data > Connections** に移動し、切断された接続に対して **Fix connection** をクリックします。

       <img src="https://mintlify.s3.us-west-1.amazonaws.com/abbyy/images/vantage/developers/connectors/ms-powerautomate/screen_connections_fixconnection.png" alt="Fix connection リンクが表示された ABBYY Vantage 接続の Connections 一覧" />

     または、接続のコンテキストメニューから **Switch account** をクリックし、再度ログインします。

       <img src="https://mintlify.s3.us-west-1.amazonaws.com/abbyy/images/vantage/developers/connectors/ms-powerautomate/screen_connections_switchaccount.png" alt="Switch account オプションを示す Connections のコンテキストメニュー" />

  これらの手順を完了すると、トークンの有効期限切れが原因でフローが失敗することはなくなります。

  ## バグ修正

  ✓ Power Automate Connector が 24 時間後にサインアウトする問題を修正しました。(CONN-3066)

  ## 既知の問題

  * CONN-2402: Swagger description に追加の Vantage API メソッドを追加する。
  * CONN-2691: Power Automate flow で documents をアップロードするときに「画像ファイル形式が認識されていません」エラーが発生する (特定の test flow) 。
  * CONN-3058: connector sample flow を拡張し、より多くの Vantage API の使用シナリオを含める。
  * CONN-3090: リフレッシュトークンを使用していても、認証トークンは 30 日後に期限切れになる。
</Update>