通过 FTP 创建和更新记录（临床运营）

您现在可以使用文件传输协议 (FTP) 将对象数据加载到 Vault 中。您可以使用单个 CSV 文件为单个对象创建和更新记录，也可使用包含多个 CSV 的 ZIP 文件同时创建和更新多个对象的记录。更新对象会维护对象的所有关系和引用，例如审计追踪。

在 Vault 中，更新操作不同于删除和创建操作。Vault 只更新现有对象记录，而不是删除现有记录，然后用包含更新数据的新记录进行替换。

访问 Vault 的 FTP 服务器

有关说明，请参见访问 Vault 的 FTP 服务器。连接到 Vault 的 FTP 服务器后，您可以启用此功能并开始加载数据。

如何启用 FTP 自动化

要启用此功能，您必须在 FTP 服务器上的连接每个用户目录中创建名为“vaultloader”的新目录。例如，要为用户 ID 为 5678 的 Vault 用户 Clara 创建“Vaultloader”目录，请导航至 vault1234/u5678 并添加“/vaultloader”。将 CSV 和 ZIP 文件加载到此目录中。

准备 CSV 输入

CSV 输入的格式与 Vault 加载程序的格式基本相同。使用字段的名称值 (field_name__v) 标记列，并输入字段值作为每行的对象记录。以下列表详细说明了您的 CSV 的要求：

  • 为每个对象创建 CSV 文件。
  • 使用对象字段的名称值 (field_name__v, __c, __clin) 作为列标题。
  • 使用对象的名称值命名 CSV 文件 (object_name__v, __c, or __clin)。例如，要将记录加载到受试者对象中，请将 CSV 命名为“subject__clin.csv”。
  • 另存为 *.csv file。
  • 要传输多个 CSV，请将每个 CSV 添加到 ZIP 文件中。

如果您要更新现有记录，而不是创建新记录，则您可以通过指定 Vault 可用于将 CSV 中的每行与记录相匹配的唯一字段（如名称或 ID）来确保 Vault 更新现有记录。将字段用作 CSV 中的一列，然后按照以下格式将字段名附加到 CSV 文件名中：

object_name__v.field_name__v.csv

例如，如果 Gladys 正在将 EDC 报告中的受试者注册数据加载到她的 CTMS Vault 中，她可能会使用受试者对象上的外部 ID 字段来匹配她的报告和目标 Vault 之间的受试者记录。

Gladys 可以在她的 CSV 中纳入外部 ID (external_id__v) 列。然后 Gladys 会保存文件名 subject__clin.external_id__v.csv。

定义 Vault 处理 CSV 的顺序

当您将记录数据加载到多个对象时，您可能需要定义 Vault 处理 CSV 的顺序。例如，Gladys 正在将记录数据加载到受试者和方案偏离对象。方案偏离与受试者有引用关系。Gladys 必须先创建受试者记录，然后才能成功创建引用它们的方案违背或偏离记录。她可以同时将两个 CSV 加载到 ZIP 文件中，仅需纳入 order.txt 文件即可。

创建纯文本 (.txt) 文件，按所需顺序列出要加载的对象。例如，Gladys 的 order.txt 文件将包括：

subject__clin

pdv__clin

Vault 会忽略未引用 CSV 文件名之一中的对象名称的任何行。因此，您可以为多个数据加载重用相同的 order.txt 文件，即使每次都没有加载对象的完整组合。

如果您在 ZIP 文件中不包括 order.txt 文件，Vault 将按字母顺序处理 CSV。

CSV 示例

FTP 服务器详细信息

Vault 会在七 (7) 天后自动从 FTP 服务器删除您的 FTP 加载程序文件。

如何将数据加载到单个对象

  1. 连接到 FTP 服务器。
  2. 将 CSV 文件加载到 /vaultloader 目录中。
  3. Vault 接收 CSV 并创建或更新相应的对象记录。

如何将数据加载到多个对象

  1. 连接到 FTP 服务器。
  2. 将 ZIP 文件加载到 /vaultloader 目录中。
  3. Vault 按照 order.txt 文件指定的顺序接收 CSV，并创建或更新相应的对象记录。

成功和失败日志文件

每次加载后，Vault 会创建单独的成功和失败日志作为 CSV 文件。您可以从 Vault 内通知或电子邮件通知下载这些文件。这两种文件均包含每个记录的系统管理 ID 值。

失败日志

失败日志包括：

  • 加载失败的每个记录的错误消息
  • 原始数据以及相应的错误
  • 原始 CSV 文件中相应行的行 ID

您可以查看并修复这些错误日志中的错误。纠正任何错误后，可以重新导入失败日志。

您可以使用标准的系统管理员或 Vault 所有者配置文件完成本文提到的所有步骤。

如果 Vault 使用自定义安全配置文件，则您的配置文件必须授予以下权限：

类型权限标签控制
安全配置文件管理员：文件暂存：访问能够访问你的 Vault 的 FTP 暂存服务器。
安全配置文件管理员：访问 API能够进行通过 FTP 创建和更新记录所需的 API 调用。
安全配置文件Vault 所有者操作：Vault 加载程序能查看和使用 Vault 加载程序选项卡。虽然通过 FTP 创建和更新记录时未使用 Vault 加载程序选项卡，但需要具有使用 Vault 加载程序的权限才能通过 FTP 服务器自动加载。
安全配置文件对象：{Object}：创建、编辑能为要加载到 Vault 中的对象创建和编辑记录。
安全配置文件对象：{Object}：读取能查看与要加载到 Vault 中的对象相关的记录。例如，在创建受试者时，用户需要对研究、研究国家和网站对象具有读取权限。