使用列表生成器创建列表、检查和视图

使用列表生成器,可以在 UI 界面中创建列表、检查和视图,而不必使用 CQL 创建它们。三种对象的创建方法相同。

创建列表、检查或视图

要创建列表、检查或视图,请执行以下操作:

  1. 导航到 Workbench 选项卡。
  2. 研究(Studies)列表中,单击研究将其打开。
  3. 从顶部导航栏的创建新的(Create New)菜单中,选择要创建的对象:列表检查视图

  4. 这将打开列表生成器。按照此页面上的说明选择要显示的数据,定义列表的结构,并配置显示选项。

选择要显示的属性 & 条目

创建列表的第一步是选择要显示的属性和条目。

有关属性的完整列表,请参阅 CQL 参考

属性分为两组:研究(Study)条目(Items)。研究属性是操作投影元素(@HDR 属性)和表单或条目组属性(@Form@ItemGroup)。条目是从单个表单 中收集的数据条目。代码列表条目可以同时显示编码值和解码值。

如何添加属性

将属性从 可用属性(Available Properties)拖放到已选择属性(Selected Properties),以将其添加到列表中。在后续步骤中,你将能够对这些属性重新排序。添加属性时,CDB 将显示列表生成器导航(Listing Builder Navigation)中添加的属性计数。

研究属性按对象分组:研究、研究中心、受试者、事件组、事件、表单和条目组。可以拖动一个对象以添加其所有属性,也可以单击以展开对象并拖动单个属性。

列表会自动包含某些研究属性。这些默认值由管理员在核心数据列表配置设置中定义。

条目属性按表单和视图进行分组。可以拖放表单以添加其所有条目,也可以拖放视图以添加其所有列。还可以使用搜索属性(Search for properties)来搜索和选择单个条目

搜索属性字段中输入条目的名称。CDB 会在键入时进行搜索。

在选定了表单(Forms)的情况下搜索条目时,CDB 会搜索表单上的条目。在选定了视图(Views)的情况下搜索条目时,CDB 会搜索视图上的条目。如果在多个位置使用同一条目,CDB 还会在搜索结果中显示该条目条目组

表单限制:最多只能从 10(十)个表单中选择条目

添加条目 后,可以在已选择属性区域中展开它以显示其他选项。这些选项会根据条目的数据类型(例如其他日期格式或操作详细信息)为条目 添加其他列。默认情况下,某些列会包含在内。这些默认值由管理员在核心数据列表配置设置中定义。在下面的示例中,CDB 将包含一个列,用于 aestart 条目的插补日期(Imputed Date)SDTM 日期(SDTM Date)

如何移除属性

可以通过单击已选择属性区域中的移除(Remove))来移除属性。

列表生成器:选择条目和属性

上次更新时间:23R3

本视频演示在使用列表生成器构建列表、检查或视图时如何选择条目和属性。

定义列表的结构

结构(Structure)步骤中,可以定义行和列的结构选项。

行结构

通过选择行结构,可以选择数据对齐是否依赖于或独立于研究计划。有两个可用选项:

  • 按受试者(By Subject):此选项尝试在受试者的单行中显示来自多个表单的数据,独立于研究计划,并显示受试者在不同事件之间匹配的所有数据。任何选定的与计划相关的字段(如“事件日期(Event Date)”或“事件名称(Event Name)”)在列表中都设置为空。
  • 按计划(By Schedule):此选项在单独的行上显示来自不同事件的表单数据。如果与计划相关的字段是必填的,我们建议使用此选项。这是所有核心列表的默认选项。

例如,列表包含来自两个事件条目访视 1性别 条目)和访视 2测试结果)。如果选择按受试者作为行结构,则列表将为每个受试者设置一行,将每个条目 显示为列表中的一列,并填充相应事件的值。如果选择按计划作为行结构,则 CDB 会认为研究计划有两个事件,因此会为每个事件创建一个行。对于事件不包含条目的行,CDB 将在该条目的列中包含空值(“–”)。

列结构

例如,通过定义列结构,可以将来自不同来源的数据合并到堆叠的列中,从而形成更窄的可读列表。有两个可用选项:

  • 宽(并排)(Wide (Side by Side)):使用此选项时,每列表示一个唯一的条目或条目属性。
  • 堆叠(联合)(Stacked (Union)):使用此选项,每列可以包含多个堆叠在一起的条目或条目属性,其中用户最多可以为每列包含五(5)个条目和/或条目属性。在显示条目名称的多个实例时,条目组名称将显示在括号中。

创建堆叠

选择堆叠(联合)作为行结构时,可以将多个条目条目属性堆叠在一起。

  1. 对于列结构(Column Structure),选择堆叠(联合)(Stacked (Union))。
  2. 选择要堆叠的列(Columns)。这些列必须使用相同的数据类型。
  3. 可选:要向堆栈添加其他行,请单击堆叠(Stack)。要移除行,请单击删除(Delete)

最多可以包含五(5)个堆叠。

列表生成器:设置列表结构

上次更新时间:23R3

本视频演示如何在列表生成器中设置列表结构。

配置显示选项

有三个可配置的显示选项:别名(Aliases)排列(Arrange)排序和筛选(Sort & Filter)

别名(Aliases)

可以在别名步骤中定义别名(列标题)。这与在 CQL 中使用 AS 相同。为要重命名的每个列输入列别名(Column Alias)的值。默认情况下,堆叠列使用顶部条目的名称,因此我们建议使用描述整个堆叠的别名。

别名唯一性:别名在列表级别必须是唯一的。

排列(Arrange)

在“排列(Arrange)”步骤中,可以对列和堆叠重新排序。将列和堆叠拖放到所需顺序中。还可以使用移动到顶部(Move to Top)向上移动(Move Up)向下移动(Move Down)移动到底部(Move to Bottom)按钮将列和堆叠移动到所需位置。

排序和筛选&

如何排序

可以按多个列对列表进行排序:

  1. 找到要作为排序依据的列。
  2. 将鼠标悬停在该列上以显示排序和筛选按钮。&
  3. 单击排序和筛选。&
  4. 单击以展开排序依据(Sort by)
  5. 选择升序(Ascending)降序(Descending)作为排序顺序。

要重置(移除)列中的排序顺序,请打开排序和筛选菜单,展开&排序依据(Sort by),然后单击 重置(Reset)

如何筛选

可以对各列应用筛选器以限制返回的数据。请注意,这些是 AND 筛选器。

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

  1. 单击确定(OK)

要重置(移除)列中的筛选器,请打开排序和筛选菜单,展开&条件(Condition),然后单击清除(Clear)

预览列表

可以在保存之前预览列表以检查配置。单击预览(Preview)。这将在新窗口中打开一个预览列表,其中包含最多 25 条来自研究 的记录。

可以在对列表进行更改时保持此预览窗口处于打开状态。要使用更改更新预览,请单击预览窗口中的刷新(Refresh)

验证并保存(Validate & Save)

完成列表配置后,单击验证并保存。首先,CDB 将检查列表、检查或视图是否有任何错误。如果没有错误,CDB 将打开一个对话框,供你定义列表属性并保存。

Workbench 将在列表生成器导航中显示包含验证错误的每个步骤的警告图标。可以将鼠标悬停在图标上以查看错误消息。

列表生成器:验证

上次更新时间:23R3

本视频回顾了列表生成器中的验证过程。

如何通过列表生成器进行修改

可以在保存后使用列表生成器修改列表、检查和视图。为此,请导航到列表、检查或视图,然后单击修改(Modify)

通过列表生成器修改:只能使用列表生成器修改你在列表生成器中创建的列表、检查和视图。对于通过 CQL 编辑器创建的任何列表,必须使用 CQL 编辑器进行修改。