用户帮助 > 使用文档 > 将追溯传播至分支文档
  
将追溯传播至分支文档
为文档创建分支时复制的字段由管理员确定。PTC 建议不要在创建分支期间自动复制追溯关系字段。这让您能够控制在使用传播追溯命令时复制至分支文档的追溯关系。
有关追溯关系的详细信息,请参阅“管理追溯关系”。
有关创建文档分支的详细信息,请参阅“创建文档分支”。
示例 1:在两个分支文档之间传播追溯
针对特定软件组件的版本 2 开始进行计划。此组件的版本 1 具有需求文档以及与相关测试节点的追溯关系。如果分析师开始处理版本 2 的需求,则会为原始需求文档创建分支。由于管理员尚未设置要在分支操作过程中复制的追溯关系,因此没有复制与测试文档的追溯关系。如果测试作者开始处理针对版本 2 的测试计划,则会为原始测试文档创建分支。系统不会复制与需求文档的追溯关系。
需求分析师发布针对版本 2 的需求文档之前,需要有一个相关的测试计划。他需要将版本 1 中需求和测试文档之间存在的追溯关系复制到 2 中。他通过使用传播追溯命令来执行此操作。
此示例说明了两个分支之间的追溯关系的简单传播。
示例 2:将现有追溯关系传播至分支
您可以将两个文档之间的现有追溯关系复制至其中一个文档的分支。这会创建从一个文档版本到相关文档的两个版本之间的追溯关系。例如,需求文档和测试文档之间存在追溯关系,通过为现有测试用例创建分支为需求创建了新的测试用例,并且您希望创建从需求到新测试用例的追溯关系。
如何传播追溯
传播追溯时,首先要选择追溯传播的目标文件。在“传播追溯”向导中,这被称为“复制至开始”文档。在示例 1 中,您选择需求文档 A1 作为要将追溯传播至的文档。然后,您需要指定下列项:
1. 要从中传播追溯的文档,例如,从中创建分支的原始需求文档。在“传播追溯”向导中,这被称为“复制自开始”文档。在示例 1 中,它是需求文档 A。
2. 该文档与您想要从中传播追溯的文档具有追溯关系。在“传播追溯”向导中,这被称为“复制自结束”文档。在示例 1 中,它是测试文档 B。
3. 您希望将传播复制至的文档,例如,分支需求文档中的测试文档。在“传播追溯”向导中,这被称为“复制至结束”文档。在示例 1 中,它是测试文档 B1。
4. 您要复制至目标文档的追溯关系,例如,“测试”关系。
该流程会创建两个映射:
一个会使“复制至开始”文档中的每个条目与“复制自开始”文档中的对应条目相关。
一个会使“复制至结束”文档中的每个条目与“复制自结束”文档中的对应条目相关。
Windchill RV&S 随后会传播追溯关系。对于要从中传播追溯的每个“复制自开始”文档,Windchill RV&S 都会确定所有转至“复制至开始”文档的追溯关系。对于每个追溯关系,Windchill RV&S 都会查找对应的“复制自结束”和“复制至结束”文档。如果“复制至结束”文档中不存在追溯关系,则 Windchill RV&S 会创建该关系。
* 
系统会正确地传播追溯,即使文档内容已编辑或移动。
疑似追溯
使用此命令传播追溯关系后,系统会标记新创建的任何被视为疑似的追溯关系,以供您审阅。在下列情况下,会将追溯标记为疑似:
如果要复制的追溯上存在疑似标志(即使“复制至结束”文档上已追溯关系,并且不是疑似)
如果“复制自开始”文档的共享项 ID 与“复制至开始”文档的共享项 ID 不同,或者如果“复制至结束”文档的共享项 ID 与“复制自结束”文档的共享项 ID 不同,则新追溯将在“复制至结束”文档上标记为疑似。
* 
有关清除疑似追溯的信息,请参阅 管理疑似追溯关系
重要考虑事项
您一次只能在一对文档之间传播追溯。
系统会传播截至当前时间(而不是分支创建时间)的追溯。因此,会传播自分支创建以来对追溯所做的任何更改。
通过追溯传播来创建新追溯关系时,会在文档节点历史记录和文档历史记录中进行记录。
系统会在追溯传播期间忽略内容项与非文档项之间的追溯。
在 GUI 中传播追溯时,“复制至开始”文档和“复制自开始”文档在分支创建历史记录中必须彼此相关。CLI 命令 im propagatetraces 则没有此限制。
要将追溯关系传播至分支文档