排查发布错误

发布地图通常很简单。 打开地图,选择输出预设,然后生成输出! 但是,如果映射或其主题中存在错误,则输出生成可能会失败。 发生这种情况时,了解如何排除故障非常重要。

为练习做准备

您可以在此处下载练习的样例文件。

练习 — 下载

发布错误的常见原因

源内容中可能会引入错误。 例如:

  • 未正确命名文件路径引用

  • 名称不正确的文件夹

  • 缺少图形或文件

  • 内容引用配置不正确

  • 交叉引用中断

  • 属性的值错误(例如,字符串而不是数字)

  • 使用的组件设置不正确 AEM Guides

错误的影响

错误可能是轻微的,并导致简单的注释,让您知道文件未成功打包,或者严重到足以导致无法生成输出。 “输出”选项卡显示颜色编码的图标以显示与输出生成相关的成功、错误或失败。

error-impact

打开和查看错误日志

可以打开生成的日志文件进行查看。

  1. 输出 选项卡,单击 生成日期下的日期/时间。

    错误日志

  2. 滚动浏览错误日志。

显示和隐藏错误类型

错误日志以唯一的颜色显示每种错误类型。

navigate-error

  1. 选择取消选择 要显示或隐藏突出显示的任何错误类型。

  2. 使用 下一个上一个 按钮(箭头)。

解决错误

根据错误类型,分辨率可能简单或复杂。 它可以由作者在XML编辑器中完成,也可以要求管理员使用 AEM Guides. 具体的更正取决于错误、影响以及您的组织工作流。

  • 未正确命名文件路径引用

    code language-none
     作者可以更新源文档中的路径引用。
    
  • 名称不正确的文件夹

    code language-none
     作者可以根据需要更新文件夹名称或移动文件。
    
  • 缺少图形或文件

    code language-none
     作者可以上传缺少的图形/文件、重命名图形/文件或移动图形/文件
    
  • 内容引用配置不正确

    code language-none
     作者可以更正引用内容的位置,或更改内容引用的路径。
    
  • 交叉引用中断

    code language-none
     作者可以更正交叉引用指向的位置,或更改目标文件名或属性
    
  • 属性的值错误(例如,字符串而不是数字)

    code language-none
     作者可以将属性更新为正确的值,管理员也可以更新系统以支持新值。
    
  • 使用的组件设置不正确 AEM Guides

    code language-none
     管理员可以更新系统、其组件或权限的安装。
    
recommendation-more-help
5d77304e-09c3-49ad-9381-b66e7cbd5f86