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等,可以通过打印入参确认传参是否符合要求。