# 调起选择联系人界面
调起选择联系人界面。可传参，支持单选多选、选择手机通讯录、默认选中联系人、限制人数等等（最多支持选择300人）。
扫码体验：
![](https://support.huaweicloud.com/devg-welink/figure/zh-cn_image_0000001485185709.png "点击放大")
#### 请求参数
| **参数**            | **类型** | **必填** | **说明**                                                                                           |
|:---|:---|:---|:---|
| needCallback      | Bool   | 是      | 是否需要回调，将返回选中的联系人相关信息                                                                             |
| isSingleSelection | Bool   | 否      | 是否单选，默认false（单选不能跟users同时存在）                                                                     |
| 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 | 否      | (只有Android模块使用)特殊场景标志位：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 | 该用户在租户自身系统的登录标识，用于认证和邮箱登录（客户内唯一） |
| 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](https://open.welink.huaweicloud.com/docs/#/990hh0/whokyc/fa5obu)