ExportOptions
说明
使用 ExportOptions
对象在导出需求和 ReqIF™ 文件链接时配置选项。
创建对象
语法
属性
Attributes
— 要导出的需求属性和特性
字符串数组 | 字符向量元胞数组
要导出的必需属性和特性,指定为字符串数组或字符元胞数组。您可以通过指定属性或特性的名称来导出内置属性、原型属性或自定义属性。对于原型属性,请输入完全限定名称,包括配置文件名称。
示例: Attributes=["Summary","Description"]
示例: Attributes=["My Custom Attribute 1", "My Custom Attribute 2"]
示例: Attributes=["myProfile.myStereotype.myProperty1", "myProfile.myStereotype.myProperty2"]
数据类型: cell
| string
IncludeLinks
— 文件是否包含链接
false
或 0
(默认) | true
或 1
导出的文件是否包含与需求集相关的链接,指定为数字或逻辑 0
(false
) 或 1
(true
)。
示例: IncludeLinks=true
数据类型: logical
MappingFile
— 映射文件的文件路径
字符向量
此 属性 为只读。
导出期间使用的映射文件的文件路径,以字符向量形式返回。当您将 ExportOptions
对象作为输入传递给 slreq.export
函数时,Requirements Toolbox™ 会设置此属性的值。
数据类型: char
OutputFile
— 导出的文件名和目录
""
(默认) | 字符串标量 | 字符向量
导出的 ReqIF 文件名和目录,指定为字符串标量或字符向量。文件名必须具有 .reqif
或 .reqifz
扩展名。如果需求包含图像并且您使用 .reqif
扩展名,该函数会自动更新文件的扩展名。
示例: OutputFile="myExportedReqIF.reqif"
数据类型: char
| string
Template
— 导出映射
""
(默认) | "Generic"
| "IBM DOORS"
| "IBM DOORS Next"
| ...
导出映射,指定为以下选项之一:
值 | 描述 |
---|---|
空字符串标量或字符向量 | 导出使用导入的需求集的映射。否则,导出将映射到通用模板。 |
"Generic" | 导出模板映射到通用模板。 |
"IBM DOORS" | 导出模板映射到 IBM® DOORS®。 |
"IBM DOORS Next" | 导出模板映射到IBM DOORSNext。 |
"Jama Software" | 导出模板映射到 Jama 软件。 |
"Polarion" | 导出模板映射到 Polarion®。 |
"PREEvision" | 导出模板映射到 PREEvision。 |
数据类型: enum
TemplateFile
— 模板文件的文件路径
字符向量
此 属性 为只读。
导出期间使用的模板文件的文件路径,以字符向量形式返回。当您将 ExportOptions
对象作为输入传递给 slreq.export
函数时,Requirements Toolbox 会设置此属性的值。
数据类型: char
View
— 要使用的 需求编辑器 视图
字符串标量 | 字符向量
导出期间使用的需求编辑器视图,指定为字符串标量或字符向量。该视图根据元数据过滤导出的需求和链接。
示例: View="myView"
数据类型: char
| string
对象函数
getFilterableAttributes | 可导出到 ReqIF 的属性和特性 |
verify | 验证需求集的 ReqIF 导出选项 |
示例
创建导出选项
此示例显示如何创建一个空的导出选项对象。
myExportOptions = slreq.export.ExportOptions
myExportOptions = ExportOptions with properties: OutputFile: '' Template: '' IncludeLinks: 0 View: '' Attributes: {}
通过设置 OutputFile
属性值来指定导出的 ReqIF 文件的名称。
myExportOptions.OutputFile = "myReqIF.reqif"
myExportOptions = ExportOptions with properties: OutputFile: "myReqIF.reqif" Template: '' IncludeLinks: 0 View: '' Attributes: {}
创建并验证导出选项
此示例展示如何创建 ReqIF 导出选项、获取可用属性和自定义属性、指定要导出的属性和属性,以及验证生成的导出选项。
打开 ShortestPath
工程。
openProject("ShortestPath");
加载shortest_path_func_reqs
需求集。
rs = slreq.open("shortest_path_func_reqs");
创建导出选项
创建一个导出选项对象,将输出文件指定为shortest_path_func_reqif.reqif
,导出链接,并使用通用导出映射。
myExportOptions = slreq.export.ExportOptions( ... OutputFile="shortest_path_func_reqif.reqif",IncludeLinks=true,Template="Generic")
myExportOptions = ExportOptions with properties: OutputFile: "shortest_path_func_reqif.reqif" Template: "Generic" IncludeLinks: 1 View: '' Attributes: {} MappingFile: '' TemplateFile: ''
指定要导出的属性
使用 getFilterableAttributes
函数获取要导出的可用属性。
attributes = getFilterableAttributes(myExportOptions,rs)
attributes = 1x11 cell
{'Summary'} {'Type'} {'Keywords'} {'CreatedOn'} {'CreatedBy'} {'ModifiedOn'} {'ModifiedBy'} {'Revision'} {'Description'} {'Rationale'} {'Priority'}
通过设置 Attributes
导出选项属性的值,仅导出 Summary
和 Description
属性以及 Priority
自定义属性。
myExportOptions.Attributes = ["Summary","Description","Priority"]
myExportOptions = ExportOptions with properties: OutputFile: "shortest_path_func_reqif.reqif" Template: "Generic" IncludeLinks: 1 View: '' Attributes: ["Summary" "Description" "Priority"] MappingFile: '' TemplateFile: ''
验证导出选项和导出需求
验证shortest_path_func_reqs
需求集的导出选项对象。
status = verify(myExportOptions,rs)
status = logical
1
将需求集集导出至 ReqIF 文件。
dir = slreq.export(rs,myExportOptions)
dir = 'shortest_path_func_reqif.reqif'
版本历史记录
在 R2023a 中推出R2023b: 指定要导出的属性以及导出期间要使用的过滤视图
分别使用 Attributes
和 View
属性指定要导出的属性,并仅导出符合需求编辑器视图指定的过滤准则的需求和链接。
R2023b: 查看导出时使用的映射文件和模板文件
通过查看MappingFile
和TemplateFile
属性返回导出时使用的映射文件和模板文件的文件路径。当您将 ExportOptions
对象作为输入传递给 slreq.export
函数时,软件会设置这些属性的值。
R2023b: 获取要导出的可用属性
使用 getFilterableAttributes
函数返回可供导出的属性和特性。
MATLAB 命令
您点击的链接对应于以下 MATLAB 命令:
请在 MATLAB 命令行窗口中直接输入以执行命令。Web 浏览器不支持 MATLAB 命令。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)