导入项目和代码列表
25R1 及以后版本
在工作室中设计研究时，您可以导入 CSV 模板以自动创建项目（Items）和代码列表（Codelists）。每个研究可以对一个病例手册版本进行导入。
先决条件
默认情况下，具有标准 CDMS 研究设计者（CDMS Study Designer）、CDMS 超级用户（CDMS Super User）和 CDMS API 读写（CDMS API Read Write）研究角色的用户可以执行下述操作。如果贵组织使用自定义研究角色，则你的角色必须授予以下权限：
| 类型 | 权限标签 | 控制 |
|---|---|---|
| “标准”选项卡 | 工作室选项卡 | 能够访问工作室选项卡 |
| 功能权限 | 设计研究 | 能够通过工作室创建研究设计定义和研究计划 |
如果您的“研究”包含受限数据，您必须具有“受限数据访问（Restricted Data Access）”权限才能查看该数据。
了解有关“研究角色”的更多信息。
如何导入
要导入项目，请执行以下操作：
- 在工作室中导航到研究。
- 在研究对象（Study Objects）下，单击项目。
- 选择导入项目（Import Items）。
- 将你的导入 CSV 文件拖放到将文件拖放到此处（Drag and drop file here）区域。也可以单击此区域上传文件。
- 此时将显示导入项目预览页面。
要导入代码列表，请执行以下操作：
- 在研究对象下，点击代码列表（Codelist），然后选择导入代码列表（Import Codelist）。
- 将你的导入 CSV 文件拖放到将文件拖放到此处（Drag and drop file here）区域。也可以单击此区域上传文件。
- 此时将显示导入代码列表预览页面。
单击取消（Cancel）以停止导入。
导入部分
导入部分显示以下内容：
- 文件名
- 文件大小
- 行数
此帮助页面的链接位于导入部分下方，用于快速访问 CSV 模板（请参阅代码列表和项目部分以下载 CSV 模板）。
预览结果表
选择文件后，将自动对其进行处理和验证。如果至少可成功处理一个文件，则会显示预览结果表。此表包括以下内容：
- 处理的记录总数
- 通过验证的记录数
- 验证失败的记录数
- 结果表中的导入状态列
- 每个模板列的结果列（列不可排序）
- 页面上的结果数
可以根据三种状态筛选记录：错误（Error）、警告（Warning）和准备导入（Ready for import）。
可以通过页面上的导航选项前进到下一个结果页面或返回上一个结果页面。你还可以输入某个页码，以直接跳转到该结果页面，实现快速访问。
导入项目
导入成功后，将在 CDMS 中重新创建 itemdefs 和 item_def_codelist_defs。您可以在工作室中查看 itemdef。Item_def_codelist_defs 只能在管理员（Admin）>业务管理员（Business Admin）中访问。
itemdefs CSV 文件应该没有错误。可以在工作室外部的模板中更正问题，然后重新导入。成功导入项目后，项目部分将 CSV 文件中的每个项目显示为不同的条目，其属性与 CSV 中定义的属性相匹配。例如，如果项目的数据类型设置为“时间”，则此属性将反映在工作室中。
如果系统中已存在 itemdef，则尝试再次导入该 itemdef 将导致错误。要更新现有项目，请直接在工作室中进行更改。CSV 中未包含的任何属性（如缩进、控制项或渐进显示）都必须在导入后在工作室中手动更新。
使用下面的模板作为你的导入文件。
项目必填列
项目导入文件中需要以下列：
| 列 | 描述 |
|---|---|
| 项名称 | 文本 |
| 外部 ID | 文本 |
| 标签 | 文本 |
| 项类型 | 文本；Veeva 值。选项：EDC、状态、标题、只读、派生 |
| 数据类型 | 文本；Veeva 值。选项：文本、日期、日期时间、时间、布尔值、URL、代码列表、标签、数字、单位 |
| 代码列表定义 | 文本。必须与现有代码列表定义匹配。 *如果数据类型等于代码列表，则为必填。 |
| 单位定义 | 文本。必须与现有单位代码列表项目定义匹配。 *如果数据类型等于单位，则为必填。 |
以下各列可选：
| 列 | 描述 |
|---|---|
| 描述 | 文本 |
导入代码列表
成功导入后，将在 CDMS 中重新创建 codelistdefs、codelistitemdefs 和 codelist_def_codelist_item_defs。您可以在工作室中查看 codelistdefs 和 codelistitemdefs。Codelist_def_codelist_item_defs 仅在管理员 > 业务管理员中可见。
codelistdefs CSV 文件应该没有错误。可以在工作室外部的模板中更正问题，然后重新导入。成功导入代码列表后，代码列表部分会将每个代码列表显示为单独不同的项目，其中包含分配给它的项目。每个导入项目的属性都与 CSV 中定义的属性匹配，因此，如果模板中“项目 1”的代码 = “1”，则它在工作室中的显示方式相同。
如果要导入的 codelistdef 已存在，则会显示错误。要更新现有代码列表，请直接在工作室中进行更改。
使用下面的模板作为你的导入文件。
代码列表必填列
代码列表导入文件中需要以下列：
| 列 | 数据类型 |
|---|---|
| 代码列表名称 | 文本（最多 128 个字符） |
| 代码列表外部 ID | 文本（最多 128 个字符） |
| 代码列表描述 | 描述 |
| 代码列表条目顺序 | 数字（0 - 9,999） |
| 代码列表条目代码 | 文本（最多 100 个字符） |
| 代码列表条目标签 | 文本（最多 1,500 个字符） |
| 已隐藏 | 布尔值（是/否） |
以下各列可选：
| 列 | 数据类型 |
|---|---|
| 代码列表描述 | 文本（最多 256 个字符） |
| 代码列表条目描述 | 文本（最多 255 个字符） |
隐藏值区分大小写。
无需添加单独的行来标识代码列表。
格式
导入后，还会验证顺序编号和接受的字段字符。
对于代码列表，如果订单号顺序不正确，系统将根据上一个有效编号对其进行自动重新分配。例如，如果代码列表有 3 个项目，编号分别为 1、10 和 3，则 10 将重新分配为 3，3 将变为 2。
对于字段，仅接受以下字符：
- a-z、A-Z
- 0-9
- 连字符（-）
- 单下划线（_）
如果在行中找到无效字符，则该记录会显示错误消息。
默认值
系统会自动为模板中未包含的必需属性提供默认值。您可以在工作室中更新这些值。所有项目定义（Item Definitions） 默认为必填（required），布尔数据类型除外。具有代码列表或单位数据类型的项目必须引用现有的代码列表或单位定义，才能成功导入。如果行引用不存在的对象，则会发生错误，并且无法导入文件。要解决此问题，请先导入缺失的代码列表或单位定义（Unit Definition），或从文件中删除引用。
验证错误
下表列出了可能的验证错误及其描述：
| 错误 | 描述 |
|---|---|
| 导入文件中缺失以下列：[缺失列名称] | CSV 文件完全无法处理。例如，选择了错误的文件。 |
| 导入文件中缺失以下列标题：[以逗号分隔的缺失列标题的列表] | 缺失列。 |
| [以逗号分隔的缺失列标题的列表] 是必需的 | 缺失必填值。 |
| [以逗号分隔的缺失列标题的列表] 的值超出字符限制。 | 值的字符数超过相应文本字段的限制。 |
| [列名称] 值 [列值] 无效 | 在相应的选项列表、布尔值或数字字段中不接受该值。 |
| 项目的顺序号不是唯一的 | 订单号对于特定代码列表不是唯一的。 |
| 文件中的重复条目 | 两行或更多行共享相同的项目名称（Item Name）（对于项目导入）或代码列表名称（Codelist Name） + 代码列表项目标签（Codelist Item Label）（对于代码列表导入）。 |