映射导入键

在某些情况下，根据研究在 EDC 中的配置方式，第三方数据在数据文件中可能具有不同的研究、研究中心、受试者或事件的值，这些值与任何 EDC 值不匹配。为了避免让数据供应商修改数据（这可能既昂贵又不切实际），CDB 支持将第三方数据加载中的传入值映射到现有 EDC 数据的功能。

先决条件

所需权限

默认情况下，具有标准 CDMS 超级用户（CDMS Super User）研究角色的用户可以执行下述操作。如果贵组织使用自定义研究角色，则你的角色必须授予以下权限%}

类型 权限标签 控制
“标准”选项卡 工作台选项卡

能够通过工作台（Workbench）选项卡访问和使用 Data Workbench 应用程序
功能权限 查看导入

能够访问“导入（Import）”页面
功能权限 管理键位映射

能够创建和管理导入的键位映射

如果您的“研究”包含受限数据，您必须具有“受限数据访问（Restricted Data Access）”权限才能查看该数据。

了解有关“研究角色”的更多信息。

映射类型

键位映射有四种类型或级别：研究、研究中心、受试者和事件。Workbench 在 ZIP 文件中包含补充数据，具体取决于键位映射模板的类型。每种键位映射类型的补充数据如下：

  • 研究：列出研究名称和研究外部 ID 的 CSV 文件。
  • 研究中心：列出研究环境中所有研究中心的研究中心编号和研究中心名称的 CSV 文件。
  • 受试者：列出研究中的所有受试者的 CSV 文件。
  • 事件：
    • 根据上次从 EDC 导出结果，列出所有事件定义的 CSV 文件。
    • 根据上次从 EDC 导出结果，列出所有事件组定义的 CSV 文件。

键位映射是在源/键位映射级别为某一研究定义的，因此每个源最多可以有四（4）种不同的键位映射。对于指定的源和级别组合的任何更新都会替换同一源和级别组合的现有映射。

访问键位映射

可以从 CDB 的导入（Import）区域访问键位映射。可以从导航抽屉（Navigation Drawer）（），或在选择研究（Study）后从研究页面上的研究菜单（）导航到导入区域。

进入导入区域后，单击标题中的 vpn_key 键位映射打开子选项卡。

列

在导入 > vpn_key 键位映射中显示以下列：

列 描述
源 键位映射的源的名称。
键位映射类型 键位映射的类型（级别）。
状态 上传的映射文件状态。可能的状态包括待定、完成和错误。
已上传 已上传映射文件的日期和时间（UTC）。

创建映射文件

要下载模板，请执行以下操作：

  1. 导航到导入 > vpn_key 键位映射。
  2. 单击键位映射模板（Key Map Template）。
  3. 选择模板（Template）。

研究

要创建研究映射，请执行以下操作：

  • 对于映射类型（Mapping Type），根据要匹配的值输入“名称”或“外部_id”。
  • 对于研究（Study），输入 Workbench 中存在的研究名称或外部 ID（在 Study_Definitions.csv 文件中列出）。
  • 对于传入值（Incoming Value），输入在导入包中存在的研究值。

为每个可能的键值对创建额外行。

下表是 Study_mapping_keys.csv 文件示例：

映射类型 研究 传入值
名称 Cholecap Cholecap_Protocol1

研究中心

要创建研究中心映射，请执行以下操作：

  • 对于映射类型（Mapping Type），根据要匹配的值输入“名称”或“编号”。
  • 对于研究中心（Site），输入 Workbench 中存在的研究中心名称或研究中心编号（根据对映射类型的选择）（在 Sites.csv 文件中列出）。
  • 对于传入值（Incoming Value），输入在导入包中存在的研究中心值。

为每个可能的键值对创建额外行。

下表是 Site_mapping_keys.csv 文件示例：

映射类型 研究中心 传入值
名称 Pleasanton General Hospital West PGH-W
名称 Pleasanton General Hospital East PGH-E

受试者

要创建受试者映射，请执行以下操作：

  • 对于受试者（Subject），输入 Workbench 中存在的受试者 ID。
  • 对于传入值（Incoming Value），输入在导入包中存在的受试者 ID。

为每个可能的键值对创建额外行。

下表是 Subject_mapping_keys.csv 文件示例：

受试者 传入值
0101-10001 101-10001
0101-10002 101-10002
0101-10003 101-10003
0102-10001 102-10001
0102-10002 102-10002

事件

要创建事件映射，请执行以下操作：

  • 对于映射类型（Mapping Type），根据要匹配的值输入“名称”或“外部_id”。
  • 对于事件（Event），输入 Workbench 中存在的事件名称或外部 ID。
  • 对于事件序列（Event Sequence），输入 Workbench 中存在的序列号。
  • 对于传入值（Incoming Value），输入在导入包中存在的事件。

为每个可能的键值对创建额外行。

下表是 Event_mapping_keys.csv 文件示例：

映射类型 事件 事件序列 传入值
名称 Visit_1 1 Visit_1
名称 Visit_2 1 Visit_2
名称 Visit_3 1 Visit_3
名称 Visit_1 2 Visit_4
名称 Visit_2 2 Visit_5
名称 Visit_3 2 Visit_6

导入映射

要导入键位映射文件，请执行以下操作：

  1. 导航到导入 > vpn_key 键位映射。
  2. 单击导入映射（Import Mapping）。
  3. 选择来源。
  4. 选择一种键位类型（Key Type）。
  5. 将文件拖放到选择文件（CSV）（Choose a File (CSV)）区域。
  6. 单击导入（Import）。

导入状态

Workbench 使用以下三（3）种状态跟踪键位映射导入：

状态 描述
待定 导入未完成。
完成 导入已成功完成。
错误 由于一个或多个错误，导入未完成。

错误

如果在导入过程中出现任何错误，可以在错误（Errors）面板中查看这些错误。

研究

下表列出了研究键位映射的可能错误：

消息 说明 解决方法
缺少一个或多个必需的列标题“映射类型”、“研究”和“传入值”。 映射 CSV 文件缺少一个必需的列，或者 CSV 文件的标题标签错误。 更新 CSV 文件，确保包含“映射类型”、“研究”和“传入值”列，并使用这些确切标签。
文件包含“映射类型”、“研究”和“传入值”之外的列。 映射 CSV 应仅包含三列：映射类型、研究和传入值。 删除除映射类型、研究和传入值以外的任何列。
文件包含无效的“映射类型”值。值必须为“外部_ID”或“名称” 映射类型列包含无效值。 更新映射类型列中的值，仅使用“外部_ID”或“名称”。
文件包含混合的“映射类型”值。值必须全部为“外部_ID”或“名称”。 每个键位映射文件只能使用一种映射类型。 更新映射，仅使用“外部_ID“或”名称”作为映射类型，而不是两者混合使用。
文件不包含任何记录。 映射文件没有任何映射行。 在文件中输入映射。
文件包含多行，其中“传入值”相同。 映射文件包含一个或多个具有相同传入值的行。 删除重复行或更新“传入值”列，确保没有重复值。

研究中心

下表列出了研究中心键位映射的可能错误：

消息 说明 解决方法
缺少一个或多个必需的列标题“映射类型”、“研究中心”和“传入值”。 映射 CSV 文件缺少一个必需的列，或者 CSV 文件的标题标签错误。 更新 CSV 文件，确保包含“映射类型”、“研究中心”和“传入值”列，并使用这些确切标签。
文件包含“映射类型”、“研究中心”和“传入值”之外的列。 映射 CSV 应仅包含三列：映射类型、研究中心和传入值。 删除除映射类型、研究中心和传入值以外的任何列。
文件包含无效的“映射类型”值。值必须为“名称”或“编号”。 映射类型列包含无效值。 更新映射类型列中的值，仅使用“名称”或“编号”。
文件包含混合的“映射类型”值。值必须全部为“名称”或“编号”。 每个键位映射文件只能使用一种映射类型。 更新映射，仅使用“编号“或”名称”作为映射类型，而不是两者混合使用。
文件不包含任何记录。 映射文件没有任何映射行。 在文件中输入映射。
文件包含多行，其中“传入值”相同。 映射文件包含一个或多个具有相同传入值的行。 删除重复行或更新“传入值”列，确保没有重复值。

受试者

下表列出了受试者键位映射的可能错误：

消息 说明 解决方法
缺少一个或多个必需的列标题“受试者”和“传入值”。 映射 CSV 文件缺少一个必需的列，或者 CSV 文件的标题标签错误。 更新 CSV 文件，确保包含“受试者”和“传入值”列，并使用这些确切标签。
文件包含“受试者”和“传入值”之外的列。 映射 CSV 应仅包含两列：受试者和传入值。 删除除受试者和传入值以外的任何列。
文件不包含任何记录。 映射文件没有任何映射行。 在文件中输入映射。
文件包含多行，其中“传入值”相同。 映射文件包含一个或多个具有相同传入值的行。 删除重复行或更新“传入值”列，确保没有重复值。

事件

下表列出了事件键位映射的可能错误：

消息 说明 解决方法
缺少一个或多个必需的列标题“映射类型”、“事件”、“事件序列”和“传入值”。 映射 CSV 文件缺少一个必需的列，或者 CSV 文件的标题标签错误。 更新 CSV 文件，确保包含“映射类型”、“事件”、“事件序列”和“传入值”列，并使用这些确切标签。
文件包含“映射类型”、“事件”、“事件序列”和“传入值”之外的列。 映射 CSV 应仅包含四列：映射类型、事件、事件序列和传入值。 删除除映射类型、事件、事件序列和传入值以外的任何列。
文件包含无效的“映射类型”值。值必须为“外部_ID”或“名称”。 映射类型列包含无效值。 更新映射类型列中的值，仅使用“名称”或“外部_ID”。
文件包含混合的“映射类型”值。值必须全部为“外部_ID”或“名称”。 每个键位映射文件只能使用一种映射类型。 更新映射，仅使用“外部_ID“或”名称”作为映射类型，而不是两者混合使用。
文件包含无效的“事件序列”值。值必须是大于 0 的整数。 “事件序列”列必须是大于 0 的整数。 更新“事件序列”列，仅包含大于 0 的整数。
文件不包含任何记录。 映射文件没有任何映射行。 在文件中输入映射。
文件包含多行，其中“传入值”相同。 映射文件包含一个或多个具有相同传入值的行。 删除重复行或更新“传入值”列，确保没有重复值。

下载映射文件

可以下载当前的映射文件。要下载映射文件，请执行以下操作：

  1. 导航到导入 > vpn_key 键位映射。
  2. 在列表中找到要下载的键位映射。
  3. 从映射（Mapping）菜单（）中，选择下载映射（Download Mapping）。

删除映射

可以删除映射。如果删除映射，未来的任何数据包均无法使用这些键位导入。

要删除键位映射，请执行以下操作：

  1. 导航到导入 > vpn_key 键位映射。
  2. 在列表中找到要删除的键位映射。
  3. 从映射（Mapping）菜单（）中，选择删除映射（Delete Mapping）。
  4. 可选：在确认对话框中，选择不再显示此信息（Do not show this again），以后的删除操作则无需确认。
  5. 单击确定（OK）。