什么是文档版本化?
要跟踪文档在项目生命周期中的演变,您可以在项目的各个阶段创建唯一的文档版本。您可以通过检入文档或内容项来创建新版本。创建文档或内容版本可为您提供与执行检入操作时完全相同的文档记录。
活动文档是用于创建版本 (使用检入操作) 的起始文档。活动文档及其内容可在其生命周期中更改。
文档版本表示文档及其内容在历史记录的特定点的结构。内容版本是一个构件,它代表内容项在其历史记录中某一特定点的一条记录。尽管活动文档可以继续演变,但版本一旦创建,便无法再更改其中的重要内容。
非文档模型项无法进行版本化。具体而言,您无法从“测试步骤”创建版本化的项,也无法将它们作为版本化内容的一部分包括在内。
项版本修订和文档版本化有什么区别?
项版本修订将修订版本标签添加到现有项中。使用修订版本标签,您可以查看截至该修订版本的项历史。“查看”是唯一可以对版本修订项执行的操作。这是一个轻量解决方案,用于在项目生命周期内跟踪项的演变。只有非文档模型项可以使用项版本修订,例如“项目”或“版本”项类型。
文档版本化记录文档结构,创建新项,并将版本标签添加到正在进行版本化的项中 (并非新项)。您可以查看版本化的项、向版本化的项添加追溯,以及修改版本化的项上的某些字段。此外,您还可以将标签应用于版本化的项、查询版本化的项、将版本化的项数据图表化、以及报告版本化的项数据。此解决方案功能更加强大,可以在整个项目生命周期中跟踪文档的演变。只有文档模型项可以使用文档版本化,例如需求文档 (段) 和需求 (节点)。
文档版本化时会发生什么?
创建文档或内容版本时,构成原始文档或内容的项 (活动项) 将复制到新项 (版本化的项) 中。每个创建的版本都有一个唯一标识符,格式如下:活动项 ID -主要版本 ID .次要版本 ID。例如,7201-1.0、7201-1.1 或 7201-2.0。仅当项已被版本化时,才会显示新版本 ID。活动项继续显示没有版本信息的项 ID,例如 7201。
从 Integrity Lifecycle Manager 12.0 和更高版本起,您能够将版本化的测试套件和测试用例添加到测试会话,并且能够对版本化的测试用例输入测试结论。
在版本化的项中,基本字段和字段值都是从活动项中复制的。例如,整数、逻辑和短文本字段。有关更复杂的字段,例如项支持的选择列表字段和查询支持的关系字段,请参阅
创建文档版本以了解详细信息。
如何使用版本化的项?
文档版本化的主要目标之一是截至内容版本化的时间制作文档内容的副本,保留字段值和文档结构,从而允许查询和追溯内容。
为了实现追溯能力目标,在版本化的项上某些字段可能需要可编辑。特别是,关系字段可以设置为可编辑,从而允许追溯版本化的项或将版本化的项与项目或版本项相关联。选择列表字段、整数字段和浮点数字段也可以设置为可编辑;它们可用于在版本化的项上存储元数据。但是请注意,重要字段无论其属于何种类型都无法设置为可编辑。
管理员可以定义在版本化的项上可编辑哪些字段。在版本化的项上标记为可编辑字段的字段不得同时标记为重要编辑字段。此外,标记为重要编辑字段的字段也不能在版本化的项上标记为可编辑字段。有关其他信息,请参阅
内容版本中的追溯关系。
此外,您还可以查询版本化的项、将版本化的项数据图表化、以及报告版本化的项数据。
使用基线标记重要的项目里程碑
检入各个文档和内容版本后,您可以将所选版本作为文档基线的一部分包括进来。有关详细信息,请参阅
设置文档基线。
内容版本中的追溯关系
追溯关系是使两个文档或内容项相关的特殊方向性关联。有关详细信息,请参阅
内容版本中的追溯关系。
如何区分活动文档和版本化文档?
为了在 GUI 和 Web 界面中区分活动文档和版本化文档,PTC RV&S 包含了以下用户界面组件:
• 图标和指示符
单个版本化文档和内容会在项顶端突出显示。例如,以下文档版本化图标和指示符会显示在“文档”视图中:
• 版本化的项 ID
每个创建的版本都有一个唯一标识符,格式如下:活动项 ID -主要版本 ID .次要版本 ID。版本化的项 ID 显示在“项详细信息”、“项”、“关系”和“文档”视图中。
• 参考模式
在版本化之前,节点包含的参考模式有“作者”、“共享”或“重复使用”。在版本化之后,版本化内容包含参考模式“版本”,以表示内容参考了共享项的静态副本,且内容不应发生任何更改。
• 项排序
使用 ID 字段为列表排序时,
PTC RV&S客户端会按数字顺序对查询结果和关系字段排序。有关详细信息,请参阅
创建文档版本主题中的“文档版本中查询结果和关系字段的列表排序”部分。
• 动态视图
在使用文档版本时,您可以利用动态视图来查看项和关系信息。有关详细信息,请参阅
创建文档版本主题中的“使用动态视图”部分。
• 文档查找器
在文档查找器中,版本化文档会根据当前查找器规则与活动文档一起显示。
• 活动项和版本化的项之间的链接
在对文档或内容进行版本化后,活动项包含指向版本化的项的链接。
版本化的项包含一个可以打开处于“当前”状态的活动项的链接,以及一个可以打开“截至”版本化的项创建之时的活动项历史视图的链接。