通用视图配置详细信息
本文包含有关一些常见视图定义 配置的解释说明。通过“映射不良事件”示例,可以查看端到端视图配置的概述。跟随该示例,可以针对在视图中引用重复表单 和条目组 时可能出现的不同问题,查看相关的解释说明。
“视图集(View Sets)”选项卡可能未在你的 Vault 中启用。请联系 Veeva 服务代表了解详细信息。
示例配置:映射不良事件
在研究 的进行过程中,你可能希望映射不良事件 表单以导出该数据供以后审查。可以轻松配置视图定义 来收集与 研究 中不良事件 相关的所有数据。
你的研究在常见日志表单 事件中使用单个不良事件 重复表单。该表单在 ig.AE 条目组 中包含以下条目:
- AETERM(文本)- 不良事件术语是什么?
- AESTDTC(日期/时间)- 不良事件的开始日期/时间
- AEENDTC(日期/时间)- 不良事件的结束日期/时间
- AEONGO(代码列表)- 不良事件是否持续?
- AESEV(代码列表)- 严重性
- AETOXG(文本)- 标准毒性等级
- AESER(代码列表)- 此不良事件是否严重?
首先,创建一个新的视图定义 和视图集定义:
- 从工作室(Studio)> 视图集(View Sets)中,单击 + 新建视图集(New View Set)以创建新的视图集定义。
- 在此示例中,输入“AE 视图集(AE View Set)”作为视图集名称(View Set Name)。
- 单击视图集定义。
- 单击 + 新建视图(New View)以创建新的视图定义。
- 在此示例中,输入“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 对象和包含该数据的字段(例如,事件 对象及其事件日期 字段)轻松引用这些数据点。