本页采用了机器翻译。点击此处可查看最新英文版本。

updateBacklinks

类: slreq.LinkSet
命名空间: slreq

同步外部导航链接

自 R2022a 起

全页展开

语法

[checked,added] = updateBacklinks(myLinkSet)
[checked,added,removed] = updateBacklinks(myLinkSet,removeUnmatched)

说明

[checked,added] = updateBacklinks(myLinkSet) 将外部文档中的反向链接与链接集 myLinkSet 中的链接进行同步。该方法返回该方法检查的链接集中的链接数以及它添加到外部文档的反向链接数。

[checked,added,removed] = updateBacklinks(myLinkSet,removeUnmatched) 会从外部文档中删除当 removeUnmatched 为 true 时链接集中没有对应链接的反向链接。该方法返回从外部文档中删除的反向链接的数量。

输入参数

全部展开

链接集，指定为 slreq.LinkSet 对象。

从外部文档中删除不匹配的反向链接的选项，指定为数据类型为 logical 的 1 或 0。

输出参量

全部展开

该方法检查的链接集中的链接数，以 double 形式返回。

该方法添加到外部文档的反向链接数量，以 double 形式返回。

该方法从外部文档中删除的反向链接的数量，以 double 的形式返回。

示例

全部展开

打开实时脚本

此示例显示如何使用 updateBacklinks 更新 Microsoft® Word 文档的反向链接。

打开 crs_req_func_spec 需求集。需求集具有指向 crs_req.docx 文档的出向链接。

rs = slreq.open("crs_req_func_spec");
myLinkSet = slreq.find(Type="LinkSet",Name="crs_req_func_spec");

更新与链接集相关的外部文档的反向链接。从外部文档中删除不匹配的反向链接。

[checked,added,removed] = updateBacklinks(myLinkSet,true)
checked = 14

added = 4

removed = 1

提示

要程序化地删除所有前向链接及其对应的反向链接：

  1. 使用 remove 方法删除链接集中除一个之外的所有链接。

  2. 使用 save 方法保存链接集。

  3. 通过更新反向链接来移除过时的反向链接。

  4. 导航至包含最后一个剩余反向链接的外部需求，并交互式删除该反向链接。

  5. 使用 remove 方法删除剩余的链接。

  6. 使用 save 方法保存链接集。

您只能在链接集包含至少一个链接时删除过期的反向链接。如果链接集不包含任何链接，请创建一个临时链接到您要移除反向链接的需求文档，然后移除这些反向链接。

有关如何交互式删除所有前向链接及其对应的后向链接的详细信息，请参阅 管理外部需求文档中的导航反向链接。

备选方法

App

您还可以使用需求编辑器更新反向链接。有关详细信息，请参阅管理外部需求文档中的导航反向链接。

版本历史记录

在 R2022a 中推出

另请参阅

类

主题