Document Understanding 活动

表单提取程序

描述​

项目兼容性​

配置​

属性面板​

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

• ApiKey - Specifies the API key of the account. The API Key field is automatically pre-populated if defined in local project settings or in the Document Understanding framework.
• 端点- UiPath™ 服务器的 URL。默认情况下，端点为https://du.uipath.com/svc/formextractor 。有关更多信息，请访问Document Understanding 公共端点。
• MinOverlapPercentage - Specifies the minimum overlap area (in percentage) between a box in the document and a box in the template required to make an extraction. The percentage value can be set between 0 and 100. The default value is 65.
• Timeout - Specifies the amount of time (in milliseconds) to wait for a response from the server before an error is thrown. The default value is 100000 milliseconds (100 seconds).

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

  Multiple templates can be defined for one Document Type. When the activity is run, the extractor selects the best matching template based on the information found on the first page.

模板管理器向导​

创建模板​

1. 在“数据提取作用域”内，向工作流添加“表单提取程序”活动。

2. 通过选择“管理模板”来配置提取程序。

   系统将打开“模板管理器”窗口。

   图 1.“模板管理器”向导概览

   

3. 选择“创建模板”以创建新模板。图 2. “新建模板”配置字段概览

   

   备注：

   如果 UiPath.IntelligentOCR.Activities 程序包已更新到 v5.1.0，则强制应用 OCR 参数已替换为将 OCR 应用于 PDF 参数。以下是新旧参数之间的兼容性：

   • “强制应用 OCR = True”替换为“将 OCR 应用于 PDF = 是”；
   • “强制应用 OCR = False”替换为“将 OCR 应用于 PDF = 自动”；
   • “强制应用 OCR =空白”替换为“将 OCR 应用于 PDF =自动” ；
   • “强制应用 OCR = <user-defined variable>替换为“将 OCR 应用于 PDF =自动” 。

   “将 OCR 应用于 PDF”选项确定是否应将 OCR 流程应用于 PDF 文档。下拉列表中提供三个选项： True 、 False和自动。如果设置为True ，则 OCR 将应用于文档的所有 PDF 页面。如果设置为False ，则仅提取数字输入的文本。默认值为“自动” ，根据输入文档确定文档是否需要应用 OCR 算法。每个 OCR 引擎都有自己的自定义选项集。请访问OCR 引擎，了解有关每个 OCR 引擎可用的所有选项的更多详细信息。默认的 OCR 引擎是UiPath 文档 OCR 。

4. 从“文档类型”下拉列表中选择模板的文档类型。

   备注：

   所有文档类型均基于分类。确保在项目文件夹中添加或创建分类。

5. 在“模板名称”字段中添加模板的名称。选择反映文档版本或版式的相关名称。

6. 在“模板文档”字段中添加文档的路径。使用“浏览”选项导航到文件的路径。

7. 从“OCR 引擎”下拉列表中选择一个 OCR，并根据需要进行配置。

8. 选择“配置”以触发模板编辑。

配置布尔值字段处理​

导出和导入模板​

导出程序​

1. 按照本页开头说明的步骤创建一个或多个模板。

2. 选择要导出的模板。

3. 选择“导出”选项：

   1. 与原始文件一起导出与原始文件一起导出会将原始文件附加到导出文件中。

   2. 不带原始文件导出

      图 5.选择“使用原始文件导出”选项的操作

      

4. 使用所需名称保存模板的存档。

5. 保存模板后，系统将显示一条消息。选择“确定”。

   图 6. “X 个模板已成功导出”消息

   

   备注：

   如果您无法共享构建模板时依据的文档内容，请使用“不带原始文件导出”选项。您仍然可以在其他项目中共享和导入模板档案，但无法再编辑或查看模板档案。

   在将模板导入到其他项目后，如果您希望能够再编辑该模板，请确保在导出时以及之后导入时使用“不带原始文件导出”选项。

导入程序​

1. 选择“导入”。

   图 7.在“模板管理器”向导中选择“导入”的操作

   

2. 选择存档。导入向导随即出现，并显示所选导出存档中的所有文档类型和所有可用模板。选择要导入的模板，然后选择所需的“导入”选项：

   1. 带原始文件导入

   2. 不带原始文件导入图 8.“模板管理器”向导中的“导入”选项

      

      备注：

      • 导入模板时，将在项目的分类中自动创建文档类型。如果已经存在名称相同的文档类型，则通过将计数附加到文档类型名称来创建另一个文档类型。
      • 如果要导入已导出但不包含原始文件的模板，或者您选择导入不包含原始文件的模板，则这些模板没有查看或编辑选项。

导入模板时的特殊情况​

• 新文档类型：如果导入了新的文档类型，则会在向导配置器中添加一个新字段，通知您将创建一个新模板。
• 复制文档类型：如果导入相同的文档类型，则会显示“此模板已存在，且会被覆盖”的警告消息。
• 扩展模板：如果导入的文档类型模板包含比现有文档类型更多的字段，则会显示“此文档类型将进行如下更新：以下字段不存在，系统将创建相应字段”的警告消息。
• 扩展文档类型：如果用户导入的文档类型包含的字段比现有字段多，则会出现“此文档类型将进行如下更新：以下字段没有要导入的配置”的警告消息。
• 名称相同但内容不同的文档类型：如果用户导入的文档类型与现有文档类型名称相同但字段不同，则系统会显示以下警告消息：“此文档类型将进行如下更新”：
  • “以下字段不存在，系统将创建相应字段”
  • “以下字段没有要导入的配置”
• 包含缺失的表格的文档类型：如果用户导入的文档类型不包含表格，则会显示“此文档类型将进行如下更新：以下字段没有要导入的配置”的警告消息。
• 包含扩展表格的文件类型：如果用户导入的文档类型所包含的表格具有额外列，则会显示“此文档类型将进行如下更新：以下字段不存在，系统将创建相应字段”的警告消息。
• 包含不完整表格的文档类型：如果用户导入的文档类型包含列缺失的表格，则会显示“此文档将进行如下更新：以下字段没有要导入的配置”的警告消息。
• 具有不同文档类型的表格模板：如果导入的文档类型模板包含具有不同文档类型的表格，则系统将创建一个新模板。如果您的分类包含一个表格，并且该表格中的一个字段具有不同的文档类型，则会显示以下消息：“ID 为xyz字段同时显示在导入分类和现有分类中，但它们的类型不兼容（两者都应为表格，或者两者都不是)。"

模板编辑器向导​

一般注意事项​

• ：设置锚点选择模式；
• ：清除整个锚点选择。

配置锚点​

配置简单字段​

配置表格​

• 逐一定义每个单元格，方法是在展开表格编辑器后，分别向每个单元格添加“自定义区域”选择；
• 使用表格标记功能 - 通过标记表格区域、绘制行和列分隔符，然后将如此标记的表格分配给字段。确保提取的区域具有与模板区域相同的列数和行数。

1. 选择表格字段的“更多选项”
2. 选择“提取新表格” 。
3. 选择要提取的表格。
4. 对于每个表格列上方的每个字段，选择要字段表示的列名称。您也可以选择“提取标头” 。
5. 最后，选择“保存新表格” 。

锚点配置​

• 确定页面级别模板是否匹配，并根据其确定为最匹配的页面级别模板提取信息；
• 确定任何基于锚点的设置是否匹配，并根据这些设置在待处理文档中的应用提取信息；
• 计算所有可能匹配项的相应置信度分数，以便报告所有可用选项的最佳结果（概率最高的匹配项）。

创建新的锚点设置​

1. Make sure you are in the Anchor Selection mode.

2. 在值区域周围绘制一个方框。

3. 使用以下方法之一为值区域选择标签（主锚点）：

   • 选择第一个单词，然后对所选内容的最后一个单词使用 Ctrl + Select。
   • 选择，拖动，然后释放以捕获词范围。
     备注：

     标签只能包含同一视觉行中的连续词。

4. 选择将用于唯一标识您的标签的任何其他锚点。相同的选择原则也适用。

5. 通过选择特定字段的“提取值”，将锚点结构分配给相应字段。

   图 12. 为一个字段创建多个锚点的示例

   

   备注：

   您还可以使用此页面之前的示例来了解如何创建模板以及定义提取区域和锚点。

编辑现有锚点设置​

1. 高亮显示您的锚点设置。

2. 对其进行更改（根据需要删除任何锚点或标签，甚至是删除值区域，以及添加新元素等）。

3. 为字段锚点选择“更多选项” ，然后使用“更改提取值”选项更新字段关联。图 13.更改字段的提取值的示例

   

   备注：

   • 如果删除目标区域，则会删除所有锚点，并且您需要重新开始。
   • 如果删除标签（主锚点），则第一个锚点（按照创建顺序）将变为新标签。

删除现有锚点设置​

• 对字段锚点选择“更多选项” ，对已保存的值使用“标记为缺失”选项。

  图 14.使用“标记为缺失”选项删除锚点设置的示例

  

• 如果是给定字段定义的一系列锚点，则为字段锚点选择“更多选项” ，然后使用“删除值”选项。

  图 15.使用“移除值”选项删除锚点设置的示例

  

混合和匹配配置​

Document Understanding 集成​