从 Microsoft Office 文档导入需求

您可以在 Microsoft^® Word 和 Microsoft Excel^® 中编写需求并将其导入 Requirements Toolbox™。当您导入需求时，您可以允许从 Microsoft Office 文档进行更新，也可以导入它们而不允许更新。要了解有关这些导入模式的更多信息，请参阅选择导入模式。

注意

您只能从 Microsoft Windows^® 平台上的 Microsoft Office 导入需求。
MATLAB^® Online™ 不支持从 Microsoft Office 文档导入需求。

要从 Microsoft Office 文档导入需求：

打开需求编辑器。在 MATLAB 命令行中，输入：
```
slreq.editor
```
点击导入。
将文档类型设置为 Microsoft Word 文档或 Microsoft Excel 电子表格。
在文档位置字段旁边，点击浏览并选择所需的文件。
设置导入选项。要了解有关 Microsoft Office 文档的导入选项的更多信息，请参阅 Microsoft Word 文档的导入选项和 Microsoft Excel 电子表格的导入选项。要了解有关导入需求集或引用需求的更多信息，请参阅选择导入模式。
点击导入导入需求。

Microsoft Word 文档的导入选项

您可以从 Microsoft Word 文档中导入纯文本和富文本格式的需求。使用富文本格式导入包含图形和表格等内容的需求。

当您从 Microsoft Word 文档导入需求时，节标题和编号将填充 ID 和摘要字段，而节正文将填充描述字段。要忽略导入的需求中的章节编号，请选择忽略节标题中的大纲编号。如果选择支持外部源更新，建议忽略大纲编号，以防止在对 Microsoft Word 文档进行更改然后更新导入的需求时章节编号发生变化而出现意外行为。例如，当您在文档中间插入新章节时，章节标题中的某些大纲数字会发生变化以反映新的章节编号。当您更新需求集时，Requirements Toolbox 会删除与大纲编号发生更改的部分相对应的引用需求，并使用更新的编号重新插入它们。这可能会产生一些意想不到的变化问题。

The Importing Requirements dialog has Document type set to Microsoft Word Document. Under Content, Plain text is selected, and under Requirement Identification, Use bookmarks to identify items and serve as custom IDs is selected.

导入的需求层次结构与 Microsoft Word 文档标题层次结构相匹配。

当导入需求时，建议选择使用书签来标识项目并用作自定义 ID，因为书签会持久存储在文档中，无法复制。

当您选择按搜索模式的出现次数标识项目(REGEXP)并输入正则表达式搜索模式时，您可以有选择地导入需求。要了解有关正则表达式的更多信息，请参阅正则表达式。

注意

如果您的需求文档中没有图像，请考虑将您的需求导入为纯文本，以防止出现与字体、样式或空白差异相关的一些问题。

Microsoft Excel 电子表格的导入选项

您可以从 Microsoft Excel 电子表格中导入纯文本和富文本格式的需求。纯文本格式仅导入文本，并将电子表格的每一列与需求属性关联。富文本格式可导入图形、布局并捕获多单元格范围。

注意

如果您的 Excel 电子表格包含分组的单元格且该组被折叠，则不会导入不可见单元格中任何的需求。

当您从 Microsoft Excel 文件导入需求时，您可以通过指定行和列来识别需求，或者使用正则表达式搜索模式。您还可以通过选择使用工作表名称作为项目 ID 前缀将每个导入需求的自定义 ID 与工作表名称附加在一起。

The Importing Requirements dialog has Microsoft Excel Spreadsheet selected. Under content, Text only (better graphics) is selected. Under Requirement Identification, Specify rows and columns is selected.

通过指定行和列来识别需求

要通过指定行和列来识别需求，请在“导入需求”对话框的“需求标识”下选择“指定行和列”。

使用此方法导入需求允许您在点击配置列时将列映射到需求属性和自定义属性。在每一列下，您可以从列表中选择一个项目。您必须选择一列来映射到摘要或描述。如果选择<自定义属性>，则会为需求集注册一个自定义属性，其自定义属性名称由列名指定。要了解有关需求的自定义属性的更多信息，请参阅向需求添加自定义属性。

每列都作为单独的指定属性或自定义属性导入，但描述和理由属性除外，它们可以组合多个相邻的列。当您为描述和理由选择多列时，每个单元格的值将连接成一个字段。

The Configure columns dialog shows rows 2 through 17 with columns for Requirements, Test Scenario, and Test Description. The Use As row shows how each column maps to properties and custom attributes in Requirements Toolbox.

如果您无法将电子表格中的某一列映射到包含唯一需求自定义 ID 的列，则导入操作将根据电子表格中的行自动生成唯一的自定义 ID。这些自定义 ID 可能不是持久的。如果您明确选择没有唯一自定义 ID 的列，则以后无法更新需求文档。

您可以通过忽略列并仅选择要导入的行范围来排除内容。要忽略某一列，请从该列顶部的下拉菜单中选择“<Ignore>”。要仅导入一定范围内的行，请在指定要导入的行下输入起始行号和结束行号。

注意

当您在需求标识下选择指定行和列时，您无法维护 Microsoft Excel 文件中的层次结构。

通过正则表达式搜索模式识别需求

要使用正则表达式搜索模式识别需求，请在导入需求对话框中的需求标识下选择使用搜索模式(REGEXP)。要了解有关正则表达式的更多信息，请参阅正则表达式。

使用正则表达式搜索模式的主要优点是，如果匹配的需求 ID 是分层的，则您可以在从 Excel 文档导入需求时保留现有层次结构。例如，模式 R[\d\.]+ 将与 ID 为 R1, R1.1, R2 等的需求匹配，而 R1.1 将被识别为 R1 的子项。此外，您可以通过仅导入与正则表达式匹配的需求来有选择地导入需求。