运行规则

可以从“EDC 工具(EDC Tools)”>“规则(Rules)”中执行规则。在“运行规则(Run Rules)”子选项卡中,可以查看每个规则的表达式条件和规则操作,以及使用运行规则 作业来执行一条或多条规则。这在完成修订之后尤其有用。还可以在“错误控制台”子选项卡中查看规则执行期间发生的任何错误,无论是在作业期间还是在研究中心的数据录入期间。请注意,Vault 不会在“规则”选项卡中列出发送电子邮件设置条目值 操作的规则。

先决条件

默认情况下,具有标准 CDMS 首席数据管理员(CDMS Lead Data Manager)研究角色的用户可以执行上述操作。如果 Vault 使用自定义研究角色,则你的角色必须具有以下权限:

类型 权限标签 控制
“标准(Standard)”选项卡 “EDC 工具”选项卡

能够访问 EDC 工具选项卡

功能权限 运行规则

能够从“EDC 工具”>“规则”中运行规则

如果您的“研究(Study)”包含受限数据,您必须具有“受限数据访问(Restricted Data Access)”权限才能查看该数据。

了解有关“研究角色”的更多信息。


规则列表

可以从 EDC 工具> 规则中查看与研究 关联的所有规则,但发送电子邮件(Send Email)设置条目值(Set Item Value) 规则操作除外。

要筛选规则列表,请执行以下操作:

  1. 单击以展开高级筛选器(Advanced Filters)面板。
  2. 选择要包含在列表中的规则操作(Rule Actions)
    “高级筛选器”面板
  3. 选择包含开始日期(Start Date)结束日期(End Date)日期范围(Date Range),以仅显示在该日期范围内修改的规则
  4. 单击查找规则(Find Rules)

如果在研究设置(Study Settings)中启用了“方案偏离”,则首席数据管理员可以从 EDC 工具> 规则中查看“方案偏离”规则。

查看规则详细信息

要查看规则的属性、表达式和操作,请执行以下操作:

  1. 导航到研究EDC 工具> 规则> 运行规则
  2. 单击要查看的规则的名称(Name)
  3. Vault 将打开规则详细信息(Rule Details)对话框。查看规则信息。
  4. 完成后,单击关闭(Close)

运行规则

可以运行一个或多个规则来评估研究 中的用户输入数据。还可以在运行此作业之前预览其结果。

查询类型规则:对于查询类型规则,如果重新提交表单、规则中正在评估的条目值未更改或运行运行规则 作业,则不会重新创建已手动关闭的系统查询。

规则操作输出

以下是运行规则作业时可能发生的规则操作输出列表:

  • 已跳过:规则评估为 true,但未采用操作,因为其发现操作已被采用。例如,对于动态规则,添加表格(Add Form)规则的计算结果可能为 true,但会跳过操作,因为表单已存在。
  • 已创建:规则评估为 true 并采用操作。
  • 已删除:规则评估为 false 并删除了之前的操作。对于动态规则,这类似于规则评估为 false 并从计划中删除表单。
  • 标记为删除:此操作输出适用于动态规则(添加表单添加事件(Add Event)),并指示规则评估为 false 并尝试从计划中删除对象,但发现其中有数据。
  • :规则评估为 true,但父级对象不存在,或者规则评估为 false,但动态对象不存在。

限制

存在以下限制:

  • 一次只能运行 100 条规则。

作业完成时间:根据配置中要运行的规则数和选择的病例手册 数,运行规则 作业可能需要几分钟到一个小时才能完成。

如何运行规则

要运行规则,请执行以下操作:

  1. 导航到 EDC 工具> 规则> 运行规则
  2. 选择要运行的规则
  3. 可选:选中全选(Select All)复选框以运行研究中的所有规则。
  4. 单击 运行规则
  5. 运行规则对话框中,如果要对所选受试者运行规则,请选择所选的受试者(Selected subjects)。否则,请将规则运行对象 保留设置为所有受试者
  6. 如果选择所选的受试者,请选择要包含的受试者(Subjects)
  7. 可选:单击预览(Preview)以查看此作业的结果,而无需实际执行规则。
  8. 单击运行(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 创建错误的时间。

筛选错误

可以按研究中心受试者规则 筛选错误列表。

按研究中心为 0101 筛选的错误控制台

要筛选错误列表,请执行以下操作:

  1. 单击研究中心受试者规则以打开筛选器菜单。
  2. 可选:开始在搜索框中输入搜索词。Vault 会在你键入时进行搜索。可以单击清除(Clear))清除搜索框。
  3. 选中要作为筛选依据的研究中心受试者规则 的复选框。
  4. 单击筛选器菜单以外的区域以关闭。

要清除筛选器,请执行以下操作:

  1. 单击研究中心受试者规则以打开筛选器菜单。
  2. 清除要移除的筛选器的复选框。
  3. 可选:单击全部清除(Clear All)以移除所有筛选器。
    “研究中心”筛选器的“全部清除”选项
  4. 单击筛选器菜单以外的区域以关闭。

查看错误详细信息

可以在“错误详细信息(Error Details)”对话框中查看某个错误的以下信息:

  • 错误消息
  • 事件组
  • 事件组序列
  • 事件
  • 表单
  • 表单序列
  • 链接
  • 随机化 ID

要打开“错误详细信息”对话框,请执行以下操作:

  1. 在错误控制台中找到要检查的错误。
  2. 将鼠标悬停在错误消息(Error Message)上以显示操作(Actions)菜单。
  3. 从“操作”菜单中,选择“查看规则详细信息(View Rule Details)”。
    “查看规则详细信息”操作
  4. 查看错误详细信息对话框中的信息。
    “错误详细信息”对话框
  5. 点击关闭(Close)

查看规则语法

要查看规则的语法,请执行以下操作:

  1. 在错误控制台中找到要检查的错误。
  2. 将鼠标悬停在错误消息上以显示操作菜单。
  3. 操作菜单中,选择查看规则详细语法(View Rule Syntax)
    “查看规则语法(View Rule Syntax)”操作
  4. Vault 会在规则语法(Rule Syntax)对话框中显示规则的属性、表达式和操作。完成后,单击关闭(Close)

将错误列表导出到 CSV

可以将错误列表导出为 CSV 文件。

要导出,请执行以下操作:

  1. 工具(Tools)> EDC 工具> 规则中导航到研究
  2. 单击错误控制台
  3. 操作菜单中,选择 CSV。Vault 开始生成文件。完成后,Vault 会发送一封电子邮件,其中包含下载 CSV 的链接。
    CSV 导出操作