通用视图配置详细信息

本文包含有关一些常见视图定义 配置的解释说明。通过“映射不良事件”示例,可以查看端到端视图配置的概述。跟随该示例,可以针对在视图中引用重复表单条目组 时可能出现的不同问题,查看相关的解释说明。

“视图集(View Sets)”选项卡可能未在你的 Vault 中启用。请联系 Veeva 服务代表了解详细信息。

示例配置:映射不良事件

研究 的进行过程中,你可能希望映射不良事件 表单以导出该数据供以后审查。可以轻松配置视图定义 来收集与 研究不良事件 相关的所有数据。

你的研究在常见日志表单 事件中使用单个不良事件 重复表单。该表单在 ig.AE 条目组 中包含以下条目

  • AETERM(文本)- 不良事件术语是什么?
  • AESTDTC(日期/时间)- 不良事件的开始日期/时间
  • AEENDTC(日期/时间)- 不良事件的结束日期/时间
  • AEONGO(代码列表)- 不良事件是否持续?
  • AESEV(代码列表)- 严重性
  • AETOXG(文本)- 标准毒性等级
  • AESER(代码列表)- 此不良事件是否严重?

首先,创建一个新的视图定义视图集定义

  1. 工作室(Studio)> 视图集(View Sets)中,单击 + 新建视图集(New View Set)以创建新的视图集定义
  2. 在此示例中,输入“AE 视图集(AE View Set)”作为视图集名称(View Set Name)
  3. 单击视图集定义
  4. 单击 + 新建视图(New View)以创建新的视图定义
  5. 在此示例中,输入“AE 列表(AE Listing)”作为视图名称(View Name)。 

引用列

现在,可以将以下引用列定义 添加到视图中。必须先添加引用列,然后才能将条目组 添加到视图中。有关向视图添加列的详细信息,请参见在工作室中创建视图

这些引用列全部都是直接(Direct)类型。

列名称 列映射对象 列映射字段 对象标识符
研究 study__v(研究) name__v(名称) {Common Log Forms/Adverse Events/ig.Adverse Event/AETERM}
国家/地区 study_country__v(研究国家/地区) name__v(名称) {Common Log Forms/Adverse Events/ig.Adverse Event/AETERM}
研究中心 site__v(研究中心) name__v(名称) {Common Log Forms/Adverse Events/ig.Adverse Event/AETERM}
受试者 ID subject__v(受试者) name__v(名称) {Common Log Forms/Adverse Events/ig.Adverse Event/AETERM}
事件日期 event__v(事件) event_date__v(事件日期) {Common Log Forms/Adverse Events/ig.Adverse Event/AETERM}
事件 event__v(事件) label__v(标签) {Common Log Forms/Adverse Events/ig.Adverse Event/AETERM}
表单 form__v(表单) label__v(标签) {Common Log Forms/Adverse Events/ig.Adverse Event/AETERM}
表单序列 form__v(表单) form_seq__v(表单序列) {Common Log Forms/Adverse Events/ig.Adverse Event/AETERM}
项组 item_group__v(条目组) label__v(标签) {Common Log Forms/Adverse Events/ig.Adverse Event/AETERM}

还可以为 SDTM 域(SDTM Domain)添加额外的静态(Static)类型引用列。

列名称
SDTM 域 AE

在添加条目组 之前要添加的最后一列是派生的 导出运行(Export Run)列。在导出的 CSV 中,此列将显示数据导出 作业运行的时间和日期。

列名称 表达式
导出运行 now()

条目值列(临床数据点)

可以使用添加条目组(Add Item Group)按钮为条目定义 中的每个条目 自动创建一个列定义。你也可以选择手动创建这些列。

单击添加条目组按钮并选择 ig.ae 条目组 {Common Log Forms/Adverse Events/ig.AE} 的标识符后,Vault 会为条目组 中的每个条目 添加一个直接 类型的列定义 到视图中。

Vault 沿对角线添加这些列定义(在新行上,但列是从现有引用列的末尾开始)。在当前版本中,Vault 不支持在视图定义 中包含空白、未映射的单元格。取而代之,Vault 添加了引用条目 对象上的源类型(Source Type)字段的列映射定义。此字段在每个条目记录 上自动为空,因此在导出的 CSV 文件中将生成一个空单元格。

保存视图定义

查看完视图定义 并对任何列进行重新排序后,单击保存(Save)。Vault 会保存视图定义,它现在可用于数据导出 作业。

重复表单 & 条目组建议

序列号参考列

在引用重复表单条目组视图定义 中,我们建议包含一个序列号 列。这便于你识别与每个表单条目组 的数据关联的序列。

表单form__v)或条目组item_group__v)对象以及表单序列form_seq__v)或条目组序列item_group_seq__v)字段创建直接 类型的列映射。然后选择正确的对象标识符集。

引用多个重复条目组或表单

视图配置过程中的一个常见陷阱是同一列映射行 上有多个映射引用重复条目组。这会导致数据导出 作业失败或生成包含重复行且无法解读的 CSV 文件。这是因为 Vault 无法在单行上的不同重复条目组 之间协调重复数据条目。

应该为重复条目组 中的每组条目 新建一行。请注意,你可以使用具有多个非重复条目组 引用和一个重复条目组 引用的单行。

编码 & 解码

当映射引用代码列表条目 时,使用 item__v(对象)和 value__v(字段)的映射将返回条目 的编码值,对审查者来说可能难以解读。

你还可以引用解码的值,从而使视图更易于阅读。要引用解码的值,请使用 codelist_item_def__v(对象)和 label__v(字段)映射。

条目命名 & 数据导出

如果你的研究 包含条目定义,并将以下值用作名称OID,则数据导出 作业可能会因为在 SAS 转换期间出错而失败。

  • 研究 ID
  • 国家/地区
  • 研究中心
  • 受试者 ID
  • 事件
  • 事件日期
  • 事件序列
  • 表单
  • 表单序列
  • 项组
  • 条目组序列

可以使用标准 Vault EDC 对象和包含该数据的字段(例如,事件 对象及其事件日期 字段)轻松引用这些数据点。