33 定义事件

使用指南

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

登录后打开您的项目,进入 项目设置。这是西安交通大学公共卫生学院维护的采集入口(现网 REDCap 17.4.5)。基线、第 7 天、第 16 天如果各复制一张表,改一个字段就要改三处。本篇在已经打开纵向的项目里 定义事件:一个事件是一个时点,表单仍只建一次。纵向总开关见 05 启用纵向数据收集。

项目设置中的定义事件
图-33-1 项目设置中的定义事件

上图为手册示意。这一段的标题是 定义你的事件并指派收集工具。要进的按钮是 定义事件。旁边的 为事件指派表单 见 34 为事件派发表单。本篇先把时点列出来。

事件的天数、偏移和标签
图-33-2 事件的天数、偏移和标签

上图为手册示意。每一行是一个事件。事件标签 是人看的名字,如入组、第一次随访。相距时间天数 从第一个事件算起,入组常写 0。偏移范围 是允许提前或推后的天数。唯一事件名称 由系统生成,逻辑和导出里用它,不要改 事件 ID。


1. 适用场景

  • 随访时点事先定好:入组、第 1 周、第 1 个月。
  • 同一条记录要在多个时点填同一张表。
  • 研究分暴露组和对照组,两边的访视安排不一样,需要两个 分组。

次数事先不知道的内容,例如不良事件、合并用药,用 35 重复采集,不是多建几个事件。家庭成员也不要做成事件或分组。


2. 操作步骤

  1. 打开 https://www.wcrcnet.cn/redcap/ 登录。页脚是 REDCap 17.4.5。
  2. 确认 主要的项目设置 里 使用定义事件的纵向数据收集? 已经 启用。没有这一行时,先做 05 启用纵向数据收集。
  3. 在 定义你的事件并指派收集工具 中点 定义事件。
  4. 看默认的第一行。把 事件标签 改成入组或基线,相距时间天数 保持 0。
  5. 在表底填写下一次随访:天数、偏移范围 的最小和最大、事件标签。间隔若是周或月,点 从其他单位转换,换成天数后再填。
  6. 点 增加新事件。还要访视就再加一行。铅笔图标改已有行,红叉删除还没有数据的事件。
  7. 自定义事件标签 可留空。要在记录页标题上显示该次访视的日期时,用方括号写已经存在的变量,例如 [visit_date],写法见 26 智能变量。
  8. 多数项目保持一个分组。只有访视日程本身不同时,才点 添加新的分组,并用 重命名分组 写成暴露组、对照组。
  9. 用一条测试记录打开 记录状态仪表板,看列是不是这些事件。

相距时间天数 和 偏移范围 要等 37 计划进度 才会用来生成日程。没开那个模块时,事件仍然可以定义,日历不会按这些天数自动排程。日历本身见 39 日历。


3. 注意与权限

  • 改事件需要项目设计权限。生产库里改事件时,按页面提示进入草稿模式再提交。
  • 已有填写数据的事件,删除前先确认该时点没有要留下的记录。页面若拒绝删除,以提示为准。
  • 分组 表示不同的访视安排,不是一条记录里的家庭成员,也不是第几次就诊。
  • 用本平台数据写论文,致谢按登录页上的文字抄。

4. 常见问题

找不到定义事件?

纵向还没开。先在 项目设置 启用 使用定义事件的纵向数据收集?。

想按「3 个月」「6 个月」各建一张表?

事件标签写成这些时点即可。表单仍在在线设计器里建一次,再挂到多个事件上。按访视复制表单,改字段时容易漏改。

天数填了,日历里没有自动出现随访?

定义事件只建立时点。按偏移生成日程,要另开 37 计划进度。没开时,这些天数只作排序和说明。

唯一事件名称要手写吗?

不用。它是系统生成的,方括号引用别的事件里的字段时用这个名字。事件 ID 不要改。


5. 建议记住的几条

  • 入口:项目设置 → 定义事件;先确认纵向已 启用。
  • 一行一个时点:事件标签 给人看,入组的 相距时间天数 写 0。
  • 周、月先点 从其他单位转换,再点 增加新事件。
  • 表单不要按访视复制;分组只在访视安排不同时再加。

本篇为平台「REDCap使用指南」系列,按手册页体例编写。查看全部指南

30 字段说明里的富文本与 HTML
« 上一篇 2026 年 10 月 6 日
34 为事件派发表单
下一篇 » 2026 年 10 月 6 日