分析表单

“分析表单”活动使用表单识别器分析表单 API，通过指定的训练模型（模型 ID ）从指定文档（ “文件路径 ”或“文件 URL” ）中提取键值对和表格数据。

完成分析表单操作后，该活动将在AnalyzeOperationResult对象（响应对象）和Page[]对象（页面）中输出结果。这两个输出都可以用作后续活动（例如，条件逻辑）中的输入变量。

工作方式

以下步骤和消息序列图示例说明了活动从设计时（即活动依赖项和输入/输出属性）到运行时的工作方式。

1. 完成设置步骤。
2. 将Azure 表单识别器作用域活动添加到项目中。
3. 在“Azure 表单识别器作用域”活动中添加“分析表单”活动。
4. （可选）为输入属性输入值。
5. 为“输出”属性创建并输入AnalyzeOperationResult和Page[]变量。
6. 运行活动。

   • 您的输入属性已发送到分析表单 API。

   • API 将 AnalyzeFormResponse 和 FormPage[] 值返回到您的输出属性变量。

     

属性

将此活动添加到 UiPath Studio 中的项目时，会指定以下属性的值。

常见

显示名称

活动的显示名称。

属性	详细信息
类型	String
必填	是
默认值	分析表单
允许的值	输入 String 或 String 变量。
注意	不适用

超时

指定等待时间 (以毫秒为单位)，如果超出该时间，系统便会抛出错误。

属性	详细信息
类型	Int32
必填	是
默认值	30000 毫秒（（30 秒）未显示）
允许的值	输入 Int32 或 Int32 变量。
注意	不适用

输入

文件路径

要分析的表单文档的本地路径。

属性	详细信息
类型	String
必填	是（如果文件 URL为空）
默认值	空白
允许的值	输入 String 或 String 变量。
注意	支持的表单文档格式: .json、.pdf、.jpg、.png、和 .tiff（所有其他格式类型都将被忽略）。

文件 URL

要分析的表单文档的 URL。

属性	详细信息
类型	String
必填	是（如果“文件路径”为空）
默认值	空白
允许的值	输入 String 或 String 变量。
注意	支持的表单文档格式: .json、.pdf、.jpg、.png、和 .tiff（所有其他格式类型都将被忽略）。

模型 ID

要用于分析表单的训练模型的标识符。

属性	详细信息
类型	String
必填	是
默认值	空白
允许的值	输入 String 或 String 变量。
注意	要获取模型 ID值，请添加活动或运行输出模型标识符的外部流程（例如，训练模型、获取模型）。

选项

IncludeTextDetails

如果选中，结果将包括文本行和元素引用。

属性	详细信息
类型	复选框
必填	否
默认值	未选中
允许的值	已选择或未选择
注意	不适用

其他

私有

如果已选择，变量和参数的值将不会在 Verbose 级进行记录。

属性	详细信息
类型	复选框
必填	否
默认值	未选中
允许的值	已选择或未选择
注意	不适用

输出

Response Object

作为反序列化对象的操作响应。

属性	详细信息
类型	AnalyzeOperationResult
必填	否（在后续活动中使用输出数据时需要）
默认值	空白
允许的值	输入 AnalyzeOperationResult 变量
注意	要获取 JSON 字符串表示形式，请使用ToString方法。如果模型找不到字段，则返回空值。

页面

表单分析的结果，包括从页面中提取的键值对和表格信息。

属性	详细信息
类型	Page[]
必填	否（在后续活动中使用输出数据时需要）
默认值	空白
允许的值	输入 Page[] 变量
注意	每个 Page 对象都包含 KeyValuePairs 和 Tables 属性。