使用来自不同环境的模型

使用Document Understanding ^TM新式项目时，您需要配置外部应用程序以访问各种租户和组织的模型。

此过程全面介绍了如何使用外部应用程序访问部署在不同环境中的模型。它包括分步说明：配置外部应用程序的访问权限，设置 Studio 工作流以使用这些模型，以及建立生产工作流。

此功能还允许您在混合部署环境中使用模型。在这种情况下，Document Understanding 项目在Automation Cloud ^TM上配置，而 Orchestrator 和机器人则部署在内部部署。

1. 配置外部应用程序
2. 配置 UiPath Studio 工作流
3. 将模型版本配置为参数
4. Document Understanding 流程模板

配置外部应用程序

1. 导航到您的 Automation Cloud 租户。
2. 转到“管理”页面，然后选择您的组织。
3. 转到“外部应用程序”页面。
   
   

   

   
   
4. 在“外部应用程序” 页面中选择“添加应用程序” 。
   提示：有关添加外部应用程序的更多信息，请查看 Automation Cloud 管理员指南中的“管理外部 OAuth 应用程序”页面。
5. 在“应用程序名称”字段中键入应用程序的唯一名称。
6. 从“应用程序类型”部分选择应用程序类型：
   • 机密应用程序：适用于安全存储应用程序密码。使用此选项满足高安全性要求。
   • 非机密应用程序：仅在不需要安全存储应用程序密码时使用此选项。
   
   

   

   
   
7. 定义外部应用程序的访问作用域。
   1. 从“资源” 部分中选择“添加作用域” 。
   2. Document Understanding从“资源” 下拉列表中选择 。
   3. 配置用户作用域以在用户上下文中授予权限。

      在“用户作用域”选项卡中，选中与要根据要求授予的逻辑 API 权限对应的复选框。如果您在用户作用域下授予权限，则意味着外部应用程序可以在用户上下文中访问这些资源。因此，必须具有相应权限的用户登录。

   4. 配置应用程序作用域，以提供应用程序级别的访问权限，从而满足更广泛的自动化需求。

      如果您使用的是机密应用程序，请导航到“应用程序作用域”选项卡，以根据需要为所选资源分配应用程序级别的权限。通过委派应用程序作用域下的权限，外部应用程序可以访问选定作用域中的数据，而无需任何用户交互。

      非机密应用程序无法访问应用程序作用域。

      
      

      

      
      
   5. 选择“保存”。
      注意：如果您已注册具有用户作用域的外部应用程序，请添加“重定向 URL” 。此 URL 将接收授权响应。但是，如果您仅选择了应用程序作用域，则可选择提供重定向 URL。
8. 选择“添加”以创建注册。

   系统会显示确认消息。对于机密应用程序，此消息包含应用程序密码。已注册的外部应用程序可以使用此密码来请求授权。确保将应用程序密码保存在安全的位置，因为您将无法再次看到它。

   
   

   

   
   

配置 UiPath Studio 工作流

开始之前，请确保满足以下先决条件：

• 使用兼容的Windows 项目版本。
• 请确保已安装“智能 OCR”活动包。IntelligentOCR.Activities包支持使用 Document Understanding 新式项目 (从v6.22.1开始)。

提示：

有关DocumentUnderstanding.Activities和IntelligentOCR.Activities包之间的区别的更详细信息，以及有关何时使用每个包的指南，请查看“Document Understanding 中的自动化”页面。

1. 打开UiPath Studio项目。
2. 定义分类。
   1. 打开分类管理器，为自动化定义相关文档类型和字段。

      您的项目分类应包含每种文档类型和必填字段。您在 Studio 中创建的分类可以包含不属于 Document Understanding 新式项目的其他文档类型和字段。如果您希望对各种文档类型使用其他提取程序（例如表单提取程序或正则表达式提取程序） ，则需要执行此步骤。

      
      

      

      
      
3. 安装IntelligentOCR.Activities包，以使用Document Understanding 项目提取程序和Document Understanding 项目分类器等活动。
   1. 添加“数据提取作用域”活动以配置提取模型，并加入 Document Understanding 项目提取程序活动。
      
      

      

      
      
   2. 添加“分类文档作用域”活动以配置分类模型，并将 Document Understanding 项目分类器活动包含在内。
4. 配置设计时凭据。
   1. 从活动作用域中打开“获取功能”向导。
      当您将Document Understanding 项目活动纳入该作用域时，系统将显示向导。此向导允许您配置映射新式项目的分类字段所需的设计时凭据。
   2. 填写以下信息：
      • 外部应用程序中的应用程序 ID和应用程序密码。
      • 目标环境的租户 URL 。
   3. 选择“获取项目” ，然后选择所需的项目和版本。
   4. 关闭向导。
   
   

   

   
   
5. 映射分类。
   1. 在“数据提取作用域” 活动中选择“配置提取程序” 。
   2. 为每个文档类型创建项目分类到模型分类的映射。
      要执行此步骤，请从分类中选择“文档类型”，并将此文档类型中的每个字段与为 Document Understanding 项目设计的模型中的相应字段对齐。
   
   

   

   
   
6. 将运行时凭据另存为 Orchestrator 资产。
   1. 导航到您的 Automation Cloud 租户。
   2. 转到“Orchestrator” 。
   3. 选择您的自动化文件夹。
   4. 转到“资产”选项卡。
   5. 选择“添加资产” ，然后从下拉列表中选择“创建新资产” 。
   6. 在“资产名称”字段中键入名称。
   7. 从“类型” 下拉列表中选择“凭据” 。
   8. 使用先前创建的 应用程序 ID 和应用程序密码作为用户名和密码。
   
   

   

   
   
7. 在 Studio 中配置运行时凭据。
   1. 导航至 Studio 项目。
   2. 转到“数据提取作用域”活动。
   3. 配置“运行时凭据资产”属性。
      在机器人连接到本地 Orchestrator 或来自其他租户时，请使用此字段访问 Document Understanding 新式项目资源。您可以通过以下方式之一选择输入凭据资产以进行身份验证：

      • 从下拉列表中选择机器人连接到的 Orchestrator 中的所需凭据资产。
      • 输入您在其中存储了访问项目的外部应用程序凭据的 Orchestrator 凭据资产的路径。路径格式必须如下： <OrchestratorFolderName>/<AssetName> 。
   4. 配置“运行时租户 URL”属性。
      将此字段与“运行时凭据资产”属性一起使用。输入机器人将连接以执行提取的租户的 URL。URL 必须采用以下格式： https://<baseURL>/<OrganizationName>/<TenantName> 。

外部应用程序提供对租户内所有 Document Understanding 项目的访问权限。您无需单独为每个项目配置访问权限。

将模型版本配置为参数

如果将项目版本配置为参数，则可以更新新项目版本的自动化工作流，而无需调整工作流代码。

1. 导航到您的 Automation Cloud 租户。
2. 转到“Orchestrator” 。
3. 选择您的自动化文件夹。
4. 转到“资产”选项卡。
5. 选择“添加资产” ，然后从下拉列表中选择“创建新资产” 。
6. 在“资产名称”字段中键入名称。
7. 从“类型” 下拉列表中选择“文本” 。
8. 在“文本”字段中键入名称以定义特定于版本的资产。
   
   

   

   
   
9. 选择“创建”。
   这使您可以更新新项目版本的自动化工作流，而无需更改工作流代码。将自动化部署到指定的文件夹时，将根据 Orchestrator 中的资产设置模型版本。此过程类似于将外部应用程序凭据另存为资产。
10. 导航至 Studio 项目。
11. 在工作流中添加“获取资产”活动，以检索版本资产。
12. 将检索到的值作为输入变量传递到Document Understanding 项目活动。
    
    

    

    
    

Document Understanding 流程模板

Document Understanding 流程是一个功能齐全的 UiPath™ Studio 项目模板，基于文档处理流程图。您可以使用它开始处理 Document Understanding^TM 的演示或大规模实施。

该流程提供日志记录、异常处理、重试机制以及应在“Document Understanding”工作流中使用的所有方法，且开箱即用。

有关更多信息，请查看Document Understanding 流程模板页面。