这个品类的数据长什么样
区县教研活动与听评课材料主要有教研活动通知、听课记录、评课纪要三类。通知含活动主题、时间、地点、参与校与教师、回执要求;听课记录含授课人、班级、学科、听课时间、观察要点与签字;评课纪要含评议要点、改进建议、主持人与参会人签字。这些材料来自各校提交与教研员汇总,更新节奏为活动前发通知、活动中记听课、活动后出纪要。进入HTTP接口与外部系统功能时,通知作为触发与回执依据,听课记录作为过程证据,评课纪要作为结论与引用来源,三者字段、日期与签字需在版本台账中保持可追。
配置怎么定
这一环由工作流里的 HTTP 节点执行,输出响应体、状态码与返回字段。版本台账与变更记录由后续节点解析响应,或外部系统按约定处理接着完成。HTTP 模块向目标地址发请求,路径参数、请求体与请求头三处都能用变量占位,变量来自全局变量、系统变量或前方节点输出。
| 对象 | 判断 | 核验动作 |
|---|---|---|
| 教研活动通知 | 通知中的活动名称、日期、参与校与回执要求是否与台账一致 | 核对请求体字段与通知原文,检查 variables 来源 |
| 听课记录 | 听课记录的授课人、班级、学科、听课日期与签字是否与评课纪要对应 | 比对两份材料同一记录的字段,确认日期与签字无缺失 |
| 评课纪要 | 评课纪要的评议要点、改进建议与参会人签字是否与通知和听课记录同步 | 核对返回字段中的版本标识与引用指向 |
| 版本台账与变更记录 | 现行版本唯一、旧版可追、引用同步 | 在请求预览中查看渲染后的完整地址,核对 Authorization 与 responseData 字段 |
容易做错的三处
- 现象:同一记录在通知与听课记录里的活动名称、日期对不上。原因:两处分别手工填写,未以同一版本台账为准。
- 现象:评课纪要已更新,听课记录仍引用旧版内容。原因:版本未同步,引用未随变更记录刷新。
- 现象:听课记录或评课纪要缺少签字或回执。原因:提交环节未校验签字字段,外部系统收到空字段。
怎么确认配好了
本功能验收:在请求预览里看渲染后的完整地址,核状态码与返回字段,再对一条样例请求比对返回结果。
业务测试:改一处内容,看版本号与引用是否同步更新。
- 在变量面板核对每个占位的来源,确认路径参数、请求头与请求体中的
variables都能追到全局变量、系统变量或前方节点输出。 - 用一条样例请求比对返回,核对
Authorization取值来源与responseData字段是否与外部接口约定一致。