这个品类的数据长什么样
培训机构教务排课与消课场景中,进入资料版本与变更维护功能的材料包括:课表、消课记录、调课申请,以及版本台账与变更记录本身。课表是排课结果的现行版本载体,消课记录是实际消耗的凭据,调课申请是变更来源,三者字段、日期与签字须一致。材料来源为教务系统导出、人工填报与外部系统回传,更新节奏按课次或按日触发,变更时需保留旧版可追。课表关注课程、班级、教师、时段;消课记录关注学生、课次、消耗数量、签字;调课申请关注原课次、目标课次、审批与回执。这些材料进入 HTTP 接口与外部系统环节时,各自作为请求体或路径参数的数据来源,由工作流节点按约定发送,响应体与返回字段再回到版本台账与变更记录中,用于判断现行版本唯一、旧版可追、引用同步。
配置怎么定
这一环由工作流里的 HTTP 节点执行,输出响应体、状态码与返回字段。版本台账与变更记录由后续节点解析响应,或外部系统按约定处理接着完成。HTTP 模块向目标地址发请求,路径参数、请求体与请求头三处都能用变量占位,变量来自全局变量、系统变量或前方节点输出。
| 对象 | 判断 | 核验动作 |
|---|---|---|
| 课表 | 课程、班级、教师、时段与日期须与消课记录、调课申请逐项一致,版本号唯一且旧版可追 | 在请求预览里看渲染后的完整地址,核对路径参数与请求体字段,确认占位变量解析成实际值 |
| 消课记录 | 学生、课次、消耗数量、日期与签字或回执须与课表、调课申请对得上,不得出现同一记录在两份材料里名称、数量、日期不一致 | 核对请求头名称与取值来源,鉴权信息按外部系统要求传入,用一条样例请求比对返回字段 |
| 调课申请 | 原课次、目标课次、审批状态与回执须与课表和消课记录同步,改一处内容后引用同步更新 | 在变量面板核对每个占位的来源,确认变量来自全局变量、系统变量或前方节点输出 |
| 版本台账与变更记录 | 现行版本唯一,旧版可追,引用同步,变更记录含变更前后字段与签字或回执 | 用一条样例请求比对返回,核对 responseData 中的版本号与引用字段是否同步更新 |
容易做错的三处
- 现象:同一消课记录在课表与调课申请里的名称、数量或日期对不上。原因:材料各自维护,变更未回写,版本未同步。
- 现象:改一处内容后版本号未变,旧版引用仍指向旧内容。原因:版本台账未更新,引用同步缺失。
- 现象:调课申请缺签字或回执,消课记录无对应凭据。原因:审批环节未闭环,外部系统未按约定回传。
怎么确认配好了
本功能验收:预览渲染后的请求,核状态码与返回字段,再对一条样例比对结果;确认 Authorization 按外部系统要求传入,variables 中每个占位可追到来源,responseData 含版本号与引用字段。
业务测试:改一处内容,看版本号与引用是否同步更新。
- 在请求预览里核对渲染后的完整地址、请求头与请求体,确认占位变量解析成实际值,鉴权信息按外部系统要求传入。
- 在变量面板核对每个占位的来源,确认变量来自全局变量、系统变量或前方节点输出,并用一条样例请求比对返回字段与版本台账。