用户帮助 > 使用文档 > 从 Windchill RV&S 数据库中删除文档 > 删除版本化文档的注意事项和最佳做法
  
删除版本化文档的注意事项和最佳做法
删除版本的注意事项
版本化的内容可以是选定文档的一个或多个版本的一部分。尽管可以删除任何版本,但已版本化的内容如果是文档的多个版本的一部分,则将从删除操作中排除。此类排除可保持版本化文档的数据和结构的完整性,保留这些文档共享版本化的内容。此类版本内容在 im deletesegment 命令 -- reportOnly 选项的 API 输出中列为 ExcluedContents。其他版本化文档中使用的版本化节点将被保留。例如,如果版本文档 1.1 包含内容 1.1,而版本文档 1.2 也包含内容 1.1,则删除文档 1.1 或 1.2 将不会删除内容 1.1。
已版本化的内容和共享项如果没有被所删除文档之外的任何版本化文档所参考,则将随选定版本文档一起删除。
与已删除的版本化文档或版本化内容相关的项都带有注释,其中说明了已删除的版本化文档或版本化内容的内部 ID、执行删除操作的用户以及操作的时间戳。
删除活动文档的所有版本后,后续的版本控制操作会针对已删除版本的项创建强制版本。此类强制版本控制操作可能不会在活动文档的生成版本上复制追溯。
包含插入或包括的内容或文档的版本化文档可以删除。
删除版本的最佳做法
删除版本化文档只能作为删除活动文档的先决条件。
请勿随意删除版本文档。请从最后版本到第一个版本的顺序依次删除所有版本文档。
在删除一个或多个版本化文档后,应避免调用后续版本控制操作。
对于文档,请在单个 API 会话中删除活动文档和所有相关文档版本。这样可避免用户对活动文档和版本化文档进行任何修改,或在修改后试图对文档进行版本控制。
您应根据业务需求制定完善的文档删除流程。
要删除的活动文档及其版本不可处于活动使用或开发状态。例如:
文档不可处于查看、编辑或版本控制过程中。
文档不可用于在段和内容级别创建追溯和添加关系。
文档不是计算或更改包所用文档和内容的一部分。为了避免计算字段值出现任何不一致,文档或其任何内容不应以任何方式直接或间接参与计算字段公式。如果选择进行删除操作的文档或其任何内容参与了字段计算,则成功删除操作前后得到的字段计算值将会不同。
删除版本化测试文档的注意事项和最佳做法
如果 Excluded Contents 已使用测试文档的任何版本作为上下文添加到测试会话中,则在删除测试文档的任何版本时,此类 Excluded Contents 都将从所有测试会话中移除。请参阅下图中的例子。
删除测试文档版本 123-1.0,将会移除测试会话 1 和 2 这两个测试会话中的 ExcludedContent 124-1.0。
为了避免从所有相关测试会话中移除已版本化的测试用例,建议对活动测试文档的所有后续检入使用 “所有内容项”选项。这样可以确保每次对活动测试文档进行版本化时,也会对内容项进行版本化,因此在删除测试文档的任何版本时,测试会话中的内容项不会移除。请参阅下图中的例子。
删除测试文档版本 123-1.0 时只会移除测试会话 1 中的测试用例
有关排除内容的详细信息,请参阅 im deletesegment