调用前提:
必须先调用过wx.qy.login,且session_key未过期,开发者可调用checkSession 检查当前登录态
当前成员必须在应用的可见范围
打开通讯录选人功能
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
fromDepartmentId | Number | 是 | 表示打开的通讯录从指定的部门开始展示,-1表示自己所在部门开始, 0表示从最上层开始 |
mode | String | 是 | 选择模式,"single"表示单选,"multi"表示多选 |
type | Array | 是 | 选择限制类型,指定"department"、"user"中的一个或者多个 |
selectedDepartmentIds | Array | 否 | 已选部门ID列表。用于多次选人时可重入 |
selectedUserIds | Array | 否 | 已选用户ID列表。用于多次选人时可重入 |
success | Function | 否 | 接口调用成功的回调函数 |
fail | Function | 否 | 接口调用失败的回调函数 |
complete | Function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
参数
Object res
参数 | 类型 | 说明 |
---|---|---|
departmentList | Array | 已选的部门列表 |
userList | Array | 已选的成员列表,不在应用可见范围内的成员userid不返回 |
wx.qy.selectEnterpriseContact({
fromDepartmentId: -1,// 必填,-1表示打开的通讯录从自己所在部门开始展示, 0表示从最上层开始
mode: "single",// 必填,选择模式,single表示单选,multi表示多选
type: ["department", "user"],// 必填,选择限制类型,指定department、user中的一个或者多个
selectedDepartmentIds: ["2","3"],// 非必填,已选部门ID列表。用于多次选人时可重入
selectedUserIds: ["lisi","lisi2"],// 非必填,已选用户ID列表。用于多次选人时可重入
success: function(res) {
var selectedDepartmentList = res.result.departmentList;// 已选的部门列表
for (var i = 0; i < selectedDepartmentList.length; i++)
{
var department = selectedDepartmentList[i];
var departmentId = department.id;// 已选的单个部门ID
var departemntName = department.name;// 已选的单个部门名称
}
var selectedUserList = res.result.userList; // 已选的成员列表
for (var i = 0; i < selectedUserList.length; i++)
{
var user = selectedUserList[i];
var userId = user.id; // 已选的单个成员ID
var userName = user.name;// 已选的单个成员名称
var userAvatar= user.avatar;// 已选的单个成员头像
}
}
});
注:user.name、user.avatar与department.name从2019年12月30日起,对新创建第三方应用不再返回,2020年6月30日起,对所有历史第三方应用不再返回,第三方页面需要通过通讯录展示组件来展示名字