传统集成活动

上次更新日期 2025年10月6日

获取频道

概述

“ 获取频道” 活动调用 Microsoft Graph 获取频道 API，以从团队 (TeamId) 检索指定频道 ( ChannelId ) 的属性和关系。

检索到频道后，该活动会在 Channel 对象 (频道) 中返回其属性和关系，您可以在后续活动中将其用作输入变量（例如，获取消息、发送消息等中的Channel.Id ）。

与使用指定的查询选项搜索并返回频道列表 (Channel[]) 的获取频道活动不同， 获取频道 活动使用提供的频道 ID 和 团队 ID检索单个指定的频道 (Channel)。此活动不能像“获取频道”活动那样用于搜索频道，并且只能在 Channel.Id 值已知时使用。

工作方式

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

完成设置步骤。
将“ Microsoft Teams 作用域”活动添加到您的项目中。
添加一个活动或运行输出 Team.Id 值的外部流程（例如，获取团队），以及一个输出 Channel.Id 值的活动或外部流程（例如，创建频道）。
在 Microsoft Teams 作用域 活动中添加获取频道活动。
输入“ 输入 ”属性的值。
为“ 输出 ”属性创建并输入 Channel 变量。
运行活动。
- 您的输入属性值将发送到“获取频道”API。
- API 会将 Channel 值返回到您的输出属性变量。

属性

将此活动添加到 UiPath Studio 中的项目时，会指定以下属性的值。

常见

显示名称

活动的显示名称。

属性	详细信息
类型	`String`
必填	是
默认值	获取频道
允许的值	输入 `String` 或 `String` 变量。
注意	不适用

输入

团队 ID

要从中检索频道的 Team 对象的 ID。

属性	详细信息
类型	`String`
必填	是
默认值	空白
允许的值	输入 `String` 或 `String` 变量。
注意	要获取 `Team.Id` 值，请使用输出中包含 `Team.Id` 值的外部流程或活动（例如，创建团队或外部 API 调用）

频道 ID

要检索的 Channel 对象的 ID。

属性	详细信息
类型	`String`
必填	是
默认值	空白
允许的值	输入 `String` 或 `String` 变量。
注意	要获取 `Channel.Id` 值，请使用输出中包含 `Channel.Id` 值的外部流程或活动（例如，创建频道或外部 API 调用）

其他

私有

如果已选择，变量和参数的值将不会在 Verbose 级进行记录。

属性	详细信息
类型	复选框
必填	否
默认值	未选中
允许的值	已选择或未选择
注意	不适用

输出

频道

表示检索到的频道的 Channel 对象。

属性	详细信息
类型	`Channel`
必填	否（如果您计划在后续活动中使用输出数据，则为必填项）
默认值	空白
允许的值	输入`Team`变量。
注意	您为此属性创建的变量可用作后续活动中的输入变量（例如，“获取消息”、“ 发送消息”等中的`Channel.Id` ）。 `Channel` 对象包含多个属性和关系，您可以在其他活动中使用这些属性和关系。下面的示例图像显示了您可以返回的一些属性。注意 - 设计器中列出的某些属性不适用于 `Channel` 对象（例如`Visibility` ）。有关适用的 `Team` 属性的列表，请访问上面的链接。