调起选择联系人界面
调起选择联系人界面。可传参,支持单选多选、选择手机通讯录、默认选中联系人、限制人数等等(最多支持选择300人)。
扫码体验:

请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| needCallback | Bool | 是 | 是否需要回调,将返回选中的联系人相关信息 |
| isSingleSelection | Bool | 否 | 是否单选,默认false(单选不能跟users同时存在) |
| minimum | Number | 否 | 最小必选人数,默认1。必须选择一个用户才可以继续操作 |
| maximum | Number | 否 | 最多可选人数,默认10个 |
| mode | Number | 否 | 默认选择模式0:包含选择联系人的基本信息;号码选中模式1:可长按选择号码,本地通讯录的选择属性也为号码字段;邮箱选中模式2:可长按选择邮箱,本地通讯录的选择属性也为邮箱字段。注意:1,2包含0 |
| dataSourceType | Number | 否 | 我的组织:1(1<<0),我的外部联系人:2(1<<1),自定义数据源:4(1<<2)。默认为1 |
| searchKeyword | String | 否 | 可选 |
| title | String | 否 | 选人组件自定义title |
| users | String | 否 | 参见下方users定义 |
| supportPortals | String | 否 | "选人组件顶部支持的入口定义:我的联系人:1 (1<<0),手机通讯录:4 (1<<2),(手机通讯录选择的属性跟随mode字段定义)" |
| fixedFlag | String | 否 | (只有Android模块使用)特殊场景标志位:1:已选中不可操作的人员显示在顶部头像展示栏;2:返回数据包含已选中不可操作的人员。已选中不可操作的人员见下方同色块区域 |
users请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| account | String | 是 | 账号 |
| type | Number | 是 | 账号类型。0:账号,1:工号,2:邮箱 |
| status | Number | 否 | 当前账号的选择状态。0:默认,1:已选中,3:已选中且不可操作 |
| name | String | 否 | 当前账号显示名 |
| calleeNumber | String | 否 | 默认回呼号码,语音会议从会议记录恢复时使用 |
| personType | String | 否 | 当前账号类型,语音会议从会议记录恢复时使用,内部 "EMP"/ 外协 "OTH" / 外部联系人 "OUTER" / 手机联系人 "ADDRESS_BOOK" |
返回结果
| 参数 | 说明 |
|---|---|
| userNameCn | 中文名 |
| userNameEn | 英文名 |
| deptCode | 部门编码 |
| deptL1Code | 一级部门编码 |
| deptL1Name | 一级部门名称 |
| deptLevel | 部门级别 |
| deptName | 部门名称 |
| corpUserId | 该用户在租户自身系统的登录标识,用于认证和邮箱登录(客户内唯一) |
| workPlace | 办公地址 |
| userEmail | 邮箱 |
| userType | 员工类型:EMP(本部)、OTH(合作方) |
| pinyinName | 拼音名,如:Rui |
| gender | 性别 男:M 女:F |
| userId | 账号 |
| signature | 个性签名 |
请求示例
- ES6版本
const _users = [ { account: 'l00123456', type: 1, status: 1, name: 'test1', calleeNumber: '', personType: '' } ]; HWH5.selectUsers({ needCallback: true, isSingleSelection: false, minimum: 2, maximum: 5, mode: 1, dataSourceType: 4, searchKeyword: '', title: 'h5demo title', users: JSON.stringify(_users), supportPortals: 1, fixedFlag: 2 }).then(data => { console.log(data); }).catch(error => { console.log(error); });
- ES5版本
var _users = [ { account: 'l00123456', type: 1, status: 1, name: 'test1', calleeNumber: '', personType: '' } ]; HWH5.selectUsers({ needCallback: true, isSingleSelection: false, minimum: 2, maximum: 5, mode: 1, dataSourceType: 4, searchKeyword: '', title: 'h5demo title', users: JSON.stringify(_users), supportPortals: 1, fixedFlag: 2 }).then(function (data) { console.log(data); }).catch(function (error) { console.log(error); });
HWH5.openUserProfile