数据返填 · 使用说明
本文面向系统使用人员，说明「数据返填」功能的操作方式与具体返填规则，便于直观了解“哪些表单会返填、怎么填、什么情况会跳过”。
「数据返填」用于把表单数据库中某个数据版本的表单数据，自动填写到指定中心 / 受试者已有表单的对应字段中。
- 数据来源：表单数据库中选定的数据版本（分类）；
- 目标对象：指定中心下的一个受试者；
- 后台异步执行，结果可在「返填记录」中查看；
- 一次返填任务 = 一个中心 + 一个受试者 + 一个数据版本。
- 进入 项目管理 页面，找到目标项目，打开 数据返填 抽屉；
- 在「数据返填」页签中依次选择：数据版本、中心、受试者；
- 点击「确认」，提示「数据返填任务添加成功」，后台开始执行；
- 任务完成后页面右上角弹出通知：成功提示「数据返填任务已完成」，失败提示「数据返填任务失败」；
- 切换到「返填记录」页签查看结果，点击操作列的放大镜可查看「返填详情」。
| 表单类型 | 是否返填 | 返填规则说明 |
| 访视表单 | ✅ 是 | 按受试者访视计划处理。表单存在则直接返填；若尚未创建，会自动创建后再返填 |
| 特殊事件（计划外访视 / 不良事件 / 伴随用药 / 其他特殊事件 / 非药物治疗） | ✅ 是 | 仅返填已创建的表单；未创建的跳过，不新建 |
| 过程管理单 | ✅ 是 | 仅返填已创建的表单；未创建的跳过 |
| 方案偏离单 | ✅ 是 | 仅返填已创建的表单；未创建的跳过 |
| 样本管理单 | ✅ 是 | 仅返填已创建的表单；未创建的跳过 |
| 知情同意文件 | ❌ 否 | 通常为扫描件 / 电子签名文件，非可填字段表单，不参与返填 |
-
只填“已创建”的表单，且“多份都填”
– 系统以受试者已创建的表单实例为处理对象；
– 同一表单在受试者下存在多个实例（如多次不良事件记录）时，每个实例都会被返填；
– 例外：访视表单若尚未创建，系统会自动创建后再返填（保证访视数据完整）；其余非访视类型未创建则跳过、不新建。 -
已完成的表单不覆盖
– 表单状态为已完成时，系统不改动它，结果记为「此表单已完成, 反填失败」，以保护已完成 / 已封存数据。 -
已创建但附件未落地的表单，先生成再返填
– 某些表单“已创建但尚未保存过”（附件未生成），系统会先用项目内的认证表单模板生成附件，再执行返填。 -
按数据版本筛选表单
– 只使用所选数据版本下的表单数据，其他版本不参与；
– 表单数据库中存在、但受试者侧匹配不到的表单，会在结果中提示「剩余无法正确匹配或不存在于受试者表单」。
系统逐字段比对后写入，满足以下全部条件的字段才会被写入：
| 校验项 | 要求 |
| 字段名称 | 表单数据库字段名必须能在目标表单中找到，否则记「表单不存在此字段」 |
| 字段类型 | 数据库字段类型与目标表单字段类型必须一致，否则不写入 |
| 字段格式 | 数据库字段格式与目标表单字段格式必须一致，否则不写入 |
- 签字域不参与返填，也不计入成功 / 失败数量；
- 部分字段成功、部分失败时，整体结果记为「部分反填成功」，并在错误信息中列出具体字段原因。
| 列 | 说明 |
| 中心 | 本次返填的中心 |
| 受试者 | 本次返填的受试者（筛选号 / 随机号） |
| 返填版本 | 本次使用的数据版本名称 |
| 表单总数 | 该版本包含的表单数量；点击数字可查看具体表单清单 |
| 成功数 | 实际返填成功的表单数量；点击数字可查看成功表单清单 |
| 返填结果 | 逐表单的返填结论（成功 / 部分成功 / 失败及原因），过长时悬停查看全文 |
| 操作用户 / 操作时间 | 发起本次返填的用户与时间 |
| 操作 | 点击放大镜查看「返填详情」 |
| 列 | 说明 |
| 记录类型 | 明确标识该表单来自访视还是特殊事件 / 过程管理单 / 方案偏离单 / 样本管理单等类型 |
| 表单名称 | 返填的表单中文名称 |
| 总数 / 有值 / 返填 | 字段总数 / 数据库中有值的字段数 / 实际返填成功的字段数 |
| 返填结果 | ✔ 成功 / ✘ 失败 |
| 错误信息 | 失败或部分失败的具体字段原因 |
| 操作用户 / 操作时间 | 执行信息 |
| 操作 | 点击查看该表单的「数据库数据信息」明细 |
返填结果的每条消息形如：将表单数据库表单[表单名]数据对[记录类型]进行填充：反填成功，方括号部分会标明表单名与记录类型。常见结论如下：
| 提示语（结论文本） | 含义 |
| 反填成功 | 该表单所有应填字段均已成功写入 |
| 部分反填成功 | 部分字段写入成功，部分字段因类型 / 格式不匹配或字段不存在而未写入，详见错误信息 |
| 表单附件未找到, 反填失败 | 表单记录存在，但对应文件未找到，无法返填 |
| 此表单已完成, 反填失败 | 表单已完成，为保护数据不覆盖而跳过 |
| 项目表单中未找到此表单, 反填失败 | 项目内不存在该表单（或未生效 / 未认证） |
| 受试者无此表单, 反填失败 | 受试者侧没有对应表单 |
| 数据库附件表写入错误, 反填失败 | 附件信息写入异常，请重试或联系系统管理员 |
| 反填异常, 反填失败 | 处理过程中出现异常，请重试或联系系统管理员 |
| 剩余无法正确匹配或不存在于受试者表单: A、B… | 该版本中这些表单在受试者侧匹配不到，未执行返填 |
| 所有表单数据填写完成 | 该版本中所有表单均已匹配并处理完成 |
- 返填范围取决于受试者已有表单：非访视类型“没有就不建”，只处理已经创建出来的表单。
- 过程管理单为中心级数据：其可见范围按中心与试验分组控制，可能不是严格按单个受试者隔离。
- 字段需要一致：表单数据库表单与项目内认证表单的字段名 / 类型 / 格式需一致，否则只能部分返填或无法返填。
- 已完成表单不覆盖：如需返填已完成表单，需先在业务上处理其状态。
- 一次一个受试者：一次任务只针对一个受试者的一个数据版本；多受试者请分别发起。
- 返填结果可追溯：所有结果均记录在「返填记录 / 返填详情」中，并区分表单来源的记录类型，便于核查。
提示：若某张表单确实存在（在其他界面可正常打开）但返填提示「表单附件未找到」，通常是该表单文件的存放方式较特殊（如集中单）。请记录下受试者、表单名称、记录类型并反馈系统管理员排查。