中小学考试命题阅卷的资料版本与变更维护:HTTP 接口

围绕中小学考试命题阅卷的资料版本与变更维护,说明HTTP 接口与外部系统的配置前提与核对动作,结合命题双向细目表、试卷确认结果传递与生效状态,附上线前的验证步骤。

这个品类的数据长什么样

本页面向中小学考试命题阅卷场景,材料包括命题双向细目表、试卷、评分细则三类。命题双向细目表承载考点、题型、分值、认知层级与命题人签字;试卷承载题号、题干、答案与考试日期;评分细则承载评分点、给分依据、阅卷人签字与回执。三类材料进入 HTTP 接口与外部系统功能时,各自角色不同:双向细目表作为命题依据与版本源头,试卷作为内容主体与引用对象,评分细则作为阅卷执行标准与回执凭据。来源为教研部门定稿与学校考务归档,更新节奏随考试安排与修订通知变化,字段特征集中在名称、数量、日期与签字四类。

配置怎么定

这一环由工作流里的 HTTP 节点执行,输出响应体、状态码与返回字段。版本台账与变更记录由后续节点解析响应,或外部系统按约定处理接着完成。请求地址、路径参数、请求头与请求体都能用变量占位,变量来自全局变量、系统变量或前方节点输出。

对象判断核验动作
命题双向细目表考点名称、题型数量、分值合计与命题日期须与试卷逐项对齐,签字栏须有命题人签署在请求体里引用细目表字段,用一条样例请求比对返回的考点名称与分值合计,核对请求头名称与取值来源
试卷题号、题干、答案与考试日期须与评分细则的评分点对应,版本号须为现行唯一在请求预览里看渲染后的完整地址,核 variables 占位是否解析成实际值,比对试卷版本号与引用处是否同步
评分细则评分点、给分依据、阅卷人签字与回执须齐全,日期须与试卷考试日期一致在变量面板核对每个占位的来源,核 Authorization 鉴权信息按外部系统要求传入,比对细则评分点与试卷题号
版本台账与变更记录现行版本唯一、旧版可追、引用同步,变更记录须含变更日期与变更人用一条样例请求比对返回字段,核 responseData 中的版本号与引用处是否同步更新

容易做错的三处

  • 现象:同一考点在双向细目表与试卷里的名称或数量对不上。原因:两份材料分别维护,未在请求体里引用同一字段。
  • 现象:试卷已修订,评分细则仍引用旧版题号。原因:版本未同步,引用处未随变更记录更新。
  • 现象:评分细则缺阅卷人签字或回执。原因:外部系统未按约定回传签字状态,请求返回字段缺失。

怎么确认配好了

本功能验收:预览渲染后的请求,核状态码与返回字段,再对一条样例比对结果,确认 responseData 中版本号与引用处一致。

业务测试:改一处内容,看版本号与引用是否同步更新。

  • 在请求预览里核对渲染后的完整地址与路径参数占位是否解析成实际值。
  • 在变量面板核对每个占位的来源,确认来自全局变量、系统变量或前方节点输出。