查询数据

Vault CDMS 使用查询来跟踪对缺失、超出范围或有其他问题的输入数据（对于条目和事件日期数据）的查询。在 CDB 中，可以查看查询、打开对条目的查询、使用备注响应任何现有查询和关闭无需进一步操作的查询。

在 Vault EDC 中，有两种类型的查询：系统查询和手动查询。Vault 会对用户输入的数据运行检查并在数据不符合研究设计期间定义的规范时创建查询，从而生成 系统查询。例如，当输入的日期超出特定范围时，Vault 会创建系统查询。手动查询是由临床研究助理（CRA）、数据管理员或临床编码员创建的查询。在 CDB 中执行的任何与查询相关操作也适用于 Vault EDC。例如，如果在 CDB 中对某个条目创建了查询，该查询将显示在 EDC 的条目上。

还可以对第三方数据创建手动查询，但这些查询仅存在于 Vault CDB 中。要将查询返回到第三方数据源，可以导出查询并管理与第三方数据提供商的协作。在 CDB 中响应第三方查询时，可以记录来自第三方数据提供商的响应，以将查询的状态设置为已回答（Answered），然后在更正数据点后关闭查询。

可用性：临床数据库（CDB）仅对 CDB 许可证持有者提供。请联系 Veeva 服务代表了解详细信息。

先决条件

所需权限

具有 CDMS Lead Data Manager（CDMS 首席数据管理员）和 CDMS Data Manager（CDMS 数据管理员）标准研究角色的用户可以执行下述操作。如果贵组织使用自定义研究角色，则你的角色必须授予下表中列出的权限。

具有 CDB 数据提供者（CDB Data Provider）研究角色或基于该角色的其他角色的用户，必须有权访问在“管理员 > 用户”中按源分配的列表。

类型 权限标签 控制
“标准”选项卡 工作台选项卡

能够通过工作台（Workbench）选项卡访问和使用 Data Workbench 应用程序
功能权限
功能权限 未处理的查询

能够创建新的（未处理）查询并对查询进行评论，而无需将其移入已回答状态
功能权限 回答查询

能够回答查询，将其移至已回答（Answered） 状态。此权限不能打开查询。
功能权限 回答第三方查询

能够在 Workbench 中回答关于第三方数据条目的查询
功能权限 查看选定 CDB 查询列表

能够查看在 CDB 中选定的查询列表（在 Workbench > 管理员 > 用户中选择）
功能权限 查看所有 CDB 查询列表

能够查看所有查询列表
功能权限 关闭查询

能够关闭查询
功能权限 查看病例手册

能够查看关于和来自受试者病例手册（Casebooks）的信息（针对报告、信息板和 CDB）
功能权限 API 访问权限

能够访问和使用 Vault CDMS API。（使用 CDB 也需要此权限。）

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

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

在 Workbench 中查看查询

要在 CDB Workbench 中查看查询，请选择一项研究，然后使用研究（Study）菜单或导航抽屉导航到查询（Queries）页面。这将打开“查询”页面上的核心（Core）选项卡。

从导航抽屉打开查询 从研究菜单打开查询

默认情况下，Workbench 包含研究中每个源的一组查询列表。例如，如果你的研究有两个源，即 EDC 和实验室，Workbench 会生成两组列表，并使用源名称对其进行标记。

  • 已关闭查询：列出在研究的数据源中处于已关闭状态的所有查询。
  • 未解决的查询：列出在研究的数据源中处于未处理或已回答状态的所有查询。
  • 查询消息：列出研究数据源中的所有查询。

核心查询列表

虽然你可以编辑查询列表的 CQL 语句，但 Workbench 不允许在当前版本中保存这些更改。因此，“查询”>“公开（Public）”或“查询（Queries）”>“私密（Queries）”中不显示任何列表。

对查询列表进行排序

在”未处理“和”已结束“子选项卡中，可以对查询列表进行排序。

要对查询列表进行排序，请执行以下操作：

  1. 将鼠标悬停在要作为排序依据的列的列标题上。
  2. 单击排序（Sort）（filter_list）打开排序（Sort）菜单。

  3. 选择升序（Ascending）或降序（Descending）。 查询列表排序菜单

  4. 单击确定（OK）。

如果列已应用排序顺序，Workbench 将显示排序（Sort）图标（ 表示升序， 表示降序）。可以在“列标题”中单击这些图标来更改或移除排序顺序。

要重置（删除）排序顺序，请打开排序菜单，然后单击重置（Reset）。

“单元格详细信息（Cell Details）”面板中的查询

还可以在“单元格详细信息（Cell Details）”面板中处理列表中的单个查询。要打开“单元格详细信息”面板，请单击要在列表数据表中查看的单元格。要关闭面板，请单击关闭（）或再次单击单元格。

可以拖动“单元格详细信息”面板的顶部边缘来调整其大小，或者单击弹出（Pop Out）（）在新窗口中打开。

单击单元格在“单元格详细信息”面板中打开查询

查询状态

Vault CDMS 中的查询有三（3）种状态：未处理、已回答 和已关闭。这些状态指示已执行哪些操作以及仍需要对查询执行哪些操作。

响应来自 Workbench 的查询会将查询移动到待解决状态。

状态 含义
未处理 未处理 表示查询尚未得到解决。这是分配给所有新创建的查询的状态。
已回答 已回答 表示查询已得到解决。例如，网站已在响应中提供查询值超出范围的原因。
已关闭 已关闭 表示查询不需要进一步的操作或讨论。如果需要，CRA 或数据管理员可以在 Vault EDC 中重新打开已关闭的查询。

将查询状态与 EDC 同步

每当在 Workbench 的查询详细信息（Query Details）面板中单击以查看查询时，Vault 都会将该查询的查询状态更新为与 EDC 相匹配。Vault 还会在工作台导出作业期间更新查询并导入从 EDC 创建的任何新查询，随后在 Workbench 导入，该作业通常在每晚运行。

如果你在 Workbench 中有一个未处理的查询，并且自上次在查询详细信息面板中查看该查询以来（但在下次导入运行之前），Vault EDC 用户已回答该查询，则在 Workbench 中查看该查询的详细信息时，Workbench 会将查询的状态更新为已回答。

打开查询

可以从列表中的单元格详细信息（Cell Details）面板打开新查询，以创建关于事件日期（Event Dates）和 EDC 条目（Items）的查询。要打开查询，请执行以下操作：

  1. 导航到列表。
  2. 单击要打开查询的单元格（Cell）。
  3. 单击创建查询（Create Query）。

  4. 在文本字段中输入备注。 创建查询

  5. 点击保存。

可以在一次操作中从列表打开多个查询。

  1. 导航到列表。
  2. 勾选要查询的行的复选框。
  3. 可选：要选择当前页面上的所有行，请选择全选（Select All）复选框。
    “全选（Select All）”复选框
  4. 单击创建查询（Create Query）。
  5. 输入查询消息（Query Message）。
  6. 单击提交（Submit）。

响应查询

可以使用备注对关于执行数据的查询进行响应。请注意，当相关数据条目或事件日期被锁定时，无法响应查询。然后，你的响应将显示在“查询详细信息”和“单元格详细信息”面板中，以及查询列表的“最后一条消息”列中。如果查询的响不超过两（2）个，CDB 会按时间顺序（从最旧到最新）列出所有响应。

如果查询处于已回答状态，在 Workbench 中响应该查询后会将其状态变回待解决。

从查询列表响应

要响应查询，请执行以下操作：

  1. 在查询 > 核心中导航到研究。

  2. 单击查询以在查询详细信息面板中查看它。 查询详细信息面板

  3. 输入查询响应。
  4. 单击回复（Reply）。 “回复”按钮

Vault 会将备注添加到查询中。

从单元格详细信息面板响应

要响应查询，请执行以下操作：

  1. 导航到列表。
  2. 单击包含查询的条目的单元格。
  3. 输入备注。
  4. 单击回复（Reply）。 “回复”按钮

Vault 会将备注添加到查询中。

响应多个查询

可以在查询列表中一次性对多个查询发送相同的消息。

  1. 导航到查询列表。
  2. 选择包含要响应的查询所在行的复选框。
  3. 可选：要选择当前页面上的所有行，请选择全选（Select All）复选框。
    “全选（Select All）”复选框
  4. 单击回复查询（Reply Query）。
    “回复查询”按钮
  5. 输入备注。
    输入备注
  6. 点击保存。

关闭查询

系统查询或手动查询得到解决后，无需进一步操作即可以关闭查询。请注意，当相关数据条目或事件日期被锁定时，无法关闭查询。关闭查询会将其从未完成查询列表移动到已关闭查询列表。刷新页面以查看此更改。关闭查询还会从引用该条目或事件日期的列表中删除任何与查询相关的单元格高亮显示。

如果用户将系统查询的值更新为通过关联编辑检查的值，Vault 会自动关闭该查询。

从查询列表响应

要关闭查询，请执行以下操作：

  1. 在查询 > 核心中导航到研究。

  2. 单击查询以在查询详细信息面板中查看它。 查询详细信息面板

  3. 可选：输入备注。
  4. 点击关闭（Close）。 “关闭”按钮

从单元格详细信息面板响应

要关闭查询，请执行以下操作：

  1. 导航到列表。
  2. 单击要关闭查询的条目的单元格。
  3. 可选：输入备注。
  4. 点击关闭（Close）。 “关闭”按钮

关闭多个查询

可以通过批量操作从查询列表和数据列表中关闭多个查询。

要从查询列表关闭多个查询，请执行以下操作：

  1. 导航到列表。
  2. 选择包含要关闭的查询所在行的复选框。
  3. 可选：要选择当前页面上的所有行，请选择全选（Select All）复选框。
    “全选（Select All）”复选框
  4. 单击关闭查询（Close Query）。
    “关闭查询”按钮
  5. 可选：输入备注。
    输入备注
  6. 点击保存。

要从数据列表关闭多个查询，请执行以下操作：

  1. 导航到列表。
  2. 选择包含要关闭的查询所在行的复选框。
  3. 可选：要选择当前页面上的所有行，请选择全选（Select All）复选框。
    “全选（Select All）”复选框
  4. 单击关闭查询（Close Query）。这会打开关闭查询（Close Query）面板。
    “关闭查询”按钮
  5. 在关闭查询日期（Close Query on）中，选择要关闭的查询的事件日期或条目。
    关闭查询日期
  6. 可选：在消息详细信息（Message Details）中输入备注。
  7. 点击关闭（Close）。

系统查询

Vault CDMS 会运行检查，并对超出定义范围的任何条目值创建系统查询。该范围是在研究设计期间定义的。

以下系统查询类型会自动定义：

  • 必填：创建条目定义 时，研究设计者可以选择将字段标记为必填。如果提交表单时此字段留空，Vault 将创建系统查询（“该字段为必填项。”）。
  • 范围：创建条目定义 时，研究设计者可以定义字段值的范围。如果输入的值超出该范围，Vault 会创建系统查询（“值超出范围。”）。请注意，此查询类型仅适用于数值，不适用于日期。
  • 未来日期：创建条目定义 时，研究设计者可以禁止使用未来日期。如果用户输入未来日期，Vault 会创建系统查询（不允许使用未来日期。）。
  • 未来日期（事件日期）：创建事件定义 时，研究设计者可以指示不允许使用未来日期。然后，Vault 可以针对输入时晚于当前日期的任何事件日期 创建系统查询。
  • 超出窗口（事件日期）：创建事件定义 时，研究设计者可以为事件 创建允许日期的窗口。如果已配置，则当事件日期 超出此窗口时，Vault 可以随时创建系统查询。

请注意，Vault CDMS 不会对已禁用的条目 创建查询。

研究设计者可以在工作室中定义其他数据验证规则。根据这些规则，Vault CDMS 可以创建其他系统生成的查询。

导出查询

可以将研究中所有未完成的或已关闭的查询导出为 CSV 文件，以供记录和外部审查。CSV 文件包含与查询列表相同的列，在列表中应用的任何排序或筛选器也适用于导出的列表。

要导出查询，请执行以下操作：

  1. 导航到研究 的 查询页面。
  2. 单击要导出的查询列表的标题。

  3. 从查询（）菜单中，选择生成 CSV（Generate CSV）。 生成 CSV

  4. 在 CSV 已成功生成（CSV generated successfully）通知中，单击 生成的 CSV 下载 CSV 文件。 用于下载生成的 CSV 的链接

外部查询

外部供应商（如 JReview®）在打开、回答或执行其他查询操作时可以指定查询源信息。查询源信息通过查询 API 从 EDC 导入到 CDB。该数据出现在 CDB 的 OriginSystem 和 OriginID 字段中：

  • 源系统名称：从 EDC 外部添加查询的系统的名称
    • 在 CDB 中称为“来源系统”（OriginSystem）
  • 源 ID：来自查询源的唯一标识符
    • 在 CDB 中称为来源 ID（OriginID）

通过 CDB 打开查询 API 设置时，OriginSystem 字段限制为 100 个字符。查询源更改在 CDB 查询列表和 CQL 中的 @QRY 属性中可见。