Document Understanding 活动

使用应用程序操作验证文档

1. 构建显示验证控件的操作应用程序。
2. 使用先前配置的应用程序来设计处理文档的 Studio 自动化，并将其发送以在 Action Center 中进行验证。
3. 在 Action Center 中完成操作。

步骤​

1. 构建 Actions 应用程序​

先决条件​

• 拥有足够的 Robot Units，因为应用程序使用 Serverless Robot 运行。
• 在 Orchestrator 中创建并配置 Serverless Robot 模板。有关 Serverless Robot 以及将其添加到租户的更多信息，请访问使用 Serverless Robot 执行 Unattended 自动化。

1. 创建 Actions 应用程序​

1. 转到 Studio Web。
2. 选择“新建” > “应用”以创建新项目。
3. 在应用程序的项目资源管理器中，选择“添加页面、工作流、控件、集成” > “操作” 。此步骤会向您的应用程序添加一个操作，并让您为其配置操作架构。
4. 展开“操作” ，然后选择“操作架构” 。使用您希望用于 Action Center 中的应用程序操作的 In 和 Out 参数配置操作架构。
   1. 对于结果，添加您希望操作具有的其他自定义结果。例如，您可以添加名为“批准”的自定义结果。
   2. 对于“输入属性” ，为要传递到操作中的数据添加属性。从“Apps” 下拉列表中选择此应用程序时，这些属性将显示在“创建应用程序任务” 活动中。输入属性允许您将数据从 Studio 自动化传递到操作。
   3. 对于“输出属性” ，为要从操作中检索的参数添加属性。可以通过“任务对象（输出）” 变量从“等待应用程序任务然后继续” 活动访问这些属性。
   4. 对于“输入/输出”属性，添加在 Studio 自动化中用作输入/输出参数的属性。这些输入/输出属性首先在传递给操作的“创建应用程序任务”活动中显示为属性。然后，在操作完成后，您可以从“等待应用程序任务然后继续”活动中，通过“任务对象（输出）”属性访问已更新的相同属性。

2. 添加并自定义验证控件​

1. 打开要包含验证站点的所需操作应用程序。

2. 选择“打开工具箱” 。

3. 在“显示”下，找到“验证控件” ，并将其添加到您的应用程序中。

   将验证控件添加到应用程序后，系统会自动在应用程序 的“项目资源管理器”的“应用程序变量”部分下创建一个Var<ValidationControl_PageName>变量。

   备注：

   您可以使用验证控件和相应的应用程序变量，从验证控件中读取信息。使用Var<ValidationControl_PageName>应用程序变量向其中写入信息。

4. 准备操作架构：

   1. 在“项目资源管理器”中的“操作”下，选择“操作架构” 。

   2. 在“输入属性”中，选择“添加属性” 。

   3. 在属性搜索栏中，选择“更多选项” 。

   4. 在“高级”下，选择“内容验证数据”。

      这是将在“创建应用程序任务”活动中显示的输入属性。内容验证数据输入属性需要ContentValidationData对象作为输入，输入可以是单个对象也可以是ContentValidationData实例的数组/列表。ContentValidationData包含验证站点的工件。ContentValidationData是使用“创建文档验证工件”活动创建的。

5. 配置验证控件：

   1. 转到“验证控件”属性。
   2. 在“来源输入”中，选择您已定义为ContentValidationData类型的“操作”输入。

6. 使用您需要的其他控件配置应用程序的其余部分。

3. 访问验证控件数据及其属性​

4. 编辑验证控件数据​

1. 选择应用程序中的任何控件，然后转到事件。
2. 选择“定义自动化” 。此操作将打开 Studio Web 的设计器面板，您可以在其中为特定应用程序控件构建触发器自动化。
3. 在文档“提取结果”的上下文中，要添加或更改常规字段的字段值，请在自动化中添加“设置变量值”活动。

   1. 对于“目标变量”字段，使用AppVariable.VarValidationControl_PageName.Field("<field name>").Value 。

      该表达式表示您要更改的字段，可通过VarValidationControl_PageName变量访问。

   2. 在“目标”字段中，为引用的字段输入所需的值。

      除常规字段外， AppVariable.VarValidationControl_PageName变量还可使用AppVariable.VarValidationControl_PageName.Field("<field name>", <index>)操作多值字段，并使用AppVariable.VarValidationControl_PageName.Field("<table field name").Field("<column name>", <row index>)与表格单元格交互。

      要删除值，请以类似方式选择目标值，并使用设置为True 的.DeleteValue标志。您可以在验证控件中更新的值属性包括：

   • 文本值 ( .Value )
   • 已确认的状态 ( .Confirmed )
   • 值的置信度 ( .Confidence )
   • 删除标志 ( .DeleteValue )
   • 标记以删除值引用 ( .KeepReference )

5. 为验证控件创建事件​

6. 使用专用的验证控件活动​

1. “设置验证控件字段焦点” : 用于根据配置的事件将焦点放在某个字段上。
2. “保存验证控件状态” - 保存验证控件的状态。要稍后重新访问并完成验证时，可以使用此选项。

常用验证控件表达式​

6. 发布并部署应用程序​

2. 创建 Studio 自动化​

先决条件​

• 安装以下活动包版本：
  • IntelligentOCR.Activities 版本 6.24.0
  • Persistence.Activities 版本 1.5.5 或更高版本。
  • AppEvents.Activities 版本 3.12.0 或更高版本。
• 在 Orchestrator 中要发布文档处理自动化的同一文件夹中创建一个存储桶。在应用程序中加载验证控件所需的数据存储在 Orchestrator 存储桶中。
• 在 Studio 项目文件夹中添加要处理的文档。
• （可选）如果要使用生成式提取或验证功能，则需要特定的服务单元
  • 如果您加入了 Flex 计划，则需要 AI Unit。有关 Document Understanding 生成式功能的更多信息，请访问生成式功能。

1. 使用 Document Understanding 处理文件​

• DocumentTaxonomy （分类）：通过“加载分类”活动检索。
• Dom （文档对象模型）和text （文档文本）：通过“数字化文档”活动获取。
• doc （文档路径）：表示已处理文件的路径。
• autoExtractionResults (提取结果)：无论使用哪种提取方法，这都是“数据提取作用域”活动的输出。

2. 将验证信息发送到应用程序​

1. 添加“创建文档验证工件”活动以创建Content Validation Data对象，该对象存储在操作应用程序中加载验证控件所需的信息。在此示例中，使用先前创建或输出的变量配置活动：
   • 存储桶文件夹路径（可选） ：在其中创建存储桶的 Orchestrator 文件夹的名称。
   • 存储桶名称： storageBucketName
   • 存储桶目录路径（必填） ：先前输入的存储桶中要存储操作数据的目录路径。
   • 文档路径： doc
   • 文档文本: text
   • 文档对象模型： dom
   • 分类： taxonomy
   • 自动提取结果： autoExtractionResults
2. 添加“创建应用程序任务”活动，以便将Content Validation Data对象绑定到先前设计的应用程序，然后将其发送到 Action Center 进行验证。在此示例中，请按如下方式配置活动：
   • 标题： CVD
   • 优先级: Medium
   • Apps： Demo.Validation.Control.in.Apps
   • 应用程序版本：v2.0.0选择应用程序以及要用于创建操作的相应版本后，该应用程序的输入属性将显示在活动的主体中。

     • 在此示例中，输入属性之一为Action_Content_Validation_Data ，它需要使用先前创建的文档验证工件： contentValidationData 。

       图 2. “创建应用程序任务”活动

       

3. 添加“等待应用程序任务然后继续”活动以返回有关操作的信息，然后继续执行工作流。在“已创建的应用程序任务”字段中，输入“创建应用程序任务”活动的输出变量。
4. 添加“检索文档验证工件”活动，以在用户在 Action Center 中执行验证后返回文档验证工件。将创建文档验证工件活动的输出变量作为检索文档验证工件活动的输入。
   提示：

   您还可以为存储在验证工件中的其他信息创建专用的输出变量，例如自动提取结果和已验证的提取结果。

3. 在 Action Center 中执行验证​

1. 打开 Action Center，然后转到“我的操作” （“管理操作” > “管理操作”） 。
2. 在“未分配”选项卡中，找到刚才使用以前的 Studio 自动化创建的操作。
3. 如果要将操作分配给自己，请选择所需的操作，然后选择“分配给自己” 。
4. 如果要将操作分配给其他用户，请为所需操作选择更多选项。然后选择“分配给用户” ，然后从下拉列表中选择一个用户。
5. 转到“待处理”选项卡，并完成操作，以便 Studio 工作流可以继续。