开放接口通讯录

举报
云会议运营喵大人 发表于 2020/02/17 13:05:19 2020/02/17
【摘要】 HWH5.selectUsersHWH5.openUserProfileHWH5.getDepartmentHWH5.selectUsers支持版本>=10.0.2调起选择联系人界面。可传参,支持单选多选、选择手机通讯录、默认选中联系人、限制人数等等扫码体验:请求参数参数类型必填说明needCallbackBool是是否需要回调,将返回选中的联系人相关信息isSingleSelectionB...

HWH5.selectUsers
HWH5.openUserProfile
HWH5.getDepartment


HWH5.selectUsers

支持版本>=10.0.2

调起选择联系人界面。可传参,支持单选多选、选择手机通讯录、默认选中联系人、限制人数等等

扫码体验:

1581915853295919.png

请求参数

参数类型必填说明
needCallbackBool是否需要回调,将返回选中的联系人相关信息
isSingleSelectionBool是否单选,默认false
minimumNumber最小必选人数,默认1。必须选择一个用户才可以继续操作
maximumNumber最多可选人数,默认10个
modeNumber默认选择模式0:包含选择联系人的基本信息;号码选中模式1:可长按选择号码,本地通讯录的选择属性也为号码字段;邮箱选中模式2:可长按选择邮箱,本地通讯录的选择属性也为邮箱字段。注意:1,2包含0
dataSourceTypeNumber我的内部联系人:1(1<<0),我的外部联系人:2(1<<1),自定义数据源:4(1<<2)。默认为1
searchKeywordString可选
titleString选人组件自定义title字符串
usersString参见下方users定义
supportPortalsString"选人组件顶部支持的入口定义:我的联系人:1 (1<<0),手机通讯录:4 (1<<2),(手机通讯录选择的属性跟随mode字段定义)"
fixedFlagString特殊场景标志位:1:已选中不可操作的人员显示在顶部头像展示栏;2:返回数据包含已选中不可操作的人员。已选中不可操作的人员见下方同色块区域

users请求参数

参数类型必填说明
accountString帐号
typeNumber帐号类型。0:帐号,1:工号,2:邮箱
statusNumber当前帐号的选择状态。0:默认,1:已选中,3:已选中且不可操作
nameString当前帐号显示名
calleeNumberString默认回呼号码,语音会议从会议记录恢复时使用
personTypeString当前帐号类型,语音会议从会议记录恢复时使用,内部 "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

支持版本>=10.0.5

打开联系人详情页面

扫码体验:

1581915868549605.png

请求参数

参数类型必填说明
userIdString用户帐号,如:xx@xx
corpUserIdString该用户在租户自身系统的登录标识,用于认证和邮箱登录(客户内唯一),如:00123456
userEmailString用户邮箱,如: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

支持版本>=10.1.2

选择部门

扫码体验:

1581915880973190.png

请求参数

无。

返回结果

参数说明
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

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。