查询数据

Veeva Clinical Data 使用查询来跟踪对缺失、超出范围或有其他问题的输入数据(对于条目事件日期数据)的查询。在查询列表和数据列表中,可以查看查询、使用查询消息响应任何现有查询关闭无需进一步操作的查询

在 Veeva Clinical Data 中,查询可以由系统生成、手动创建或通过 API 生成。系统查询由 EDC 规则和 CDB 检查生成。手动查询是通过 EDC“审查(Review)”选项卡、“编码器(Coder)”选项卡或任何 CDB 数据列表生成的。例如,当输入的日期超出特定范围时,Vault 会创建系统查询。手动查询是由临床研究助理(CRA)、数据管理员或临床编码员在数据列表中创建的查询。请注意,也可以通过 CDB 查询 APIEDC 查询 API 从外部系统生成查询。

如果是针对 Veeva EDC 数据条目 进行的查询,则在 CDB 中执行的任何与查询相关的操作都会自动显示在 Veeva EDC 中。例如,如果在 CDB 中针对 Veeva EDC 条目事件日期事件方法 创建查询,则该查询将显示在 EDC 中的条目 上。未处理的 EDC 和第三方源查询不会发送到 Veeva EDC。

对于第三方查询,数据提供商可以直接在 CDB Workbench 中响应,也可以由数据管理员代表他们响应。要将查询列表传输到第三方数据源,可以导出查询并管理与第三方数据提供商的协作。在 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 访问权限

能够访问和使用 Veeva EDC 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))在新窗口中打开。

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

查询状态

Veeva Clinical Data 中的查询有三(3)种状态:未处理已回答已关闭。这些状态指示已执行哪些操作以及仍需要对查询执行哪些操作。

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

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

将查询状态与 EDC 同步

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

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

响应查询

可以使用备注对关于 EDC 和第三方数据的查询进行响应。请注意,当相关数据条目事件日期被锁定时,无法响应查询。然后,你的响应将显示在“查询详细信息”和“单元格详细信息”面板中,以及查询列表的“最后一条消息”列中。查询消息按从最旧到最新的时间顺序显示。

查询状态:当具有“打开查询”权限的用户响应查询时,查询状态将更新为未处理(Open)。如果用户只有“回答查询”权限(即没有“打开查询”权限),则查询状态将设置为已回答(Answered)。换句话说,来自数据管理员的响应会始终将查询状态设置为未处理,而只有来自研究中心用户的响应会将查询状态设置为已回答

从查询列表响应

要响应查询,请执行以下操作:

  1. 查询 > 核心中导航到研究
  2. 单击查询以在查询详细信息面板中查看它。 查询详细信息面板

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

系统会将查询消息添加到查询中。

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

要响应查询,请执行以下操作:

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

系统会将查询消息添加到查询中。

响应多个查询

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

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

关闭查询

解决系统或手动查询后,可以关闭关于 EDC 和第三方数据的查询。请注意,当相关数据条目事件日期被锁定时,无法关闭查询。

系统可以根据一组定义的标准自动关闭由“EDC 规则”或“CDB 检查”创建的查询。

从查询列表响应

要关闭查询,请执行以下操作:

  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)

未解决的查询未解决的查询列表显示处于未处理已回答 状态的所有查询。关闭查询会将其从未完成查询列表移动到已关闭查询列表。刷新页面以查看此更改。关闭查询还会从引用该条目事件日期的列表中删除任何与查询相关的单元格高亮显示。

系统查询

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

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

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

请注意,Veeva Clinical Data 不会对已禁用的条目 创建查询。

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

导出查询

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

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

  1. 导航到研究查询页面。
  2. 单击要导出的查询列表的标题
  3. 查询)菜单中,选择生成 CSV(Generate CSV) 生成 CSV

  4. CSV 已成功生成(CSV generated successfully)通知中,单击 生成的 CSV 下载 CSV 文件。 用于下载生成的 CSV 的链接

外部查询

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

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

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

查询指标

查询指标(Query Metrics)页面提供了关于查询生成源、其整体影响以及团队在重新查询方面的参与度的深入信息。

访问查询指标

可以从主查询(Queries)页面通过单击“网格视图(Grid View)”访问 Query Metrics(查询指标)。”网格视图“图标()位于页面的右上角。查询指标每天按需刷新。

“生成的总查询”图表

生成的总查询(Total Queries Generated)图表包括来自 EDC 和 3PD 数据的所有生成的查询,包括未处理、已回答和已关闭的查询。该图表由图例、内圈和外圈组成。内圈包含三个饼图扇形区域,用于展示查询生成源的分布情况。外圈展示细化的生成源的分布情况。

查询生成源

查询的生成方法有三种:

  • 手动:由(EDC 和 CDB)用户手动创建的查询。
  • CDMS 系统生成(在图表中标记为系统 ):由 CDB 检查、EDC 规格或 EDC 触发器自动生成的查询。例如,如果在提交表单时某个字段留空,则系统可能会创建查询。
  • 外部:通过 CDB 和 EDC API 从外部系统生成的查询。

每种源类型的百分比由内圈中的扇形区域表示。百分比的计算公式如下:

查询百分比 =(某一扇形区域的查询总数/所有选定扇形区域的查询总数)* 100

外圈显示细化的生成源及其分布情况。

细化的生成源按如下方式分类:

  • CDMS 系统生成:
    • EDC 规则
    • EDC 触发器
    • CDB 检查
  • CDMS 手动生成:
    • EDC 手动
    • CDB 手动
  • 外部生成:
    • 外部系统

提示框

内圈和外圈均适用提示框。将鼠标悬停在扇形区域上时,提示框会显示活动扇形区域的总计和重新查询数据等信息。

重新查询

重新查询涉及查询团队之间的多轮讨论。例如,当数据管理员由于原始查询的上下文发生变化或需要更多说明解释而需要重新审视查询时,可能会发生重新查询。

重新查询百分比显示在所选扇形区域的提示框中,并基于一组逻辑原则(见下文)。

生成的总查询图表中,重新查询百分比适用以下逻辑:

源类型 逻辑
手动和外部查询& 具有多条未处理查询消息的查询。
系统生成的查询:EDC 规则、CDB 检查和 EDC 触发器& 1.由同一个源生成多个查询的查询。例如,针对同一条目或事件日期的多个查询。
2.具有多条未处理查询消息的查询。

单个扇形区域的重新查询百分比使用以下公式进行计算:

重新查询百分比 =(某一扇形区域的重新查询总数/所有选定扇形区域的重新查询总数)* 100

与图表交互

可以通过选择或取消选择标签和扇形区域来筛选图表数据。筛选时,百分比会更新,查询总数保持不变。取消选择的图例将变为灰色,并且相应的扇形区域将从图表中移除。

标签

以下图表提供了图例中每个标签的说明。

标签及其相应的 CDB 和 EDC 字段:

标签 总查询计数(CDB 字段) EDC 字段
外部 source_type = external__v source_type = external__v
外部源(示例图像中的 EXT SYS) source_type = external__v.按每个唯一的外部源分组。 source_type = external__v
系统 CDB @QRY.Category =“系统(System)”且 source_type <> external__v 如果 manual__v = 是(Yes),则 @QRY.Category 将填充“手动(Manual)”。如果 Manual_V = 否(No),则 @QRY.Category 将设置为 System(系统)。
EDC 规则 CDB @QRY.Category =“系统”且 source_type <> external__v 且 @QRY.RuleDef 不为空 rule_def__v
EDC 触发器 CDB @QRY.Category =“系统”且 source_type <> external__v 且 @QRY.TriggerID 不为空 trigger_qualifier__v

标签及其相应的 CDB 字段:

标签 总查询计数(CDB 字段)
手动 CDB @QRY.Category =“手动”且 source_type <> external__v
CDB 检查 @QRY @QRY.Category =“系统”且 source_type <> external__v 且 @QRY.OriginName 不为空
CDB 手动 @QRY @QRY.Category =“手动”且 source_type <> external__v 且 @QRY.OriginName 不为空
EDC 手动 @QRY @QRY.Category =“手动”且 source_type <> external__v 且 @QRY.OriginName 为空

“按来源划分的已关闭查询”图表

“按来源划分的已关闭查询(Closed Queries by Origin)”图表概述了每个代类别中表现最差的前 10 个查询:

  • EDC 规则
  • CDB 检查
  • CDB 手动
  • 外部系统

表现基于未发生数据更改的已关闭查询数。未发生数据更改的已关闭查询数最多的行将位列前 10 名。

图表图例标签指示生成类别以及查询是否在发生数据更改的情况下关闭。生成类别由图表中相应颜色的水平条表示。

“按来源划分的已关闭查询”图表中仅包含已关闭的查询。

将鼠标悬停在水平条上时,将显示一个提示框,其中包含以下数据:

  • 在未发生数据更改的情况下关闭的查询数
  • 在未发生数据更改的情况下关闭的查询百分比
  • 在发生数据更改的情况下关闭的查询数

“按研究中心/数据提供者划分的查询”图表

“按研究中心/数据提供者划分的查询(Queries By Site / Data Provider)”图表按源(条形图)和平均查询时效(叠加折线图)显示查询总数。Y 轴表示查询总数,X 轴显示源(Site NameSource.Form)。叠加折线图显示每个研究中心或数据提供者的平均查询时效。图表中会显示所有状态类型(未处理已回答已关闭)的查询。

图表图例标签指示经过颜色编码的查询源类别(由图表中的垂直条表示)。源类别如下:

  • 系统
  • 数据管理(DM)
  • 临床
  • 编码器
  • 安全
  • 未定义

将鼠标悬停在数据点上时,将显示一个提示框,其中包含以下数据:

  • 研究中心或数据提供者
  • 查询数量
  • 平均查询时效
  • 重新查询百分比