通讯录选人

接口说明

支持版本>=10.0.2

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

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 Nmuber 否 当前帐号的选择状态。0：默认，1：已选中，2：未选中且不可操作，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);
  });

    result. ""

      Not Found. ""