Get Analyze Form Result

[フォームの結果を取得 分析] アクティビティは、Form Recognizer の Get Analyze Form Result API を使用して、以前に実行したフォーム分析操作の結果 ([結果の場所] と [モデル ID]) を非同期的に取得します。

操作が完了すると、アクティビティは操作ステータスを String ([操作のステータス]) に出力し、結果を AnalyzeOperationResult オブジェクト ([応答オブジェクト]) と Page[] オブジェクト ([ページ]) に出力します。 後続のアクティビティ (例: 条件ロジック) では、すべての出力を入力変数として使用できます。

動作のしくみ

以下の手順とメッセージ シーケンス ダイアグラムは、設計時 (つまり、アクティビティの依存関係と入/出力プロパティ) から実行時に至るまでの、アクティビティの動作のしくみの例を示したものです。

1. 「セットアップ」の手順を完了します。
2. プロジェクトに [ Azure フォーム認識器スコープ] アクティビティを追加します。
3. モデル識別子を出力するアクティビティを追加するか外部プロセスを実行します (例: [モデルをトレーニング]、[ モデルを取得])。
4. 結果の場所を出力するアクティビティを追加するか外部プロセスを実行します (例:
5. [ Azure フォーム認識スコープ] アクティビティ内に [ フォームの結果を分析 する] アクティビティを追加します。
6. [入力] セクションのプロパティに値を入力します。
7. [出力] セクションのプロパティのために String 型変数、AnalyzeOperationResult 型変数、および Page[] 型変数を作成し、入力します。

8. アクティビティを実行します。

   • 入力プロパティは、 Get Analyze Form Result API に渡されます。
   • API は、ステータス String、 AnalyzeFormResponse、および Page[] の値を、出力プロパティ変数に返します。
     
     

     

     
     

プロパティ

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

共通

表示名

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

属性	詳細
入力	String
Required	はい
既定値	フォームの結果を分析する
許容値	String または String 型変数を入力します。
備考	N/A

入力

モデル ID

フォームの分析に使用するトレーニング モデルの識別子です。

属性	詳細
入力	String
Required	はい
既定値	空
許容値	String または String 型変数を入力します。
備考	[ モデル ID] の値を取得するには、モデル識別子を出力するアクティビティを追加するか外部プロセスを実行します (例: [ モデルをトレーニング]、[モデルを 取得])。

結果の場所

進行状況の追跡と操作の結果の取得に使用する 結果 ID を含む URL です。

属性	詳細
入力	String
Required	いいえ (後続のアクティビティで出力データを使用する必要があります)
既定値	空
許容値	String 型変数を入力します。
備考	[結果の場所] を取得するには、結果の場所を出力するアクティビティを追加するか外部プロセスを実行します (例: )。 詳細については、Analyze Form API ドキュメントの 「操作場所 」をご覧ください。

その他

プライベート (Private)

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

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

出力

操作ステータス

操作のステータスです。

属性	詳細
入力	String
Required	いいえ (後続のアクティビティで出力データを使用する必要があります)
既定値	空
許容値	String 型変数を入力します。
備考	以下の 4 つのステータスが考えられます。 notStarted: 分析操作が開始されていません。 running: 分析操作が進行中です。 failed: 分析操作が失敗しました。 succeeded: 分析操作が成功しました。 ステータスが 成功の場合、応答 JSON にはフォーム理解とテキスト認識の結果が含まれます。

Response Object

逆シリアル化されたオブジェクトとしての操作の応答です。

属性	詳細
入力	AnalyzeOperationResult
Required	いいえ (後続のアクティビティで出力データを使用する必要があります)
既定値	空
許容値	AnalyzeOperationResult 型変数を入力します。
備考	JSON 文字列表現を取得するには、 ToString メソッドを使用します。 モデルでフィールドが見つからない場合、null 値が返されます。 データ フィールドを含むオブジェクトの詳細については、Get Analyze Form Result API ドキュメントの「応答」セクションをご覧ください。

ページ数

ページから抽出されたキーと値のペアと表の情報を含むフォーム分析の結果。

属性	詳細
入力	Page[]
Required	いいえ (後続のアクティビティで出力データを使用する必要があります)
既定値	空
許容値	Page[] 型変数を入力します。
備考	各 Page オブジェクトには、 KeyValuePairs と Tables のプロパティが含まれます。