通讯录选人

接口说明

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"

返回结果

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

    result. ""

      Not Found. ""