管理查询

在 Vault EDC 中，有两种类型的查询：系统查询和手动查询。Vault 会对数据运行检查并在数据不符合研究设计期间定义的规范时创建查询，从而生成系统查询。例如，当输入的日期超出特定范围时，Vault 会创建系统查询。手动查询是由临床研究助理（CRA）或数据管理员创建的查询。

有关特定于临床研究协调者（CRC）和主要研究员的查询信息，请参阅回答查询。

先决条件

所需权限

默认情况下，具有标准 CDMS 临床试验监查员（CDMS Clinical Research Associate）、CDMS 数据管理员（CDMS Data Manager）和 CDMS 首席数据管理员（CDMS Lead Data Manager）研究角色的用户可以执行这些操作。如果 Vault 使用自定义研究角色，则你的角色必须具有以下权限：

类型	权限标签	控制
“标准”选项卡	审查（Review）选项卡	能够访问审查选项卡
功能权限	未处理的查询	能够创建新的（未处理）查询并对查询进行评论，而无需将其移入已回答状态
功能权限	关闭查询	能够关闭查询

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

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

回答查询：如果你拥有打开查询权限，则对查询进行评论不会将其移动到已回答状态。

查看查询

在审查 > 我的研究 > 查询中，你可以查看你有权访问的研究中心中的所有查询的列表，包括事件日期查询。在待解决查询和已回答查询列中，Vault 在研究中心和受试者级别按状态列出的查询的总数。有关这些状态的详细信息，请参阅下文。

单击可以打开查询。Vault 会自动打开该查询所在的表单或事件。你可以在这里评论或关闭查询。

请注意，如果一个带有待解决查询的条目在数据录入中被隐藏，审查用户只能关闭查询，而不能对其进行评论。

你可以从该查询所在的表单中查看包含三（3）条以上备注的已关闭的查询。已关闭的查询显示在所要查询的事件日期 （用于事件日期 查询）或条目（用于条目查询）的旁边。

查询团队

每个查询都有一个徽章，表明这个查询是由哪个团队创建的。仅当研究在 Studio 中启用了团队查询限制时，才会显示查询的查询团队。

如果研究使用“团队查询限制（Team Query Restrictions）”功能，则只有与查询创建者属于同一团队的成员才能关闭查询，除非你具有关闭所有查询（Close All Queries）权限，在这种情况下，无论你在哪个查询团队，都可以关闭任何查询。例如，如果一个查询由临床团队创建，那么只有该团队的成员才能关闭该查询。在此示例中，数据管理团队的成员可以对查询发表评论，但无法关闭它。你仍然可以查看和评论由其他团队创建的查询。所选的查询团队将在 UI 中可见，并显示在“查询详细信息列表”和“研究数据提取”的 SYS_Q 数据集中。

如果用户具有多个研究角色，则该用户可以使用“查询团队”字段中的下拉菜单来选择他们响应查询时所用的角色。

启用团队查询限制后，用户可以在研究级设置中选择将哪个查询团队分配给系统查询。了解有关研究设置的更多信息。

启用团队查询限制和查询详细信息列表：如果未启用“团队查询限制”研究设置，则查询详细信息列表中的“角色”列将填充用户在作业生成时的当前角色。此信息不会记录在查询记录中。在正在进行的研究中启用“团队查询限制”设置后，对于后续的查询，用户的角色和团队将在执行查询操作时存储在查询记录中，并将填充到查询详细信息列表的“角色”和“团队”列中。在启用“团队查询限制”设置之前创建的查询不会被分配查询团队。如果要在查询详细信息列表中保留现有查询的当前角色，建议不要在正在进行的研究中启用查询团队。

系统查询

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

对渐进显示隐藏的条目进行查询：虽然 Vault 不会对隐藏或禁用的条目创建编辑检查查询，但基于规则的查询可能仍会对已被渐进显示隐藏或禁用的条目打开，具体取决于控制项。

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

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

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

手动关闭系统查询后，在重新提交表单时不会再次触发同一个系统查询。

如果你拥有查看查询规则权限并且可以访问 EDC 工具区域，则可以在 EDC 工具 > 查询规则中查看所有数据验证规则的列表。

打开手动查询

你可以从审查选项卡中的表单打开查询。要在审查选项卡中打开查询，请执行以下操作：

在审查选项卡中，导航到要打开查询所在的表单或条目。
对于条目查询，单击条目上的打开查询图标。
对于事件日期查询，单击事件日期上的打开查询图标。
在文本录入字段输入备注。请注意，查询消息的长度限制为 500 个字符。最佳做法是避免使用特殊字符，因为它们可能无法在导出文件中正确显示。
点击保存。Vault 创建查询。

你的新查询现在显示为数据录入用户需要回答的待解决查询。这个查询也会在审查选项卡的查询列表中显示。

查询只读条目和跨表单衍生条目：Vault 不允许对只读条目或跨表单衍生条目开放手动查询。

对查询进行备注

你可以对查询进行备注。

导航到有未处理查询的事件、表单或条目。
单击打开查询 图标。
单击回复（Reply）（对于手动查询）或备注（Comment）（对于系统查询）。
输入备注。
点击保存。

如果你拥有回答查询权限，则对查询进行备注只会将其移动到已回答状态。

对针对只读条目的查询进行备注：Vault 不允许你针对只读条目在系统生成的查询上进行备注。

关闭查询

系统查询或手动查询得到解决后，无需进一步操作即可以关闭查询。请注意，你可以立即关闭你创建的查询，而无需用户回答该查询。

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

导航到待解决查询。已回答的查询图标表示查询已被回答。
可选：输入备注。
单击关闭查询（Close Query）。

重新打开查询

如果需要其他操作或讨论，你可以重新打开手动查询。请注意，你只能重新打开包含三（3）条或更多备注的查询。

要重新打开查询，请执行以下操作：

导航到已关闭的查询。
单击重新打开（Reopen）。
输入备注。

Vault 将查询返回到待解决状态。

外部查询

你可以使用查询 API 将查询从外部源推送到 EDC。通过查询 API，你可以在打开、回答或执行其他查询操作时定义源信息。

可以推送以下部分或全部源信息：

源系统名称：从 EDC 外部添加查询的系统的名称
源用户：从 EDC 外部添加查询的用户的名称
源类型：查询的源类型
源 ID：来自查询源的唯一标识符

源系统名称的字符限制为 100 个字符。例如，“JReview”。源用户的字符限制也是 100 个字符。源类型的限制为 30 个字符，源 ID 的限制为 64 个字符。

在源类型为“external_v”时，在数据录入 UI 和审查 UI 中会显示关于事件和条目查询的源信息。

检索数据

查询源信息可以从查询详细信息列表作业 CSV 文件、研究数据提取文件中的系统数据集（SYS_Q 和 SYS_QT）以及查询 API 获取。

在每个位置显示的信息如下：

位置	源信息
查询详细信息列表 CSV	源用户、源类型、源系统名称、源 ID
SYS_Q 数据集	源用户、源类型、源系统名称、源 ID
SYS_QT 数据集	消息源用户、消息源类型、消息源系统名称、消息源 ID
查询 API	查看 CDMS 开发者门户上的查询源系统信息图表

查询状态和图标&

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

Vault 会在事件或表单状态图标的顶部显示徽章图标。然后，Vault 会在查询本身中显示查询的完整状态图标。

徽章	名称	状态
	未处理	未处理表示查询尚未得到回答。未处理的查询徽章显示在病例手册计划中查询的事件或表单的现有状态图标上，而未处理的查询图标显示在查询本身上。Vault 会在任务栏中列出未处理的查询。
	已回答	已回答表示查询已得到解决。例如，研究中心已提供一个原因作为对查询值的响应。已回答的查询徽章显示在病例手册计划中查询的事件或表单的现有状态图标上，而已回答的查询图标显示在查询本身上。
不适用	已关闭	已关闭表示查询不需要进一步的操作或讨论。如果需要，CRA 或数据管理员可以重新打开已关闭的查询。

EDC 工具中的规则

具有 EDC 工具区域访问权限的首席数据管理员和其他用户可以在此处对规则执行其他操作：

在 EDC 工具 > 规则中，你可以查看有关规则的详细信息，包括其表达式。
在 EDC 工具 > 作业历史中，你可以查看已运行的任何运行规则作业的历史记录。

有关详细信息，请参阅管理规则。