# 通讯录选人
# 选人和选部门
# 使用说明
支持选人和选部门。选择部门后,把所选部门转换成对应部门下的人。
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
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
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 (部门人数) |