选人

选人、选员工

selectContacts （mtl-js-sdk 5.5.33 版本以上）
支持平台

微信 友空间 安卓 iOS
✔︎ ✔︎ ✔︎ ✔︎

参数

名称 类型 必填 说明 说明
success function 是 无 回调函数
tenantId String 否 无 租户id
tenantName String 否 无 租户名称
yhtToken String 否 无 友互通token
wbAt String 否 无 wb_at
fail function 否 无 回调
baseUrl String 否 默认获取当前环境局 联系人baseurl
maxCount Int 否 100 最大选人数
navTitle String 否 选择联系人 导航标题
lang string 否 多语言 默认简体中文
hiddenNav bool 否 隐藏导航栏 默认不隐藏
selectUserNumber int 否 已选择的人员个数 默认0
selectUserList arry 否 已选择的人员列表 []
selectDeptList arry 否 已选择的部门及人员列表 []
multiple bool 否 true 单选/多选;默认多选
filterList array 否 无 根据范围选择人员
isemployee String 否 不传递或者传递""的时候，调用人员页面， 传递 isemployee: "isemployee", 调用员工页面 选择员工还是人员

示例

加载js

FILE_PATH = 'selectcontacts/mobile.contacts.min.js'
日常：https://mdf-mobile-daily.yyuap.com/runtime-mobile/{FILE_PATH}
预发：https://mdf-mobile-runtime-pre.diwork.com/runtime-mobile/{FILE_PATH}
正式：https://mdf-mobile-runtime.diwork.com/runtime-mobile/{FILE_PATH}

环境地址说明 环境+FILE_PATH
已内置日常（DAILY_URL）、预发（PRE_URL）、生产（DIWORK_URL）。
其他专属化自己拼接 （环境+FILE_PATH）

var url = mtl.contacts.DAILY_URL;
mtl.contacts.init({
        url, success: () => {
          console.log("success->", window.selectContacts)
        }
      })

选人调用api

mtl.contacts.selectContacts({
        baseUrl: 'https://build.yyuap.com',
        success: function callBack(res) {
          console.log('callBack: ', res)
        },
        maxCount: 200,
      })

选员工调用api

mtl.contacts.selectPersonnel({
  baseUrl: 'https://build.yyuap.com',
  success: function callBack(res) {
    console.log('callBack: ', res)
  },
  maxCount: 200,
})


使用：

 mtl.contacts.init({
      url, success: () => {
        console.log("success->", window.selectContacts)
        mtl.contacts.selectContacts({ // 只传递回调函数
          success: function callBack(res) {
            console.log('callBack: ', res)
          },
          maxCount: 200,
          filterList: ["87e551be-0037-4bfd-ad38-8fbb6ca974cc","891e5335-04e9-45e7-9914-e467f05ac153"],
        })
      }
    })

第三方调用:

// 需要在打开选人组件之前存储 key_mobile_app_url 到mtl
const mobileAppUrl = "https://yonbip.diwork.com/iuap-yonbuilder-mobile" // 生产环境地址
mtl.setStorage({ key: "key_mobile_app_url", data: mobileAppUrl })

返回格式

{
    code: 0,
    data: {
        selectUserNumber: 0, // 选择的人员总数
        selectUserList: [{  // 勾选的人员个数，每一个人员为一个对象
                "yhtUserId": "70d4e960-389b-433e-b74c-30e8f766b0a1",
                "userName": "z0080",
                "avatar": null,
                "orgName": "cc1234",
                "deptName": "财务部",
                "deptId": "2167854006456576",
                "positionDutyName": null,
                "mobile": "13423230079",
                "checked": true
        }],
    selectDeptList: [{  // 勾选的部门/组织,如果改组织下面有人员，会有users该数组，且数组中是该部门（及下级）的所有人员
        "deptId": "2177968263483648",
        "deptName": "0304组织部门1",
        "type": 2,
        "haveSub": false,
        "number": 0,
        "orgName": "新增组织1",
        "textMap": {
            "zh_TW": "繁体-繁体",
            "en_US": "0304组织部门1",
            "zh_CN": "0304组织部门1",
            "fr_FR": ""
        },
        "checked": true,
        users: [{
            "yhtUserId": "70d4e960-389b-433e-b74c-30e8f766b0a1",
            "userName": "z0080",
            "avatar": null,
            "orgName": "cc1234",
            "deptName": "财务部",
            "deptId": "2167854006456576",
            "positionDutyName": null,
            "mobile": "13423230079",
            "checked": true
        }]
    }]
}
}

参数说明

名称 类型 说明
code Int 0 成功
message String 描述
data Object 正确返回数据格式

selectUserList

名称 类型 说明
code Int 0 成功
message String 描述
data Object 正确返回数据格式


是否仍需要帮助？ 请保持联络！
最后更新于 2026/04/24