调起选择联系人界面
调起选择联系人界面。可传参,支持单选多选、选择手机通讯录、默认选中联系人、限制人数等等(最多支持选择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