28 数据字典：离线改字段再上传

适用平台：陕西省重大疾病防控与大健康数据共享平台（REDCap 17.4.5） 维护单位：西安交通大学公共卫生学院流行病与卫生统计学系 读者：已获账号、具备项目设计权限的项目负责人与数据管理员 更新日期：2026-09-23

登录后打开您的项目，进入 在线设计器 一带的设计页。这是西安交通大学公共卫生学院维护的采集入口（现网 REDCap 17.4.5）。字段可以在浏览器里逐条加，也可以整表用 数据字典 离线改：下载 CSV，用电子表格批量增删改，再 上传您的数据字典文件。本篇只讲这条离线路径；只查字段属性见下一篇编码手册。

上图为手册示意。现网常见按钮：下载数据字典 / 下载当前数据字典，以及 上传您的数据字典文件（仅 CSV）。设计器说明里也会把 在线表单编辑器 与 上传数据字典 并列为两种改法。

---

1. 适用场景

• 一次要加几十个字段，或统一改变量名、选项编码、字段标签。
• 希望在 Excel 里排序、筛选、复制整行后再回传。
• 团队用版本对比（本地留一份旧 CSV）跟踪结构变更。

只改一两个字段，继续用在线设计器更省事。生产库大改结构前，先在练习项目或草稿流程里验证。

---

2. 操作步骤

2.1 下载当前字典

1. 打开 https://www.wcrcnet.cn/redcap/ 登录。页脚是 REDCap 17.4.5。
2. 进入项目 → 打开数据字典相关页（多在 在线设计器 / 项目主页与设计下的字典标签）。
3. 点 下载数据字典（或 下载当前数据字典）。分隔符可选逗号、制表符或分号；日常用逗号 CSV 即可。

示范文件（数据字典示范文件）不是您项目的字典，只教格式，不要当成当前结构去改。

2.2 离线编辑

用 Excel 或其他表格软件打开 CSV。常见列包括变量名、表单名、字段类型、标签、选项、分支逻辑、计算等（以下载文件表头为准）。

注意点	说明
保存格式	必须仍是 CSV；不要存成 xlsx 再直接上传
变量名	字母数字下划线；改名后同步改分支逻辑与计算里的引用
字段类型等	须用 REDCap 允许的取值；非法值上传时会被拒或清空
复杂计算	可在字段注释里用人话写清含义，方便以后查

改完另存一份带日期的备份，再准备上传。

2.3 上传并确认

1. 回到同一页，在 使用下面的表单上传数据字典 处选择文件。
2. 系统先检查错误；有 在您的数据字典中找到的错误 须改完再传。
3. 检查通过后确认对项目做更改；成功后现网会提示字段更改已实施一类信息。

开发状态下可直接改结构。生产模式下通常要先进入草稿/设计变更流程，再提交审批（后续「生产模式下修改设计」专篇）。上传前系统常会自动留一份工具快照，便于回退。

---

3. 注意与权限

• 需要项目设计权限。上传会整体替换元数据，误传会大范围改表，正式库务必先备份或确认有快照。
• sql 类型等字段可能仅管理员可改；被拦时按提示联系本站管理员，不要强行改类型绕过。
• 不要把真实受试者标识写进字段标签示例。
• 用本平台数据写论文，致谢按登录页上的文字抄。

---

4. 常见问题

上传提示必须是 CSV？ 在 Excel 里另存为 CSV（逗号分隔）再传。xlsx 不能直接当数据字典用。

只有警告没有错误，能继续吗？ 警告有时可忽略，错误必须改。以页面列出的 错误 / 警告 分区为准。

上传后分支逻辑报错？ 多半是改了变量名却没改逻辑里的旧名。对照编码手册或在线设计器逐条修。

和「工具快照」什么关系？ 快照是某一时刻整份字典的备份；可下载后再上传以恢复。日常批量改字段仍走本篇的下载—编辑—上传。

---

5. 建议记住的几条

• 流程：下载数据字典 → 离线改 CSV → 上传您的数据字典文件。
• 只认 CSV；示范文件不是您的项目。
• 改名要连带改逻辑与计算；正式库先练习项目或走草稿。
• 只想查某个字段属性，用编码手册，不必每次下载整表。