获取团队

概述

“获取 Teams” 活动使用搜索参数 ( 查询选项) 和指定的团队列表类型（“筛选 - 所有团队” 或“我已加入的团队” ），将调用 Microsoft Graph ListAllTeams 或 ListJoinedTeams API 以检索与您的查询匹配的团队。

检索团队后，该活动将在Team[]对象中输出其属性和关系，您可以在后续活动（例如，获取频道、更新频道中的Team(0).Id等）中将其用作输入变量。

工作方式

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

1. 完成设置步骤。
2. 将“Microsoft Teams 作用域”活动添加到您的项目。
3. 在“Microsoft Teams 作用域”活动中添加“获取 Teams”活动。
4. （可选）为输入属性输入值。
5. 为“输出”属性创建并输入Team[]变量。
6. 运行活动。

   • 您的输入属性值将发送到“列出所有团队” API 或“列出已加入团队” API。

   • API 会将 Team[] 值返回到您的输出属性变量。

     

属性

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

常见

显示名称

活动的显示名称。

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

输入

筛选

要检索的团队类型。

属性	详细信息
类型	下拉列表
必填	是
默认值	所有团队
允许的值	从两个选项中选择： “所有团队” - 返回组织中的所有团队。“我的已加入的团队” - 仅返回您所属的团队。
注意	下面的示例序列图像显示了两个选项的输出。

选项

查询选项

检索团队列表时要应用的搜索参数。

属性	详细信息
类型	QueryOption[] （OData 语法）
必填	否
默认值	空白
允许的值	输入 QueryOption[] 或 QueryOption 变量。
注意	使用OData 系统查询选项输入值）；格式如下：_{New QueryOption("Option", "OptionParameter")

其他

私有

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

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

输出

团队

与列表类型和查询选项值匹配的团队数组（ Team[]对象）。

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

示例

下图显示了活动依赖关系和输入/输出属性值的示例。

有关分步说明和示例，请参阅快速入门指南。