数据加载程序的数据导入配置

出于诊断目的处理实验室样本（如血液或 DNA）的 MedTech 公司或开发靶向疗法的制药公司会使用接收大量样本的机器，从而生成包含一项或多项测试结果的文件。Vault EDC 可以从这些文件导入数据，并自动将其输入到配置的表单 及其数据收集条目 中，而无需用户手动输入。

要使数据加载程序将此数据导入 Vault EDC，研究设计者必须首先为其创建数据导入配置。数据导入配置标识目标 表单，并将 CSV 文件中的列映射到标识符（如受试者 ID 或研究中心）以及目标表单 上的数据收集条目。当数据加载程序导入 CSV 时，需要选择 Vault 用于在导入期间处理数据的数据导入配置。

你必须为要将数据加载到其中的每个表单 创建数据导入配置。因此，如果要将机器或设备数据加载到多个表单中，则必须在工作室中为每个表单 创建单独的数据导入配置。

创建新的数据导入配置

1. 导航到研究 的工作室（Studio）> 研究（Studies）> 数据加载程序（Data Loader）。
2. 单击 + 新建（New）。
3. 输入数据导入配置 的名称（Name）。除短划线（-）和下划线（_）以外，此名称 不能包含任何空格或特殊字符。
4. 输入数据导入配置 的标签（Label）。
5. 可选：输入描述（Description）。
6. 选择目标表单（Destination Form）。这是你的导入数据加载到的表单。
7. 选择你的列标题创建方法（Column header creation method）。请参见下面的更多详细信息。
   1. 上传文件（Upload file）：上传 CSV 文件。Vault 将获取 CSV 中的每个列标题，并在映射表中为它们创建行。然后，你可以将这些列中的每个列映射到一个表单条目。
   2. 手动创建（Create manually）：在映射表中创建 CSV 列标题映射。CSV 中的每一列都必须有一个映射。
8. 如果你选择上传文件（Upload file），请将文件拖放到拖放（Drag and Drop）区域，或者单击该区域并上传你的文件。
9. 如果选择了手动创建，请输入Column Header（列标题），然后单击 + 添加（Add）。对每列重复此操作。最多可以添加 100 列。
10. 创建映射。
11. 单击保存（Save）或单击保存并关闭（Save and Close）以保存并关闭编辑器。

列标题

数据导入配置 的主要目的是将 CSV 列值映射到目标表单上的条目 或用于标识目标表单的所需元数据。

以下各列必填：

• 研究中心编号（Site Number）：受试者的研究中心 的研究中心编号（名称）。
• 受试者 ID（Subject ID）：受试者 的受试者 ID（姓名）。
• 事件组（Event Group）：包含事件 的事件组 的名称。
• 事件（Event）：包含目标表单 的事件（访视）的名称。
• 事件日期（Event Date）：事件（访视）的日期。
• Data Items（数据条目）：对于要输入到目标表单中的每个数据条目，都必须有一列。

可以通过两种方法创建列标题。

你可以选择上传文件，只需上传现有的 CSV 文件，Vault 即会将其所有列标题添加到映射网格中。

你也可以选择手动创建。对于此方法，你可以手动输入每个列标题。输入标题值，然后单击 + 添加。对每个标题重复此操作。单击以移除标题。

创建映射

你的映射会标识目标表单条目 导入值的源、值和格式。Vault 会将以下条目添加到映射表中。你可以将这些条目映射到 CSV 列（导入文件），在导入过程中以提示的形式收集值，或定义静态值以用作条目值。

导入来源

导入来源（Import Source）定义值的来源。共有三个选项：

• 导入文件（Import File）：导入文件中有一列包含此值。你可以在导入值（Import Value）中选择此列。
• 提示（Prompt）：导入文件中没有包含此值的列。Vault 将在导入数据时向数据加载程序显示输入此值的提示。
• 静态值（Static Value）：导入文件中没有包含此值的列。只需在导入值 字段中提供静态值，Vault 即会在导入期间使用该值填充此字段。

导入值

导入值 定义 Vault 在导入过程中用于填充字段的值。

如果为导入来源选择了导入文件，请在 CSV 文件中选择包含此值的列（Column）。

如果为导入来源选择了静态值，请在导入值字段中选择要使用的值（Value）。

如果你选择了提示作为导入来源，则无法在此字段中选择任何内容，因为数据加载程序将在启动导入时提供提示中的值。

导入格式

对于事件日期 以及日期、时间和日期时间条目，如果选择了导入文件作为导入来源，则可以在导入格式（Import Format）字段中为相应值选择日期时间格式。

转换值

对于代码列表类型的条目，如果选择了导入文件作为导入来源，则可以将代码列表值 映射到导入值。对于值不同的情况，例如“是”和“Y”，文件中的值可以映射到 EDC 代码列表中的选择。

要转换值，请执行以下操作：

1. 单击转换值（Translate Values）字段中的栏（Bars）。
2. 为每个代码列表值（Codelist Value）输入导入值。
3. 点击保存。

可用映射

下表列出了可用的映射。所有映射均必填。

项名称	映射列	备注
Site Number（研究中心编号）	导入来源 导入值	受试者的研究中心 的研究中心编号（名称）。
受试者 ID	导入来源 导入值	受试者的受试者 ID（姓名）。
事件组	导入来源 导入值	包含事件 的事件组 的名称。
事件	导入来源 导入值	包含目标表单 的事件（访视）的名称。
事件日期	导入来源 导入值 导入格式	事件（访视）的日期。
数据条目	导入来源 导入值 导入格式（仅限日期、日期时间和时间） 转换值（仅限代码列表类型的条目）	Vault 在映射网格中为目标表单上的每个数据收集条目 创建一行。

从另一项研究中复制数据导入配置

你可以从有权访问的其他研究 中复制数据导入配置。当你在多个研究 中使用某个表单 并计划将数据导入到这两个研究中时，该功能非常有用。

要从另一项研究 中复制数据导入配置，请执行以下操作：

1. 导航到研究 的工作室（Studio）> 研究（Studies）> 数据加载程序（Data Loader）。
2. 单击从研究中复制（Copy From Study）。
3. 选择创建副本（Create a copy）或使用现有（Use existing）以处理重复项。详情请见此处。
4. 对于从研究中复制，选择要从何处复制（从另一项研究中（From Another Study）或从库中（From Library））。
5. 选择要从中复制的研究环境（Study Environment）。
6. 搜索或滚动以找到要复制的数据导入配置。
7. 选择要复制的事件组。
8. 可选：选中全选（Select all）复选框以选择所有要复制的数据导入配置。
9. 单击复制配置（Copy Configurations）。Vault 开始将数据导入配置 复制到你的研究 中。
10. 可选：在从研究中复制对话框中：
    • 单击查看摘要（View Summary）以查看已复制表单的列表和副本的状态。
    • 单击查看日志（View Log）以查看复制的每个对象记录的详细状态信息。
11. 完成后，单击关闭（Close）。单击关闭（Close）后，你将无法再访问摘要或日志文件。

如何编辑数据导入配置

要编辑数据导入配置，请执行以下操作：

1. 导航到研究 的工作室（Studio）> 研究（Studies）> 数据加载程序（Data Loader）。
2. 在列表中找到要编辑的数据导入配置。
3. 将鼠标悬停在定义的名称上以显示操作（Actions）菜单。
4. 从操作菜单中，选择 编辑。
5. 进行更改。
6. 单击保存并关闭（Save and Close）。

如何删除数据导入配置

要删除数据导入配置，请执行以下操作：

1. 导航到研究 的工作室（Studio）> 研究（Studies）> 数据加载程序（Data Loader）。
2. 在列表中找到要编辑的数据导入配置。
3. 将鼠标悬停在定义的名称上以显示操作（Actions）菜单。
4. 从操作菜单中，选择 删除（Delete）。
5. 在确认对话框中，单击删除。

部署到其他环境

启用数据加载程序 设置是研究部署包的一部分，因此每次部署时都会包含对此设置的更改。

你的数据导入配置 也包含在包中。但是，这些更改被视为无版本更改。因此，对数据导入配置的更改会在部署后自动应用，无需修订。在对数据导入配置 进行更改时请考虑这一点。