26 智能变量

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

登录后打开您的项目，进入 项目设置。这是西安交通大学公共卫生学院维护的采集入口（现网 REDCap 17.4.5）。邀请信或字段标签里如果写死一个人的姓名，换一条记录仍是旧名字。本篇用方括号把值放进文字：普通字段写成 [变量名]，能跟着当前记录、事件或调查变化的名字叫做 智能变量。用花括号 {变量名} 把字段从原位移走，见 25 字段嵌套。

上图为手册示意。现网这一排的按钮名是 智能变量。点开后是 智能变量列表，里面有每个名字的说明和例子。现网把往文字里插入值叫做 管道。

上图把随访事件的自定义标签写成 第[current-instance]次注射。重复实例依次是 1、2、3 时，标题会变成第 1 次、第 2 次。项目还没有重复表单或重复事件时，这个名字没有可显示的编号。

---

1. 适用场景

• 字段标签、调查邀请或确认信里，要出现这条记录自己的编号、姓名或日期。
• 自动邀请的正文里，要放这条记录对应的调查链接。
• 计算或分支逻辑里，要引用另一个字段，或判断当前打开的是调查还是数据录入页。

名单以 智能变量 按钮里的说明为准。项目仪表板上的智能图、智能表，不在本篇。

---

2. 操作步骤

1. 打开 https://www.wcrcnet.cn/redcap/ 登录。页脚是 REDCap 17.4.5。
2. 在 项目设置 点 智能变量，先核对名字，再抄进项目。
3. 引用本项目的字段：方括号里写变量名，例如 [weight]。单项选择、下拉默认带出选项文字。要原始编码时，在名字后加 :value，写成 [icecream:value]。
4. 引用当前上下文：用列表里的智能变量，例如 [record-name]。判断当前页是不是调查，用 [is-survey]。
5. 调查链接写成 [survey-link:表单名] 或 [survey-url:表单名]。冒号后面是表单的英文名称，不是中文标题。自动邀请缺这个链接会无法保存，见 21 调查自动邀请。
6. 纵向项目里，上一事件的某个字段写成 [previous-event-name][变量名]，两对方括号挨着放。纵向怎么打开，见 05 启用纵向数据收集。
7. 保存后用一条测试记录打开数据录入页，再打开调查，核对带出来的是不是这条记录的值。

---

3. 注意与权限

• 改标签和邀请需要项目设计权限。生产库中改设计要进草稿模式。
• 管道不按数据查看权限过滤。看得到这段文字的人，就看得到带出来的值，即使对方打不开来源那张表。标识字段不要放进会转发出去的邀请、确认信或书签。
• 文件上传字段默认带出的是内部编号。要原始文件名，写成 [变量名:label]。
• 用本平台数据写论文，致谢按登录页上的文字抄。

---

4. 常见问题

带出来的是编码，不是选项文字？

单项选择和下拉默认是文字。写成 [变量名:value] 时，带出的才是编码。

邀请里的链接是空的？

写成 [survey-link:表单名]，表单名用设计器里的英文名称。只写 [survey-link]、不带表单名，在没有默认表单的位置会是空的。

方括号写了，原字段却不见了？

搬走字段的是花括号 {变量名}。方括号只把值抄进文字，原来的字段还在。见 25 字段嵌套。

自定义标签没有变成「第几次」？

[current-instance] 只在重复表单或重复事件里有编号。普通的一次性事件上，它没有 1、2、3 可显示。

---

5. 建议记住的几条

• 入口：项目设置 → 智能变量，核对名字后再写进方括号。
• 字段写成 [变量名]；要编码时加 :value。
• 调查链接写成 [survey-link:表单名]，表单名用英文名称。
• 标识内容不要管道进会转给他人的邮件或书签。