加载分类

UiPath.IntelligentOCR.Activities.TaxonomyManagement.LoadTaxonomy

将借助“分类管理器”创建的 taxonomy.json 文件转变为可进一步与其他活动配合使用的变量。

属性

常见

• “显示名称”- 活动的显示名称。

其他

• “私有”- 选中后将不再以“Verbose”级别记录变量和参数的值。

输出

• 分类 - 要加载的分类，存储在 DocumentTaxonomy 变量中。您随后可在接收分类作为输入的活动中使用该输出。
  重要提示：如果您使用的是 Intel Xe GPU 且分类管理器未正确显示，我们建议将图形驱动程序更新到最新版本。有关详细信息，请参阅此页面。

分类扩展方法

Serialize()

对“DocumentTaxonomy”对象调用“Serialize()”方法后，该方法将为此对象返回“JSON”表示，便于用户存储和检索以供日后使用。

Deserialize(String)

在与作为参数传递的 JSON 编码数据结合使用后，“DocumentTaxonomy.Deserialize(jsonString)”静态扩展方法将返回“DocumentTaxonomy”对象。

GetFields(String)

对 DocumentTaxonomy 对象执行调用后，使用 DocumentTypeId 字符串调用的 GetFields() 方法将返回在该文档类型中定义的字段列表。

分类管理器可用于创建和编辑特定于当前自动化项目的分类文件。该分类文件包含由用户定义并按“组”和“类别”分类的文档类型。

您可以使用“加载分类”活动将分类文件转换为 .NET 数据类型，然后将其作为输入传递给以下活动：

• 分类文档作用域
• 训练分类器范围
• 训练提取程序范围
• 呈现验证站点

只有在安装 v1.6.0 或更高版的 UiPath.IntelligentOCR.Activities 包作为项目依赖项后，才能访问分类管理器。包安装完成后，“向导”部分的功能区中会显示“分类管理器”按钮。

使用分类管理器

“分类管理器”窗口用于创建按组和类别组织的文档类型。首次在项目中打开“分类管理器”时，系统不会定义任何组、类别或文档类型。

建立结构

第一步是创建组或文档类型。两者之间的区别在于，组涉及层次结构，而文档类型可以创建为单个文件。复杂的项目意味着创建组、类别和文档类型，而简单的项目只能要求创建一种或两种文档类型。

创建组

创建组时，要为在组内创建的文档类型也创建类别。这可以通过点击“组”按钮来完成。选择组名称后，可以使用“保存”按钮或按 Enter 键来保存该名称。

创建类别

定义并选择组后，您可以使用其定义的按钮在组内创建“类别”和/或“文档类型”。

创建文档类型

“文档类型”可以作为组的一部分创建，也可以创建为单个文件。在组内创建时，请确保选中该组，然后单击“文档类型”按钮。

如果将“文档类型”创建为单个文件，请确保未选择任何组，然后单击“文档类型”按钮。单击“文档类型”按钮后，输入文件的名称，然后单击“保存”按钮。

注意： 如果在使用 Studio v20.10 时从 Orchestrator 提交“文档理解操作”，请确保该分类没有创建没有类别的文档类型。

选择已创建的“文档类型”，您可以更改其名称、将其唯一 ID 复制到剪贴板、将其重新分配给另一个组或类别，也可以不进行任何操作。您还可以输入文档类型的代码。

保存文档类型后，系统会为其生成 文档类型 ID 。 打开文档进行编辑，会在“ 文档类型名称” 选项卡旁边显示 ID。 文档类型 ID 具有 Group.Category.Document 类型的结构，可以复制到剪贴板。 文档类型 ID 代码是一项可选功能，可用于查找文档或将文档映射到您在分类中定义的文档类型。

创建字段

选择“文档类型”后，您可以使用字段按钮来创建新字段。单击字段按钮后，您可以为字段输入其名称，然后从下拉列表中选择其类型。

“ 字段 ” 类别有两个选项卡，即“ 详细信息 ” 和 “规则”。 “ 详细信息 ” 选项卡提供有关所选字段的信息，例如字段名称、分配的热键或字段类型，而“ 规则” 选项卡允许您创建字段的提取结果需要满足的规则。

可用的字段类型包括：

• 文本
• 数字
• “日期”- 选择此类型后，便可指定预期格式（可选）。
  备注：

  如果要添加预期格式，请使用符合 MSDN 的格式。

  提取程序可能会使用此格式，并且在尝试将日期解析为日、月和年等组成部分时，数据提取作用域活动也会使用此格式。

• 名称
• 地址
• “集合” - 选择此类型后，您可以从预先建立的列表中向字段添加多个值。
• 布尔值
• “表格”- 选择此类型后，便可编辑表格结构，其中包括添加列及编辑列名称和类型。
  
  

  

  
  

详细信息选项卡

创建新字段后，单击该字段以查看更多信息。 默认情况下，当您打开字段时，将显示“详细信息” 选项卡，允许您修改字段的名称、颜色或热键。 您还可以指定它是多值 (Is multi-value)，还是允许处理文档中没有证据的值 (Requires reference)。 多值选项允许字段具有多个值，而不受特定列表的限制。

有关如何使用这两个字段的更多信息，请查看以下说明：

• 为多值：如果某个字段设置为多值，则可以为该特定字段报告多个值。示例：您想要提取一个“总监列表”，其中的条目数量不定。想象一下像单列表这样的多值字段。
• 需要引用：当需要引用字段时，仅当您从验证站点中看到的文档中选择某些内容时，才可以为其添加值。对于要捕获可能在文档中不可见的值的特殊字段，您可以将“需要引用”切换到“关闭”。这样一来，用户即可添加值，而无需在文档中指定该值的来源位置。

您可以从“ 详细信息 ”选项卡中选择启用 验证程序注释 。通过设置验证者注释，人工验证者可以添加有关他们在验证期间做出的决策的注释。 您可以配置以下设置：

• “只读” ：如果启用，人工验证者可以将“ 验证站点 ” 中“ 提取 结果” 字段上设置的任何验证人备注视为消息。如果禁用（默认状态），则人工验证者还可以在“验证站点”中编辑该注释，从而将有关所做决策的信息传达回机器人。
• 文本：如果选择“文本”，则验证程序注释将在“验证站点” 中显示为文本消息（启用编辑时为可编辑文本）。 人工验证者可以在 “验证站点” 中查看、编辑或添加最多 200 个字符的消息。
• 选项：如果选择选项，则可以配置一系列单选按钮，人工验证者可以查看这些单选按钮，如果不是只读模式，则可以在“验证站点” 中进行选择。 您最多可以添加 10 个选项。

提示： 查看 UiPath.DocumentProcessing.Contracts 部分的“ 提取结果类 ”页面，详细了解与验证程序注释相关的两种方法（GetFieldValidatorNotes(<fieldId>) 和SetFieldValidatorNotes(<fieldId>, <validatorNote>) 。

可以使用旁边显示的“删除”按钮删除已创建的字段，也可以使用拖放功能对其进行重新排序。

通过选择“ 删除 ” 按钮，也可以从“详细信息” 窗口中删除字段。

重复以上步骤即可创建多个组、类别和文档类型，您后续还可使用“搜索”字段对其进行筛选。

规则选项卡

此处的字段规则可帮助您优化提取结果，并在运行工作流时自动对其进行验证。 它们的作用是提高提取效率，并通过突出显示需要在验证站点中注意的字段，帮助您轻松验证这些字段。 您可以创建多个应用于一个字段的规则。

您可以通过设置 评估者类型 和 严重性级别来定义规则。

评估者类型

使用“评估程序类型” 指定应如何评估已定义的规则。 您可以选择两种赋值器类型： AND和 OR。

评估者类型	描述	示例
AND	当需要执行所有规则时，请使用此赋值器类型。	规则 ：发票编号以 A 开头，以 X 结尾。 有效结果 : 有效字段值为 A123X。 无效结果 : 有效字段值为 A123。
或	只需执行其中一个规则。	规则 : 发票编号以 A 开头，或为 123。 无效结果 : 有效字段值为 A123、123。 无效结果 : 有效字段值为 234、1A23。

严重性级别

指示为字段定义的所有规则的重要性。 如果在验证站点会话中违反规则，则无法设置 MUST 级别。 您可以从两个关键性级别中选择：“ 必须”、“ 应该”。

识别出设置的严重性级别后，将触发创建的规则。

当您要提交规则时，“ 必须 ”规则要求 100% 成功，否则“ 提交 ”操作将失败。 “ 应该 ”规则允许您 提交 ，即使该规则已被破坏。

您始终可以使用“ 提取结果类 ”类中的帮助程序方法（该类位于 UiPath.DocumentProcessing.Contracts 活动包中）来检查规则是否被违反。

严重性级别	描述
MUST	当创建的规则必须包含在“提取结果”流程中时，请使用此严重性级别。
SHOULD	当创建的规则是可选的时，请使用此严重性级别。

选择“ 评估者类型 ” 和“ 严重性级别” 后，您必须设置适用于新创建规则的类型。 您可以选择多个选项。 以下是所有可用列表的完整列表：

• 不为空
• 可能的值
• 开头为
• 结尾为
• 包含
• 定长
• 是电子邮件
• 正则表达式
  注意： 您为其创建规则的字段类型决定了您可以从中选择一个的可能规则类型的数量。 例如，文本类型的字段显示所有可能的规则类型，而日期类型的字段仅显示两种规则类型，即非空和可能的值。

规则类型

以下是所有可用规则类型的列表，并根据严重性级别进行分类：

规则类型	描述	字段类型	严重性级别	评估者类型
不为空	提取的值不能为空，这意味着该字段为必填字段。 如果缺少该值，则需要验证/手动输入。	适用于以下类型的字段： 数字 text 日期 地址 name SET boolean	MUST SHOULD	AND 或
可能的值	用户定义了所有可能的值，提取的数据是创建规则时作为输入添加的值之一（例如 “雇主类型”为“全职”、“非全日制”或“实习”）。	适用于以下类型的字段： 数字 text 日期	MUST SHOULD	AND 或
表达式	定义用作提取数据规则的数学表达式。	适用于以下类型的字段： 数字 配置规则时，条件为必填项。 选择以下选项之一： 等于 不等于 大于 大于或等于 小于或等于 数学表达式为必填项。 使用预定义的运算符定义表达式。 以下是一些示例： 总数量 * 净单价\n- 总计 = 小计 + 交货 折扣 - “求和”运算符收集表格列中的所有值。	MUST SHOULD	AND 或
开头为	这是一个固定规则，这意味着提取的值需要以用户添加的其中一个值开头。	适用于以下类型的字段： text 地址 name	MUST SHOULD	AND 或
结尾为	这是一个固定规则，意味着提取的值需要以用户添加的其中一个值结尾。	适用于以下类型的字段： text 地址 name	MUST SHOULD	AND 或
包含	这是一个固定规则，表示提取的值需要包含用户添加的其中一个值。	适用于以下类型的字段： text 地址 name	MUST SHOULD	AND 或
定长	这是一个固定规则，意味着提取的值需要具有一定的固定长度。	适用于以下类型的字段： text 地址 name	MUST SHOULD	AND 或
是电子邮件	这是一个固定规则，表示提取的值需要以电子邮件格式写入。	适用于以下类型的字段： text 地址 name	MUST SHOULD	AND 或
正则表达式	这是一个固定规则，意味着提取的值需要包含与用户添加的其中一个值相似的正则表达式。	适用于以下类型的字段： text 地址 name	MUST SHOULD	AND 或

使用规则

我们通过一个实际示例来更好地理解这些规则的适用性。 以下是为字段创建新规则或一组规则的方法：

其他选项

正在编辑

您可以“编辑”已创建的任何组、类别或文档类型的名称。这可以通过选择三个配置级别中的其中一个级别，然后编辑“名称”字段来完成。

正在删除

您也可以删除组、类别和文档类型。有两个可用选项：

• 单击按钮
  
  

  

  
  
• 单击窗口右上方的“删除” 按钮。
  
  

  

  
  

在这两种情况下，系统都会显示一个弹出窗口，要求您确认删除操作。 单击“ 删除 ”以批准上述 GIF 中所示的操作。

自定义和辅助功能

热键和颜色会自动分配给新创建的字段。您可以使用它们来提高可见性并更快地浏览分类。通过单击热键或颜色代码字段来自定义它们。

带有颜色和热键的自定义字段可以指示验证站点和模板管理器在显示字段时使用指定的颜色，并将指定的热键用作为字段提供值的快捷方式。您可以在此处找到有关如何使用字段快捷方式为字段分配值的更多信息。

使用键盘快捷方式浏览分类管理器。 激活“ 切换键盘快捷方式 ” 选项，以避免意外触发键盘快捷方式。 也可以一键折叠节点。

这是所有可用键盘快捷方式的绝佳视图。

注意：您在分类管理器中所做的更改将自动保存到特定于项目的 taxonomy.json 文件中。