Box 作用域

UiPath.Box.Activities.BoxScope

Box 活动使用JWT 身份验证在 UiPath 和 Box 自定义应用程序之间建立连接。 此连接授权机器人代表您调用 Box API 和访问资源。

要启用身份验证，您可以创建具有 JWT 身份验证的 Box 自定义应用程序。 创建应用程序后，Box 会生成一个配置文件，其中包含建立经过身份验证的连接所需的信息。 您还可以选择使用 OAuth 身份验证创建 Box 自定义应用程序。 有关更多信息，在构建第一个自动化项目之前，请参阅 设置 指南。

创建自定义应用程序后，选择要使用的身份验证类型（身份验证类型），并将配置文件的位置（配置文件路径）或文件内容（配置文件内容）输入到“ 框作用域 ”活动中如果您使用的是 JWT 身份验证，则输入 (客户端 ID) 和 (客户端密码)（如果您使用的是 OAuth 身份验证）。

建立连接后，父 框作用域 活动可以在 BoxClient 对象 (框连接) 中输出连接记录，您可以在后续子作用域活动中使用该对象。

工作方式

以下步骤和消息序列图是活动从设计时（即活动依赖项和输入/输出属性）到运行时如何工作的示例。

1. 完成 设置 步骤。
2. 将“ 框作用域 ”活动添加到您的项目中。
3. 输入“ 输入 ”和“ JWT 身份验证 ”属性（如果使用 JWT）的值。
4. 为“ 输出 ” 属性创建并输入 BoxClient 变量。

   • 您可以在后续使用“ 框作用域 ”活动时使用此变量。

     
     

     

     
     

属性

常见

• “错误时继续 ” - 指定是否希望活动在引发错误时继续运行。 此字段仅支持 Boolean 值。
• “显示名称”- 活动的显示名称。此字段仅支持 Strings 和 String 变量。

现有连接

• Box 连接 - 来自父 Box 作用域 活动的连接记录，您可以使用它来代替建立新连接。 此字段仅支持 BoxClient 变量。
  • BoxClient 变量必须来自先前运行的 Box 作用域 活动（父级），该活动仍具有活动连接。
  • 如果您无法使用此属性建立连接，请尝试重新运行父 框作用域 活动。

输入

• “身份验证 类型” - 要用于连接到自定义应用程序的身份验证类型。 从下拉列表中选择三个项目之一：

  • JWT - 指定 JWT 身份验证。 首次运行“ 框作用域 ”活动（即父作用域）时必需。
  • OAuth - 指定 OAuth 身份验证。 首次运行“ 框作用域 ”活动（即父作用域）时必需。
  • “框连接” - 对于在包含父作用域的同一自动化项目中后续运行“ 框作用域 ”活动是可选的。

JWT 身份验证

• 配置文件内容 - String 对象中 JSON 配置文件的内容。 此字段仅支持 Strings 或 String 变量。 有关配置文件的更多信息，请参阅 Box 设置 指南。
• 配置文件路径 - 所下载配置文件的位置。 此字段仅支持 Strings 或 String 变量。 有关配置文件的更多信息，请参阅 Box 设置 指南。
• “用户 ID ” - 要用于身份验证的用户帐户的 ID。 此字段仅支持 Strings 或 String 变量。 如果留空，系统将对服务帐户进行身份验证。

其他

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

OAuth 2 身份验证

• 客户端 ID - Box 应用程序的客户端 ID。 此字段仅支持 Strings 或 String 变量。 有关配置文件的更多信息，请参阅 Box 设置 指南。
• 客户端密码 - Box 应用程序的客户端密码。 输入 SecureString 或 SecureString 变量。 有关配置文件的更多信息，请参阅 Box 设置 指南。

输出

• Box 连接 - 已建立连接的记录，可在此作用域活动中包含的其他 Box 作用域 活动中使用。 此字段仅支持 BoxClient 变量。
  备注：

  您可以将此变量传递给父作用域活动内的工作流中的作用域活动。

  例如，您可能有 3 个工作流。 第一个包括与已注册应用程序建立连接的父作用域活动（即父工作流）。 第二个工作流创建一个新的联系人记录，第三个工作流创建一个新的客户记录；两者都包含在父作用域活动中。

  工作流运行时，父作用域活动会将 BoxClient 变量传递给第二个和第三个工作流中的现有连接 BoxConnection 属性（请参见下图）。