CSV：模板与字段
CSV 模板下载、编码约定与常见字段含义。
integrationcsv
受众：教务 / 机构管理员 · 适用：SaaS / 私有
目标：按官方模板正确填表，减少校验失败。
使用前
- 在机构管理 数据集成 下载对应类型的 官方模板（老师 / 学生 / 班级 / 班级成员等）。
- 用 UTF-8 保存；Excel 编辑后请确认未变成系统默认 ANSI 编码。
- 不要改表头列名；删除空行与合并单元格。
- 一文件只放一种导入类型。
字段约定（通则）
| 类型 | 说明 |
|---|---|
| 必填 | 模板标注必填的列不可为空 |
| 邮箱 | 建议小写；同一机构内避免重复 |
| 显示名 | 师生在 App 中看到的名称 |
| 班级代码 | 须与系统中已有班级或同批将导入的班级一致 |
| 角色 | 仅使用模板允许的取值（如 teacher / student） |
| 初始密码 | 若提供，需满足最少位数等策略；也可导入后由管理员重置 |
| 学号/工号 | 若模板有此列，建议与教务唯一键一致，便于对账 |
具体列名与枚举以模板文件为准；不同版本模板可能增减列。
分类型注意点
| 类型 | 注意 |
|---|---|
| 班级 | 先保证代码唯一；名称可含年级/学期信息 |
| 老师 / 学生 | 邮箱是登录键之一；勿与其他角色串用同一邮箱（除非产品明确支持） |
| 班级成员 | 依赖已存在的班级代码与账号；先导班级与人，再导关系 |