25 字段嵌套

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

登录后打开您的项目，进入 在线设计器。这是西安交通大学公共卫生学院维护的采集入口（现网 REDCap 17.4.5）。用药、家庭成员这类题若每项占一整行，一页会拉得很长。本篇用字段嵌套：把已经建好的字段挪到同一张表的另一处，例如嵌进一个表格。字段类型本身仍按 09 字段类型怎么选 来建。方括号把别的字段的值抄进来显示，是后面的智能变量，不是本篇。

上图为手册示意。现网说明在设计器右侧 如何在其他位置嵌入字段（也写作 如何嵌入字段）。最常见的放法，是写在 描述性 字段的标签里，并用 富文本编辑器 排成表格。

---

1. 适用场景

• 多个相关字段要排在同一块区域或一张小表里，而不是各自占一行。
• 选项旁边要跟着一个补充填空，例如选「其他」后立刻出现说明框。
• 嵌进去之后，原位置不再单独露出来。

字段还没建好时，先用 08 向表单添加字段 建好再嵌。要藏掉整张表，用 16 表单显示逻辑；要藏掉一道题，用 24 分支逻辑。

---

2. 操作步骤

2.1 先有字段，再写花括号

1. 打开 https://www.wcrcnet.cn/redcap/ 登录。页脚是 REDCap 17.4.5。
2. 在本张表里建好待嵌入的字段，记下变量名。校验、分支逻辑仍然留在这些字段上，嵌套不会把它们清掉。
3. 打开宿主字段（常用 描述性 文本），在标签、注释、节标题或选项标签里写入 {变量名}，例如 {date_dob}。花括号里是变量名，不是中文标签。
4. 保存后新建一条测试记录，打开这张表看位置对不对。设计器里的 预览工具 也能看个大概，但布局以测试记录为准。

同一张表、同一页调查才能嵌。多页调查上，嵌入字段和宿主字段必须在同一页。一个字段不能嵌进自己的标签或注释。下拉选项的标签、调查说明、调查确认文字、调查队列文字，以及邀请信、通知信的正文里，都不能放 {变量名}。

数据录入页上若要在新位置旁看到字段注释等图标，写成 {last_name:icons}。调查页上不显示这些图标。

2.2 花括号和方括号

{date_dob} 是把该字段搬过去，原来那一行不再单独出现。[date_dob] 是在文字里引用它的值，原来的字段还在。两套符号不要混用。引用值的写法留在智能变量那篇。

宿主字段若因分支逻辑被隐藏，嵌在里面的字段一起隐藏。嵌入字段自己的分支逻辑仍然生效：条件为假时，只藏这个嵌入字段。

---

3. 注意与权限

• 改标签需要项目设计权限。生产库中改设计要进草稿模式。
• 嵌套只在网页上的表单和调查里生效。REDCap 移动应用程序里看不到这种排版。
• 变量名改了之后，花括号里的名字要一起改，否则页面上会留一个空位或报错。
• 用本平台数据写论文，致谢按登录页上的文字抄。

---

4. 常见问题

嵌完之后，原来的位置还在？ 写的是方括号 [变量名]，不是花括号 {变量名}。方括号不会把原字段挪走。

保存或打开表单时提示不能嵌入？ 常见原因：嵌进了自己、嵌进了下拉标签、嵌进了调查说明或邮件正文，或嵌到了另一张表、另一页调查。改回同一张表、同一页上另一个字段的标签。

表格里的填空不随分支逻辑消失？ 逻辑要写在被嵌入的那个字段上，或写在宿主字段上。只改了表格里的说明文字，不会隐藏输入框。

预览里对齐，真实记录里错位？ 以测试记录打开的数据录入页为准，再回 富文本编辑器 调整。

---

5. 建议记住的几条

• 字段先建好，再把 {变量名} 放进同一张表另一个字段的标签或注释。
• 花括号是搬走并藏起原位置；方括号是引用值，原字段还在。
• 不能跨表、不能跨调查页，也不能嵌进下拉标签和邀请信。
• 用一条测试记录看效果；预览工具 只作参考。