# 通讯录选人

# 选人和选部门

# 使用说明

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

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 (部门人数)

← 免登授权码会话 →