Umbenennen des internen Namens einer Inhaltsfragmentvariante in AEM
Adobe Experience Manager (AEM) aktualisiert nur den Anzeigetitel (jcr:title), wenn eine Inhaltsfragment-Variante umbenannt wird, während der interne Variantenname unter jcr:content/data unverändert bleibt, da er beim Erstellen der Variante festgelegt wird. Um das Problem zu beheben, erstellen Sie eine neue Variante mit dem gewünschten internen Namen, kopieren Sie den Inhalt, aktualisieren Sie die Verweise und entfernen Sie die alte Variante nach der Validierung.
Beschreibung description
Umgebung
Adobe Experience Manager (alle Versionen)
Problem/Symptome
- Beim Umbenennen einer Inhaltsfragmentvariante im Inhaltsfragment-Editor wird nur deren Anzeigebezeichnung (
jcr:title) aktualisiert. - Der interne Variantenname, d. h. der Knotenname unter
jcr:content/data, bleibt unverändert. - Komponenten und Headless-APIs wie GraphQL verwenden den internen Namen, um auf die Variante zu verweisen.
- Es gibt keine unterstützte Möglichkeit, den internen Namen einer vorhandenen Variante direkt zu ändern, nachdem sie erstellt wurde.
Grundursache
Der interne Name einer Inhaltsfragmentvariante wird festgelegt, wenn die Variante erstellt wird, und wird von AEM-Komponenten und -APIs als Kennung verwendet. Beim Umbenennen der Variante in der Benutzeroberfläche wird nur die Anzeigebeschriftung (jcr:title) aktualisiert, nicht der interne Knotenname. Dieses Verhalten ist beabsichtigt und erhält stabile Referenzen für Headless- und komponentenbasierte Integrationen.
Lösung resolution
Gehen Sie wie folgt vor, um das Problem zu beheben:
- Erstellen Sie im Inhaltsfragment-Editor eine neue Variante mit dem gewünschten internen Namen und Titel.
- Kopieren Sie den Inhalt manuell von der ursprünglichen Variante in die neue Variante.
- Aktualisieren Sie alle Verweise wie Seiten, Komponenten und GraphQL-Abfragen, um den neuen Variantennamen zu verwenden.
- Stellen Sie sicher, dass alle Funktionen mit dem neuen Variantennamen erwartungsgemäß funktionieren.
- Entfernen Sie nach Abschluss der Validierung die alte Variante, um Verwirrung zu vermeiden.