批量导入用户
通过 Excel (.xlsx) 或 CSV (.csv) 文件批量导入用户和分组,支持自动创建不存在的分组,适合企业初始部署或大规模用户管理场景。
Express 版用户可以通过邀请链接快速添加成员。详见 成员邀请。
入口: 用户管理页面右上角 导入 按钮。
操作流程
导入过程分为 3 个步骤:
步骤 1:上传文件
- 点击 下载 Excel 模板 或 下载 CSV 模板 获取标准模板文件。
- 按模板格式填写用户数据。
- 将填写好的文件拖拽到上传区域,或点击选择文件。
- 点击 下一步 进入数据预览。
字段说明
| 字段名 | 必填 | 说明 |
|---|---|---|
username | 是 | 用户的唯一标识,系统内不可重复。 |
password | 是 | 用户初始密码。 |
email | 否 | 邮箱地址。 |
mobile | 否 | 手机号码。 |
nickname | 否 | 显示昵称。 |
group | 是 | 所属分组名称。若分组不存在,系统将自动创建。 |
groupDescription | 否 | 分组描述。仅在分组不存在需要自动创建时使用。 |
isGroupAdmin | 否 | 是否为组管理员。可填 true/false 或 是/否,默认 false。 |
步骤 2:数据预览
系统解析文件后展示预览表格,可在此检查数据是否正确。如有格式错误或缺失必填项,系统会高亮提示。
步骤 3:执行导入
确认无误后点击执行,系统批量创建用户和分组。导入完成后展示结果摘要(成功数、跳过数、失败数)。
注意事项:
- 模板第一行为表头,请勿修改。
- 若用户名已存在,可选择跳过或更新该用户信息。
- 分组不存在时会自动创建(仅管理员有此权限)。
- 建议首次导入前先用少量数据测试,确认格式无误后再批量操作。