Appearance
chooseContactWithComplexPicker 复合人员选择器
接口说明
支持选人
使用说明
是否需要鉴权 | 是否支持Android | 是否支持IOS | 是否支持PC |
---|---|---|---|
是 | 是 | 是 | 是 |
参数说明
名称 | 类型 | 是否必填 | 示例值 | 描述 |
---|---|---|---|---|
title | String | 否 | 标题 | |
multiple | Boolean | 否 | 是否多选 | |
maxUsers | Integer | 否 | 最多可选人数(默认、最大值1000) | |
pickedUsers | Array<string> | 否 | 已选择用户,用户 ID 数组 | |
disabledUsers | Array<string> | 否 | 不可选用户,用户 ID 数组 | |
requiredUsers | Array<string> | 否 | 必选用户,用户 ID 数组 | |
responseUserOnly | Boolean | 否 | 是否只返回用户 | |
limitTips | String | 否 | 超过限定人数返回提示 | |
pickedDepartments | Array<string> | 否 | 已选部门,部门 ID 数组 | |
disabledDepartments | Array<string> | 否 | 不可选部门,部门 ID 数组 | |
requiredDepartments | Array<string> | 否 | 必选部门 (不可取消选中状态), 部门 ID 数组 | |
panelTypes | Array | 否 | 选人面板列表,选人面板列表<br/>+ 我的联系人:2<br/>+ 全局组织:1<br/>+ 我的群组:4<br/>+ 特别关注:7<br/>+ 所在组织:9 | |
visibilityCodes | Array<string> | 否 | 属性可见性列表,不传默认都可被选<br/>手机号隐藏=“PHONE_HIDE”;<br/>不可单聊=“CHAT_INVALID”;<br/>不可拉入群-“GROUP_CHAT_PULL_INVALID”;<br/>不可被应用钉-“APP_DING_INVALID”;<br/>不可被电话钉-“PHONE_DING_INVALID”;<br/>不可被短信钉-“SMS_DING_INVALID”;<br/>音视频隐藏-“AUDIO_VIDEO_HIDE” | |
enableExternalUser | Boolean | 否 | 是否可以选择外域数据 | |
organizationToPerson | Boolean | 否 | 是否把选的组织转化为组织下的人员列表 | |
title | String | 否 | 标题 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
selectedCount | Number | 选择人数 | |
users | Array | 返回选人的列表,列表中的对象包含name (用户名)、avatar (用户头像)、userid (用户工号,pc端返回请做特殊处理,当userid获取不到数据时从emplid中获取)、external(是否域外用户)字段。 | |
departments | Array | <br/> | 返回已选部门列表,列表中每个对象包含id (部门id)、name (部门名称) |
用法DEMO
调用示例
javascript
SZHN_HZT_SDK.chooseContactWithComplexPicker()
.then(res => {
console.log(res);
})
.catch(err => {
console.log(err);
});
补充说明
错误信息:
- 点击选择人员信息错误:{“errorCode”: “2”, “errorMessage”: “pick require disable ids contains null”};问题原因是入参有不规范的值,比如pickedUsers 中含有 undefined等,可以通过打印入参确认传参是否符合要求。