科研伦理审查的资料版本与变更维护:HTTP 接口与外部系统

围绕科研伦理审查的资料版本与变更维护,说明HTTP 接口与外部系统的配置前提与核对动作,结合伦理审查申请、知情同意书模板确认结果传递与生效状态,附上线前的验证步骤。

这个品类的数据长什么样

科研伦理审查场景中,伦理审查申请、知情同意书模板、风险评估表三类材料进入同一套资料版本与变更维护流程。伦理审查申请承载研究名称、方案版本、提交日期与研究者签字;知情同意书模板承载受试者告知项、签署栏与版本日期;风险评估表承载风险等级、处置措施、评估日期与审核签字。三类材料字段交叉引用,同一记录的名称、数量、日期须一致。资料以现行版本唯一、旧版可追溯为更新节奏,每次内容变更触发版本号递增,引用该材料的申请与文档同步更新。材料进入该功能时,HTTP 节点负责向外部系统传递版本台账与变更记录所需的请求,不承担写库与审批。

配置怎么定

这一环由工作流里的 HTTP 节点执行,输出响应体、状态码与返回字段。「版本台账与变更记录」由后续节点解析响应,或外部系统按约定处理接着完成。请求地址、路径参数、请求头与请求体均可通过 variables 引用全局变量、系统变量或前方节点输出,鉴权信息按外部系统要求放入 Authorization。

对象判断核验动作
伦理审查申请研究名称、方案版本、提交日期与研究者签字须与知情同意书模板一致在请求预览里核对渲染后的完整地址与请求体字段,比对 responseData 返回的名称、版本与日期
知情同意书模板受试者告知项、签署栏与版本日期须与风险评估表引用一致核对请求头名称与取值来源,用一条样例请求比对返回字段中的版本号与签字回执
风险评估表风险等级、处置措施、评估日期与审核签字须与申请记录对应在变量面板核对每个占位的来源,确认 variables 与 Authorization 解析成实际值
版本台账现行版本唯一、旧版可追、引用同步改一处内容后,核版本号与引用是否同步更新,并记录返回字段中的版本标识

容易做错的三处

  • 现象:同一记录在申请与知情同意书模板里的名称、数量、日期对不上。原因:两处材料分别维护,变更未同步到引用方。
  • 现象:版本未同步,旧版仍被引用。原因:版本号未随内容变更递增,引用关系未随台账刷新。
  • 现象:缺签字或回执,外部系统收到空字段。原因:请求体字段与外部接口约定不一致,或占位变量未解析。

怎么确认配好了

本功能验收:预览渲染后的请求,核状态码与返回字段,再对一条样例比对结果,确认 responseData、variables、Authorization 均按预期解析。

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

  • 在请求预览里核对渲染后的完整地址、请求头名称与请求体字段,确认占位变量能解析成实际值。
  • 用一条样例请求比对返回字段,确认版本台账与变更记录中的版本号、引用关系同步更新。