通讯录选人


接口说明

支持版本>=10.0.2

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

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:已选中,2:未选中且不可操作,3:已选中且不可操作
name String 当前帐号显示名
calleeNumber String 默认回呼号码,语音会议从会议记录恢复时使用
personType String 当前帐号类型,语音会议从会议记录恢复时使用,内部 "EMP"/ 外协 "OTH" / 外部联系人 "OUTER" / 手机联系人 "ADDRESS_BOOK"

返回结果

参数 说明
userNameCn 中文名
deptCode 一级部门编号
deptName 部门名,如:终端与通讯业务部
corpUserId 工号
userNameEn 英文名
mobileNumber 手机号码
userEmail 邮件地址
pinyinName 拼音名,如:Rui
gender 性别 男: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);
    });
    

result. ""

    Not Found. ""