UiPath Marketplace 用户指南

上次更新日期 2025年10月10日

分析表单

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

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

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

完成设置步骤。
将“ Azure 表单识别器作用域”活动添加到项目中。
在 Azure 表单识别器作用域 活动中添加分析表单活动。
输入“ 输入 ”属性的值。
为“输出”属性创建并输入 AnalyzeOperationResult 和 Page[] 变量。
运行活动。
- 您的输入属性将发送到分析表单API。
- API 将 AnalyzeFormResponse 和 FormPage[] 值返回到您的输出属性变量。

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

活动的显示名称。

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

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

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

要分析的表单文档的 URL。

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

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

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

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

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

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

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

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

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