54 CSV 导入与更新记录

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

登录后打开项目，左侧进入 数据导入工具。西安交通大学公共卫生学院维护的现网是 REDCap 17.4.5。已有一批记录在表格里，要写进项目或改掉已保存的值，用 CSV，不要去改数据字典。数据字典改的是字段结构（见 28）。本篇是把一行行记录传进去。

手册这一步没有单独截图。现网入口是 数据导入工具。可以 下载您的数据导入模板，也可以改一份从本项目导出的 CSV。

---

1. 适用场景

• 外部表里已有筛选号和若干字段，要一次写入多条记录。
• 已有记录要批量改几个字段，CSV 里带原来的记录编号。
• 项目开了 记录自动编号，要决定新行是沿用文件里的编号，还是交给系统顺延。

单条录入仍走 添加/编辑记录。计算字段不用写进 CSV，导入时会重算。

---

2. 操作步骤

2.1 准备 CSV

1. 打开 https://www.wcrcnet.cn/redcap/ 登录。页脚是 REDCap 17.4.5。
2. 数据导入工具 → 下载您的数据导入模板。
3. 第一行用变量名，不要写成字段的中文标签。单选、下拉填选项的原始编码，不填选项上的文字。
4. 纵向项目按模板保留事件列。多中心若模板里有数据访问组列，一条记录只填一个组。

2.2 上传并核对预览

1. 点 浏览，选中 CSV，再点 上传文件。
2. 上传后数据还没进项目。预览表里：黑色是 新数据，灰色是 现有数据(不会改变)，另一色是 将被覆盖的数据。
3. 有警告先改文件再重新 上传文件。确认后点页面底部的 导入数据。

文件很大时，现网可能改由后台导入，完成后发邮件。以页面上的成功提示为准。

开了 记录自动编号 时，导入页有两种选择。沿用 CSV 里的记录名，就不要选 是，对每条记录使用记录自动编号。

预览里有一项设成「是」之后，CSV 中的空单元格会覆盖已保存的值，把库里的数清掉。只想改有内容的格子时，保持这项为否。

---

3. 注意与权限

• 需要数据导入权限。分在数据访问组里的人，只能导入本组的记录。
• 计算字段 以及带 @CALCTEXT、@CALCDATE 的字段不会按 CSV 里的数写入，导入过程中会重算。
• 生产状态下更新已有记录，可能要求填写变更原因，缺了会导入失败。
• 用本平台数据写论文，致谢按登录页上的文字抄。

---

4. 常见问题

预览里全是错误，编码明明对？ 表头用了中文标签，或单选填了选项文字。改成变量名和原始编码后再 上传文件。

导入成功，某个自动填的字段仍是旧值？ 带 @SETVALUE 的字段不会在导入时刷新。打开该记录的表单保存一次，才会按当前值重写。

空着的列把原来的数抹掉了？ 空单元格覆盖被设成了「是」。只补有内容的列时，把这项改回否，空列不要留在会覆盖的位置。

---

5. 建议记住的几条

• 入口：数据导入工具 → 上传文件 → 看预览 → 导入数据。
• 表头用变量名，选项填编码。
• 空单元格是否覆盖已有值，在点 导入数据 之前看清楚。