开放接口通讯录
【摘要】 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）