# 通讯录选人

# 选人和选部门

# 使用说明

支持选人和选部门。选择部门后,把所选部门转换成对应部门下的人。

Android iOS PC
支持 支持 支持
yy.biz.contact.complexPicker({
  title: "测试标题", //标题
  corpId: "xxx", //企业的corpId
  multiple: true, //是否多选
  limitTips: "超出了", //超过限定人数返回提示
  maxUsers: 1000, //最大可选人数
  pickedUsers: [], //已选用户
  pickedDepartments: [], //已选部门
  disabledUsers: [], //不可选用户
  disabledDepartments: [], //不可选部门
  requiredUsers: [], //必选用户(不可取消选中状态)
  requiredDepartments: [], //必选部门(不可取消选中状态)
  appId: 158, //应用的Id
  //permissionType:"xxx",          //可添加权限校验,选人权限,目前只有GLOBAL这个参数
  //responseUserOnly:false,        //返回人,或者返回人和部门
  //startWithDepartmentId:0 ,   //仅支持0和-1
  onSuccess: function(result) {
    /**
        {
            selectedCount:1,                              //选择人数
            users:[{"name":"","avatar":"","userid":""}],//返回选人的列表,列表中的对象包含name(用户名),avatar(用户头像),emplId(用户工号)三个字段
            departments:[{"id":,"name":"","number":}]//返回已选部门列表,列表中每个对象包含id(部门id)、name(部门名称)、number(部门人数)
        }
        */
  },
  onFail: function(err) {}
});
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

# 参数说明

参数 参数类型 说明
title String 标题
corpId String 企业的 corpId
multiple Boolean 是否多选
limitTips String 超过限定人数返回提示
maxUsers Number 最大可选人数
pickedUsers Array[String] 已选用户
pickedDepartments Array[String] 已选部门
disabledUsers Array[String] 不可选用户
disabledDepartments Array[String] 不可选部门
requiredUsers Array[String] 必选用户 (不可取消选中状态)
requiredDepartments Array[String] 必选部门 (不可取消选中状态)
appId Number 应用 id
permissionType String 暂时没用  ,可不传选人权限,目前只有 GLOBAL 这个参数
responseUserOnly Boolean true:返回人员信息;
false:返回人员和部门信息
startWithDepartmentId Number 暂时没用,可不传 0 表示从企业最上层开始
-1 表示从自己所在部门开始

# 返回说明

参数 说明
selectedCount 选择人数
users 返回选人的列表,列表中的对象包含 name (用户名)、avatar (用户头像)、emplId (用户工号)三个字段
departments 返回已选部门列表,列表中每个对象包含 id (部门 id)、name (部门名称)、number (部门人数)

# 选择部门信息

# 使用说明

接口会返回部门的信息,是以部门为维度,不是以人为维度。

Android iOS PC
支持 支持 支持
yy.biz.contact.departmentsPicker({
  title: "测试标题", //标题
  corpId: "xxx", //企业的corpId
  multiple: true, //是否多选
  limitTips: "超出了", //超过限定人数返回提示
  maxDepartments: 100, //最大选择部门数量
  pickedDepartments: [], //已选部门
  disabledDepartments: [], //不可选部门
  requiredDepartments: [], //必选部门(不可取消选中状态)
  appId: 158, //微应用的Id
  //permissionType:"xxx",          //选人权限,目前只有GLOBAL这个参数
  onSuccess: function(result) {
    /**
        {
            userCount:1,                              //选择人数
            departmentsCount:1,//选择的部门数量
            departments:[{"id":,"name":"","number":}]//返回已选部门列表,列表中每个对象包含id(部门id)、name(部门名称)、number(部门人数)
        }
        */
  },
  onFail: function(err) {}
});
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

# 参数说明

参数 参数类型 说明
title String 标题
corpId String 企业的 corpId
multiple Boolean 是否多选
limitTips String 超过限定人数返回提示
maxDepartments Number 最大可选部门数
pickedDepartments Array[String] 已选部门
disabledDepartments Array[String] 不可选部门
requiredDepartments Array[String] 必选部门 (不可取消选中状态)
appId Number 应用的 Id
permissionType String 暂时没用,可不传选人权限,目前只有 GLOBAL 这个参数

# 返回说明

参数 说明
userCount 选择人数
departmentsCount 选择的部门数
departments 返回已选部门列表,列表中每个对象包含 id (部门 id)、name (部门名称)、number (部门人数)
上次更新: 3/21/2020, 9:22:50 PM