リリースノート
変更点
public-schema.jsonは用途を明確にするため、schema-vantage-transactions-api.jsonに名前を変更しました (Parse JSON アクションで使用) 。ABBYY-Vantage.swagger.jsonは Processing API 用であることを明確にするため、ABBYY-Vantage-ProcessingAPI.swagger.jsonに名前を変更しました。- 古いフロー例を削除し、更新版の Invoice フロー例を追加しました。
- PDF ガイドとリリースノートを削除し、この Documentation サイトに移動しました。
- コネクタ アイコンとして任意で使用できる
Vantage-Square-icon.pngの Vantage ロゴを追加しました。
1.3 から 2.0 へのアップグレード
1
OpenAPI ファイルから更新する
Custom Connectors でコネクタを探します。… メニューをクリックし、Update from OpenAPI file を選択します。
2
コネクタ設定を更新する
コネクタ設定で次の更新を行います。General タブ:
- 新たに追加された Vantage アイコンを使用して、コネクタ アイコンをアップロードします (任意) 。
- Host が使用している Vantage region と一致していることを確認します。
- 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は現在は無効です。
3
接続をテストする
Test タブで、以前の接続を使用するか、New connection を選択してアカウントを再認証します。
ListAllAvailableSkills 操作を選択し、Test operation をクリックします。レスポンスに Status (200) と表示されれば、設定は完了です。4
フローを確認する
Power Automate のフローを確認してテストし、正しく機能することを確認します。
リリースノート
このリリースについて
このリリースでは、Vantage Public API のリフレッシュトークンがサポートされ、接続を最大 30 日間維持できるようになりました。30 日が経過すると、client は再認証する必要があります。これは既知の制限事項です。
アップグレード手順
1
カスタム コネクタを編集する
Power Automate で Data > Custom connectors に移動し、ABBYY Vantage カスタム コネクタを編集します。
2
Security タブを開く
コネクタ エディターで Security タブに移動し、Edit をクリックします。
3
クリアされたフィールドを再入力する
編集モードに入るとクリアされるフィールドに入力します。
- Client ID:
DAFadfakljaf... - Client secret:
Vezu_jgEw8kFi1u.... - Refresh URL: Token URL と同じ endpoint、
https://<vantage_server_address>/auth2/connect/token
4
Scope を更新する
Scope フィールドに
offline_access を追加し、次のようにします。openid permissions publicapi:all offline_access5
コネクタを更新する
Update connector をクリックします。
6
接続を修復する
Data > Connections に移動し、切断された接続に対して Fix connection をクリックします。または、接続のコンテキストメニューから Switch account をクリックし、再度ログインします。
バグ修正
- Power Automate Connector が 24 時間後にサインアウトする問題を修正しました。(CONN-3066)
既知の問題
- CONN-2402: Swagger description に追加の Vantage API メソッドを追加する。
- CONN-2691: Power Automate フロー で documents をアップロードするときに「画像ファイル形式が認識されていません」エラーが発生する (特定の test フロー) 。
- CONN-3058: connector sample フロー を拡張し、より多くの Vantage API の使用シナリオを含める。
- CONN-3090: リフレッシュトークンを使用していても、認証トークンは 30 日後に期限切れになる。
