Document intelligence Logic Apps ワークフローを作成する
このコンテンツの適用対象: v2.1 | 最新バージョン: v4.0 (プレビュー)
重要
このチュートリアルとロジック アプリの Document intelligence コネクタは、Document intelligence REST API v3.0 以降を対象としています。
重要
このチュートリアルとロジック アプリの Document intelligence コネクタは、Document intelligence REST API v2.1 を対象としており、FOTT サンプル ラベル付けツールと共に使用する必要があります。
Azure Logic Apps は、コードを 1 行も記述せずにワークフローを自動化するために使用できるクラウドベースのプラットフォームです。 このプラットフォームを使用すると、Microsoft およびお使いのアプリケーションを、アプリ、データ、サービス、システムに簡単に統合できます。 ロジック アプリは、ワークフローを開発するときに作成する Azure リソースです。 ロジック アプリでできることの例をいくつか以下に示します。
- ビジネス プロセスとワークフローを視覚的に作成する。
- ワークフローをサービスとしてのソフトウェア (SaaS) およびエンタープライズ アプリケーションと統合する。
- エンタープライズ アプリケーション統合 (EAI)、企業間 (B2B)、および電子データ交換 (EDI) タスクを自動化する。
詳細については、Logic Apps の概要に関するページを参照してください。
このチュートリアルでは、ロジック アプリ コネクター フローを構築して、以下のタスクを自動化する方法について学習します。
- OneDrive フォルダーに請求書が追加されたタイミングを検出する。
- Document Intelligence の事前構築済み請求書モデルを使用して、請求書を処理する。
- 請求書から抽出された情報を、事前に指定された電子メール アドレスに送信する。
Microsoft OneDrive アカウントまたは Microsoft ShareDrive サイトのファイルを使用するワークフローを選択します。
前提条件
このチュートリアルを完了するには、以下のリソースが必要です。
Azure サブスクリプション。 無料の Azure サブスクリプションを作成することができます。
無料の OneDrive または OneDrive for Business クラウド ストレージ アカウント。
Note
- OneDrive は個人用ストレージ向けです。
- OneDrive for Business は Office 365 の一部であり、組織向けに設計されています。 すべての作業ファイルを格納、共有、および同期できるクラウド ストレージが提供されます。
無料の Outlook オンラインまたは Office 365 電子メールアカウント**。
ロジック アプリをテストするためのサンプルの請求書。 このチュートリアルでは、サンプルの請求書ドキュメントをダウンロードして使用できます。
Document Intelligence リソース。 Azure サブスクリプションを入手したら、Azure portal で Document Intelligence リソースを作成して、キーとエンドポイントを取得します。 既存の Document Intelligence リソースがある場合は、そのリソース ページに直接移動します。 Free 価格レベル (F0) を使用してサービスを試用し、後から運用環境用の有料レベルにアップグレードすることができます。
リソースがデプロイされた後、[リソースに移動] を選択します。 Azure portal のリソースからキーとエンドポイントの値をコピーし、Microsoft メモ帳などの便利な場所に貼り付けます。 アプリケーションを Document Intelligence API に接続するためのキーとエンドポイントの値が必要です。 詳細については、「Document Intelligence リソースを作成する」を参照してください。
OneDrive フォルダーを作成する
ロジック アプリの作成に進む前に、OneDrive フォルダーを設定する必要があります。
OneDrive または OneDrive for Business のホーム ページにサインインします。
左上隅のサイドバーにある [➕ 新規追加] ボタンを選択し、[フォルダー] を選択します。
新しいフォルダーの名前を入力し、[作成] を選択します。
ファイルに新しいフォルダーが表示されます。
これで、OneDrive での作業は完了です。
ロジック アプリ リソースを作成する
この時点で、Document Intelligence リソースと OneDrive フォルダーはすべて設定されているはずです。 次は、ロジック アプリ リソースを作成します。
Azure Portal に移動します。
Azure ホーム ページから [➕ リソースの作成] を選択します。
検索バーからロジック アプリを検索して選択します。
[作成] ボタンを選択します
次は、[ロジック アプリの作成] フィールドに以下の値を入力します。
- [サブスクリプション]。 現在のサブスクリプションを選択します。
- リソース グループ。 ご利用のリソースを含む Azure リソース グループ。 Document Intelligence リソースに対して使用しているものと同じリソース グループを選びます。
- [種類] 。 [従量課金プラン] を選択します。 従量課金プランという種類のリソースは、グローバルなマルチテナント Azure Logic Apps で実行され、従量課金モデルが使用されます。
- [ロジック アプリ名]。 リソースの名前を入力します。 わかりやすい名前 (YourNameLogicApp など) を使用することをお勧します。
- 発行。 [ワークフロー] を選択します。
- [リージョン]。 ローカル リージョンを選択します。
- Log Analytics を有効にする。 このプロジェクトでは、[いいえ] を選択します。
- プランの種類。 [従量課金プラン] を選択します。 従量課金プランという種類のリソースは、グローバルなマルチテナント Azure Logic Apps で実行され、従量課金モデルが使用されます。
- ゾーン冗長性。 [無効] を選択します。
完了すると、以下の画像のようになります ([リソース グループ]、[ロジック アプリ名]、および [リージョン] は異なる場合があります)。 これらの値を確認した後、左下隅にある [確認と作成] を選択します。
短い検証チェックが実行されます。 それが正常に完了した後、左下隅にある [作成] を選択します。
次に、デプロイが進行中であることを示す画面にリダイレクトされます。 Azure がデプロイされるまで少し時間を置きます。これには数分かかる場合があります。 デプロイが完了した後に、デプロイが完了したことを示すバナーが表示されます。 この画面に達したら、[リソースに移動] を選択します。
最後に、[Logic Apps デザイナー] ページにリダイレクトされます。 ホーム画面に使用できる Logic Apps の概要の短いビデオがあります。 ロジック アプリの設計を開始する準備ができたら、[テンプレート] セクションで、[空のロジック アプリ] ボタンを選択します。
次の画像に似た画面が表示されます。 これで、ロジック アプリの設計と実装を開始する準備ができました。
自動化フローを作成する
これでロジック アプリ コネクター リソースの設定と構成が完了したので、自動化フローを作成してテストしてみましょう。
検索バーで OneDrive または OneDrive for Business を検索して選択します。 そして [ファイルが作成されたとき] トリガーを選択します。
次に、ポップアップ ウィンドウが表示され、OneDrive アカウントにログインするように求められます。 [サインイン] を選択し、プロンプトに従ってアカウントを接続します。
ヒント
Office 365 アカウントを使用して OneDrive コネクタにサインインしようとすると、申し訳ありません。@MICROSOFT.COM アカウントでサインインできません のようなエラーが表示される場合があります。
- このエラーは、OneDrive が、Office 365 アカウントではなく Outlook.com または Microsoft Live アカウントを使用してアクセスできる、個人用のクラウドベースのストレージであるために発生します。
- Office 365 アカウントを使用する場合は、OneDrive for Business コネクタを使用できます。 OneDrive for Business アカウントにこのプロジェクトの OneDrive フォルダーが作成されていることを確認してください。
アカウントが接続された後、OneDrive アカウントまたは OneDrive for Business アカウントで先ほど作成したフォルダーを選択します。 その他の既定値はそのままにしておきます。
次は、新しいステップをワークフローに追加します。 新しく作成された OneDrive ノードの下にある [➕ 新規ステップ] ボタンを選択します。
ロジック アプリのデザイナー ビューに新しいノードを追加する必要があります。 [操作を選択してください] 検索バーで、Form Recognizer (Document Intelligence に名称変更予定) を検索し、一覧から [事前構築済みモデルまたはカスタム モデルのドキュメントを分析する (v3.0 API)] を選択します。
すると、接続作成のウィンドウが表示されます。 具体的には、Document Intelligence リソースを Logic Apps Designer Studio に接続します。
[接続名] を入力します。 覚えやすいものにする必要があります。
以前にコピーした Document Intelligence リソースの [エンドポイント URL] と [アカウント キー] を入力します。 前にこのステップをスキップした場合、または文字列を紛失した場合は、Document Intelligence リソースに戻り、再度コピーできます。 完了したら [作成] を選択します。
Note
すでに資格情報を使用してログインしている場合は、前の手順はスキップされます。
次に、[事前構築済みモデルまたはカスタム モデルのドキュメントを分析する (v3.0 API)] コネクタの選択パラメーターのウィンドウが表示されます。
フィールドに次のように入力します。
モデル識別子。 呼び出すモデルを指定します。この場合は、事前構築済みの請求書モデルを呼び出すので、事前構築済みの請求書を入力します。
ドキュメント/画像ファイルの内容。 このフィールドを選択します。 動的コンテンツのポップアップが表示されます。 そうでない場合は、フィールドの下にある [動的コンテンツの追加] ボタンを選択し、[ファイル コンテンツ] を選択します。 このステップでは、基本的には分析対象のファイルを Document Intelligence の事前構築済み請求書モデルに送信します。 [ドキュメント/イメージ ファイルのコンテンツ] フィールドに [ファイル コンテンツ] バッジが表示されたら、この手順を正しく完了しています。
ドキュメント/画像 URL。 OneDrive フォルダーから直接ファイル コンテンツを参照しているため、このプロジェクトではこのフィールドをスキップします。
新しいパラメーターの追加。 このプロジェクトでは、このフィールドをスキップします。
さらにいくつか手順を追加する必要があります。 もう一度、[➕ 新しいステップ] ボタンを選択して、別のアクションを追加します。
[操作を選択してください] 検索バーに、「コントロール」と入力し、[コントロール] タイルを選択します。
下にスクロールし、[コントロール] の一覧から [For Each コントロール] のタイルを選択します。
[For each] ステップのウィンドウには、[前のステップの出力を選択する] というラベルの付いたフィールドがあります。 このフィールドを選択します。 動的コンテンツのポップアップが表示されます。 そうでない場合は、フィールドの下にある [動的コンテンツの追加] ボタンを選択し、[ドキュメント] を選択します。
次に、[For each] ステップのウィンドウ内から [Add an Action](アクションの追加) を選択します。
[操作を選択してください] 検索バーに「Outlook」と入力し、[Outlook.com] (個人用) または [Office 365 Outlook] (職場用) を選択します。
アクション一覧で、[電子メールの送信 (V2)] が表示されるまで下へスクロールして、このアクションを選択します。
OneDrive と同様に、Outlook または Office 365 Outlook アカウントにサインインするように求められます。 サインインすると、Document Intelligence が請求書から抽出する動的コンテンツを含む電子メールを書式設定するウィンドウが表示されます。
一部のフィールドは、次の式を使用して入力します。
items('For_each')?['fields']?['FIELD-NAME']?['content']
特定のフィールドにアクセスするには、[動的コンテンツの追加] ボタンを選択し、[式] タブを選択します。
[ƒx] ボックスに、上記の数式をコピーして貼り付け、FIELD-NAME を抽出するフィールドの名前に置き換えます。 使用可能なフィールドの完一覧については、特定の API の概念ページを参照してください。 この場合は、 事前構築済みの請求書モデルのフィールド抽出値を使用します。
もう少しで完了です。 次のフィールドに対して以下の変更を行います。
宛先。 個人または会社の電子メール アドレス、あるいはアクセス権のあるその他の電子メール アドレスを入力します。
件名。 「請求書送信元:」と入力し、次の式を追加します。
items('For_each')?['fields']?['VendorName']?['content']
本文。 請求書に関する特定の情報を追加します。
- 「請求書 ID:」と入力し、前と同じメソッドを使用して、次の式を追加します。
items('For_each')?['fields']?['InvoiceId']?['content']
- 新しい行に「請求書期限:」と入力し、次の式を追加します。
items('For_each')?['fields']?['DueDate']?['content']
- 「請求額:」と入力し、次の式を追加します。
items('For_each')?['fields']?['AmountDue']?['content']
- 最後に、請求額は重要な数値なので、電子メールでこの抽出の信頼スコアを送信することもできます。 そのためには、「請求額 (信頼度):」と入力し、次の式を追加します。
items('For_each')?['fields']?['AmountDue']?['confidence']
完了すると、ウィンドウは次の図のようになります。
左上隅にある [保存] を選択します。
注意
- 現在のバージョンでは、PDF ごとに 1 つの請求書のみが返されます。
- 今後 PDF から複数の請求書を返すことが可能な出力形式にするには、電子メール送信アクションの周りに "For each ループ" が必要です。
次は、新しいステップをワークフローに追加します。 新しく作成された OneDrive ノードの下にある [➕ 新規ステップ] ボタンを選択します。
ロジック アプリのデザイナー ビューに新しいノードを追加する必要があります。 [操作を選択してください] 検索バーで、 "Form Recognizer (Document Intelligence に名称変更予定)" を検索し、一覧から [請求書を分析する] を選択します。
接続を作成できるウィンドウが表示されます。 具体的には、Form Recognizer リソースを Logic Apps Designer Studio に接続します。
- [接続名] を入力します。 覚えやすいものにする必要があります。
- 以前にコピーした Form Recognizer リソースの [エンドポイント URL] と [アカウント キー] を入力します。 前にこの手順をスキップした場合、または文字列を紛失した場合は、Form Recognizer リソースに戻り、再度コピーできます。 完了したら [作成] を選択します。
Note
すでに資格情報を使用してログインしている場合は、前の手順はスキップされます。 続けて、[請求書の分析] パラメーターを完了します。
次に、[請求書を分析する] コネクタの選択パラメーターのウィンドウが表示されます。
フィールドに次のように入力します。
- ドキュメント/画像ファイルの内容。 このフィールドを選択します。 動的コンテンツのポップアップが表示されます。 そうでない場合は、フィールドの下にある [動的コンテンツの追加] ボタンを選択し、[ファイル コンテンツ] を選択します。 このステップでは、基本的には分析対象のファイルを Document Intelligence の事前構築済み請求書モデルに送信します。 [ドキュメント/イメージ ファイルのコンテンツ] フィールドに [ファイル コンテンツ] バッジが表示されたら、この手順を正しく完了しています。
- ドキュメント/画像 URL。 OneDrive フォルダーから直接ファイル コンテンツを参照しているため、このプロジェクトではこのフィールドをスキップします。
- テキスト詳細情報の追加。 [はい] を選択します。
- 新しいパラメーターの追加。 このプロジェクトでは、このフィールドをスキップします。
最後のステップを追加する必要があります。 もう一度、[➕ 新しいステップ] ボタンを選択して、別のアクションを追加します。
[操作を選択してください] 検索バーに「Outlook」と入力し、[Outlook.com] (個人用) または [Office 365 Outlook] (職場用) を選択します。
アクション一覧で、[電子メールの送信 (V2)] が表示されるまで下へスクロールして、このアクションを選択します。
Outlook または Office 365 Outlook アカウントにサインインします。 これを実行すると、請求書から抽出された動的コンテンツを使用して送信される電子メールを書式設定するウィンドウが表示されます。
もう少しで完了です。 フィールドに次のエントリを入力します。
宛先。 個人または会社の電子メール アドレス、あるいはアクセス権のあるその他の電子メール アドレスを入力します。
件名。 [Invoice received from:](次から受信した請求書:) を入力してから、動的なコンテンツの [Vendor name field Vendor name](ベンダー名フィールドのベンダー名) を追加します。
本文。 請求書に関する特定の情報を追加します。
[請求書 ID:] を入力し、[Invoice ID field Invoice ID](請求書 ID フィールドの請求書 ID) を追加します。
新しい行で、[請求書の期限:] を入力し、動的コンテンツの [Invoice date field invoice date (date)](請求日フィールドの請求日 (日付)) を追加します。
[請求額:] を入力し、動的コンテンツの [Amount due field Amount due (number)](請求額フィールドの請求額 (数値)) を追加します。
最後に、請求額は重要な数値なので、電子メールでこの抽出の信頼スコアを送信することもできます。 これを行うには、[Amount due (confidence):](請求額 (信頼度):) を入力し、動的コンテンツの [Amount due field confidence of amount due](請求額フィールドの請求額の信頼度) を追加します。 完了すると、ウィンドウは次の画像のようになります。
ヒント
動的コンテンツ表示が自動的に表示されない場合は、[動的コンテンツの検索] バーを使用してフィールド エントリを検索します。
左上隅にある [保存] を選択します。
注意
- 現在のバージョンでは、PDF ごとに 1 つの請求書のみが返されます。
- 電子メール送信アクションの周りに "For each ループ" を配置すると、今後 PDF から複数の請求書を返すことが可能な出力形式になります。
前提条件
このチュートリアルを完了するには、以下のリソースが必要です。
Azure サブスクリプション。 無料の Azure サブスクリプションを作成することができます。
SharePoint サイトにアクセスします。
無料の Outlook オンラインまたは Office 365 電子メール アカウント。
ロジック アプリをテストするためのサンプルの請求書。 このチュートリアルでは、サンプルの請求書ドキュメントをダウンロードして使用できます。
Document Intelligence リソース。 Azure サブスクリプションを入手したら、Azure portal で Document Intelligence リソースを作成して、キーとエンドポイントを取得します。 既存の Document Intelligence リソースがある場合は、そのリソース ページに直接移動します。 Free 価格レベル (F0) を使用してサービスを試用し、後から運用環境用の有料レベルにアップグレードすることができます。
リソースがデプロイされた後、[リソースに移動] を選択します。 Azure portal のリソースからキーとエンドポイントの値をコピーし、Microsoft メモ帳などの便利な場所に貼り付けます。 アプリケーションを Document Intelligence API に接続するためのキーとエンドポイントの値が必要です。 詳細については、「Document Intelligence リソースを作成する」を参照してください。
SharePoint フォルダーの作成
ロジック アプリの作成に進む前に、SharePoint フォルダーを設定する必要があります。
SharePoint サイトのホーム ページにサインインします。
[ドキュメント] を選択し、サイト ウィンドウの左上隅近くにある [➕ 新規] ボタンをクリックして、 [フォルダー] を選択します。
新しいフォルダーの名前を入力し、[作成] を選択します。
新しいフォルダーはサイト ライブラリにあります。
これで SharePoint の使用は完了です。
ロジック アプリ リソースを作成する
この時点で、Document Intelligence リソースと SharePoint フォルダーはすべて設定されているはずです。 次は、ロジック アプリ リソースを作成します。
Azure Portal に移動します。
Azure ホーム ページから [➕ リソースの作成] を選択します。
検索バーからロジック アプリを検索して選択します。
[作成] ボタンを選択します
次に、次の値を使用して [ロジック アプリの作成] フィールドに入力します。
- [サブスクリプション]。 現在のサブスクリプションを選択します。
- リソース グループ。 ご利用のリソースを含む Azure リソース グループ。 Document Intelligence リソースに対して使用しているものと同じリソース グループを選びます。
- [種類] 。 [従量課金プラン] を選択します。 従量課金プランという種類のリソースは、グローバルなマルチテナント Azure Logic Apps で実行され、従量課金モデルが使用されます。
- [ロジック アプリ名]。 リソースの名前を入力します。 わかりやすい名前 (YourNameLogicApp など) を使用することをお勧します。
- 発行。 [ワークフロー] を選択します。
- [リージョン]。 ローカル リージョンを選択します。
- Log Analytics を有効にする。 このプロジェクトでは、[いいえ] を選択します。
- プランの種類。 [従量課金プラン] を選択します。 従量課金プランという種類のリソースは、グローバルなマルチテナント Azure Logic Apps で実行され、従量課金モデルが使用されます。
- ゾーン冗長性。 [無効] を選択します。
完了すると、以下の画像のようになります ([リソース グループ]、[ロジック アプリ名]、および [リージョン] は異なる場合があります)。 これらの値を確認した後、左下隅にある [確認と作成] を選択します。
短い検証チェックが実行されます。 それが正常に完了した後、左下隅にある [作成] を選択します。
次に、デプロイが進行中であることを示す画面にリダイレクトされます。 Azure がデプロイされるまで少し時間を置きます。これには数分かかる場合があります。 デプロイが完了した後に、デプロイが完了したことを示すバナーが表示されます。 この画面に達したら、[リソースに移動] を選択します。
最後に、[Logic Apps デザイナー] ページにリダイレクトされます。 ホーム画面に使用できる Logic Apps の概要の短いビデオがあります。 ロジック アプリの設計を開始する準備ができたら、[テンプレート] セクションで、[空のロジック アプリ] ボタンを選択します。
次の画像に似た画面が表示されます。 これで、ロジック アプリの設計と実装を開始する準備ができました。
検索バーから SharePoint を検索して選択します。 そして [ファイルが作成されたとき (プロパティのみ)] トリガーを選択します。
Logic Apps によって、SharePoint アカウントに自動的にサインインされます。
アカウントが接続されたら、[サイト アドレス] フィールドと [ライブラリ名] フィールドに値を入力します。 [新しいパラメーターの追加] フィールドを選択し、 [フォルダー] を選択します。
先ほど作成したフォルダーを含むディレクトリ パスを選択します。
ヒント
一覧表示された各フォルダーの末尾にある矢印を選択して、パス内の次のフォルダーに移動します。
次は、別のステップをワークフローに追加します。 新しく作成された SharePoint ノードの下にある [➕ 新規ステップ] ボタンを選択します。
もう一度、検索バーから SharePoint を検索して選択します。 次に、[ファイルのコンテンツの取得] アクションを選択します。
フィールドに次のように入力します。
- サイトのアドレス。 SharePoint サイトを選択します。
- ファイル識別子。 このフィールドを選択します。 動的コンテンツのポップアップが表示されます。 そうでない場合は、フィールドの下にある [動的コンテンツの追加] ボタンを選択し、[識別子] を選択します。
- 内容の種類を推測します。 [はい] を選択します。
別の新しいステップをワークフローに追加します。 新しく作成された SharePoint ノードの下にある [➕ 新規ステップ] ボタンを選択します。
ロジック アプリのデザイナー ビューに新しいノードを追加する必要があります。 [操作を選択してください] 検索バーで、Form Recognizer (Document Intelligence に名称変更予定) を検索し、一覧から [事前構築済みモデルまたはカスタム モデルのドキュメントを分析する (v3.0 API)] を選択します。
接続を作成できるウィンドウが表示されます。 具体的には、Document Intelligence リソースを Logic Apps Designer Studio に接続します。
[接続名] を入力します。 覚えやすいものにする必要があります。
以前にコピーした Document Intelligence リソースの [エンドポイント URL] と [アカウント キー] を入力します。 前にこのステップをスキップした場合、または文字列を紛失した場合は、Document Intelligence リソースに戻り、再度コピーできます。 完了したら [作成] を選択します。
Note
すでに資格情報を使用してログインしている場合は、前の手順はスキップされます。
次に、[事前構築済みモデルまたはカスタム モデルのドキュメントを分析する (v3.0 API)] コネクタの選択パラメーターのウィンドウが表示されます。
フィールドに次のように入力します。
- モデル識別子。 呼び出すモデルを指定します。この場合は、事前構築済みの請求書モデルを呼び出すので、事前構築済みの請求書を入力します。
- ドキュメント/画像ファイルの内容。 このフィールドを選択します。 動的コンテンツのポップアップが表示されます。 そうでない場合は、フィールドの下にある [動的コンテンツの追加] ボタンを選択し、[ファイル コンテンツ] を選択します。 このステップでは、基本的には分析対象のファイルを Document Intelligence の事前構築済み請求書モデルに送信します。 [ドキュメント/イメージ ファイルのコンテンツ] フィールドに [ファイル コンテンツ] バッジが表示されたら、この手順を正しく完了しています。
- ドキュメント/画像 URL。 OneDrive フォルダーから直接ファイル コンテンツを参照しているため、このプロジェクトではこのフィールドをスキップします。
- 新しいパラメーターの追加。 このプロジェクトでは、このフィールドをスキップします。
さらにいくつか手順を追加する必要があります。 もう一度、[➕ 新しいステップ] ボタンを選択して、別のアクションを追加します。
コントロールを選択し、コントロール タイルを選択します。
下にスクロールし、[コントロール] の一覧から [For Each コントロール] のタイルを選択します。
[For each] ステップのウィンドウには、[前のステップの出力を選択する] というラベルの付いたフィールドがあります。 このフィールドを選択します。 動的コンテンツのポップアップが表示されます。 そうでない場合は、フィールドの下にある [動的コンテンツの追加] ボタンを選択し、[ドキュメント] を選択します。
次に、[For each] ステップのウィンドウ内から [Add an Action](アクションの追加) を選択します。
[操作を選択してください] 検索バーに「Outlook」と入力し、[Outlook.com] (個人用) または [Office 365 Outlook] (職場用) を選択します。
アクション一覧で、[電子メールの送信 (V2)] が表示されるまで下へスクロールして、このアクションを選択します。
Outlook または Office 365 Outlook アカウントにサインインします。 そうすると、Document Intelligence が請求書から抽出する動的コンテンツを含む電子メールを書式設定するウィンドウが表示されます。
一部のフィールドは、次の式を使用して入力します。
items('For_each')?['fields']?['FIELD-NAME']?['content']
特定のフィールドにアクセスするには、[動的コンテンツの追加] ボタンを選択し、[式] タブを選択します。
[ƒx] ボックスに、上記の数式をコピーして貼り付け、FIELD-NAME を抽出するフィールドの名前に置き換えます。 使用可能なフィールドの完一覧については、特定の API の概念ページを参照してください。 この場合は、 事前構築済みの請求書モデルのフィールド抽出値を使用します。
もう少しで完了です。 次のフィールドに対して以下の変更を行います。
宛先。 個人または会社の電子メール アドレス、あるいはアクセス権のあるその他の電子メール アドレスを入力します。
件名。 「請求書を受け取った宛先:」と入力し、カーソルをコロンの後ろに置いたままにします。
[式] フィールドに次の式を入力し、 [OK] を選択します。
items('For_each')?['fields']?['VendorName']?['content']
- フィールドに式を入力した後、[OK] ボタンを選択すると、カーソルを置いた場所に式バッジが表示されます。
本文。 請求書に関する特定の情報を追加します。
- 「請求書 ID:」と入力し、前と同じ方法を使用して、カーソルを置き、次の式を式フィールドにコピーし、次の式の [OK] を選択します。
items('For_each')?['fields']?['InvoiceId']?['content']
- 新しい行に「請求書期限:」と入力し、次の式を追加します。
items('For_each')?['fields']?['DueDate']?['content']
- 「請求額:」と入力し、次の式を追加します。
items('For_each')?['fields']?['AmountDue']?['content']
- 最後に、請求額は重要な数値なので、電子メールでこの抽出の信頼スコアを送信することもできます。 そのためには、「請求額 (信頼度):」と入力し、次の式を追加します。
items('For_each')?['fields']?['AmountDue']?['confidence']
完了すると、ウィンドウは次の図のようになります。
左上隅にある [保存] を選択します。
注意
- 現在のバージョンでは、PDF ごとに 1 つの請求書のみが返されます。
- 今後 PDF から複数の請求書を返すことが可能な出力形式にするには、電子メール送信アクションの周りに "For each ループ" が必要です。
ロジック アプリを保存した後、更新または編集する必要がある場合、For each ノードは次の画像のようになります。
もう一度、検索バーから SharePoint を検索して選択します。 次に、[ファイルのコンテンツの取得] アクションを選択します。
フィールドに次のように入力します。
- サイトのアドレス。 SharePoint サイトを選択します。
- ファイル識別子。 このフィールドを選択します。 動的コンテンツのポップアップが表示されます。 そうでない場合は、フィールドの下にある [動的コンテンツの追加] ボタンを選択し、[識別子] を選択します。
- 内容の種類を推測します。 [はい] を選択します。
次に、別の新しいステップをワークフローに追加します。 新しく作成された SharePoint ノードの下にある [➕ 新規ステップ] ボタンを選択します。
ロジック アプリのデザイナー ビューに新しいノードを追加する必要があります。 [操作を選択してください] 検索バーで、 "Form Recognizer (Document Intelligence に名称変更予定)" を検索し、一覧から [請求書を分析する] を選択します。
すると、接続作成のウィンドウが表示されます。 具体的には、Form Recognizer リソースを Logic Apps Designer Studio に接続します。
- [接続名] を入力します。 覚えやすいものにする必要があります。
- 以前にコピーした Form Recognizer リソースの [エンドポイント URL] と [アカウント キー] を入力します。 前にこの手順をスキップした場合、または文字列を紛失した場合は、Form Recognizer リソースに戻り、再度コピーできます。 完了したら [作成] を選択します。
Note
すでに資格情報を使用してログインしている場合は、前の手順はスキップされます。 続けて、[請求書の分析] パラメーターを完了します。
次に、[請求書を分析する] コネクタの選択パラメーターのウィンドウが表示されます。
フィールドに次のように入力します。
- ドキュメント/画像ファイルの内容。 このフィールドを選択します。 動的コンテンツのポップアップが表示されます。 そうでない場合は、フィールドの下にある [動的コンテンツの追加] ボタンを選択し、[ファイル コンテンツ] を選択します。 このステップでは、基本的には分析対象のファイルを Document Intelligence の事前構築済み請求書モデルに送信します。 [ドキュメント/イメージ ファイルのコンテンツ] フィールドに [ファイル コンテンツ] バッジが表示されたら、この手順を正しく完了しています。
- ドキュメント/画像 URL。 OneDrive フォルダーから直接ファイル コンテンツを参照しているため、このプロジェクトではこのフィールドをスキップします。
- テキスト詳細情報の追加。 [はい] を選択します。
- 新しいパラメーターの追加。 このプロジェクトでは、このフィールドをスキップします。
最後のステップを追加する必要があります。 もう一度、[➕ 新しいステップ] ボタンを選択して、別のアクションを追加します。
[操作を選択してください] 検索バーに「Outlook」と入力し、[Outlook.com] (個人用) または [Office 365 Outlook] (職場用) を選択します。
アクション一覧で、[電子メールの送信 (V2)] が表示されるまで下へスクロールして、このアクションを選択します。
Outlook または Office 365 Outlook アカウントにサインインします。 これを実行すると、請求書から抽出された動的コンテンツを使用して送信される電子メールを書式設定するウィンドウが表示されます。
もう少しで完了です。 フィールドに次のエントリを入力します。
宛先。 個人または会社の電子メール アドレス、あるいはアクセス権のあるその他の電子メール アドレスを入力します。
件名。 [Invoice received from:](次から受信した請求書:) を入力してから、動的なコンテンツの [Vendor name field Vendor name](ベンダー名フィールドのベンダー名) を追加します。
本文。 請求書に関する特定の情報を追加します。
[請求書 ID:] を入力し、[Invoice ID field Invoice ID](請求書 ID フィールドの請求書 ID) を追加します。
新しい行で、[請求書の期限:] を入力し、動的コンテンツの [Invoice date field invoice date (date)](請求日フィールドの請求日 (日付)) を追加します。
[請求額:] を入力し、動的コンテンツの [Amount due field Amount due (number)](請求額フィールドの請求額 (数値)) を追加します。
最後に、請求額は重要な数値なので、電子メールでこの抽出の信頼スコアを送信することもできます。 これを行うには、[Amount due (confidence):](請求額 (信頼度):) を入力し、動的コンテンツの [Amount due field confidence of amount due](請求額フィールドの請求額の信頼度) を追加します。 完了すると、ウィンドウは次の画像のようになります。
ヒント
動的コンテンツ表示が自動的に表示されない場合は、[動的コンテンツの検索] バーを使用してフィールド エントリを検索します。
左上隅にある [保存] を選択します。
注意
- 現在のバージョンでは、PDF ごとに 1 つの請求書のみが返されます。
- 電子メール送信アクションの周りに "For each ループ" を配置すると、今後 PDF から複数の請求書を返すことが可能な出力形式になります。
オートメーション フローをテストする
フローをテストする前に、完了した内容を簡単にレビューしてみましょう。
- このシナリオでは、トリガーを作成しました。 トリガーは OneDrive アカウント内の事前に指定されたフォルダーにファイルが作成されたときに発生します。
- Document Intelligence アクションをフローに追加しました。 このシナリオでは、請求書 API を使用して、OneDrive フォルダーから請求書を自動的に分析することにしました。
- フローに Outlook.com アクションを追加しました。 分析した請求書データの一部を事前に指定された電子メール アドレスに送信しました。
フローを作成したので、最後にテストして、想定されている動作になることを確認します。
ロジック アプリをテストするには、まず新しいタブを開き、このチュートリアルの最初に設定した OneDrive フォルダーに移動します。 このファイルを OneDrive フォルダーのサンプル請求書に追加します。
ロジック アプリ デザイナー タブに戻り、[トリガーの実行] ボタンを選択し、ドロップダウン メニューから [実行] を選びます。
右上隅に、トリガーが成功したことを示すメッセージが表示されます。
左上隅にあるアプリ名のリンクを選択して、ロジック アプリの概要ページに移動します。
状態を確認して、実行が成功したか失敗したかを確認します。 状態インジケーターを選択して、成功したステップをチェックできます。
実行に失敗した場合は、失敗したステップをチェックして、正しい情報を入力したことを確認します。
ワークフローの実行が成功したら、メールを確認します。 指定した情報を含む新しい電子メールがあります。
完了したら、ロジック アプリを無効にするか削除して、使用を停止します。
お疲れさまでした。 このチュートリアルを完了しました。