由于AEM Guides中的缓存,Assets已在DXML后处理中跳过
AEM Guides中的DXML后处理在确保资产元数据(如标题、文档状态和链接引用)在整个用户界面中正确同步和呈现方面发挥着重要作用。 这可以在创作内容中实现准确显示和可靠导航。 如果AEM Guides中的资源未正确处理(例如缺少元数据、主题链接断开或不完整的输出预设),则问题可能源于DXML后处理程序中的缓存路径。 本文介绍如何识别存储库中忽略的路径并将其删除,以恢复正确的资产处理和元数据同步。
描述 description
环境
- 产品: Adobe Experience Manager (AEM) Managed Services
- 版本:AEM 6.5,指南4.0+
问题/症状
- DITA文件中的 标题 字段未保留更新,在刷新后恢复到其以前的状态。
- 属性控制台中不存在 文档状态 字段,但在“文件属性”面板中可见。
- 文件显示为文件,而不是指南中应有的 主题 类型。
- 添加到映射的主题以红色显示,指示断开或不可用的链接,而不是蓝色。
- 如果资源位于CRX/DE中
/var/dxml/postprocess/ignoredPaths节点下列出的路径中,则新创建的映射可能缺少输出预设。 这些路径被视为从DXML后处理中排除,并且问题可能会在该节点中定义的任何位置发生。 - 文件属性下的 用于 和 传出链接 引用未正确更新。
解决方法 resolution
此问题的根本原因是后处理工作流由于缓存的资产路径而忽略特定路径。 AEM Guides提供了一个OSGi配置,允许管理员指定应从后处理中排除的文件夹 — 请参阅AEM Guides文档中的禁用文件夹的后处理。 除了此配置外,存储库在/var/dxml/postprocess/ignoredPaths处还包含一个节点,该节点充当要跳过的路径的缓存。 如果资产位于这些路径中的某一个路径中,则在DXML后处理期间将忽略该资产,并且可能会显示如下所示的INFO级别日志消息:
[后处理]路径因缓存配置而被忽略[后处理]正在跳过对有效负载/content/dam/<资产路径的后处理>
解决步骤
-
验证CRX/DE中受影响的路径是否列在
/var/dxml/postprocess/ignoredPaths下。 导航到此节点,并检查与忽略的路径对应的属性。 有关步骤,请参阅AEM as a Cloud Service用户指南中的CRXDE Lite快速入门。 -
从
ignoredPaths节点中删除不必要的条目:仅保留/content/dam/projects/translation_output(默认值)。 有关步骤,请参阅AEM 6.5 User Guide中的How to Delete Properties and Nodes with cURL。 如果您将具有空值的属性POST到节点,AEM将删除该属性。 要从给定节点中删除属性,请使用以下格式:code language-none curl -u 'userId:password' \ -F "propertyName=" \ http://localhost:4502/path/to/nodepropertyName应替换为要删除的属性的名称。path/to/node应为属性存在的存储库路径。 将等号(=)后面的值保留为空会告知AEM删除指定的资产。注意:您需要为要从节点中删除的每个属性重复该命令。
-
删除与受影响路径相关的所有其他条目。 或仅删除导致受影响资源被忽略的路径。 有关步骤,请参阅《AEM 6.5用户指南》中的Sling内容。
-
对受影响路径下的所有资产重新运行DAM更新资产工作流。 这可确保生成元数据和正确处理资源。 有关步骤,请参阅AEM Assets教程中的运行DAM更新资产工作流。
-
验证:
-
标题会在更新后保留。
-
Document State字段在各个界面上正确显示。
-
文件图标显示为主题。
-
主题在添加到映射时以蓝色显示。
-
所有输出预设都可用于新映射。
-
引用(用于,传出链接)更新准确。
您可以参考AEM Guides文档中的AEM Guides中的报告来制定验证核对清单,跨资源和映射验证内容状态、引用以及与输出相关的属性。
-
在清除忽略的路径并重新运行资源工作流后,以前缺少的资源及元数据将重新显示并正确显示在AEM Guides中。 标题、文档状态、链接和输出预设将按预期更新,确认处理已正常恢复。