删除文档的注意事项和已知限制
删除操作的注意事项
• 删除文档及其内容是不可逆的。
• 已删除文档及其内容项的 ID 绝不会重复使用。
• 作为一种最佳做法,如果要删除的文档是上游追溯文档,则必须先删除所有下游追溯版本。
• 确保文档在打开的测试会话中没有任何活动或版本化的测试用例。
• 删除操作包括所有其他文档中未引用的所有内容项和共享项。
• 如果共享项被其他文档中的节点所参考,则该共享项不会被删除。
• 指向已删除项的项链接将不起作用。例如,如果内容或文档已用作其他项的多格式文本字段中的项链接,则删除内容或文档时,不会更新项链接。
• 若计算字段中的指标基于所删除的段或内容计算而来,那么这些值将不再有效。
• 其他版本化文档中使用的版本化节点将被保留。例如,如果版本文档 1.1 包含内容 1.1,而版本文档 1.2 也包含内容 1.1,则删除文档 1.1 或 1.2 将不会删除内容 1.1。内容 1.1 将在 API 输出中被列为
ExcludedContents。有关
ExcludedContents 的详细信息,请参阅
im deletesegment。
• 删除段操作会影响 Tests 和 Tests For 系统关系。系统会对 Tests For 关系字段进行分析,所有属于测试用例的内容将从测试会话中移除。如果 Tests For 关系字段中有项不是测试会话,而是 Tests For 关系字段中允许的类型,则此类关系也会作为删除段操作的一部分被移除。
• 成功完成删除文档操作后,文档与系统中存在的所有相关项的关系将被移除。
• IM 服务器中的源追溯将被移除。但基于需求或规范而开发的源成员仍然是源系统的一部分。
• 删除版本化文档不会删除关联的的版本标签。例如,即使在删除版本 1.1 后,也可以按“标签 1.1”查看活动文档。
删除操作的已知限制
• 在删除上游或下游段后,与追溯关系字段相关的内容项的追溯状况字段不会更新。仅当明确编辑这些项的追溯关系字段时,才会更新追溯状况。
• 如果内容或文档已用作其他项的多格式文本字段中的项链接,则删除内容或文档时,不会更新项链接。
• 如果将审核日志配置为捕获对文档所做的任何更改,则在成功删除段后,与文档创建和编辑相关的先前的条目仍会保留在审核日志中。例如,在删除段 24212 后,与段 24212 及其内容 24213 和 24215 相关的审核日志条目仍将在审计日志中可用。
• 在“全新的 Web 界面”中,如果添加到“收藏项”表格和“最近查看的”表格的文档被删除,则“全新的 Web 界面”会显示这些项的出错消息。必须从这些表格中删除已删除项的条目。除非完成此操作,否则“全新的 Web 界面”主页将继续显示此类已删除项的出错消息。