Skip to content

chooseContactWithComplexPicker 复合人员选择器 ​

接口说明 ​

支持选人

使用说明 ​

是否需要鉴权是否支持Android是否支持IOS是否支持PC
是是是是

参数说明 ​

名称类型是否必填示例值描述
titleString否标题
multipleBoolean否是否多选
maxUsersInteger否最多可选人数(默认、最大值1000)
pickedUsersArray<string>否已选择用户,用户 ID 数组
disabledUsersArray<string>否不可选用户,用户 ID 数组
requiredUsersArray<string>否必选用户,用户 ID 数组
responseUserOnlyBoolean否是否只返回用户
limitTipsString否超过限定人数返回提示
pickedDepartmentsArray<string>否已选部门,部门 ID 数组
disabledDepartmentsArray<string>否不可选部门,部门 ID 数组
requiredDepartmentsArray<string>否必选部门 (不可取消选中状态), 部门 ID 数组
panelTypesArray否选人面板列表,选人面板列表<br/>+ 我的联系人:2<br/>+ 全局组织:1<br/>+ 我的群组:4<br/>+ 特别关注:7<br/>+ 所在组织:9
visibilityCodesArray<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”
enableExternalUserBoolean否是否可以选择外域数据
organizationToPersonBoolean否是否把选的组织转化为组织下的人员列表
titleString否标题

返回数据 ​

名称类型示例值描述
selectedCountNumber选择人数
usersArray返回选人的列表,列表中的对象包含name (用户名)、avatar (用户头像)、userid (用户工号,pc端返回请做特殊处理,当userid获取不到数据时从emplid中获取)、external(是否域外用户)字段。
departmentsArray<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等,可以通过打印入参确认传参是否符合要求。