活动

Slack 作用域

UiPath.Slack.Activities.SlackScopeActivity

概述

SlackScope活动遵循OAuth 2.0协议，在 UiPath 和 Slack API 之间建立经过身份验证的连接。

在Slack 作用域活动建立连接之前，它需要获得授权，才能代表您执行操作并访问您允许的数据。要授予授权，您可以创建一个新的Slack 应用程序并将其安装到工作区（无需编码）。您无需通过 Slack 应用程序目录公开分发此应用程序，只需将其安装到要自动化的工作区中。

创建应用程序时，您需要分配作用域（即权限），以定义应用程序（以及随后的活动）可以调用的 API 方法以及可以访问的信息。

注册应用程序后，Slack 会分配您在“ Slack 作用域”活动中输入的唯一客户端 ID (ClientID)、客户端密码 (ClientSecret) 和 OAuth 访问令牌 (Token )，以启动连接。

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

根据自动化模式（无人值守或有人值守），“ Slack 作用域 ”活动有两种不同的身份验证模型。

无人值守自动化和有人值守自动化在 Slack 作用域 活动方面存在两个区别：作用域设置要求和允许访问。

作用域设置要求

如设置指南的添加应用程序权限部分所述，如果您计划运行 Unattended 自动化，则必须使用应用程序的 OAuth 和权限 功能设置来设置作用域。

如果要运行 Attended 的自动化，则不必（可以）使用应用程序的“ OAuth 和权限 ” 功能设置来设置作用域，而是使用“ 作用域 ” 属性来设置作用域（如下所述）。

为了在使用活动时获得最佳用户体验，建议您设置“使用应用程序的 OAuth 和权限 ”功能设置（如设置指南中所述）。通过提前设置作用域，您可以在构建和运行项目时在无人值守自动化和有人值守自动化之间自由切换。

允许访问

在有人值守的自动化期间运行“ Slack 作用域 ”活动时，系统将打开一个网页，提示您通过单击“ 允许 ”按钮，向应用程序授予对所选作用域的访问权限。

在无人值守自动化期间，系统会在后台以静默方式向您的应用程序授予访问权限（无需用户执行任何操作）。

“客户端 ID” -Slack 为您的应用程序分配的唯一 ID。输入 String 值。
- 此属性仅接受客户端 ID 的 String 值。它不支持 String 变量。
- 要查找您的客户端 ID，请转到所创建应用程序的 “基本信息 ” 页面。在“ 应用程序凭据 ”下，您将看到您的客户端 ID 和客户端密码。
“客户端密码 ” - 与您的客户端 ID 关联的唯一 ID。输入 String 值。
- 此属性仅接受客户端密码的 String 值。它不支持 String 变量。
- 要查找您的客户端密码，请转到应用程序的“ 基本信息 ” 页面。在“ 应用程序凭据 ”下，您将看到您的客户端 ID 和客户端密码。
令牌 - 应用程序的 OAuth 访问令牌，仅用于无人值守自动化。当您将应用程序安装到工作区时，Slack 会自动生成此令牌。输入 String 值。此属性仅接受 OAuth 访问令牌的 String 值。它不支持 String 变量。
- 要获取 OAuth 访问令牌，您必须首先将应用程序安装到工作区。安装应用程序后，转到应用程序的“ 已安装应用程序设置” 页面（如上图所示）。
- 有关更多信息，请参阅设置指南中的将应用程序安装到 WorkSpace 。

“作用域 ” - 要授予（或按照《设置指南》时之前授予的）应用程序的作用域的分类列表。选择所有适用的作用域。有 7 个作用域：PublicChannels、PrivateChannels、DirectMessages、GroupMessages、Users、Chat、Files。
- 有关作用域的完整列表及其到活动的映射以及上述允许的值，请参阅设置指南中的要添加的作用域。

“私有”- 选中后将不再以“Verbose”级别记录变量和参数的值。
“ReportApiErrorAsException” - 选中后，使用此应用程序作用域的所有子活动都会在 BusinessActivityExecutionException 中报告 API 错误响应。清除后，子活动将在“响应状态”输出属性中填充 API 错误消息，并继续执行工作流。检查 ResponseStatus 属性以确认成功执行。