企业内部前端APIH5微应用JSAPI开放接口通讯录
【摘要】 HWH5.selectContactsHWH5.openUserProfile使用H5微应用JSAPI需要引用资源,查看详细文档HWH5.selectContacts调起选择联系人界面。可传参,支持单选多选、选择手机通讯录、默认选中联系人、限制人数等请求参数参数类型必填说明needCallbackBool是是否需要回调,将返回选中的联系人相关信息isSingleSelectionBool否是...
HWH5.selectContacts
HWH5.openUserProfile
使用H5微应用JSAPI需要引用资源,查看详细文档
HWH5.selectContacts
调起选择联系人界面。可传参,支持单选多选、选择手机通讯录、默认选中联系人、限制人数等
请求参数
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
needCallback | Bool | 是 | 是否需要回调,将返回选中的联系人相关信息 |
isSingleSelection | Bool | 否 | 是否单选,默认false |
minimum | Number | 否 | 最小必选人数,默认1 必须选择一个用户才可以继续操作 |
maximum | Number | 否 | 最多可选人数,默认十个,最多人数不要超过100个 |
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 | Nmuber | 否 | 当前帐号的选择状态 0:默认,1:已选中,3:已选中且不可操作 |
name | String | 否 | 当前帐号显示名 |
calleeNumber | String | 否 | 默认回呼号码,语音会议从会议记录恢复时使用 |
personType | String | 否 | 当前帐号类型,语音会议从会议记录恢复时使用,内部 "EMP"/ 外协 "OTH" / 外部联系人 "OUTER" / 手机联系人 "ADDRESS_BOOK" |
返回结果
参数 | 说明 |
---|---|
chineseName | 中文名 |
deptCode | 一级部门编号 |
deptName | 部门名,如:终端与通讯业务部 |
corpUserId | 工号 |
englishName | 英文名 |
mobileNumber | 手机号码 |
userEmail | 邮件地址 |
pinyinName | 拼音名,如:Rui |
sex | 性别 男:M 女:F |
signature | 个性签名 |
userId | 帐号 |
请求示例
ES6版本
const _users = [ { account: 'test1@welink', type: 1, status: 1, name: 'test1', calleeNumber: '', personType: '' }, { account: 'test2@welink', type: 1, status: 1, name: 'tes2', calleeNumber: '', personType: '' } ]; HWH5.selectContacts({ 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: 'test1@welink', type: 1, status: 1, name: 'test1', calleeNumber: '', personType: '' }, { account: 'test2@welink', type: 1, status: 1, name: 'tes2', calleeNumber: '', personType: '' } ]; HWH5.selectContacts({ 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@huawei.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); });
【版权声明】本文为华为云社区用户原创内容,未经允许不得转载,如需转载请自行联系原作者进行授权。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱:
cloudbbs@huaweicloud.com
- 点赞
- 收藏
- 关注作者
评论(0)