比较规则(V2)
25R1 及以后版本
利用 Veeva EDC 的比较规则功能,研究设计者能够轻松创建系统管理的查询规则来比较日期和日期时间,而无需使用规则编辑器。通过比较规则,用户只需选择他们所需的标识符和运算符,而无需编写表达式以及对用户定义的规则进行验证和故障排除,大大缩短了研究构建时间。
所有比较规则都使用查询操作。默认情况下,系统会根据比较规则中使用的标识符和运算符构建标准查询消息,你也可以提供自定义查询消息。有关详细信息,请参见“可用的运算符”表。
先决条件
对于在 25R1(2025 年 4 月)版本之后创建的研究,比较规则配置器 V2 自动可用。可以为不使用比较规则 V1 的现有研究启用此功能。请联系 Veeva 服务代表了解详细信息。
具有 CDMS 研究设计者(CDMS Study Designer)标准角色的用户可以执行下述操作。如果贵组织使用自定义研究角色,则你的角色必须授予以下权限:
类型 | 权限标签 | 控制 |
---|---|---|
“标准”选项卡 | 工作室选项卡 | 能够访问工作室选项卡 |
功能权限 | 设计研究 | 能够通过工作室创建研究设计定义和研究计划 |
如果您的“研究”包含受限数据,您必须具有“受限数据访问(Restricted Data Access)”权限才能查看该数据。
了解有关“研究角色”的更多信息。
创建比较规则
要创建比较规则,请执行以下操作:
-
单击 + 新建比较规则(+ New Comparison Rule)以打开新建比较规则(New Comparison Rule)页面。
- 选择标识符 1(Identifier 1)和标识符 2(Identifier 2)。
- 选择标识符的类型(Type)。可以选择条目(Item)、事件日期(Event Date)或病例手册变量(Casebook Variable)。
- 选择标识符的各个组成部分。对于每个类型,必填字段均以黄色突出显示。
- 可选:对于条目类型的标识符,可以将事件(Event)和事件组(Event Group)留空,以便针对所选表单 或在整个计划范围内相互评估该规则。此功能类似于用户定义的规则中的 @Form 浮动标识符。
-
对于重复表单:如果选择的表单 是重复表单,则对于重复表单实例(Repeating Form Instances),选择当前实例(Current Instance)、所有实例(All Instances),或选择特定实例(Specific Instance)并输入希望规则评估所针对的序列号。
- 对于允许未知的标识符条目:对于未知处理(Unknown Handling),选择是否将日期或日期时间的未知部分替换为最小值或最大值。
-
从下拉菜单中选择运算符(Operator)。比较规则 V2 中的运算符与比较规则 V1 中的运算符功能不同。了解有关可用运算符(#available-operators)的更多信息。
- 可选:对于规则范围(Rule Scope),选中在当前事件组内(Within Current Event Group)复选框。对于多次收集的输入,此设置会提示 Vault 仅在评估规则时所在的当前事件组 内添加事件 或表单,而不是在整个研究范围内进行添加。
- 可选:对于规则执行(Rule Execution),选中保存后规则(Post-save Rule)复选框,以将规则的执行延迟到用户提交表单之后。对于存在大量排列组合情况的规则,你可能希望这样做,以避免表单提交过程延长。
- 可选:要使用自己的文本作为查询消息,请输入查询消息覆盖(Query Message Override)。否则,请将此字段留空以使用默认查询消息。
- 创建完规则后,单击保存并关闭(Save and Close)。
复制比较规则
在 Vault 中,你可以从当前研究 和你有权访问的另一项研究 中复制比较规则。只能从使用比较规则 V2 的其他研究 中复制比较规则。
从当前研究
你可能希望通过在研究中复制比较规则来快速创建与研究中另一条规则类似的规则。要在当前研究中复制比较规则,请执行以下操作:
- 导航到工作室(Studio)> 比较规则(Comparison Rules)。
- 将鼠标悬停在比较规则上以显示操作(Actions)菜单。
-
单击复制(Duplicate)。新建比较规则(New Comparison Rule)页面随即打开,其中所做的选择与正在复制的比较规则相同。
- 进行所需的更改,然后单击保存并关闭(Save and Close)。
从另一项研究
你还可以从另一项研究 中复制比较规则。请注意,如果目标研究 中不存在匹配的标识符,则 Vault 会以“无效”状态复制规则,你需要更新标识符并重新激活规则,然后才能使用它们。要从另一项研究 中复制比较规则,请执行以下操作:
- 导航到工作室(Studio)> 比较规则(Comparison Rules)。
- 单击从研究中复制(Copy from Study)。
- 选择创建副本(Create a copy)或使用现有(Use existing)以处理重复项。
- 选择 Vault。
- 选择要从何处复制(从研究中(From Study)或从库中(From Library))。
- 选择要从中复制的研究。
- 选择要从中复制的环境(Environment)。
- 选择要复制的比较规则。
- 可选:选中全选(Select all)复选框以选择所有要复制的比较规则。
- 单击复制 # 条比较规则(Copy # Comparison Rule(s))。Vault 会开始一项将比较规则复制到研究中的作业。完成后,Vault 会发送一封电子邮件通知,其中包含用于下载日志文件的链接。
- 点击关闭(Close)。
比较规则操作
可以从“比较规则操作(Comparison Rule Actions)”菜单执行以下操作:
- 重命名(Rename)
- 复制(Duplicate)
- 停用/激活(Inactivate / Activate)
- 存档
- 查看规则绑定(View Rule Bindings)
存档(删除)比较规则
已存档的比较规则在功能上已删除。它们不会显示在工作室 > 比较规则的比较规则列表中,也无法检索。
要存档比较规则,请执行以下操作:
- 导航到工作室(Studio)> 比较规则(Comparison Rules)。
- 单击存档。比较规则已存档(删除),无法检索。
可用的运算符
下表列出了可供使用的运算符。每个运算符都有一个标准查询消息。
比较规则 V2 运算符更改:比较规则 V2 中的规则逻辑和运算符标签与比较规则 V1 中的有所不同。与用户定义的规则类似,V2 比较规则中的表达式的计算结果为 true 或 false。当表达式的计算结果为 true 时,将执行规则操作并添加查询消息。
运算符 | 质疑消息 |
---|---|
晚于(>) | 标识符 1 不能晚于标识符 2 。 |
晚于或等于(≥) | 标识符 1 不能晚于或等于标识符 2 。 |
早于(<) | 标识符 1 不能早于标识符 2 。 |
早于或等于(≤) | 标识符 1 不能早于或等于标识符 2 。 |
等于(=) | 标识符 1 不能等于标识符 2 。 |
不等于(≠) | 标识符 1 必须等于标识符 2 。 |