CSV 文件格式和示例

导入逗号分隔值 (CSV) 文件之前，请确保文件符合 CSV 格式。此外，CSV 文件和电子表格文件必须遵循行和列的内容规则，且必须以 UTF-8 进行编码。

CSV 格式

IBM Engineering Requirements Management DOORS Next (DOORS Next) 实现了来自 Internet Society 的网络工作组的 RFC 4180 文档中指定的 CSV 格式。有关 CSV 文件格式的常规信息，请参阅 RFC 编辑器 Web 站点上的逗号分隔值。

CSV 和电子表格内容规则

要成功导入 CSV 文件或电子表格文件，内容必须符合以下规则：

行

文件中的每行必须包含相同数目的单元格。该规则也应用于标题行。

标题行

第一行必须包含列标题。这些标题不得包含转义字符或单引号。

第一行的列

下表包含针对第一行的列的需求。可根据需要确定列数以对应工件类型中的字段。这些列映射至的工件类型由每个内容行的“类型”列中的条目确定。

表 1. 行和列的内容规则：第一行的列
列名称	存在
工件类型	必需。 CSV 文件中的每行必须包含与此系统中工件类型相对应的列中的条目。
名称	省略主文本时必需。缺省情况下，系统中的每个工件都具有名称字段。查看文件夹层次结构或查看搜索和过滤结果时，会显示此字段中的数据。
主文本	省略名称时必需。在系统中，每个基于文本的工件类型包含主文本字段，该字段与有关此工件的主要内容相对应。例如，如果此工件是需求，那么其主文本表示实际需求，例如，"The vehicle must have two wheels."
描述	建议。缺省情况下，系统中的每个工件都具有描述字段。将鼠标悬停在标题上时会在工具提示中显示描述。

以下示例显示工件的 CSV 条目，该工件拥有名为 MyRequirementType 的定制工件类型：

Artifact Type, Primary Text, Name, Description, Owner
MyRequirementType, "The vehicle must have two wheels.", "Vehicle wheels", "This requirement defines the rules for vehicles", "Joe Blogs"

有关创建定制工件类型的信息，请参阅创建需求工件类型。

在导出的文件中，链接列中的链接通过与以下示例类似的标记表示：

{LINK id=3129 uri=https://server/rm/resources/_abaf26f172a149b2aaf8f22933be1661}

“主要文本”列中的链接与以下示例类似：

"The text contains a link:{LINK id=3129 title=""3129: AMR Information Architecture"" uri=https://server/rm/resources/_abaf26f172a149b2aaf8f22933be1661}."

图像和嵌入式工件与以下示例类似：

{EMBEDDED id=3498 title=""new requirement"" uri=https://server/rm/resources/_klHmkbljEeWqUL0WZ--HjQ}

{IMAGE id=3496 title=""watson-analytics-logo.png"" uri=https://server/rm/wrappedResources/_dyVrMLljEeWqUL0WZ--HjQ}

内容行

CSV 文件可在其标题行后含有许多行。每行对应一个将创建的工件。 “类型”列中的条目对应系统中将创建的工件类型。此行中的其他单元格对应工件上的匹配字段。

重要信息: 如果包含列内容的单元格与 "类型" 值表示的指定工件类型不匹配，那么将忽略该单元格。即使 CSV 导入完成，也可能因为某个工件类型没有对应列而导致未包括某些数据。为避免此情况，请按工件类型导入内容。例如，您可单独导入不同的工件类型，在此情况下，所有行的“类型”列都将包含相同值。

不受支持的字段

下列字段是系统维护的，因此在 CSV 导入功能中不受支持。如果您导入的 CSV 文件包含其中任何字段，那么导入时会忽略这些字段。

标识
创建者
创建者
创建日期
添加者
修改者
修改时间

注: 您可以将 "团队所有权" 列添加到视图; 但是，当前不支持导出 "团队所有权" 信息。如果导出操作中包含该列，那么所生成 CSV 或电子表格文件中的“团队所有权”字段将为空。

日期格式

通常所有语言环境支持由各种标准（例如，ANSIC、XSD、RFC822 和 RFC3339）定义的某些日期格式。包括这些日期格式是为了用于通过程序生成 CSV 文件的方案。示例：

2011-08-01T10:54:12+01002011-08-01T10:54:12.203Z
2011-08-01T10:54:12Z
Mon, 01 Aug 2011 10:54:12 BST
Monday, 01-Aug-11 10:54:12 BST
Aug 01, 2011 10:54:12 AM BST
2011-08-01T10:54:12
Mon Aug 1 10:54:12 2011
2011-08-01
10:54:12 AM BST
10:54:12

此外，还支持 International Components for Unicode (ICU) 在语言环境上定义的长/中/短格式。以下示例显示用于柏林语言环境的长格式：

de_DE Montag, 1. August 2011 11:58:36 Deutschland
de_DE Montag, 1. August 2011 11:58:36 MESZ
de_DE Montag, 1. August 2011 11:58:36
de_DE Montag, 1. August 2011 11:58
de_DE 1. August 2011 11:58:36 Deutschland
de_DE 1. August 2011 11:58:36 MESZ
de_DE 1. August 2011 11:58:36
de_DE 1. August 2011 11:58
de_DE 01.08.2011 11:58:36 Deutschland
de_DE 01.08.2011 11:58:36 MESZ
de_DE 01.08.2011 11:58:36
de_DE 01.08.2011 11:58
de_DE 01.08.11 11:58:36 Deutschland
de_DE 01.08.11 11:58:36 MESZ
de_DE 01.08.11 11:58:36
de_DE 01.08.11 11:58

以下示例显示用于芝加哥语言环境的长格式：

en_US Monday, August 1, 2011 5:08:17 AM CT
en_US Monday, August 1, 2011 5:08:17 AM CDT
en_US Monday, August 1, 2011 5:08:17 AM
en_US Monday, August 1, 2011 5:08 AM
en_US August 1, 2011 5:08:17 AM CT
en_US August 1, 2011 5:08:17 AM CDT
en_US August 1, 2011 5:08:17 AM
en_US August 1, 2011 5:08 AM
en_US Aug 1, 2011 5:08:17 AM CT
en_US Aug 1, 2011 5:08:17 AM CDT
en_US Aug 1, 2011 5:08:17 AM
en_US Aug 1, 2011 5:08 AM
en_US 8/1/11 5:08:17 AM CT
en_US 8/1/11 5:08:17 AM CDT
en_US 8/1/11 5:08:17 AM
en_US 8/1/11 5:08 AM