slreq.registerNavigationFcn

注册导航函数，引用需求

语法

slreq.registerNavigationFcn(domain,callbackFunction)

说明

slreq.registerNavigationFcn(domain,callbackFunction) 注册了一个导航回调函数 callbackFunction，用于从 ReqIF™ 文件导入的引用需求，这些文件具有 Domain属性值，等于 domain。使用此函数可以在第三方需求管理工具中从需求编辑器导航到原始需求。

注意

导航回调函数应采用以下形式：

function myCustomNavigationFunction(ref)
% Enter your implementation here
end

该函数应该将slreq.Reference对象作为输入。

示例

全部折叠

注册并获取从 ReqIF 文件导入的引用需求的导航回调函数

打开实时脚本

此示例显示如何注册并获取从 ReqIF™ 文件导入的引用需求的注册导航回调函数。

将 ReqIF 文件 mySpec.reqif 导入 Requirements Toolbox™。

count = slreq.import("mySpec.reqif");

获取已导入需求集的句柄。检查域中是否存在导入的引用需求。

rs = slreq.find("Type","ReqSet","Name","mySpec");
topRef = children(rs);
domain = topRef.Domain

domain = 
'Third-Party Tool'

检查该域当前是否已注册任何导航回调函数。

callback = slreq.getNavigationFcn(domain)

callback =

  0x0 empty char array

为域注册自定义导航回调函数myNavigationFcn。确认导航回调函数已注册。

slreq.registerNavigationFcn(domain,"myNavigationFunction")
callback = slreq.getNavigationFcn(domain)

callback = 
'myNavigationFunction'

清理

清除打开的需求集而不保存。取消注册自定义导航回调函数。

slreq.clear;
slreq.registerNavigationFcn(domain,'');

输入参数

全部折叠

`domain` — 第三方需求工具域
字符串标量 | 字符向量

要注册导航回调函数的第三方需求工具域，指定为字符串标量或字符向量。

该参量应该与引用需求的 Domain属性值相匹配。

`callbackFunction` — 导航回调函数名称
字符串标量 | 字符向量

要注册的导航回调函数名称，指定为字符串标量或字符向量。

提示

您可以通过输入以下命令来清除域的已注册导航回调函数：
```
slreq.registerNavigationFcn(domain,"")
```
您可以在 MATLAB^® 命令提示符下输入以下命令来获取引用需求的 Domain属性的值：
```
domain = myReferencedRequirement.Domain
```
```
domain =

    'Third-Party Tool'
```
您可以使用Requirements Toolbox™生成的模板来创建您的导航回调函数。有关更多信息，请参阅从导入的需求导航至原始需求。