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

# サンプルプロセス

> InvoiceWorkflowSample フローをインポートして実行し、Microsoft Power Automate 用 ABBYY Vantage コネクタがどのようにトランザクションを開始し、完了までポーリングして、field の結果を抽出するかを確認します。

コネクタのダウンロードには `InvoiceWorkflowSample.zip` が含まれています。これは、エンドツーエンドの請求書処理シナリオを示すサンプルフローです。ユーザーが請求書をアップロードすると、ABBYY Vantage がその field を抽出し、フローが抽出された請求書番号を収集します。

<Note>
  サンプルをインポートする前に、[コネクタガイド](/ja/vantage/connectors/ms-powerautomate/guide) の手順を完了し、ABBYY Vantage カスタム コネクタをインストールして接続を作成してください。
</Note>

<div id="what-the-sample-demonstrates">
  ## サンプルの概要
</div>

このフローは手動でトリガーされ、アップロードするファイルの指定を求めます。続いて、Vantage のトランザクションにおける一般的なライフサイクルをたどります。

<Steps>
  <Step title="トランザクションを開始する">
    **Starts processing of the files in new transaction** アクションは、どの Skill でドキュメントを処理するかを指定する `skillId` を使用して、アップロードしたファイルを ABBYY Vantage に送信します。
  </Step>

  <Step title="完了までポーリングする">
    **Do until** ループは 10 秒ごとに **Gets transaction info** を呼び出して、トランザクションのステータスを確認します。ステータスが `Processed`、`Failed`、`Canceled` のいずれかになるか、60 回の反復 (最大 1 時間) に達すると、ループは終了します。
  </Step>

  <Step title="結果を処理する">
    **Switch** アクションは、最終的なトランザクションステータスに応じて分岐します。

    * **Failed**: このサンプルでは、この分岐は独自のエラー処理を実装するためのプレースホルダーとして空のままにしています。
    * **Default (成功) **: フローはトランザクションの結果ファイルから `FieldsJson` ファイル型をフィルターし、その後、一致した各項目をループ処理します。
  </Step>

  <Step title="field の値を抽出する">
    各 `FieldsJson` 結果ファイルに対して、フローは **Downloads the result files** を呼び出し、**Parse JSON** アクションで JSON を解析して、**請求書番号** field の値を `invoiceNumberArray` という名前の配列変数に追加します。
  </Step>
</Steps>

このパターン――トランザクションを開始し、完了するまでポーリングし、その後 field の結果をダウンロードして解析する――は、コネクタを使用して構築するほとんどのフローの基本になります。

<div id="import-the-sample">
  ## サンプルをインポートする
</div>

1. [Power Automate](https://make.powerautomate.com) で、左側のナビゲーション ペインから **My flows** を選択します。

2. **Import** の横にある下向き矢印を選択し、**Import Package (Legacy)** を選択します。

3. **Upload** を選択し、`InvoiceWorkflowSample.zip` を選んで **Open** を選択します。

4. パッケージの詳細がロードされたら、関連するリソースを設定します。
   * **Vantage 3 Test** API リソースで、**Import Setup** を **Select during import** に設定し、ABBYY Vantage の カスタム コネクタ を選択します。
   * **ABBYY Vantage** connection リソースで、**Import Setup** を **Select during import** に設定し、ABBYY Vantage connection を選択します。

5. **Save** を選択します。

6. 必須リソースの設定がすべて完了したら、**Import** を選択します。

7. インポートしたフローを開き、有効にします。

<Note>
  このサンプルの **Starts processing of the files in new transaction** アクションは、エクスポート元のテナントの `skillId` を参照しています。実行する前にフローを開いてこのアクションを編集し、ご自身のテナントの Skill を選択してください。
</Note>

<div id="run-the-sample">
  ## サンプルを実行する
</div>

インポートしたフローを開き、**Test** > **Manually** > **Test** を選択して実行します。メッセージが表示されたら、請求書ファイル (PDF または画像) をアップロードします。実行が完了したら、実行履歴で **invoiceNumberArray** 変数を確認し、ドキュメントから抽出された請求書番号を確認します。

<div id="next-steps">
  ## 次のステップ
</div>

Microsoft Power Automate コネクタの[リリースノート](/ja/vantage/connectors/ms-powerautomate/release-notes)を参照してください。