运行规则
可以从“EDC 工具(EDC Tools)”>“规则(Rules)”中执行规则。在“运行规则(Run Rules)”子选项卡中,可以查看每个规则的表达式条件和规则操作,以及使用运行规则 作业来执行一条或多条规则。这在完成修订之后尤其有用。还可以在“错误控制台”子选项卡中查看规则执行期间发生的任何错误,无论是在作业期间还是在研究中心的数据录入期间。请注意,Vault 不会在“规则”选项卡中列出发送电子邮件 或设置条目值 操作的规则。
先决条件
规则列表
可以从 EDC 工具> 规则中查看与研究 关联的所有规则,但发送电子邮件(Send Email) 和设置条目值(Set Item Value) 规则操作除外。
要筛选规则列表,请执行以下操作:
- 单击以展开高级筛选器(Advanced Filters)面板。
- 选择包含开始日期(Start Date)和结束日期(End Date)的日期范围(Date Range),以仅显示在该日期范围内修改的规则。
- 单击查找规则(Find Rules)。
如果在研究设置(Study Settings)中启用了“方案偏离”,则首席数据管理员可以从 EDC 工具> 规则中查看“方案偏离”规则。
查看规则详细信息
要查看规则的属性、表达式和操作,请执行以下操作:
- 导航到研究 的 EDC 工具> 规则> 运行规则。
- 单击要查看的规则的名称(Name)。
- Vault 将打开规则详细信息(Rule Details)对话框。查看规则信息。
- 完成后,单击关闭(Close)。
运行规则
可以运行一个或多个规则来评估研究 中的用户输入数据。还可以在运行此作业之前预览其结果。
查询类型规则:对于查询类型规则,如果重新提交表单、规则中正在评估的条目值未更改或运行运行规则 作业,则不会重新创建已手动关闭的系统查询。
规则操作输出
以下是运行规则作业时可能发生的规则操作输出列表:
- 已跳过:规则评估为 true,但未采用操作,因为其发现操作已被采用。例如,对于动态规则,添加表格(Add Form)规则的计算结果可能为 true,但会跳过操作,因为表单已存在。
- 已创建:规则评估为 true 并采用操作。
- 已删除:规则评估为 false 并删除了之前的操作。对于动态规则,这类似于规则评估为 false 并从计划中删除表单。
- 标记为删除:此操作输出适用于动态规则(添加表单、添加事件(Add Event)),并指示规则评估为 false 并尝试从计划中删除对象,但发现其中有数据。
- 无:规则评估为 true,但父级对象不存在,或者规则评估为 false,但动态对象不存在。
限制
存在以下限制:
- 一次只能运行 100 条规则。
作业完成时间:根据配置中要运行的规则数和选择的病例手册 数,运行规则 作业可能需要几分钟到一个小时才能完成。
如何运行规则
要运行规则,请执行以下操作:
- 导航到 EDC 工具> 规则> 运行规则。
- 选择要运行的规则。
- 可选:选中全选(Select All)复选框以运行研究中的所有规则。
- 单击 运行规则。
- 在运行规则对话框中,如果要对所选受试者运行规则,请选择所选的受试者(Selected subjects)。否则,请将规则运行对象 保留设置为所有受试者。
- 如果选择所选的受试者,请选择要包含的受试者(Subjects)。
- 可选:单击预览(Preview)以查看此作业的结果,而无需实际执行规则。
- 单击运行(Run)。Vault 开始作业。完成后,Vault 会发送一封电子邮件通知,其中包含用于下载作业日志和任何相关输出文件的链接。
关于输出文件
规则 作业的作业输出是一个包含四(4)个 CSV 文件的 ZIP 文件夹:
- “rule_details.csv”:列出作为作业的一部分执行的规则,以及有关所执行操作的详细信息。请注意,“已跳过”操作表示规则执行的操作已经发生,例如,查询 已创建。
- “create_delete_dynamics_details.csv”:列出作为动态规则的一部分添加到计划中的每个组件的详细信息。
- “dynamics_summary.csv”:汇总规则执行过程中在计划中添加或移除的动态事件组、事件、表单、条目组 和条目。
- “errors.csv”:列出规则执行过程中发生的任何错误
规则作业输出和具有相同规则操作标识符的规则:当运行触发特定规则操作的规则作业时,如果该规则操作标识符在其他规则中相同,Vault 会在规则执行文件中列出共享该操作的其他规则以及已执行的规则。这为用户提供了有关可能与所执行规则冲突的规则的更完整信息,即使未选择的规则不会再次执行也是如此。
错误控制台(Error Console)
可以从“EDC 工具”>“规则”的错误控制台子选项卡中查看规则执行过程中发生的任何错误。Vault 在“错误控制台”子选项卡标签后的括号中显示错误数。
每当发生错误时,Vault 都会向所有具有运行规则 权限的研究用户发送通知。Vault 会在控制台中将错误保留六十(60)天
要访问错误控制台,请导航到“工具”>“EDC 工具”>“规则”,然后单击错误控制台。
Vault 会针对列表中的每个错误显示以下信息:
列 | 描述 |
---|---|
错误消息 | 此列显示实际的错误消息文本。如果错误消息被截断,请将鼠标悬停在其上以显示完整文本。 |
规则 | 失败的规则 的名称。 |
Study Country(研究国家/地区) | 规则 执行失败的受试者 的研究国家/地区。 |
研究中心 | 规则 执行失败的受试者 的研究中心。 |
受试者 | 包含规则 执行失败的事件日期 或条目 的受试者。 |
创建日期 | 创建日期 是指规则执行失败的日期和时间,即 Vault 创建错误的时间。 |
筛选错误
可以按研究中心、受试者 和规则 筛选错误列表。
要筛选错误列表,请执行以下操作:
- 单击研究中心、受试者或规则以打开筛选器菜单。
- 可选:开始在搜索框中输入搜索词。Vault 会在你键入时进行搜索。可以单击清除(Clear)()清除搜索框。
- 选中要作为筛选依据的研究中心、受试者 或规则 的复选框。
- 单击筛选器菜单以外的区域以关闭。
要清除筛选器,请执行以下操作:
查看错误详细信息
可以在“错误详细信息(Error Details)”对话框中查看某个错误的以下信息:
- 错误消息
- 事件组
- 事件组序列
- 事件
- 表单
- 表单序列
- 链接
- 随机化 ID
要打开“错误详细信息”对话框,请执行以下操作:
- 在错误控制台中找到要检查的错误。
- 将鼠标悬停在错误消息(Error Message)上以显示操作(Actions)菜单。
- 点击关闭(Close)。
查看规则语法
要查看规则的语法,请执行以下操作:
- 在错误控制台中找到要检查的错误。
- 将鼠标悬停在错误消息上以显示操作菜单。
- Vault 会在规则语法(Rule Syntax)对话框中显示规则的属性、表达式和操作。完成后,单击关闭(Close)。
将错误列表导出到 CSV
可以将错误列表导出为 CSV 文件。
要导出,请执行以下操作: