第三方应用开发 客户端API 小程序 企业通讯录 wx.qy.selectEnterpriseContact
wx.qy.selectEnterpriseContact
最后更新:2024/03/28
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
wx.qy.selectEnterpriseContact
最后更新:2024/03/28

wx.qy.selectEnterpriseContact(Object object)

调用前提:
必须先调用过wx.qy.login,且session_key未过期,开发者可调用checkSession 检查当前登录态
当前成员必须在应用的可见范围

打开通讯录选人功能

参数

Object object
参数名类型必填说明
fromDepartmentIdNumber表示打开的通讯录从指定的部门开始展示,-1表示自己所在部门开始, 0表示从最上层开始
modeString选择模式,"single"表示单选,"multi"表示多选
typeArray选择限制类型,指定"department"、"user"中的一个或者多个
selectedDepartmentIdsArray已选部门ID列表。用于多次选人时可重入
selectedUserIdsArray已选用户ID列表。用于多次选人时可重入
successFunction接口调用成功的回调函数
failFunction接口调用失败的回调函数
completeFunction接口调用结束的回调函数(调用成功、失败都会执行)

 

object.success 回调函数

参数

Object res

参数类型说明
departmentListArray已选的部门列表
userListArray已选的成员列表,不在应用可见范围内的成员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日起,对所有历史第三方应用不再返回,第三方页面需要通过通讯录展示组件来展示名字
上一篇
wx.qy.getContext
下一篇
wx.qy.openUserProfile