将需求导出至 ReqIF 文件

您可以将需求和链接从 Requirements Toolbox™ 导出到 ReqIF™ 文件，导出到支持通过需求交换格式(ReqIF)进行数据交换的第三方需求管理工具。您可以选择要包含在导出的 ReqIF 文件中的属性、原型属性和自定义属性。您还可以通过在需求编辑器中创建过滤视图来过滤导出的需求和链接。

当您导出指向不在需求集的项的链接时，Requirements Toolbox 会在 ReqIF 文件中插入代理对象以防止链接断开。

选择导出映射

当您将需求和链接导出到 ReqIF 文件时，您必须选择一个导出映射，将需求和链接数据映射到 ReqIF 需求和链接数据。Requirements Toolbox 包括这些第三方工具的导出映射：

IBM^® DOORS^®
IBM DOORS Next
Polarion™
PREEvision
Jama

Requirements Toolbox 还包含一个通用映射，如果您的第三方工具没有导出映射，则可以使用它。

如果您需要进行 ReqIF 往返，选择导出映射非常重要，即导入 ReqIF 文件，编辑需求，然后将其导出回 ReqIF 文件。在 ReqIF 往返过程中导出需求时，可以使用以下任一方式避免意外行为：

导入和导出的映射相同
导出的通用映射

有关 ReqIF 往返的更多信息，请参阅 ReqIF 文件的往返导入和导出。

导出需求和链接类型

您使用的属性映射会影响 Requirements Toolbox 如何将需求和链接类型名称导出到 ReqIF 文件。

在 ReqIF 往返过程中，如果您重新使用用于导入的相同属性映射，则导出的 ReqIF 需求类型名称和链接类型名称将恢复为原始 ReqIF 文件中的值。

当您使用通用映射需求集及其链接时，Requirements Toolbox 会根据您使用内置类型、自定义需求类型还是构造原型来以不同的方式设置导出的需求和链接类型名称。

Requirements Toolbox 类型	导出的 ReqIF 类型名称
内置需求类型： `Functional` `Container` `Informational`	`Requirement`
内置链接类型： `Relate` `Implement` `Verify` `Derive` `Refine` `Confirm`	`Relate` `Implement` `Verify` `Derive` `Refine` `Confirm`
`sl_customization` 文件中定义的自定义需求或链接类型。请参阅使用 sl_customization 文件定义自定义需求和链接类型。	自定义需求或链接类型名称
配置文件中定义的原型。请参阅使用原型自定义需求和链接。	原型名称

导出需求

您可以导出单个需求集或单个导入节点。此外，如果您在 Requirements Toolbox 中编写了需求，则可以导出单个需求，该需求也会导出其父需求和子需求以维护需求层次结构。

要导出：

在需求编辑器中，选择需求集、导入节点或需求。
点击导出 > ReqIF。
在将导出需求设置为 ReqIF 对话框中，将导出属性和类型的映射设置为第三方工具或泛型的属性映射。有关详细信息，请参阅选择导出映射。
在过滤属性下，使用添加和删除按钮来指定要包含在 ReqIF 文件中的属性和自定义属性。
在要导出的其他内容下，选择导出链接以在导出的 ReqIF 中包含链接，或清除选择以省略链接。有关导出链接的更多信息，请参阅导出链接。
输出文件显示导出的 ReqIF 文件的文件路径和名称。要编辑文件路径或名称，点击浏览，然后点击保存保存文件路径和名称。
通过点击导出导出 ReqIF 文件。

The Export Requirement dialog with export mapping for attributes and types set to Generic.

注意

Requirements Toolbox 不导出链接属性、链接自定义属性或除链接类型名称之外的链接原型属性。

要仅导出当前需求编辑器视图中的属性和自定义属性，请选择包括来自活动视图列的属性。有关显示附加列的更多信息，请参阅显示额外的列。

要导出需求和链接的子集，请创建一个根据需求和链接元数据进行过滤的视图，并在需求编辑器中应用该视图。有关视图的更多信息，请参阅在需求编辑器中配置视图。

注意

如果子需求满足过滤视图准则但其父需求不满足，则需求编辑器将显示父需求以保留层次结构。但是，当您导出需求时，ReqIF 文件不包含不符合过滤准则的父需求。

以编程方式导出需求

以编程方式导出需求：

使用 slreq.find 或 slreq.load 函数获取需求集的句柄。
例如，此代码加载并返回名为 myReqSet 的需求集的句柄。
```
myReqSet = slreq.load("myReqSet");
```
创建一个 ExportOptions 对象并指定：
- 导出文件的名称
- 导出映射
- 导出链接的选项
- 要导出的属性
例如，此代码创建一个 ExportOptions 对象，将导出的 ReqIF 文件命名为 myReqIF.reqif，使用通用模板，导出链接，并且仅导出 Summary、Type 和 Description 需求属性。
```
exportOptions = slreq.export.ExportOptions( ...
    OutputFile="myReqIF.reqif",Template="Generic", ...
    IncludeLinks=true,Attributes=["Summary","Type","Description"]);
```
使用 slreq.export 函数导出需求和链接。
例如，此代码使用 myReqSet 中的导出选项导出 exportOptions 的需求集。
```
dir = slreq.export(myReqSet,exportOptions);
```

要过滤导出的需求和链接，请使用 create 函数创建过滤视图，然后使用 View 名称值参量将该视图作为输入传递给 ExportOptions 创建函数。

导出链接

如果您的需求有链接，您可以在将需求导出到 ReqIF 文件时将其导出。

如果您将 Requirements Toolbox 中的需求链接到需求集未包含的项（例如 Simulink^® 模块或不同需求集的需求），然后将该需求和相关链接导出到 ReqIF 文件，则 Requirements Toolbox 会将链接代理对象插入到链接项的 ReqIF 文件中。下表显示了为链接对象生成的链接代理对象类型名称：

链接项	链接代理对象类型名称
Simulink 模型元素 Stateflow^® 模型元素 System Composer™ 模型元素	`Simulink Object`
Simulink Test™: 测试文件测试套件测试用例迭代评估	`Simulink Test Object`
MATLAB^® 代码	`MATLAB Code Range`
Web 浏览器 URL	`External Resource`
Simulink 数据字典条目	`Simulink DDEntry`
需求引用需求	`Requirements Toolbox Object`
所有其他项	`Requirement`

注意

导出的链接代理对象具有持久 ID，第三方工具可以使用这些 ID 来避免重复代理对象。如果不同的 ReqIF 文件包含来自相同 MATLAB 或 Simulink 对象的链接，则可能会发生重复。

如果将 ReqIF 文件重新导入到具有链接代理对象的 Requirements Toolbox，则软件会重建与代理对象相关的链接以及具有 Requirement 以外类型的代理对象的需求。有关详细信息，请参阅从 Requirements Toolbox 生成的 ReqIF 文件中导入链接。