クイックスタート

概要

以下は、Amazon Textract アクティビティのステップバイステップの使用手順を示すページへのリンクです。 これらのガイドは、各種アクティビティの実用的なサンプルの作成に役立ち、AWS リソースへの接続を確認したり、入/出力データ型に習熟したりできるようにするために役立ちます。

クイックスタート	説明
Analyze Single Page Document	このページの手順を完了すると、以下のアクションを実行するオートメーション シーケンスが使用できるようになります。 AWS リソースへの接続を確立します ( Amazon スコープ )。 単一の JPEG または PNG ファイルを分析します ( 単一ページのドキュメントを分析 )。 見つかったデータの種類に応じて分析結果を出力します ( [条件分岐 (if )])。 ファイルにフォーム データ ( [ FormField[] ] が含まれている場合、 PageDetail.FormFields.Items().Key 値と PageDetail.FormFields.Items().Value 値が出力ウィンドウに書き込まれます ( [繰り返し (コレクション の各要素)] と [ 1 行を書き込み ])。ファイルに表データ ( DataTable ) が含まれている場合、 PageDetail.Tables 値が出力ウィンドウに書き込まれます ( [ 出力データ テーブル ] と [ 1 行を書き込み ] )。
分析を開始および取得	このページの手順を完了すると、以下のアクションを実行するオートメーション シーケンスが使用できるようになります。 AWS リソースへの接続を確立します ( Amazon スコープ )。 Amazon Textract 分析ジョブを開始します ([ ドキュメント分析の開始 ])。 開始した分析ジョブのステータス ( [繰り返し (後判定 )]、[ ドキュメント分析ステータスを取得 ]、[ 1 行を書き込み ]、[ 遅延 ]) を取得および出力します。 分析ジョブが成功した場合に、分析結果を取得して出力します ( [条件分岐 (if )]、[ ドキュメント分析を取得 ]、[ 繰り返し (コレクション の各要素)]、[ 1 行を書き込み ])。

クイックスタート - 単一ページのドキュメントを分析する

概要

このガイドの目的は、Amazon Textract の [単一ページのドキュメントを分析 ] アクティビティを使用した、実用的なサンプルを作成できるようになることです。

この実用的なサンプルにより、AWS リソースへの接続をすばやく確認したり、アクティビティの入力/出力データ型に習熟したりすることができます。

このページの手順を完了すると、以下のアクションを実行するオートメーション シーケンスが使用できるようになります。

1. AWS リソースへの接続を確立します ([Amazon スコープ])。
2. 単一の JPEG または PNG ファイルを分析します ([単一ページのドキュメントを分析])。
3. 見つかったデータの種類 ([条件分岐 (if)]) に応じて分析結果を出力します。

   • ファイルにフォーム データ ( [FormFields]) が含まれている場合、出力ウィンドウに PageDetail.FormFields.Items().Name 値と PageDetail.FormFields.Items().Value 値が書き込まれます ([繰り返し (コレクション の各要素)] と [ 1 行を書き込み])。

   • ファイルに表データ (DataTable) が含まれている場合、 PageDetail.Tables 値が出力ウィンドウに書き込まれます ([データ テーブルを出力 ] と [1 行を書き込み])。

     

前提条件

はじめる前に

1. Amazon Textract のセットアップ 手順を完了します。
2. S3 バケットにアップロードするか、ローカルに保存して、JPEG または PNG ファイルを使用できるようにします。

手順

プロジェクトをビルドする

1. プロジェクトに [Amazon スコープ ] アクティビティを追加します。

2. Enter the Id, Secret, and Region for the IAM user that you want to use for the Amazon Textract activities.

   • 詳細については、「 セットアップ」 ガイドの「 IAM ユーザーを作成する 」セクションをご覧ください。

3. [ Amazon スコープ] アクティビティ内に [ 単一ページのドキュメントを分析] アクティビティを追加します。

4. Enter the DocumentPath to, or the Bucket and DocumentName of, the JPEG or PNG file that you want to analyze.

5. [ページ値] の PageDetail 変数を作成し、入力します (例: pageDetail)。

   • When creating your variable, select *UiPath.Amazon.Textract.Client.Models.PageDetail
   • を変数の型として使用します。

6. [ 単一ページのドキュメントを分析] アクティビティの後に[条件分岐 (if)] アクティビティを追加します。

7. [条件] プロパティに、上記の手順で作成した PageDetail 変数と を入力します。HasFormData.ToString.Equals("True") は、ファイルにFormFieldオブジェクトが含まれているかどうかを判断します (例: pageDetail.HasFormData.ToString.Equals("True"))。

8. [Then] ステートメント ボックスに [繰り返し (コレクションの各要素)] アクティビティを追加します。

   1. TypeArgument プロパティで、_UiPath.Amazon.Textract.Client.Models.FormFields を選択します。
   2. [ 値 ] プロパティに、[メッセージを取得] アクティビティ用に作成した変数の FormFields.Items プロパティを入力します (例: pageDetail.FormFields.Items)。
   3. [繰り返し (コレクションの各要素)] アクティビティに [1 行を書き込み] アクティビティを追加します。
      1. [テキスト] プロパティに「item」と入力します。名前+" |"+アイテム。価値+" |"+アイテム。フォーム データのKeyValuePair値を出力する信頼度です。
   4. [Else] ステートメント ボックスに [1 行を書き込み] アクティビティを追加します。
   5. [テキスト] プロパティに「No form data found」と入力します。

9. 最初の [条件分岐 (if)] アクティビティの後にもう 1 つ [条件分岐 (if)] アクティビティを追加します。

10. [条件] プロパティに、上記の手順で作成した PageDetail 変数と を入力します。HasTableData.ToString.Equals("True") を使用して、ファイルにDataTableオブジェクトが含まれているかどうかを判断します (例: pageDetail.HasTableData.ToString.Equals("True"))。

11. [Then] ステートメント ボックスに [データ テーブルを出力] アクティビティを追加します。

    1. [ データ テーブル] プロパティに、[ 単一ページのドキュメントを分析] アクティビティ用に作成した PageDetail変数 を入力します 。Tables(0) は、ファイル内の 'DataTable' オブジェクトを指定します (例: pageDetail.Tables(0))
    2. [テキスト] プロパティで、DataTableコンテンツの String 変数 (例:dataTable)。
    3. [データ テーブルを出力] アクティビティの後に [1 行を書き込み] アクティビティを追加します。
       1. [テキスト] プロパティに、DataTable内容を出力するために上記の手順で作成した String 型変数を入力します。
    4. [Else] ステートメント ボックスに [1 行を書き込み] アクティビティを追加します。
    5. [テキスト] プロパティに「No table data found」と入力します。

12. [実行] をクリックし、[出力] ウィンドウに予期されるフォーム データとテーブル データが含まれていることを確認します。

    

    

完了です!

準備ができたら、他の クイックスタート ガイドを試して、さまざまな Amazon Textract アクティビティにさらに習熟してください。

To learn more about the Amazon Textract activities (including example property inputs/outputs), see the Activities page for a complete activity list and links to the activity detail pages.

クイックスタート - 分析を開始および取得する

概要

このガイドの目的は、Amazon Textract の [ドキュメント分析を開始]、[ ドキュメント分析のステータスを取得]、および [ドキュメント分析を取得 ] アクティビティを使用した、実用的なサンプルを作成できるようになることです。

この実用的なサンプルにより、AWS リソースへの接続をすばやく確認したり、アクティビティの入力/出力データ型に習熟したりすることができます。

このページの手順を完了すると、以下のアクションを実行するオートメーション シーケンスが使用できるようになります。

1. AWS リソースへの接続を確立します ([Amazon スコープ])。

2. Amazon Textract の分析ジョブを開始します ([ドキュメントの分析を開始])。

3. 開始した分析ジョブのステータス ([繰り返し (後判定)]、[ ドキュメント分析ステータスを取得]、[ 1 行を書き込み]、[ 遅延]) を取得して出力します。

4. 分析ジョブが成功した場合に、分析結果を取得して出力します ([条件分岐 (if)]、[ ドキュメント分析を取得]、[繰り返し (コレクションの各 要素)]、[ 繰り返し (コレクションの各要素)]、[ 1 行を書き込み])。

   

前提条件

はじめる前に

1. Amazon Textract のセットアップ 手順を完了します。
2. S3 バケットにアップロードするか、ローカルに保存して、JPEG または PNG ファイルを使用できるようにします。

手順

プロジェクトをビルドする

1. プロジェクトに [Amazon スコープ ] アクティビティを追加します。

2. Enter the Id, Secret, and Region for the IAM user that you want to use for the Amazon Textract activities.

   • 詳細については、「 セットアップ」 ガイドの「 IAM ユーザーを作成する 」セクションをご覧ください。

3. [ Amazon スコープ] アクティビティ内に[ドキュメントの分析を開始] アクティビティを追加します。

4. Enter the Bucket and DocumentName of, the JPEG or PNG file that you want to analyze.

5. [ジョブ ID] の値を表すString変数を作成し、入力します (例: jobId)。

6. [ドキュメントの分析を開始] アクティビティの後に [ 繰り返し (後判定)] アクティビティを追加します。

7. [ 繰り返し (後判定 )] アクティビティ内に、[ ドキュメント分析のステータスを取得] アクティビティを追加します。

8. [ジョブ ID] プロパティに、上記でジョブ ID 用に作成したString変数を入力します (例: jobId)。

9. [ジョブのステータス] の値に使用するString変数を作成し、入力します (例: jobStatus)。

10. [繰り返し (後判定)] アクティビティの [条件] プロパティに、JobStatus 変数と条件値を入力します (例: jobStatus = "IN_PROGRESS")

    • 使用可能なジョブのステータス値のリストについては、[ ドキュメント分析のステータスの詳細を取得] ページの[ジョブのステータス] プロパティ セクションをご覧ください。

11. [ドキュメント分析のステータスを取得] アクティビティの後に [ 1 行を書き込み] アクティビティを追加します。

12. [テキスト] プロパティに、上記の [ジョブのステータス] の値用に作成したString変数を入力します (例: jobStatus)。

13. [ 1 行を書き込み] アクティビティの後に [ 待機] アクティビティを追加します。

14. [ 期間] プロパティに、ドキュメントの処理に要する推定時間を入力します。この例では、 00:00:20 と入力して 、ジョブ ステータス の出力値の変更を示します (デモ以外のシナリオでは、1 つのフォーム ドキュメントに 「00:00:55 」と入力します)。

    注:

    上記のシナリオでは、ロボットは分析ジョブのステータスを 20 秒ごとに取得して出力します。ステータスは IN_PROGRESS です。この条件の場合、ロボットはステータスを取得するまでステータスを取得して出力できます。

15. [繰り返し (後判定)] アクティビティの後に[条件分岐 (if)] アクティビティを追加します。

16. [条件] プロパティに、条件値とともに JobStatus 変数を入力します (例: jobStatus = "SUCCEEDED" または jobStatus="PARTIAL_SUCCESS")。

17. [Then] ステートメント ボックスに、[ドキュメント分析を取得] アクティビティを追加します。

    1. [ジョブ ID] プロパティに、[ドキュメントの分析を開始] アクティビティの [ジョブ ID] プロパティ用に作成したString変数を入力します。(例: jobId)。
    2. ページ値のPageDetail[]変数を作成し、入力します (例: pageDetails)。
    • When creating your variable, select *UiPath.Amazon.Textract.Client.Models.PageDetail[]
    • を変数の型として使用します。

18. 以下の例では、Pages プロパティの PageDetail[] 配列の最初のドキュメントのみを評価します。

    1. PageDetail配列内の最初の項目を格納する 型変数を作成して入力します。そして、[ ドキュメント分析を取得] アクティビティの後に[代入] アクティビティを使用します (例: pageDetail)。
    2. 先ほど作成した変数の値としてPageDetail(0)を割り当てます(pageDetail)

19. [代入] アクティビティの後に [繰り返し (コレクションの各要素)] アクティビティを追加します。

    1. [TypeArgument] プロパティで [UiPath.Amazon.Textract.Client.Models.FormFields] を選択します
    2. [値] プロパティに、[代入] アクティビティ用に作成した変数の FormFields.Items プロパティを入力します (例: pageDetail.FormFields.Items)。
    3. [繰り返し (コレクションの各要素)] アクティビティに [1 行を書き込み] アクティビティを追加します。
       1. [テキスト] プロパティに「item」と入力します。名前+" |"+アイテム。価値+" |"+アイテム。フォームの値を出力するための信頼度。
    4. [Else] ステートメント ボックスに [1 行を書き込み] アクティビティを追加します。
    5. [テキスト] プロパティに、失敗したジョブに関するメッセージを入力します (例: _「ジョブが失敗した。もう一度やり直してください」)。

20. シーケンスを実行し、[ 出力 ] ウィンドウにジョブのステータスとフォーム データ期待値が表示されていることを確認します。

    

    

完了です!

準備ができたら、他の クイックスタート ガイドを試して、さまざまな Amazon Textract アクティビティにさらに習熟してください。

To learn more about the Amazon Textract activities (including example property inputs/outputs), see the Activities page for a complete activity list and links to the activity detail pages.