27 动作标签

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

登录后打开您的项目，进入 在线设计器，编辑一个字段。这是西安交通大学公共卫生学院维护的采集入口（现网 REDCap 17.4.5）。有的数要系统算好给录入员看，调查页上却不必让参与者改。本篇用 动作标签：以 @ 开头，写在 动作标签 / 字段注解 框里。这些词只出现在设计界面，填写页上看不到。公式怎么写，见 10 计算字段。

上图为手册示意。框的名称是 动作标签 / 字段注解。框下方的按钮是 @ 动作标签，打开后列出 所有可用的动作标签及其说明。手册把关闭窗口写成「更新并关闭编辑器」，现网按钮是 保存 和 取消。

---

1. 适用场景

• 计算字段在调查上隐藏，在数据录入页只读。例如 BMI 给录入员看，参与者不改。
• 字段还空着时放入一个初始值，一旦保存就不再覆盖。
• 每次打开页面，都按当时的其他字段重写某一个值。

名单很长，仍在更新。用之前先点 @ 动作标签 看这一条的格式。外部模块另加的标签，以该模块自己的说明为准。

---

2. 操作步骤

1. 打开 https://www.wcrcnet.cn/redcap/ 登录。页脚是 REDCap 17.4.5。
2. 在线设计器 中打开字段，找到 动作标签 / 字段注解。
3. 多个标签之间空一格，或各写一行。以 // 开头的文字只是给人看的注释，不改变字段。
4. 调查隐藏、录入页只读的计算字段：公式按 10 计算字段 写好，框里再加上 @HIDDEN-SURVEY @READONLY-FORM。
5. 只在字段还没有保存过数据时填一次：@DEFAULT='初值'。保存后再打开，已填写的内容留在那里。
6. 每次打开数据录入页或调查页都覆盖现有值：@SETVALUE='文字'。文本字段里也可以带上其他字段的值，例如 @SETVALUE='[first_name] [last_name]'。方括号的写法见 26 智能变量。
7. @NOW 在打开页面时，把当时的日期和时间写入还空着的文本字段。它不是点击 保存 的时刻，也不会改掉已经保存的值。
8. 点 保存。用一条测试记录分别打开数据录入页和调查页，看隐藏、只读和赋值是否如预期。

@SETVALUE、@NOW、@TODAY 会自己写入值。字段上同时有分支逻辑时，离开页面可能弹出是否擦除的提示。要让填写人看不见，用 @HIDDEN，见 24 分支逻辑。

---

3. 注意与权限

• 改注解需要项目设计权限。生产库中改设计要进草稿模式。
• 动作标签在网页上的表单和调查里起作用。短信调查、语音调查不使用这些标签；本站发给参与者的邀请走邮件。
• 字段注解 里的注释不会出现在填写页、调查页或 PDF 上。
• 用本平台数据写论文，致谢按登录页上的文字抄。

---

4. 常见问题

调查里还能看见 BMI？

看注解里有没有 @HIDDEN-SURVEY。只写 @READONLY-FORM 时，调查上仍然显示，数据录入页不能改。

保存过的内容被盖掉了？

用的是 @SETVALUE，每次打开页面都会覆盖。只要一个初始值、保存后不再动，改成 @DEFAULT。

两个标签写在一起没有生效？

中间要有空格或换行。写成 @HIDDEN-SURVEY@READONLY-FORM 时，系统认不出后面那一个。

想让填写人在备注框里自己加粗？

那是加在备注字段上的 @RICHTEXT。设计器里 字段描述 的 使用富文本编辑器，只美化说明文字，不把答案框变成富文本。

---

5. 建议记住的几条

• 入口：编辑字段 → 动作标签 / 字段注解，先点 @ 动作标签 看格式。
• 多个标签用空格或换行分开；// 后面的注释不影响字段。
• @DEFAULT 只填还空着的字段；@SETVALUE 每次打开都覆盖。
• 要藏起来用 @HIDDEN 或 @HIDDEN-SURVEY，再用测试记录看调查页和录入页。