Box 作用域

UiPath.Box.Activities.BoxScope

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

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

After creating your Custom App, you select the type of authentication that you want to use (Authentication Type) and enter the location of your configuration file (Config File Path) or the contents of the file (Config File Content) into the Box Scope activity if you are using JWT authentication or enter the (Client ID) and (Client Secret) if you are using OAuth Authentication.

After establishing a connection, a parent Box Scope activity can output a record of the connection in a BoxClient object (Box Connection) that you can use in subsequent child scope activities.

工作方式

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

1. 完成设置步骤。
2. Add the Box Scope activity to your project.
3. 输入“输入”和“JWT 身份验证”属性的值（如果使用 JWT）。
4. 为“输出”属性创建并输入BoxClient变量。

   • You can use this variable in subsequent uses of the Box Scope activity.

     

属性

常见

• ContinueOnError - Specifies if you want the activity to continue running when an error is thrown. This field supports only Boolean values.
• “显示名称”- 活动的显示名称。此字段仅支持 Strings 或 String 变量。

现有连接

• Box Connection - A connection record from a parent Box Scope activity that you can use instead of establishing a new connection. This field supports only BoxClient variables.
  • The BoxClient variable must be from a previously run Box Scope activity (parent) that still has an active connection.
  • If you're unable to establish a connection using this property, try re-running your parent Box Scope activity.

输入

• AuthenticationType - The type of authentication that you want to use to connect to your Custom App. Select one of the three items from the drop-down list:
  • JWT - To specify JWT Authentication. Required for the first run of the Box Scope activity (i.e., parent scope).
  • OAuth - To specify OAuth authentication. Required for the first run of the Box Scope activity (i.e., parent scope).
  • BoxConnection - Optional for subsequent runs of the Box Scope activity within the same automation project that includes a parent scope.

JWT 身份验证

• 配置文件内容- String对象中 JSON 配置文件的内容。此字段仅支持Strings和String变量。有关配置文件的更多信息，请参阅 Box设置指南。
• 配置文件路径- 下载的配置文件的位置。此字段仅支持Strings或String变量。有关配置文件的更多信息，请参阅 Box设置指南。
• User ID - The ID of the user account that you want to use for authentication. This field supports only Strings or String variables. If left empty, authentication is done for the service account.

其他

• Private - If this checkbox is selected, the values of variables and arguments are no longer logged at Verbose level.

OAuth 2 身份验证

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

输出

• Box Connection - A record of your established connection that you can use in other Box Scope activities that are included in this scope activity. This field supports only BoxClient variables.

  备注：

  您可以将此变量传递给父作用域活动中工作流中的作用域活动。例如，您可能有 3 个工作流。第一个示例包括父作用域活动，用于与已注册的应用程序（即父工作流）建立连接。第二个工作流创建新的联系人记录，第三个工作流创建新的客户记录；两者都包含在父作用域活动中。运行工作流时，父作用域活动会将BoxClient变量传递给第二个和第三个工作流中的现有连接“BoxConnection”属性（请参见下图）。