成绩对接应先统一记录身份和业务含义,再确定传输方式。至少明确人员、课程或任务、一次作答记录、分数及其满分、完成状态和结果时间,同时约定多次训练、教师复核与更正的处理规则。只传一个总分通常不足以解释这条成绩属于谁、哪次任务和哪个版本。
先确定一条成绩代表什么
同一学生可能多次练习同一病例,也可能参加一次正式考核。应定义一次作答的唯一编号,并说明任务、病例和评分规则版本,避免发送时只依据学生与课程编号而覆盖之前的训练记录。
区分原始分、满分、换算分和通过状态。百分制成绩与分项累计分不能直接混用,未完成、待复核和零分也不是同一种状态。把字段类型、可为空条件和示例写成双方都能阅读的数据说明。
明确发布时机与更正关系
训练结束时可以产生暂存结果,教师复核后可能形成确认成绩。项目需要约定何时向外部平台发送、哪些状态允许学生看到,以及复核前后是否使用同一记录编号,避免临时结果被当成最终成绩。
对申诉更正和重新评分,保留原记录与修订关系,说明哪一版本当前有效。接收方如何更新展示、是否重新计算汇总应同步确认;只在发送方修改数字而不通知接收方,会留下不一致的两套结果。
使用样本完成端到端核对
准备正常完成、未完成、零分、多次练习、待复核和更正结果等样本。发送后在接收平台实际查看人员、任务、分数和状态,再核对导出或统计结果,不能只以接口返回成功判断业务正确。
为拒收数据记录可定位原因,例如人员未匹配或任务编号不存在。双方约定修复后如何补传和确认完成,教师应能知道哪些记录仍未同步,避免在考试结束后才发现成绩遗漏。
实施检查清单
- 每次作答具有可追溯的唯一编号。
- 分数、满分与状态的含义明确。
- 复核发布和更正关系经过约定。
- 接收平台展示与发送记录逐项一致。
常见问题
上传总分就能完成成绩对接吗?
总分只是其中一个字段,还需要能够识别人、任务和作答次数,并解释满分、状态及版本。
多次训练应该取最高分还是最后一次?
由教学用途决定并明确约定。原始记录应能够区分各次训练,汇总规则不应隐藏在接口实现中。