目录
兼容性:企业微信 3.1.8 开始支持
返回 ticket 的选人接口。
用于第三方应用唤起选择企业通讯录成员,用户选择的范围区分成两部分回传给第三方应用:
ww.selectPrivilegedContact({
fromDepartmentId: -1,
mode: 'multi',
selectedContextContact: 1
selectedOpenUserIds: ['xxx', 'yyy'],
selectedTickets: ['ticket1', 'ticket2']
})
本接口必须使用应用身份进行注册
仅第三方应用(非通讯录应用)可调用
属性 | 类型 | 必填 | 说明 | 最低版本 | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
fromDepartmentId | number | 是 | 从指定的部门开始展示
| |||||||||||
mode | string | 是 | 选择模式 | |||||||||||
| ||||||||||||||
selectedContextContact | boolean | 是 | 是否勾选当前环境的参与者 例如在群「+」号打开,默认勾选当前群成员 | |||||||||||
selectedOpenUserIds | string | 否 | 已选用户 OpenID 列表 仅在 mode 为 multi 时支持 | 企业微信 3.1.12 | ||||||||||
selectedTickets | string[] | 否 | 已选Ticket列表 仅在 mode 为 multi 时支持 | 企业微信 3.1.12 | ||||||||||
success | Function | 否 | 成功回调 | |||||||||||
fail | Function | 否 | 失败回调 | |||||||||||
cancel | Function | 否 | 取消回调 | |||||||||||
complete | Function | 否 | 完成回调 |
Promise<Object>
属性 | 类型 | 必填 | 说明 | |||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
errMsg | string | 是 | 通用错误信息 | |||||||||||||||||||||||||||||||||||||||||
errCode | number | 是 | 通用错误码 | |||||||||||||||||||||||||||||||||||||||||
result | Object | 是 | 当调用成功时返回,对应用户选择的内容 | |||||||||||||||||||||||||||||||||||||||||
|
wx.invoke("selectPrivilegedContact", {
"fromDepartmentId": -1,// 必填,表示打开的通讯录从指定的部门开始展示,-1表示自己所在部门开始, 0表示从最上层开始
"mode": "multi",// 必填,选择模式,single表示单选,multi表示多选
"selectedContextContact": 1 // 是否勾选当前环境的参与者。例如在群+号聊天附件栏打开,默认勾选当前群成员。
"selectedOpenUserIds"["xxx","yyy"], // 非必填,已选用户OpenID列表。single模式忽略该参数。
"selectedTickets"["ticket1","ticket2"] // 非必填,已选ticket列表。single模式忽略该参数
},function(res){
if (res.err_msg == "selectPrivilegedContact:ok")
{
var selectedUserList = res.result.userList; // 已选的成员列表
for (var i = 0; i < selectedUserList.length; i++)
{
var openUserId = selectedUserList[i].openUserId; //成员openUserId
}
var selectedTicket = res.result.selectedTicket; // 已选的集合Ticket
var expiresIn = res.result.expiresIn; // ticket有效期
var selectedUserCount = res.result.selectedUserCount; // 用户选中的用户个数
}
}
);