导入编码列表

在工作室中设计研究时,您可以导入 CSV 模板以自动创建编码列表(Codelists)。每个研究 可以对一个病例手册版本进行导入。

先决条件

默认情况下,具有标准 CDMS 研究设计者(CDMS Study Designer)CDMS 超级用户(CDMS Super User)CDMS API 读写(CDMS API Read Write)研究角色的用户可以执行下述操作。如果贵组织使用自定义研究角色,则你的角色必须授予以下权限:

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

能够访问工作室选项卡

功能权限 设计研究

能够通过工作室创建研究设计定义和研究计划

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

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


每个编码列表最多可以导入 2,000 个条目。

如何导入

要导入编码列表,请执行以下操作:

  1. 在工作室中导航到研究
  2. 研究对象(Study Objects)下,单击编码列表 已选择“研究对象”菜单“编码列表”

  3. 单击 导入编码列表(Import Codelist) “导入编码列表”菜单

  4. 将你的导入 CSV 文件拖放到将文件拖放到此处(Drag and drop file here)区域。也可以单击此区域上传文件。
  5. 可选:单击取消(Cancel)以停止导入。

编码列表导入成功后,将在 EDC 中重新创建编码列表定义编码列表条目定义编码列表定义 - 编码列表条目定义。可以在工作室中查看编码列表定义编码列表条目定义编码列表定义 - 编码列表条目定义仅在管理员 > 业务管理员中可见。

导入代码列表部分和预览结果表

了解在工作室中如何创建代码列表

格式

导入后,会验证顺序编号和接受的字段字符。

对于编码列表,如果订单号顺序不正确,系统将根据上一个有效编号对其进行自动重新分配。例如,如果编码列表有 3 个项目,编号分别为 1、10 和 3,则 10 将重新分配为 3,3 将变为 2。

对于字段,仅接受以下字符:

  • a-z、A-Z
  • 0-9
  • 连字符(-)
  • 单下划线(_)

如果在行中找到无效字符,则该记录会显示错误消息。

默认值

系统会自动为模板中未包含的必需属性提供默认值。您可以在工作室中更新这些值。所有项目定义(Item Definitions) 默认为必填(required),布尔数据类型除外。具有编码列表单位数据类型的项目必须引用现有的编码列表或单位定义,才能成功导入。如果行引用不存在的对象,则会发生错误,并且无法导入文件。要解决此问题,请先导入缺失的编码列表单位定义(Unit Definition),或从文件中删除引用。

导入编码列表 CSV 模板

使用下面的模板作为你的导入文件。

下载导入编码列表模板

必填列

编码列表导入文件中需要以下列:

数据类型
编码列表名称 文本(最多 128 个字符)
编码列表外部 ID 文本(最多 128 个字符)
编码列表条目顺序 数字(0 - 9,999)
编码列表条目编码 文本(最多 100 个字符)
编码列表条目标签 文本(最多 256 个字符)

以下各列可选:

数据类型
编码列表描述 文本(最多 256 个字符)
编码列表条目描述 文本(最多 255 个字符)
已隐藏 布尔值(是/否)

隐藏值区分大小写。无需添加单独的行来标识编码列表

选择 CSV 文件时,“导入”页面上的将文件拖放到此处(Drag and drop file here)区域将显示 CSV 中的文件名、文件大小和行数。

此帮助页面的链接位于将文件拖放到此处区域下方,用于快速访问 CSV 模板

预览结果表

如果至少可成功处理一个文件,则会在“导入”页面上显示预览结果表。此表包括以下内容:

  • 处理的记录总数
  • 通过验证的记录数
  • 验证失败的记录数
  • 结果表中的导入状态列
  • 每个模板列的结果列(列不可排序)
  • 页面上的结果数

可以根据三种状态筛选记录:错误(Error)、警告(Warning)准备导入(Ready for import)

可以通过页面上的导航选项前进到下一个结果页面或返回上一个结果页面。你还可以输入某个页码,以直接跳转到该结果页面,实现快速访问。

管理错误

如果 CSV 文件中存在错误,请在工作室之外修复错误,然后重新导入。成功导入编码列表后,编码列表部分会将每个编码列表显示为单独不同的项目,其中包含分配给它的项目。每个导入项目的属性都与 CSV 中定义的属性匹配,因此,如果模板中“项目 1”的编码 = “1”,则它在工作室中的显示方式相同。如果要导入的编码列表定义 已存在,则会显示错误。要更新现有编码列表,请直接在工作室中进行更改。

验证错误

下表列出了可能的验证错误及其描述:

错误 描述
导入文件中缺失以下列:[缺失列名称] CSV 文件完全无法处理。例如,选择了错误的文件。
导入文件中缺失以下列标题:[以逗号分隔的缺失列标题的列表] 缺失列。
[以逗号分隔的缺失列标题的列表] 是必需的 缺失必填值。
[以逗号分隔的缺失列标题的列表] 的值超出字符限制。 值的字符数超过相应文本字段的限制。
[列名称] 值 [列值] 无效 在相应的选项列表、布尔值或数字字段中不接受该值。
项目的顺序号不是唯一的 订单号对于特定编码列表不是唯一的。
文件中的重复条目 两行或多行具有相同的代码列表名称 + 代码列表条目标签(对于代码列表导入)。