2. 临床结局评估量表数字化
把一张纸质量表搬进 eCOA 平台，绝不是把题目逐条敲进表单那么简单。纸质量表里隐含了大量“人脑默认执行”的规则——跳转、计分、时间窗、缺失判定——这些规则在电子化时必须被显式地建模、编码和校验。本节围绕“结构解析—条目建模—评分规则—逻辑校验—电子化转换”这条主线，讲清楚一张量表从纸面到可运行电子表单的完整转换方法。
一、量表结构解析：先拆骨架，再填内容
任何量表都可以拆成四层结构：量表（Instrument）→ 维度/子量表（Domain/Subscale）→ 条目（Item）→ 选项（Response Option）。以常见的 12 条目健康调查简表（示例，非真实量表）为例：它包含“躯体功能”“情绪状态”两个维度，每个维度下挂若干条目，每个条目绑定一组选项。解析时要做三件事：
- 确定层级归属：每个条目属于哪个维度，维度是否参与独立计分。
- 确定条目顺序与呈现方式：是逐条呈现还是整页呈现，是否允许回看修改。
- 确定条目间的依赖关系：哪些条目是“条件条目”，只在特定前置回答下才出现。
结构解析的产出通常是一份“量表结构清单”，它是后续所有建模工作的唯一依据。清单里每个条目至少要有：条目编号、题干文本、选项集合、所属维度、是否必答、跳转条件、计分方向。
二、条目类型：决定控件与校验方式
条目类型直接决定电子表单用什么控件、做什么校验。常见类型包括：
| 条目类型 | 典型形式 | 电子控件 | 关键校验 |
|---|---|---|---|
| 单选（Single Choice） | 5 级 Likert | 单选按钮组 | 必答、选项互斥 |
| 多选（Multi Choice） | 症状勾选 | 复选框组 | 最少/最多选几项 |
| 数值（Numeric） | 疼痛评分 0–10 | 数字输入/滑块 | 范围、整数、步长 |
| 日期时间（DateTime） | 症状发生时间 | 日期选择器 | 不晚于当前、不早于入组 |
| 文本（Text） | 开放补充说明 | 文本框 | 长度、是否必填 |
| 视觉模拟（VAS） | 100 mm 标尺 | 滑块 | 0–100 连续值 |
类型选错会带来连锁问题。例如把 0–10 的疼痛评分做成自由文本，就无法做范围校验，也无法参与计分。因此条目类型必须在结构解析阶段就锁定。
三、评分规则：从条目分到总分
评分规则是量表数字化的核心难点。它通常包含三层：条目计分（选项→分值）、维度计分（条目分→维度分）、总分计分（维度分→总分）。以示例量表为例，采用 1–5 分 Likert 计分，其中反向条目需要先翻转：
条目 Q3 为反向条目：
原始选项分 = 1,2,3,4,5
翻转后得分 = 6 - 原始分
维度分 = 该维度下所有条目得分之和
总分 = 各维度分之和
缺失处理：若某维度缺失条目数 > 该维度条目数的 50%，则该维度分记为缺失这里有两个必须明确的约定：一是计分方向（正向/反向），二是缺失值规则。缺失规则又分“条目级缺失”和“维度级缺失”，前者影响维度分计算，后者影响总分是否可算。这些规则必须在电子表单中写成可执行逻辑，而不是留给数据管理员事后手工处理。
四、逻辑校验：让表单自己“拦住”错误
逻辑校验分四类，建议按优先级依次实现：
- 必答校验：未作答的必答条目阻止提交。
- 范围校验：数值型条目限定上下限与步长，如疼痛评分 0–10 整数。
- 一致性校验：跨条目比对，如“是否吸烟=否”时“每日吸烟量”应为空或 0。
- 跳转校验：条件条目只在满足前置条件时出现，且出现后变为必答。
五、电子化转换方法：从结构清单到可运行表单
推荐的转换路径是“结构清单 → 数据模型 → 表单渲染 → 规则引擎 → 测试用例”。数据模型用 JSON 描述量表结构，规则引擎负责执行跳转与计分。下面给出一个条目级 JSON 示例：
{
"itemId": "Q3",
"text": "过去一周，您感到情绪低落的频率",
"type": "single",
"options": [
{"code": 1, "label": "从不"},
{"code": 2, "label": "偶尔"},
{"code": 3, "label": "有时"},
{"code": 4, "label": "经常"},
{"code": 5, "label": "总是"}
],
"required": true,
"reverseScored": true,
"domain": "emotion"
}转换完成后，必须用测试用例验证：正常作答、边界值、跳转触发、反向计分、缺失处理五类场景各至少一条。只有测试通过，量表才算真正“电子化”完成。
总结来看，量表数字化的本质是把纸质量表里“隐含的规则”变成“显式的、可执行的、可测试的逻辑”。结构解析确定骨架，条目类型确定控件，评分规则确定算法，逻辑校验确定边界，电子化转换把四者串成一条可运行、可验证的链路。只有这条链路完整闭合，eCOA 平台采集到的数据才具备可计分、可溯源、可审计的质量基础。