メインコンテンツへスキップ
​
2.0
リリースノート

​
変更点

✓ 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 は、現在は無効です。
ページ上部の Update connector をクリックして変更を保存します。
  1. Test タブで、以前の接続を使用するか、New connection を選択してアカウントを再認証します。ListAllAvailableSkills 操作を選択し、Test operation をクリックします。レスポンスに Status (200) と表示されれば、設定は完了です。
  2. Power Automate のフローを確認し、正しく機能することをテストします。
​
1.3
リリースノート

​
このリリースについて

このリリースでは、Vantage Public API のリフレッシュトークンがサポートされ、接続を最大 30 日間維持できるようになりました。
30 日が経過すると、client は再認証する必要があります。これは既知の制限事項です。

​
アップグレード手順

  1. Power Automate で Data > Custom connectors に移動し、ABBYY Vantage カスタム コネクタを編集します。
  2. コネクタ エディターで Security タブに移動し、Edit をクリックします。 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 Client ID、Client secret、Authorization URL、Token URL、Refresh URL、Scope の各フィールドが入力された OAuth 2.0 security settings
  5. Update connector をクリックします。 Update connector ボタンが強調表示されたコネクタ エディターのツールバー
  6. Data > Connections に移動し、切断された接続に対して Fix connection をクリックします。 Fix connection リンクが表示された ABBYY Vantage 接続の Connections 一覧 または、接続のコンテキストメニューから Switch account をクリックし、再度ログインします。 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 日後に期限切れになる。