Analyze Single Page Document

The Analyze Single Page Document activity uses the Amazon Textract AnalyzeDocument API to synchronously analyze a local document (DocumentPath) or a document stored in an S3 bucket (Bucket, DocumentName, and Version). If your document includes a table, you have the option to indicate if the first row contains column headers (DiscoverColumnHeaders) and/or ignore empty rows (IgnoreEmptyRows).

ドキュメントの分析後、アクティビティはドキュメントのプロパティを PageDetail オブジェクト (Page) で返します。このオブジェクトは、Amazon Textract アクティビティ パッケージ以外の他のアクティビティの入力変数として使用できます。

動作のしくみ

次の手順とメッセージ シーケンス ダイアグラムは、設計時 (つまり、アクティビティの依存関係と入出力プロパティ) から実行時までのアクティビティの動作の例です。

1. 「セットアップ」の手順を完了します。
2. プロジェクトに [Amazon スコープ ] アクティビティを追加します。
3. [ 単一ページのドキュメントを分析 ] を [Amazon スコープ ] アクティビティ内に追加します。
4. [ローカル パス] または [S3 ストレージ] 入力プロパティに値を入力します。
5. [出力 (ページ)] プロパティの PageDetail 変数を作成し、入力します。
6. アクティビティを実行します。

   • 入力したプロパティは、 AnalyzeDocument API に渡されます。

   • API は、出力プロパティ変数に PageDetail 値 ([ページ]) を返します。

     

プロパティ

以下のプロパティの値は、このアクティビティを UiPath Studio でプロジェクトに追加するときに指定します。

共通

表示名

アクティビティの表示名です。

属性	詳細
入力	String
Required	はい
既定値	Amazon Scope
許容値	String または String 型変数を入力します。
備考	N/A

ローカル パス

ドキュメントパス

分析するファイルのローカルの場所です。

属性	詳細
入力	String
Required	はい ( S3 ストレージ プロパティが空の場合)
既定値	空
許容値	String または String 型変数を入力します。
備考	サポートされているドキュメント形式: PNG と JPEG (同期呼び出しでは PDF はサポートされていません)。

オプション

分析の種類

実行する分析の種類を指定します。 [表] を使用して、入力ドキュメントで検出されたテーブルに関する情報を返し、検出されたフォーム データを返すフォームを使用します。

属性	詳細
入力	ENUM
Required	No.
既定値	すべて
許容値	すべて、表、フォーム
備考	N/A

DiscoverColumnHeaders

ドキュメントのテーブルに列ヘッダーを含めるかどうかを指定します。

属性	詳細
入力	チェックボックス
Required	いいえ
既定値	非選択
許容値	選択または非選択
備考	N/A

空の行を無視

ドキュメントの分析時に、ドキュメントの表内の空の行を無視するかどうかを指定します。

属性	詳細
入力	チェックボックス
Required	いいえ
既定値	非選択
許容値	選択または非選択
備考	N/A

S3 ストレージ

バケット

ドキュメントが保存されている Amazon S3 バケットの名前です。

属性	詳細
入力	String
Required	はい
既定値	空
許容値	String または String 型変数を入力します。
備考	ドキュメントを含む S3 バケットの AWS リージョンは、[Amazon スコープ] アクティビティで選択したリージョンと一致する必要があります。Amazon Textract が S3 バケット内のファイルを処理するには、ユーザーに S3 バケットへのアクセス許可が必要です。詳細については、「セットアップ」ガイドの「IAM ユーザーの作成」セクションのステップ 6 をご覧ください。

DocumentName

The case-sensitive name of the file in the specified Bucket that you want to analyze.

属性	詳細
入力	String
Required	はい
既定値	空
許容値	String または String 型変数を入力します。
備考	サポートされているドキュメントの形式 ( PNG、JPEG、PDF)

バージョン

バケットでバージョン管理が有効化されている場合は、オブジェクトのバージョンを指定できます。

属性	詳細
入力	String
Required	いいえ
既定値	空
許容値	String または String 型変数を入力します。
備考	N/A

その他

プライベート (Private)

選択すると、変数と引数の値が Verbose レベルでログ記録されなくなります。

属性	詳細
入力	チェックボックス
Required	いいえ
既定値	非選択
許容値	選択または非選択
備考	N/A

出力

ページ

指定したドキュメントから抽出されたプロパティです。

属性	詳細
入力	PageDetail
Required	いいえ (後続のアクティビティで出力データを使用する予定がある場合に推奨)
既定値	空
許容値	PageDetail 型変数を入力します。
備考	See Page Detail for the description of the PageDetail object and its properties.

例

次の画像は、アクティビティの依存関係と入力/出力プロパティの値の例です。

ステップバイステップの手順および例は、「クイックスタート」ページをご覧ください。