UiPath Marketplace 用户指南

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

获取频道

使用搜索参数 (QueryOptions) 和指定的团队 (TeamId)， 获取频道 活动调用 Microsoft Graph 列表频道 API 以检索与查询匹配的频道。

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

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

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

活动的显示名称。

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

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

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

要在检索频道列表时应用的搜索参数。

属性	详细信息
类型	`QueryOption[]` （OData 语法）
必填	否
默认值	空白
允许的值	输入 `QueryOption[]` 或 `QueryOption` 变量。
注意	使用 OData 系统查询选项输入值；格式如下： `_{New QueryOption("Option", "OptionParameter")}` 。例如，如果要应用 `$filter` 选项，则应输入“filter”作为第一个字符串，然后输入筛选参数作为第二个字符串（例如`{New QueryOption("filter", "displayName ne 'General'")}` 。

与 “查询选项” 值匹配的频道数组（ Channel[] 对象）。

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