选哪种进数方式
按场景选择界面新建/复制、CSV 导入导出或 API 对接。
integrationcsvapidirectory
受众:机构管理员、教务、IT · 适用:SaaS / 私有
目标:选对数据进入方式,避免一上来就上复杂对接。
怎么选
| 场景 | 更推荐 | 原因 |
|---|---|---|
| 试用、试点、个别补录、人数很少 | 界面新建 / 从选中复制 | 机构管理员在 设置 → 组织与进数;教务在 班级 |
| 同结构多班、或多名同类账号 | 从选中复制 再改身份字段 | 少填重复项;注意复制班不带成员 |
| 开学一次性建档、人数较多、无开发资源 | CSV | 下载模板即可,校验反馈直观 |
| 每周/每日与教务或 SIS 同步 | API | 可增量、可自动化、少人工差错 |
| 先试点再规模化 | 先 界面或 CSV 再 API | 先验证字段与班级代码约定 |
| 私有部署且已有中台 | API 为主;界面/CSV 作补录 | 中台管主数据,界面纠错最快 |
| 只要导出成绩快照 | CSV 导出 | 不必上 API |
| 需要程序化创建作业/拉结果 | API | 导出无法满足持续写入 |
决策顺口溜
- 人很少、马上要用?→ 界面新建或复制(见 建班与授权老师)。
- 有没有开发同学?没有且名单已在表格里 → CSV。
- 要不要每周自动变?要 → API。
- 字段还没定?先界面或 CSV 小样本。