11 文件上传字段

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

登录后打开您的项目，进入 在线设计器 并点开表单，用 08 向表单添加字段 的步骤打开 添加新字段。这是西安交通大学公共卫生学院维护的采集入口（现网 REDCap 17.4.5）。09 字段类型怎么选 点过 文件上传；本篇只把它配好：让填写人上传附件或图像。字段矩阵见下一篇；描述性文本里附说明文件，那是另一种类型。

上图为手册示意；现网对话框分区可能略有调整，以您看到的 字段类型 选项名为准。

---

1. 适用场景

• 需要收集知情同意扫描件、检验报告 PDF、伤口照片、签名页照片等，答案本身就是一个文件。
• 一张表里某一题必须「有文件才算填完」，而不是只在说明区放一份只读模板。
• 单份附件体积不超过手册给出的上限（约 50MB）；更大文件请先压缩或拆分后再传。

只要说明文字、不要求对方上交文件，用 描述性文本（可附模板）即可，不必建上传字段。

---

2. 操作步骤

2.1 添加一个文件上传字段

1. 打开 https://www.wcrcnet.cn/redcap/ 登录。页脚是 REDCap 17.4.5。
2. 我的项目 → 项目标题 → 在线设计器 → 点开目标表单。
3. 点 添加字段（有的位置写作添加新字段）。
4. 字段类型 选 文件上传。
5. 填写 字段标签（给人看）和 变量名称（给库用，字母数字下划线）。
6. 该题必须上传才算完成时，将 必需 设为是；能识别个人身份的扫描件勾 标识符。
7. 点 保存。

变量名建议一眼能看出内容，例如 consent_scan、lab_pdf，避免笼统的 file1。

2.2 录入端怎么用

打开记录进入该表后，填写人会看到上传控件：选择本地文件并保存表单。已上传的文件一般可在同页查看或重新上传替换（以现网按钮为准）。导出数据时，文件类字段通常给出文件名或下载入口，而不是把二进制塞进 CSV 单元格；批量下载附件走项目里的文件相关功能（若已开启）。

2.3 和相近类型的区别

需求	建议类型
对方必须上交一份文件/图片	文件上传
只展示说明，并可附只读模板	描述性文本
手写签名轨迹	签名（不是上传一张签名照片；若只要扫描件仍用文件上传）

---

3. 注意与权限

• 需要项目设计权限才能新增或改字段类型。
• 上传字段往往含身份信息或病历影像，设计时勾好 标识符，导出与分享前按课题去标识规则处理。
• 单文件约 50MB 上限；超限时先压缩或换格式，再让对方重传。
• 生产模式下改结构，先按界面提示进入可设计状态。
• 用本平台数据写论文，致谢按登录页上的文字抄。

---

4. 常见问题

上传后导出 CSV 里为什么看不到图片内容？ 正常。表格导出通常只保留文件名或链接类信息；原文件仍在项目附件侧，按导出/下载入口取。

能不能一道题传很多个文件？ 一个文件上传字段对应一次上传位。需要多份独立材料时，建多个上传字段，或约定打成一个压缩包再传（注意大小上限）。

描述性文本里已经附了模板，还要再建上传字段吗？ 模板给对方看；对方交回的扫描件或照片，用 文件上传 采集。

超过 50MB 怎么办？ 先压缩或拆成多题；仍不够时与管理员确认本站是否另有大文件约定，不要反复撞上限。

---

5. 建议记住的几条

• 入口：添加字段 → 字段类型 → 文件上传。
• 标签给人看，变量名给库用；身份相关勾 标识符。
• 单文件约 50MB；超限先压缩再传。
• 只要展示模板用描述性文本；要对方交文件才用上传字段。
• 矩阵、计算、CDE 不在本篇。