成绩录入与学分认定的问答受理与缺项补问:HTTP 接口

围绕成绩录入与学分认定的问答受理与缺项补问,说明HTTP 接口与外部系统的配置前提与核对动作,结合成绩单、缓考申请确认结果传递与生效状态,附上线前的验证步骤。

这个品类的数据长什么样

成绩录入与学分认定场景的材料以成绩单、缓考申请、补考安排为主,来源是教务系统导出件与院系报送件,更新节奏按学期批次推进,字段特征集中在课程名称、学分数量、考试日期与签字栏。成绩单承担成绩与学分认定的主记录角色,缓考申请承担特殊状态说明角色,补考安排承担时间与考场补充角色。材料进入问答受理与缺项补问功能时,各自作为待核验对象,先识别字段是否齐全,再决定是否追问。

配置怎么定

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

对象判断核验动作
成绩单课程名称、学分数量、考试日期与签字栏是否与缓考申请、补考安排逐项对应核对同一记录在两份材料里的名称、数量、日期是否一致,检查签字或回执是否齐全
缓考申请缓考课程、缓考日期与审批签字是否与成绩单、补考安排相互印证比对同一课程在两份材料里的日期与名称,确认版本未同步时以哪份为准
补考安排补考课程、补考日期与考场信息是否与成绩单、缓考申请字段吻合检查补考安排与成绩单的课程数量、日期是否对得上,缺签字或回执时标记追问
请求地址与路径参数占位变量能解析成实际值在请求预览里看渲染后的完整地址,核对 variables 来源

容易做错的三处

  • 现象:同一课程在成绩单与补考安排里的名称、数量对不上。原因:两份材料版本未同步,录入批次不同。
  • 现象:缓考申请缺审批签字或回执,受理时无法确认状态。原因:材料流转环节遗漏签字或回执归档。
  • 现象:请求返回 401 或外部系统收到空字段。原因:Authorization 取值来源未核对,或请求体字段与外部接口约定不一致。

怎么确认配好了

本功能验收:预览渲染后的请求,核状态码与返回字段,再对一条样例比对结果,确认 responseData 中字段与外部接口约定一致。

业务测试:提一个缺关键信息的问句,看是否先追问再作答。

  • 在变量面板核对每个占位的来源,确认 variables 与 Authorization 取值可追溯。
  • 用一条样例请求比对返回,核对请求体字段与外部接口约定一致,并检查引用文本的 tokens 与数组条数分别记录。