开放接口通讯录
【摘要】 HWH5.selectUsersHWH5.openUserProfileHWH5.getDepartmentHWH5.selectUsers支持版本>=10.0.2调起选择联系人界面。可传参,支持单选多选、选择手机通讯录、默认选中联系人、限制人数等等扫码体验:请求参数参数类型必填说明needCallbackBool是是否需要回调,将返回选中的联系人相关信息isSingleSelectionB...
HWH5.selectUsers
HWH5.openUserProfile
HWH5.getDepartment
HWH5.selectUsers
调起选择联系人界面。可传参,支持单选多选、选择手机通讯录、默认选中联系人、限制人数等等
扫码体验:
请求参数
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
needCallback | Bool | 是 | 是否需要回调,将返回选中的联系人相关信息 |
isSingleSelection | Bool | 否 | 是否单选,默认false |
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 | 否 | 特殊场景标志位: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 | 该用户在租户自身系统的登录标识,用于认证和邮箱登录(客户内唯一) |
mobileNumber | 手机号码 |
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
打开联系人详情页面
扫码体验:
请求参数
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
userId | String | 否 | 用户帐号,如:xx@xx |
corpUserId | String | 否 | 该用户在租户自身系统的登录标识,用于认证和邮箱登录(客户内唯一),如:00123456 |
userEmail | String | 否 | 用户邮箱,如:xxx@xxx.com |
注意:userId、corpUserId、userEmail,只要给一个即可,但必须要给一个。
返回结果
调起通讯录详情页面。
请求示例
ES6版本
HWH5.openUserProfile({ userId: 'xx@xx'}).catch((error) => { console.log('查看通讯录详细信息异常', error); });
ES5版本
HWH5.openUserProfile({ userId: 'xx@xx'}).catch(function (error) { console.log('查看通讯录详细信息异常', error); });
HWH5.getDepartment
选择部门
扫码体验:
请求参数
无。
返回结果
参数 | 说明 |
---|---|
deptCode | 部门id |
deptNameCN | 部门中文名 |
deptNameEN | 部门英文名 |
请求示例
ES6版本
HWH5.getDepartment() .then(res => { console.log(res); }) .catch(err => { console.log(err); });
ES5版本
HWH5.getDepartment() .then(function (res) { console.log(res); }) .catch(function (err) { console.log(err); });
【版权声明】本文为华为云社区用户原创内容,未经允许不得转载,如需转载请自行联系原作者进行授权。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱:
cloudbbs@huaweicloud.com
- 点赞
- 收藏
- 关注作者
评论(0)