成员

1. 适用场景

成员组件可以获取钉钉通讯录的人员，选择人员时可以使用，比如设置出差申请人、资产责任人、维护人员等，还可以和 公式 组合使用，另还可用于流程表单设置审批人时使用，比如 发起人自选审批人。

2. 基础功能

2.1 多选模式

支持选择多位人员，当人员仅需要选择一位时，可以关闭该按钮。

多选模式

2.2 默认展示人员

可以选择指定人员作为默认值，在提交页面可以默认展示对应的成员。

设置默认值

当成员状态是普通的时候，默认展示成员可以清除，重新搜索选择其他人员。

成员状态设置为只读的时候，组件就不支持选择人员，仅可读的状态。

2.3 显示工号

设置是否需要人员姓名后面带有工号，这里的工号默认展示员工的UserID。

显示工号

2.4 高级查询模式 （新版本成员组件）

钉钉电脑端和网页浏览器端使用宜搭成员组件时，新增高级查询功能，支持基于通讯录树状关系的选择及组织下钻能力

高级选人功能入口，默认在电脑端开启，点击后会以弹框的方式，提供一个完整的成员选择页面

2.4.1 使用场景

• 根据组织通讯录的层级关系，按树状层级关系，向下查询并选择目标成员

2.4.2 效果示意

3. 公式组合

有多种用法，比如自动获取发起人姓名、工号、部门等，具体可以参考 高级函数 文档。

3.1 获取当前登录人昵称

参考 GETUSERNAME 函数公式

3.2 获取当前登录人或当前登录人的主管

参考 USER 函数公式

4. 注意事项

1. 成员组件可以选择全公司的人员，但是展示时只能展示本部门的人员，需要通过搜索选择其他部门的人员。
2. 目前由于容器限制，在钉钉移动端 iframe 中使用该组件时，会因为容器未向 iframe 注入 JSAPI 导致无法正常选择人员，请避免在这种场景中使用该组件。

5. 常见问题

5.1 为什么成员组件批量导入的时候，输入了人名但导进去显示空白？

因为格式不对，批量导入的时候需要注意格式，具体参考批量导入。

5.2 想通过部门组件选择了某个部门，那成员组件只能选择这个部门里面的人员，可以怎么做 ？

成员组件目前没有可以直接控制可选范围的配置项，可以使用这个方案：创建一个中间表，里面放入部门和所属成员，通过数据联动，获取这个中间表。

5.3 批量导入成员组件不成功，导入之后没有数据 ？

使用了成员组件，批量导入不成功，需要注意格式，姓名 + [员工 UserID ]，括号需要是英文格式下的中括号 [] ，查看以下截图：