1. 概述
自建用户体系支持批量添加成员，在通讯录界面，按以下操作，即可批量添加成员
「通讯录」>「邀请用户」>「批量添加成员」>「下载通讯录模板」>按格式修改后「导入」平台
批量添加成员时，需要保证操作正确，防止导入失败。请查看以下注意事项！
2. 批量添加成员注意事项
从其他系统中导出数据
如果您需要整理这样的一份表格，我们给出了一些参考方法。一般情况下我们拥有以下三张表
用户信息表，例如user表，表结构大致为
id username mobile email .... 部门表，例如department表，表结构大致为
id name pid（父部门ID） ... 部门与用户关联表，例如user_department表，表结构大致为
id user_id dep_id ...
我们可以从这三张表中查询出模版要求的数据，执行以下的sql语句
select u.username as fullname, u.email as email, u.id as username, u.mobile as mobile, d.name as dept, d.id as did, d.pid as fid
from department d
left join user_department ud on ud.dep_id = d.id
left join user u on u.id = ud.user_id
执行完后会拿到以下的数据
fullname | email | username | mobile | dept | did | fid |
|---|---|---|---|---|---|---|
| 姓名1 | 邮箱1 | 用户ID | 手机号 | 部门名称 | 部门ID | 父部门ID |
| 姓名2 |
这样便拿到了模版数据，放在模版中即可。
2.1 基本填写注意事项
姓名必填，邮箱与用户ID必填其一，手机号可不填
手机号格式需要保持正确，邮箱格式保持正确
单次导入只导入前300行，超过300行的数据不导入
当需要导入一个无用户的部门时，需要在模版中添加一行用户信息为空，部门信息不为空的数据
当需要导入一个无部门的用户时，部门信息为空即可
导入时通讯录其他操作不可操作，公开邀请链接不可以邀请
2.2 关于用户ID的说明
用户ID是成员在企业内的唯一标识，即用户ID不为空时用户信息需要完全一致才会认为是同一用户。注意：这里校验不仅会校验上传文件中的数据也会校验平台中已有的数据。用户ID只能设置一次，且不能修改，请谨慎填写。
同一个用户ID的部门信息可以不一致，同一个用户将在不同部门内。
例1：小王即在部门1下也在部门2下
姓名 邮箱 用户ID 手机号 部门名称 部门ID 父部门ID 小王 123@123.com 123 12345678901 部门1 部门1的ID 部门1的父部门ID 小王 123@123.com 123 12345678901 部门2 部门2的ID 部门2的父部门ID 同一个用户ID的成员信息不可以不一致，会导致冲突。只会导入第一行的数据，第二行是错误数据不导入
例2：小王，同一个用户ID对应的邮箱不一致，只会导入第一行数据
姓名 邮箱 用户ID 手机号 部门名称 部门ID 父部门ID 小王 123@123.com 123 12345678901 部门1 部门1的ID 部门1的父部门ID 小王 123456@123456.com 123 12345678901 部门2 部门2的ID 部门2的父部门ID
2.3 填写错误及处理方式
部门ID填写为数字格式，填写其他格式则格式错误，该行数据不导入
手机号不允许重复，重复时导入第一行，第二行及其后不导入
部门ID和父部门ID不允许重复：当部门ID和父部门ID相等时，该行数据不导入
当部门ID一致但部门名称不一致时，部门ID冲突，会导入第一行部门，第二行及其后不导入
当部门ID一致但父部门ID不一致，父部门ID冲突，会导入第一行部门，第二行及其后不导入
部门信息（部门ID和部门）不完整时，该行数据不导入
无法查找到父部门ID（父部门ID无效）时，该行数据不导入
当出现部门结构死循环时，产生死循环的部门不导入，且父部门是死循环部门的部门会丢失父部门
如下例部门结构死循环中，A正常导入；B部门会导入，但无父部门；C部门不导入
部门部门ID父部门IDA 1 101 B 101 110 C 110 1
2.4 其他情况说明：
如平台通讯录内已经有部门架构，建议不填写部门信息将成员导入后，在平台内为成员分配部门。
3. 批量添加成员示范
如果你想获得以下成员结构
平台效果如下：
则需要填写如下模板：
