修复因AEM Guides中的B树索引错误导致的DITA后处理故障

Adobe Experience Manager (AEM) Guides中的DITA和DITAMAP文件的后处理可能会由于B树引用索引不一致而失败,通常是在您在DAM中删除并重新上传内容之后。 要解决此问题,请上传内容并将其提取到DAM中的新位置。

描述 description

环境

Adobe Experience Manager (AEM)指南

症状

处理已删除并重新摄取到DAM中的DITA和DITAMAP文件时,AEM Guides中可能会出现后处理失败。 当受影响文件的jcr:content节点中缺少预期的属性,并且反复尝试打开或保存这些文件会触发相同的错误时,通常会出现此问题。

该问题通常与用于删除内容的方法有关,尤其是在标准AEM用户界面之外执行删除时,这会使B树引用索引处于不一致的状态。 因此,后处理无法成功完成,并且文件仍保持错误状态。

解决方法 resolution

按照以下步骤解决问题。

  1. 从DAM中删除受影响的ZIP文件和所有提取的内容。

  2. 将ZIP文件上传并解压缩到新文件夹或DAM中的其他路径(请勿重用原始文件夹)。

  3. 提取后,请验证新位置中的文件的后处理是否成功完成。

  4. (可选)使用以下端点检查并尝试修复B树引用索引:

    • 获取/bin/fmdita/validatebtree?operation=validate (报告无效的内容引用)
    • GET /bin/fmdita/validatebtree?operation=patch (尝试修补损坏的引用)

    注:这些操作可能会提供诊断信息,但并不一定能解决问题。

  5. 确认使用AEM用户界面而不是直接通过CRX/DE执行内容删除,以避免将来出现索引不一致的情况。

  6. 如果在执行这些步骤后问题仍然存在,请收集有关上传和提取过程的完整错误日志,并联系Adobe支持以获取进一步帮助。

要验证分辨率,请检查后处理是否完成且没有错误,以及所摄取文件的jcr:content节点上是否存在预期属性。

recommendation-more-help
experience-cloud-kcs-help-kbarticles