使用列表

数据列表显示了 CQL（临床查询语言）查询在 CDB 中的结果。除了列表的源数据外，还可以查看每个数据点的审查状态、查询和上下文。CDB 会自动为研究中的每个表单（EDC 和第三方）创建一个核心列表。可以通过修改其他列表的 CQL 语句来创建额外的自定义列表。

CDB 仅向具有受限数据访问权限的用户（通常是首席数据管理员）显示受限（设盲）数据。默认情况下，此权限授予给具有标准 CDMS Lead Data Manager（CDMS 首席数据管理员）研究角色的用户。如果你是盲态用户（没有受限数据访问权限），Workbench 不会在列表中显示受限条目，也不会显示从受限条目衍生的列、受限表单的核心列表、受限表单的任何 @HDR、@Form 或 @ItemGroup 信息，或者来自受限源的任何数据。

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

列表类型

有四（4）种类型的列表：

  • 核心列表：这些是 CDB 在导入数据时自动创建的列表。每个表单 都有一个核心列表。
  • 自定义列表：这些是应用了自定义 CQL 的列表，以你希望的方式显示数据。了解如何创建自定义列表。
  • 导出列表：这些是在你将列表添加到导出定义并对其进行自定义以便导出时，Workbench 创建的列表。请注意，这些列表只能从导出 > 定义访问，而不能从列表（Listings）区域访问。了解如何创建导出定义。系统列表是 Workbench 自动创建的一种特殊类型的导出列表。它们只公开上下文研究信息，而不公开任何收集的数据。这些列表仅作为原始类型导出数据包的一部分提供。
  • 审查列表：这些列表可用于在数据进入 Workbench 时对其进行审查，包括创建已知差异。了解如何使用审查列表审查数据。

访问列表

首先，从研究（Studies）页面中选择研究。然后，从导航抽屉（Navigation Drawer）（）或研究中打开列表页面。

从导航抽屉打开的列表 从研究菜单打开的列表

Workbench 将研究列表分为四组。要查看特定组中的列表，请单击以打开相应的选项卡。

列表选项卡

  • playlist_add_check 审查：这些是已启用审查的自定义列表。这些列表允许审查传入的数据并识别任何问题。了解有关审查数据的详细信息。
  • 核心：当研究中的每个表单传入系统时，Workbench 会自动为其创建一个核心列表。
  • 公开（Public）：这些是有权查看的所有自定义列表，列表没有启用审查。其中包括你自己的标记为公开的列表，以及研究中其他用户的任何公开列表。Workbench 显示在审查组中启用了审查的自定义列表。
  • lock_outline 私密：这些是你创建并标记为私密的自定义列表。

单击列表的标题将其打开。

单击列表的标题将其打开

可以从导出>定义中访问导出列表（包括系统列表）。

搜索列表

可以使用标题、类别、目标、描述 和来源 列搜索特定列表。此搜索使用“包含（contains）”。

要进行搜索，请执行以下操作：

  1. 在 Workbench 中导航到研究。

  2. 在顶部导航栏中，单击搜索（）。

  3. 默认情况下，Workbench 会搜索所有对象类型。可以选中并清除类型（Type）下拉列表中的复选框，以更改 Workbench 正在搜索的对象。

  4. 选择要搜索的列（Column）。默认值为标题（Title）。
  5. 输入搜索文本（Search Text）。
  6. 单击搜索或按 Enter 键进行搜索。
  7. 单击结果（Results）部分中的列表标题将其打开。

Workbench 会在搜索面板的结果部分显示搜索结果。

Workbench 随列表显示一个指示列表类型的图标：

  • playlist_add_check 表示审查列表
  • 表示核心列表
  • 公开 表示公开列表
  • lock_outline 表示私密列表

单击关闭（Close）（）关闭搜索面板。

上次访问的列表

为方便起见，“临床报告”会显示指向上次访问的列表（Last Listing Visited）的链接。可以单击此链接轻松导航到上次访问的列表。

收藏列表

可以将列表标记为收藏夹，以便以后从收藏夹（Favorites）菜单轻松访问。

要将列表标记为收藏夹，请执行以下操作：

  1. 导航到要收藏的列表。

  2. 单击添加到收藏夹（Add to Favorites）（）。

  3. 现在可以从收藏夹菜单（）中访问。

要将其从收藏夹中移除，请单击从收藏夹中移除（Remove from Favorites）（），或在收藏夹菜单中单击相应的移除（Remove）（）。

要访问收藏夹，请在选择研究 后单击以打开顶部导航栏中的收藏夹菜单（）。

可以单击链接的对象名称（Object Name）以打开该列表。

可以按类型筛选对象的列表。

排序和筛选&

可以按以下各列对“列表（Listings）”页面进行排序和筛选：

  • 标题
  • 类别
  • 目标
  • 创建日期
  • 创建者
  • 修改日期
  • 修改者
  • 上次上传
  • 当前状态（仅限 TST 环境）
  • 修改时间（仅限 TST 环境）

如果列已应用排序或筛选器，则 Workbench 将显示排序图标（表示升序，表示降序）和筛选器图标（filter_list）。可以在“列标题”中单击这些图标来编辑排序或筛选器。还可以对尚未具有排序和筛选功能的列进行排序和筛选。

如何排序

要对“列表（Listings）”页面进行排序，请执行以下操作：

  1. 导航到研究 的“列表（Listings）”页面。
  2. 找到要作为排序依据的列。
  3. 将鼠标悬停在该列上以显示排序和筛选按钮。&
  4. 单击排序和筛选&（filter_list）。
  5. 单击以展开排序依据（Sort by）。
  6. 选择升序（Ascending）或降序（Descending）作为排序顺序。

对标题升序排序

如何筛选

要对“列表（Listings）”页面进行筛选，请执行以下操作：

  1. 导航到研究 的“列表（Listings）”页面。
  2. 找到要作为排序依据的列。
  3. 将鼠标悬停在该列上以显示排序和筛选按钮。&
  4. 单击排序和筛选&（filter_list）。
  5. 单击以展开条件（Condition）。
  6. 选择一个运算符（Operator）。Workbench 使用输入的值（Value）和选择的运算符（Operator）来比较列中的值。在 CQL 参考（CQL Reference）中了解有关可用比较运算符的更多信息。
  7. 如果需要，请输入用于比较值的值（比较）。请注意，只能使用静态值，而不能使用函数。对于日期，请使用 YYYY-MM-DD 格式或使用日历选择器。
  8. 还可以通过比较进行筛选。选择运算符（Operator）后，单击比较（Compare）()。然后，可以从可用列中进行选择。

  1. 单击确定（OK）。

如何重置筛选器

要重置（移除）列中的筛选器，请打开排序和筛选（Sort & Filter）菜单，然后单击清除（Clear）。

隐藏列表列

可以根据需要隐藏和显示列，而无需使用“隐藏列（Hide Columns）”选项将其从列表中移除。

此设置将在对象和研究 中保持，直到取消隐藏列。

CDB 用橙色虚线表示隐藏列。CDB 为每组隐藏列（彼此相邻且全部隐藏的列）显示一条虚线。

要隐藏列，请执行以下操作：

  1. 导航到列表。
  2. 将鼠标悬停在列标题上以显示排序和筛选菜单&（filter_list）。

  3. 单击隐藏列。

  4. CDB 会隐藏该列。隐藏列由橙色虚线表示。单击取消隐藏列（Unhide Columns）以显示所有隐藏列。

查看列表

要查看列表中返回的临床数据，请单击列表的标题将其打开。

列表标题

列表（Listing）页面的标题显示列表的类别（Category）、目标（Objective）和关联表单（Associated Forms）。类别（Category）和目标（Objective）是在创建列表期间定义的，Workbench 会根据 FROM 子句中 CQL 查询引用的表单生成关联表单（Associated Forms）的列表。

核心列表可以有一个已配置（Configured）标签，指示核心列表具有一组自定义的列

给药表单的列表标题

展开和折叠网格&

可以隐藏标题以查看更多网格内容。要隐藏标题，请单击展开网格（Expand Grid）。要再次显示标题，请单击折叠网格（Collapse Grid）。

数据表

每个列表代表一个或一组 CQL 查询的结果。工作台在列表的数据表中显示这些结果。根据数据集的大小，可能需要水平滚动才能查看受试者 行的所有数据。如果列表返回的结果行超过 100 行，可以对结果集进行翻页以查看其他结果。

调整列大小

要设置列宽：

  1. 将鼠标悬停在两列之间的行上。
  2. 单击并拖动该行以调整列的大小。 屏幕录制，显示单击并拖动以调整列表列大小

分页

Workbench 在列表中每页最多显示 100 行。使用向左和向右箭头按钮进行翻页。要直接转到某个页面，请输入页码并按 Enter 键。

一个列表最多可以在 Workbench UI 中显示 1000 行。如果 CQL 语句返回的结果行超过 1000 行，则分页菜单将显示“1000+”。可以对列表应用筛选器以查看其他行。

如果没有对列表应用筛选器，则 CSV 下载将包含所有记录。

对结果进行排序

&可以使用排序和筛选菜单来按列排序，也可以编辑列表的 CQL 语句以添加 ORDER BY 子句来对结果进行排序。

突出显示

查看列表中的数据时，可以快速浏览列表，并通过列表突出显示获取有关缺失数据或未解决查询的关键信息。可以将鼠标悬停在突出显示的单元格上以查看缺失数据的原因。

在以下情况下，Workbench 会突出显示行和单元格：

  • 事件日期 具有未处理或已回答的查询：

事件日期上突出显示了未处理的查询

  • 事件 被标记为没有发生（Did Not Occur）：

突出显示“没有发生（Did Not Occur）”

  • 表单 被标记为特意留空（Intentionally Left Blank）：

突出显示表单“特意留空（Intentionally Left Blank）”

  • 条目 被标记为特意留空（Intentionally Left Blank）：

突出显示条目“特意留空（Intentionally Left Blank）”

  • 条目 具有未处理或已回答的查询

突出显示条目查询

“单元格详细信息（Cell Details）”面板

可以在单元格详细信息（Cell Details）面板中查看有关单个 EDC 条目（来自表单）的上下文信息和审查状态。

要打开单元格详细信息（Cell Details）面板，请单击要在数据表中查看的单元格。要关闭面板，请再次单击单元格。

单元格详细信息面板显示以下信息：

  • 受试者 ID（@HDR.Subject.Name）
  • 活动 & 活动日期（@HDR.Event.Name、@HDR.Event.Date）
  • 条目名称（EDC.Item）

在“单元格详细信息（Cell Details）”面板中，可以检查以下状态。Workbench 会突出显示已完成或已应用的审查状态：

  • SDV
  • DMR
  • 已签名
  • 已冻结
  • 已锁定

单元格详细信息面板

在单元格详细信息面板中，可以单击查看 EDC 的审查选项卡中的查询。单击表单标识符（Form Identifier）链接以在 EDC 中查看查询。

关于第三方事件日期的查询：如果查询针对的是仅由第三方系统捕获的事件（访视）的事件日期，Workbench 不会显示打开该事件的链接。

单击表单标识符在 EDC 中打开查询。

CQL 编辑器

可以使用 CQL 编辑器修改数据表中的数据。请参见下面的详细信息。

固定列

可以固定列，这样即使向右滚动，这些列也保持可见。默认情况下，审查（Review）列始终处于固定状态。

要固定列，请执行以下操作：

  1. 单击固定列（push_pin Columns）。
  2. 选择要固定的列数。这是从左边开始的列计数，最左边的列是 1。
  3. 单击固定列（Pin Columns）菜单以外的区域将其关闭。

Workbench 会固定列，在最右侧固定列的右侧显示粗体边框。

Workbench 会在会话之间保留固定项。固定列不适用于其他用户。

如果对列表中 CQL 的投影进行了更改（列表中包含的列发生了更改），则 Workbench 会移除已固定的列（将固定项重置为“1”）。

对列表数据进行排序 & 筛选

可以使用排序和筛选菜单轻松对列表数据进行排序和筛选，而无需使用 CQL 编辑器编辑关联语句。&每次更新排序顺序或任何筛选条件时，Workbench 都会更新应用的 CQL 语句。这有助于快速、轻松地创建所需的视图。然后，可以保存列表以供以后返回。

要打开筛选和排序（Sort & Filter）菜单，请单击要作为排序依据或应用筛选器的列的列标题。

如果列已应用排序或筛选器，则 Workbench 将显示排序图标（表示升序，表示降序）和筛选器图标（filter_list）。可以在“列标题”中单击这些图标来编辑排序或筛选器。还可以对尚未具有排序和筛选功能的列进行排序和筛选。

排序和筛选菜单&

如何对列表进行排序

可以使用排序和筛选（Sort & Filter）菜单按单列排序。如果要应用多重排序（按多个列排序），可以使用 CQL 编辑器更新列表的 ORDER BY 子句。

已知问题：在当前版本中，无法按重复条目组中的任何列进行排序。

要按列排序，请执行以下操作：

  1. 在数据表中找到要排序的列。
  2. 如果列尚未应用排序或筛选，请将鼠标悬停在列标题（Column Header）上以显示筛选（Filter）图标（filter_list）。
  3. 单击筛选图标（filter_list）。这将打开排序和筛选（Sort & Filter）菜单。
  4. 在排序依据（Sort by）下，选择升序（Ascending）（A-Z）或降序（Descending）（Z-A）作为排序顺序。
  5. 单击确定（OK）。Workbench 会按列值以所选排序顺序对数据表进行排序。Workbench 在列标题中显示排序（Sort）图标（用于升序或降序）。
  6. 可选：保存列表以保留排序顺序。

使用排序和筛选菜单应用排序顺序会自动替换列表 CQL 语句中的 &ORDER BY 子句。

如何重置列的排序顺序

要重置（移除）排序并将列表恢复为默认顺序，请打开排序和筛选（Sort & Filter）菜单，然后单击重置（Reset）。

重置排序顺序

如何对列表进行筛选

还可以使用排序和筛选（Sort & Filter）菜单筛选列表。可以选择比较运算符，如果需要，还可以选择要作为筛选依据的值，并将其用作筛选器。

请注意，条件筛选器会添加到 CQL 语句中的任何现有筛选器（WHERE 子句）中。要完全替换 CQL 语句中的 WHERE 子句，必须编辑 CQL 语句以将其删除。

在当前版本中，对于通过“排序和筛选”菜单应用的筛选条件，Workbench 会将所有数据视为字符串进行筛选。&可以使用 CQL 语句中的 WHERE 子句应用更高级的筛选条件。在数据网格中进行筛选时，请考虑以下事项：

  • 使用等于（=）运算符筛选日期列时，在输入条件筛选器的值时，必须使用 YYYY-mm-dd 日期格式（2020-04-24）。
  • 可以使用 like（%）运算符对日期列的 YYYY、mm 和 dd 格式日期组件进行筛选，但不能筛选拼写或缩写月份。例如，%2020% 是允许的，但“%Nov%”不是允许的筛选条件。
  • 当列包含混合单位时（例如，身高列可能同时具有英寸和英尺的值），我们建议使用 CQL 编辑器来筛选该列，因为在当前版本中，Workbench 在数据网格中应用筛选时无法考虑计量单位。

要使用条件筛选器筛选列表，请执行以下操作：

  1. 在数据表中找到要筛选的列。
  2. 将鼠标悬停在列标题上以显示筛选图标（filter_list）。
  3. 单击筛选图标（filter_list）。这将打开排序和筛选（Sort & Filter）菜单。
  4. 在条件（Condition）下，选择运算符（Operator）。Workbench 使用输入的值（Value）和选择的运算符（Operator）来比较列中的值。在 CQL 参考（CQL Reference）中了解有关可用比较运算符的更多信息。

  5. 如果需要，请输入用于比较值的值（比较）。请注意，只能使用静态值，而不能使用函数。日期请使用 YYYY-MM-DD 格式。 筛选器条件 enrolled__v

  6. 还可以通过比较进行筛选。选择运算符（Operator）后，单击比较（Compare）()。然后，可以从可用列中进行选择。

  1. 单击确定（OK）。 “确定（OK）”按钮

如何重置筛选器

要重置（移除）列中的筛选器，请打开排序和筛选（Sort & Filter）菜单，然后单击重置（Reset）。要重置整个列表中的所有筛选条件，请打开 CQL 编辑器并从 CQL 语句中删除 WHERE 子句。

重置排序顺序

如果仅使用排序和筛选（Sort & Filter）菜单来筛选列表，重置操作会从该列中移除所有筛选器。如果同时使用排序和筛选菜单和 &CQL 编辑器来筛选列表，Workbench 会将筛选条件重置为最后应用的 CQL 语句的 WHERE 子句。

重置列表的所有排序和筛选条件&

可以重置列表所有列的排序和筛选。这会将列表重置为上次保存的状态。

要重置所有列，请单击重置（Reset）。

查看 CQL

可以查看列表的 CQL 语句，而无需打开该列表。

要查看 CQL，请执行以下操作：

  1. 导航到研究 的“列表（Listings）”页面。

  2. 将鼠标悬停在该列表的标题（Title）上以显示列表菜单（）。 列表菜单

  3. 从列表（Listing）菜单中，选择查看 CQL（View CQL）。 查看 CQL 操作

  4. Workbench 会显示 CQL 语句对话框，标题为列表的标题。完成后，单击关闭（Close）（）。 CQL 语句对话框

使用 CQL 编辑器

可以使用 CQL 编辑器编辑 CQL 语句、更改列表中显示的信息、重命名列等。

数据工作台默认将以下语句应用于列表：

select @HDR, * from EDC.Adverse_Events where @Form.Status = 'submitted__v' or @HDR.Event.Status IN ('did_not_occur__v')

可以拖动 CQL 编辑器的顶部（橙色）边框来更改面板大小。还可以在单独的窗口中打开 CQL 编辑器。在 CQL 编辑器中单击“弹出（Pop Out）”（）。

要编辑 CQL 语句，请执行以下操作：

  1. 导航到研究的列表。

  2. 单击 CQL 编辑器（CQL Editor）。CDB 将在浏览器窗口的下半部分打开 CQL 编辑器。 “CQL 编辑器”按钮

  3. 对语句进行更改。有关创建 CQL 语句的详细信息，请参阅 CQL 参考。

  4. 单击应用（Apply）。如果语句中没有错误，CDB 将更新列表以反映语句结果。如果有错误，CDB 会在查询（Query）字段上方的横幅中显示错误。解决错误，然后再次单击应用（Apply）。 “应用”按钮

  5. 可选：单击重置（Reset）以返回已保存的语句。 “重置”按钮

  6. 单击关闭（Close）（X）关闭 CQL 编辑器。

可以将结果集另存为自定义数据列表，以便稍后返回这些结果并与组织中的其他用户共享这些结果。详细信息请参阅创建自定义数据列表。

将列表数据导出为 CSV

可以将列表数据导出为 CSV 文件，以便离线审查或在外部系统中使用。Workbench 导出列表数据时会根据当前应用的 CQL 语句纳入列表中显示的所有数据。

要生成列表的 CSV 文件，请执行以下操作：

  1. 打开列表。

  2. 从列表（Listing）菜单中，选择生成 CSV（Generate CSV）。 “生成 CSV（Generate CSV）”操作

  3. Workbench 将启动创建 CSV 文件的作业。完成后，Workbench 会在屏幕左下角显示一条通知，其中包含用于下载 CSV 的链接。可以单击此链接下载 CSV 文件。 “CSV 已生成（CSV generated）”通知

一旦有任何用户为公开列表生成 CSV，Workbench 会在“列表（Listings）”页面的最新下载（Latest Download）列中显示该 CSV 的下载链接。单击下载图标（）以下载 CSV 文件。

最新下载 CSV 的提示框

数据列表类别

Workbench 在从 Vault EDC 导入或第三方数据导入期间自动创建的任何列表都会被分配为核心列表类别。任何自定义列表都有由创建列表的用户分配的类别。贵组织可以在创建自定义列表时创建这些类别。详细信息请参阅创建自定义数据列表。