クイックスタート

概要

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

クイックスタート	説明
Analyze Single Page Document	このページの手順を完了すると、以下のアクションを実行するオートメーション シーケンスが使用できるようになります。 AWS リソースへの接続を確立します ([Amazon スコープ])。 単一の JPEG または PNG ファイルを分析します ([単一ページのドキュメントを分析])。 見つかったデータの種類 ([条件分岐 (if)]) に応じて分析結果を出力します。 If the file includes form data (FormField[]), the PageDetail.FormFields.Items().Key and PageDetail.FormFields.Items().Value values are written to the output window (For Each and Write Line). If the file includes table data (DataTable), the PageDetail.Tables values are written to the output window (Output Data Table and Write Line).
分析を開始および取得	このページの手順を完了すると、以下のアクションを実行するオートメーション シーケンスが使用できるようになります。 AWS リソースへの接続を確立します ([Amazon スコープ])。 Amazon Textract の分析ジョブを開始します ([ドキュメントの分析を開始])。 開始した分析ジョブのステータス ([繰り返し (後判定)]、[ ドキュメント分析ステータスを取得]、[ 1 行を書き込み]、[ 遅延]) を取得して出力します。 Retrieves and outputs the results of the analysis if/when the analysis job is successful (If, Get Document Analysis, For Each, and Write Line).

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

概要

このガイドの目的は、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. Amazon Textract アクティビティに使用する IAM ユーザーの ID、シークレット、 リージョン を入力します。

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

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

4. 分析する JPEG または PNG の [ドキュメント パス ] (Bucket) と [DocumentName] ( バケット ) と [ DocumentName] (ドキュメント名) を入力します。

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

   • 変数を作成する際は、変数の型として 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 アクティビティにさらに習熟してください。

Amazon Textact アクティビティの詳細 (プロパティの入力/出力の例を含む) については「 アクティビティ 」ページをご覧ください。すべてのアクティビティが記載されたリストと、アクティビティの詳細な説明ページへのリンクが記載されています。

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

概要

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

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

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

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

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

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

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

   

前提条件

はじめる前に

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

手順

プロジェクトを構築する

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

2. Amazon Textract アクティビティに使用する IAM ユーザーの ID、シークレット、 リージョン を入力します。

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

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

4. 分析する JPEG または PNG の [ バケット ] と [ ドキュメント名 ] を入力します。

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)。
    • 変数を作成する際は、変数の型として 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 アクティビティにさらに習熟してください。

Amazon Textact アクティビティの詳細 (プロパティの入力/出力の例を含む) については「 アクティビティ 」ページをご覧ください。すべてのアクティビティが記載されたリストと、アクティビティの詳細な説明ページへのリンクが記載されています。