在AEM中重命名内容片段变量的内部名称
Adobe Experience Manager (AEM)在重命名内容片段变体时仅更新显示标题(jcr:title),而jcr:content/data下的内部变体名称保持不变,因为它是在创建变体时设置的。 要解决此问题,请使用所需的内部名称创建新变体,复制内容,更新其引用,并在验证后删除旧变体。
描述 description
环境
Adobe Experience Manager(所有版本)
问题/症状
- 在内容片段编辑器中重命名内容片段变体只会更新其显示标签(
jcr:title)。 - 内部变体名称(即
jcr:content/data下的节点名称)保持不变。 - 组件和Headless API(如GraphQL)使用内部名称引用变量。
- 现有变体创建后,不支持直接更改其内部名称的方式。
根本原因
内容片段变量的内部名称在创建变量时设置,并由AEM组件和API用作标识符。 重命名UI中的变体只会更新显示标签(jcr:title),而不会更新内部节点名称。 此行为通过设计来维护Headless集成和基于组件的集成的稳定引用。
解决方法 resolution
请按照以下步骤解决问题:
- 在内容片段编辑器中,使用所需的内部名称和标题创建新变体。
- 手动将内容从原始变体复制到新变体。
- 更新所有引用(如页面、组件和GraphQL查询)以使用新的变体名称。
- 验证新变体名称的所有功能是否均可按预期工作。
- 完成验证后,请删除旧变量以避免混淆。
recommendation-more-help
experience-cloud-kcs-help-kbarticles