获取聊天成员

概述

“获取聊天成员” 活动调用 Microsoft Graph 列表对话成员 API 来检索指定聊天 ( ChatId ) 的成员。

检索到成员后，该活动会在 ConversationMember[] 对象 (ChatMembers) 中返回成员属性数组，您可以在后续活动中将其用作输入变量。

工作方式

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

1. 完成 设置 步骤。
2. 将“ Microsoft Teams 作用域”活动添加到您的项目中。
3. 添加活动或运行输出 Chat.Id 值的外部流程（例如，获取聊天记录）。
4. 在 Microsoft Teams 作用域 活动中添加 获取聊天成员 活动。
5. 为“ 输入 ”属性输入一个值。
6. 为“ 输出 ”属性创建并输入 ConversationMember[] 变量。

7. 运行活动。

   • 您的输入属性值将发送到 ListConversationMembers API。
   • API 会将 ConversationMember[] 值返回到您的输出属性变量。
     
     

     

     
     

属性

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

常见

显示名称

活动的显示名称。

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

输入

ChatId

要从中检索成员列表的 Chat 对象的 ID。

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

其他

私有

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

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

输出

ChatMembers

指定聊天中的成员及其属性（ ConversationMember[] 对象）的列表。

属性	详细信息
类型	ConversationMember[]
必填	否（如果您计划在后续活动中使用输出数据，则为必填项）
默认值	空白
允许的值	输入ConversationMember[]变量。
注意	您为此属性创建的变量可用作后续活动中的输入变量。 ConversationMember 对象包含多个可在其他活动中使用的 属性 。 下面的示例图像显示了您可以返回的一些属性。

示例

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

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