格式化需求数据

在可以将需求数据从 Word 文档导出到 ALM 之前，数据必须作为段落或表放置。另外，如果要导出需求类型和用户定义的字段，则必须首先从 ALM 项目中导入它们的定义。

然后，可以使用 Microsoft Word 插件工具栏按钮对需求字段进行标记。您可以格式化需求，以便在将需求导出到 ALM 时，需求在需求树中处于相同或不同的层次结构级别。

在本主题中︰

在 Word 文档中放置需求数据

Word 文档可以包含段落或表形式的需求数据。

数据作为段落

当数据作为段落提供时，需求的每个字段都必须放在单独的行上。对于每个需求，必须先显示需求名称，然后显示其他需求字段。以下示例显示了作为段落放置的两个需求的数据:

数据作为表

当文档包含表时，每一行必须包含需求的数据。第一列必须是需求的名称。以下示例显示了表中列出的同样两个需求的数据:

返回页首

导入需求类型

您可以将需求类型及其相关的用户定义字段的定义从 ALM 项目导入到 Word 文档。然后，可以为 Word 文档中的每个需求定义和导出需求类型。在为需求定义需求类型之后，可以导出可用于该类型需求的用户定义字段的值。

要从 ALM 项目导入需求类型，请执行以下操作:

1. 单击 以打开“需求类型定义向导”。

2. 以 http://<ALM 服务器名称>[:端口]/qcbin 格式输入 ALM URL，然后单击“下一步”。

   对于单点登录用户，启用“添加基本身份验证标头模式”。

   备注: “添加基本身份验证标头模式”是可选的，只有在收到“无效的服务器响应”消息时才应启用。

3. 输入 ALM 用户名和密码，然后单击“下一步”。

4. 选择 ALM 域和项目，然后单击导入。

   插件从 ALM 项目导入需求类型和用户定义的字段。

5. 在插件导入需求类型和用户定义的字段后，“需求类型定义向导 - 第 5 步，共 5 步”对话框将打开。单击“完成”。需求类型和用户定义的字段在 Word 文档中进行更新。

返回页首

标记需求字段

将数据作为段落或表放置后，必须标记需求字段。要标记需求字段，请突出显示文本，然后单击 ALM“需求”工具栏上的相应按钮。将在标记的文本行旁边添加一个图标。书签插入到文档中，以允许插件在导出到 ALM 时标识所标记的文本。

当标记需求字段时，请注意以下事项:

• 对于每个需求，必须提供需求名称。您还可以导出需求类型、审核状态、作者、优先级、描述和富文本。此外，如果导出需求类型，则可以导出该类型可用的用户定义字段的数据。

• 如果需求树中存在同名的需求，则需求的字段将更改为包含新值。如果您的文档在相同的层次结构级别上包含两个同名的需求，则仅创建第二个需求。

• 如果未提供审核状态，则默认值为“未审核”。

• 每个字段的数据应与标记它的图标位于同一行上。但“描述”字段、用户定义的备注字段和富文本除外。

  描述字段	数据可以扩展到其他行，可以包括回车和缩进。
  用户定义的备注字段	数据可以扩展到其他行，但只有第一行导出到 ALM。
  富文本数据	数据可以包含您在常规 Word 文档中可包含的任何内容。当富文本数据导出到 ALM 时，富文本数据作为附件添加到需求中。附件名为 Legacy_Rich_Content.doc。 备注: 此需求每一次额外导出到 ALM 时，都会覆盖 Legacy_Rich_Content.doc 文件。

• 拟用于具有选择列表的 ALM 字段的数据必须与这些选择列表中的条目完全匹配。例如，“优先级”字段只能接受以下实体之一: “5 - 紧急”、“4 - 非常高”、“3 - 高”、“2 - 中”或“1 - 低”。

• 您无法导出 ALM 项目中不存在的用户定义字段的数据，或不可用于需求类型的字段的数据。

要标记需求字段，请执行以下操作:

1. 打开一个包含需求文本的 Word 文档。

2. 您可以使用结构检查器来确保您不会插入使结构无效的书签。例如，结构检查器可确保您不会在需求中添加多个名称，或者在打开需求之前将其关闭。要打开或关闭结构检查器，请在 ALM“需求”工具栏上，单击“打开结构检查器”按钮或“关闭结构检查器”按钮。

3. 突出显示文档中的文本行或表单元格，然后单击 ALM“需求”工具栏上的相应按钮:

   字段	工具栏按钮	图标
   需求名称
   需求的审核状态
   需求的作者
   需求的优先级
   需求的描述

4. 要将需求分配给类型，请在需求数据中添加并突出显示新文本行，或者添加新表列并在新列中突出显示与需求相对应的单元格。在 ALM“需求”工具栏上的“类型”框中，选择需求类型。单击“类型”按钮以将需求类型添加到文档中。需求类型已添加，并由“需求类型”图标 指示。

5. 要将值分配给用户定义的字段，请突出显示文档中包含该值的文本行或表单元格。在 ALM“需求”工具栏上的“字段”框中，选择用户定义的字段。单击“字段”按钮，使用“用户定义的字段”图标 标记该值。

6. 要添加导出到 ALM 的富文本，请突出显示富文本，然后单击“打开富文本”按钮。已添加“打开富文本”图标 以指示富文本的开头。

   将光标放在要添加的富文本的末尾，然后单击“关闭富文本”按钮。已添加“关闭富文本”图标 以指示富文本的结尾。

7. 对所有需求数据重复以上操作。文档中任何未标记的文本都将被忽略。

8. 单击“关闭需求”按钮，以关闭每个带有“关闭需求”图标 的需求。此标记的位置取决于需求是在相同的层次结构级别上还是在不同的层次结构级别上。

   有关详细信息，请参阅示例: 相同层次结构级别上的需求或示例: 不同层次结构级别上的需求。

9. 要取消标记一个或多个字段，请使用撤消按钮或手动删除标记。有关详细信息，请参见从 Word 文档中删除格式。

10. 标记所有需求字段后，将需求导出到 ALM。有关详细信息，请参见将数据从 Microsoft Word 导出到 ALM。

返回页首

示例: 相同层次结构级别上的需求

要在需求树中的相同层次结构级别上定义需求，请使用“关闭需求”按钮将“关闭需求”标记直接放置在每个需求之后。这导致将需求放置在与先前需求相同的级别上。

当文档包含段落时，在需求的最后一行之后插入一行，并用“关闭需求”标记对其进行标记:

当文档包含表时，在表的末尾添加一列，并为每个需求插入“关闭需求”标记:

将需求导出到 ALM 之后，需求显示在根需求下的相同层次结构级别上。

返回页首

示例: 不同层次结构级别上的需求

您可以将需求定义为先前需求的子需求。使用“关闭需求”按钮可将父需求的“关闭需求”标记放置在所有子需求之后。

例如，要将 Req_2 定义为 Req_1 的子级，将 Req_3 和 Req_4 定义为 Req_2 的子级，则将 Req_2 的“关闭需求”标记放置在其子需求定义之后。将 Req_1 的“关闭需求”标记放在最后。

当文档包含段落时，将每个“关闭需求”标记放在其自己的行上的适当位置。请注意，Req_1 和 Req_2 的“关闭需求”标记插入到 Req_3 和 Req_4 之后。

当数据作为表提供时，在表的末尾添加一列，并将每个“关闭需求”标记放置在适当位置:

将需求导出到 ALM 之后，Req_2 显示为 Req_1 的子级，Req_3 和 Req_4 显示为 Req_2 的子级。

返回页首

接下来的步骤：

• 将数据从 Microsoft Word 导出到 ALM