Studio Web 用户指南

适用平台：

上次更新日期 2025年9月22日

验证控件

“验证控件”是 Studio Web 中 Apps 中的一个组件，可将 Document Understanding 中的“验证站点”嵌入到您的应用程序中。这使您可以查看、更正或批准从文档（例如发票、表单或电子邮件）中自动提取的数据。常见场景包括人机回圈自动化，尤其是当数据提取不确定或不完整时。例如，如果扫描了一张发票，但总金额看起来不确定，则“验证控件”允许人工在提交前检查并更正。

“验证控件”可让您直接在网页应用程序中手动审核文档，尤其是在以下情况下：

数据缺失或不明确
置信度较低
验证业务规则需要人工判断

用户场景

验证控件用户场景的示例包括：

批准总计不确定的发票
使用部分提取的数据审核保险索赔
在文档质量较低时确认姓名和地址

功能

通过将“验证控件”集成到应用程序中，您可以：

直接在应用程序界面中查看完整文档。
查看提取的数据，例如名称、金额、日期。
编辑、确认或删除数据。
根据用户输入触发业务规则或工作流。
验证多种文档类型、表格值和复杂的字段结构。
使用存储桶存储和检索所有文档验证内容，通过 Automation Cloud 进行安全的数据交换。

工作方式

主要工作流如下:

1、2、3、4：您上传要提取的文档。机器人使用 Document Understanding 或 Communications Mining 处理您的文档。

图 5：机器人使用“创建文档验证工件”或“创建通信 Mining 验证工件”活动创建ContentValidationData类的输出对象。此对象包含提取的结果、原始文档和支持信息。

然后，该活动会创建并存储验证控件显示文档及其提取详细信息所需的所有中间数据。此数据保存在 Orchestrator 存储桶中，您可以使用ContentValidationData对象访问这些数据。

6：提取您数据的 Robot 触发包含“验证控件”的 Action 应用。此应用程序将作为 Action Center 任务呈现给您。

注意：如果要构建独立的应用程序，则可以将ContentValidationData对象分配给ContentValidationData变量，而不添加步骤 6（创建应用程序任务）和步骤 7（等待应用程序任务并继续）。您可以将此变量用作验证控件的数据源。

7：作为用户，您会在 Action Center 中收到任务。您打开网页应用程序，并在一侧查看文档，在另一侧查看提取的数据。然后，您可以更正值、确认数据或拒绝错误的条目。

8、9、10：提交经过验证的数据后，机器人将使用“检索文档验证工件”或“检索 Communications Mining 验证工件”活动来检索更新的信息，然后继续自动化。这可确保工作流仅使用已审核和批准的数据。

限制

在应用程序中使用“验证控件”时，请记住以下限制：

您只能在 Automation Cloud 中使用。不支持本地部署或混合环境。
“验证控件”仅适用于Studio Web应用程序项目。您不能在 VB Apps 中使用它。
您只能将其用于文档验证任务。目前，该活动不支持文档分类。

内容验证数据对象

ContentValidationData对象是验证控件加载和呈现文档及其提取详细信息所需的数据。它用作控件的数据源。

此对象由“创建文档验证工件”或“创建 Communications Mining 验证工件”活动创建并存储在 Orchestrator 存储桶中。任务完成后，可以将ContentValidationData对象用作检索文档验证工件或检索 Communications Mining 验证工件活动的输入，以检索已验证的信息。

内容验证数据 JSON 结构

启用日志活动后，您可以从工作流日志中访问 JSON 格式的ContentValidationData对象。此 JSON 会准确告知验证控件可在存储桶中找到所需所有文件的位置，以及可显示文档及其提取数据的位置。以下是 JSON 格式的序列化ContentValidationData对象示例：

{
"BucketName":"DUValidationStationTestSb",
"BucketId":186140,
"FolderId":756377,
"FolderKey":"c2751834-1f05-4f4e-9cb8-509406f6faac",
"DocumentId":"4e32cef6-d4ee-4eac-a382-e80a2640de8a",
"DocumentPath":"v1\\4e32cef6-d4ee-
4eac-a382-e80a2640de8a\\CMS 1500.zip",
"EncodedDocumentPath":"v1\\4e32cef6-d4ee-4eac-a382-
e80a2640de8a\\encoded.zip",
"TextPath":"v1\\4e32cef6-d4ee-4eac-a382-
e80a2640de8a\\text.zip",
"DocumentObjectModelPath":"v1\\4e32cef6-d4ee-4eac-a382-
e80a2640de8a\\dom.zip",
"TaxonomyPath":"v1\\4e32cef6-d4ee-4eac-a382-
e80a2640de8a\\taxonomy.zip",
"AutomaticExtractionResultsPath":"v1\\4e32cef6-d4ee-4eac-a382-
e80a2640de8a\\input_results.zip",
"ValidatedExtractionResultsPath":"v1\\4e32cef6-d4ee-4eac-a382-
e80a2640de8a\\output_results.zip",
"ExtractorPayloadsPath":"v1\\4e32cef6-d4ee-4eac-a382-
e80a2640de8a\\extractor_payloads.zip",
"ShowOnlyRelevantPageRange":false,
"AdditionalDataPath":"",
"OriginalDocumentFileName":"CMS 1500.pdf",
"CustomizationInfoPath":"v1\\4e32cef6-d4ee-4eac-a382-
e80a2640de8a\\customization_info.zip"
}{
"BucketName":"DUValidationStationTestSb",
"BucketId":186140,
"FolderId":756377,
"FolderKey":"c2751834-1f05-4f4e-9cb8-509406f6faac",
"DocumentId":"4e32cef6-d4ee-4eac-a382-e80a2640de8a",
"DocumentPath":"v1\\4e32cef6-d4ee-
4eac-a382-e80a2640de8a\\CMS 1500.zip",
"EncodedDocumentPath":"v1\\4e32cef6-d4ee-4eac-a382-
e80a2640de8a\\encoded.zip",
"TextPath":"v1\\4e32cef6-d4ee-4eac-a382-
e80a2640de8a\\text.zip",
"DocumentObjectModelPath":"v1\\4e32cef6-d4ee-4eac-a382-
e80a2640de8a\\dom.zip",
"TaxonomyPath":"v1\\4e32cef6-d4ee-4eac-a382-
e80a2640de8a\\taxonomy.zip",
"AutomaticExtractionResultsPath":"v1\\4e32cef6-d4ee-4eac-a382-
e80a2640de8a\\input_results.zip",
"ValidatedExtractionResultsPath":"v1\\4e32cef6-d4ee-4eac-a382-
e80a2640de8a\\output_results.zip",
"ExtractorPayloadsPath":"v1\\4e32cef6-d4ee-4eac-a382-
e80a2640de8a\\extractor_payloads.zip",
"ShowOnlyRelevantPageRange":false,
"AdditionalDataPath":"",
"OriginalDocumentFileName":"CMS 1500.pdf",
"CustomizationInfoPath":"v1\\4e32cef6-d4ee-4eac-a382-
e80a2640de8a\\customization_info.zip"
}

其中：

BucketName和BucketId — 这些属性表示存储与文档验证相关的所有文件的存储桶。
FolderId和FolderKey — 这些属性表示文档及其相关文件在存储桶中的特定文件夹。
DocumentId — 正在验证的特定文档的唯一标识符。
DocumentPath — 存储桶中原始文档文件的完整路径。
EncodedDocumentPath 、 TextPath 、 DocumentObjectModelPath 、 TaxonomyPath — 这些是存储在存储桶中的各种中间文件的路径。这些文件对于验证控件正确呈现文档至关重要。其中包括文档布局信息 ( DocumentObjectModelPath ) 和全文 ( TextPath ) 等数据。
AutomaticExtractionResultsPath — 文件的路径，该文件包含机器人自动提取的数据。
ValidatedExtractionResultsPath — 这是在验证完成后保存最终的已验证数据的位置。
OriginalDocumentFileName — 原始文件的名称。

使用 ContentValidationData 作为数据源

如果使用“创建文档验证工件”活动，则可以将生成的ContentValidationData对象直接分配给验证控件作为其数据源。为此，您必须：

将Actions 应用程序添加到您的项目。
对于 操作架构 的“输入属性” ，选择“+ 添加属性”。
搜索ContentValidationData对象，将其选中并为其命名。例如“cvd”。
将“验证控件” 的“数据源” 字段设置为操作输入属性（“cvd”）。这会将 AccionProperties.cvd 设置为验证控件的数据源。

但是，手动创建 JSON 对象时，您不能将其直接与“验证控件”一起使用。您必须首先将其转换为具有简化属性集的 Visual Basic (VB) 表达式，例如BucketId 、 FolderKey和DocumentId 。

例如：

New UiPath.DocumentProcessing.Contracts.Actions.ContentValidationData With { 
.BucketId = 186140, 
.FolderKey =
new Guid("c2751834-1f05-4f4e-9cb8-509406f6faac"), 
.DocumentId = "4e32cef6-d4ee-4eac-a382-e80a2640de8a",
.DocumentObjectModelPath = "v1/4e32cef6-d4ee-4eac-a382-e80a2640de8a/dom.zip", 
.TaxonomyPath = "v1/4e32cef6-
d4ee-4eac-a382-e80a2640de8a/taxonomy.zip", 
.TextPath = "v1/4e32cef6-d4ee-4eac-a382-e80a2640de8a/text.zip",
.EncodedDocumentPath = "v1/4e32cef6-d4ee-4eac-a382-e80a2640de8a/encoded.zip", 
.AutomaticExtractionResultsPath
= "v1/4e32cef6-d4ee-4eac-a382-e80a2640de8a/input_results.zip",
.CustomizationInfoPath = "v1/4e32cef6-d4ee-4eac-a382-e80a2640de8a/customization_info.zip"
}New UiPath.DocumentProcessing.Contracts.Actions.ContentValidationData With { 
.BucketId = 186140, 
.FolderKey =
new Guid("c2751834-1f05-4f4e-9cb8-509406f6faac"), 
.DocumentId = "4e32cef6-d4ee-4eac-a382-e80a2640de8a",
.DocumentObjectModelPath = "v1/4e32cef6-d4ee-4eac-a382-e80a2640de8a/dom.zip", 
.TaxonomyPath = "v1/4e32cef6-
d4ee-4eac-a382-e80a2640de8a/taxonomy.zip", 
.TextPath = "v1/4e32cef6-d4ee-4eac-a382-e80a2640de8a/text.zip",
.EncodedDocumentPath = "v1/4e32cef6-d4ee-4eac-a382-e80a2640de8a/encoded.zip", 
.AutomaticExtractionResultsPath
= "v1/4e32cef6-d4ee-4eac-a382-e80a2640de8a/input_results.zip",
.CustomizationInfoPath = "v1/4e32cef6-d4ee-4eac-a382-e80a2640de8a/customization_info.zip"
}