Beheben von Zugriffs- und Konfigurationsproblemen des universellen Editors, wenn AEM die EDS-Inhaltsquelle ist
Wenn Edge Delivery Services (EDS) AEM als Inhaltsquelle verwendet, sehen Autoren im universellen Editor keine erwarteten Metadatenfelder, Blockkonfigurationswerte, Vorlagenvarianten oder JSON-Daten. Die Ursache ist fast immer eine architektonische oder nicht übereinstimmende Konfiguration: Ein EDS-Projekt unterstützt nur eine primäre Inhaltsquelle, BYOM-Modelle (bring your own model) müssen Metadaten explizit für den universellen Editor bereitstellen, die dynamische Feldpopulation erfordert eine benutzerdefinierte universelle Editor-Erweiterung und JSON- oder Konfigurationsdaten müssen absichtlich über das EDS-Repository, strukturierte Inhalte oder DAM-Zuordnungen verfügbar gemacht werden. Durch Bestätigen des Autorenmodus, Erzwingen der Single-Source-Regel und Freigeben der erforderlichen Metadaten und Daten werden die fehlenden Editor-Felder wiederhergestellt.
Beschreibung description
Problem: Der universelle Editor zeigt keine Metadaten, Blockfelder oder JSON-Daten an, wenn AEM die EDS-Inhaltsquelle ist
Beschreibung
Bei der Arbeit mit Edge Delivery Services (EDS) und dem universellen Editor (UE) sehen Autorinnen und Autoren im Editor keine erwarteten Metadatenfelder, Blockkonfigurationswerte, Vorlagenvarianten oder JSON-Daten. Seiten werden in nicht korrekt geladen oder Autoren können keine Metadaten auf Seitenebene, dynamischen Felder oder Blockoptionen konfigurieren. In anderen Fällen versuchen Kunden, nicht unterstützte Architekturmuster zu verwenden, z. B. die Mischung von universellem Editor und dokumentbasierter Inhaltserstellung innerhalb eines einzigen EDS-Projekts oder die Konfiguration mehrerer Inhaltsquellen innerhalb desselben fstab.yaml. Diese Fehlkonfigurationen führen zu inkonsistentem Rendering, fehlenden Metadaten, der Unfähigkeit, bestimmte Authoring-Schnittstellen zu verwenden, oder zu Blöcken, die die erforderlichen Eingaben von AEM nicht nutzen.
Umgebung:
- Adobe Experience Manager as a Cloud Service (AEMaaCS)
- AEM Managed Services
- AEM as a Cloud Service - Sites
- Edge Delivery Services (ED)
- Universeller Editor
Problem/Symptome:
- Der universelle Editor wird geladen, Metadatenfelder oder Blockkonfigurationsfelder werden jedoch nicht angezeigt, und es wird kein Fehler angezeigt.
- Blöcke können nicht gerendert werden, da Metadaten auf Seitenebene oder Blockebene in BYOM fehlen.
- Autoren erwarten in einem EDS-Projekt sowohl dokumentenbasiertes als auch benutzerdefiniertes Authoring, aber es wird nur eine Quelle erkannt.
- Benutzerdefinierte JSON- oder Konfigurationsdaten sind im universellen Editor nicht verfügbar, obwohl die Datei in DAM oder GitHub vorhanden ist.
- Dynamische Dialogfeld-/Dropdown-Optionen für Blöcke werden in der Benutzeroberfläche nie ausgefüllt.
Grundursache:
EDS und der universelle Editor folgen einem strengen Architekturmodell. Ein einzelnes EDS-Projekt hat nur eine primäre Inhaltsquelle, BYOM-Modelle müssen Metadaten explizit für den universellen Editor verfügbar machen, die dynamische Feldpopulation erfordert benutzerdefinierte universelle Editor-Erweiterungen und JSON- oder andere Konfigurationsdaten müssen absichtlich über das EDS-Repository, strukturierte Inhalte oder DAM-Zuordnungen verfügbar gemacht werden. Eine falsche Konfiguration eines dieser Bereiche führt zu fehlenden Metadaten, nicht zugänglichen Konfigurationsdaten oder nicht unterstützten Hybrid-Setups.
Wie kann ich bestätigen
- Legen Sie fest, welcher Authoring-Modus vom Projekt verwendet wird - universeller Editor, dokumentbasiert oder beides -, um festzustellen, ob der universelle Editor für die betreffende Seite aktiviert ist und funktioniert. Wenn es unklar ist, erfassen Sie die genaue URL, die in der Benutzeroberfläche geöffnet wird.
- Überprüfen Sie die
fstab.yaml- oder Projektanforderungen, um sicherzustellen, dass das EDS-Projekt nur eine primäre Inhaltsquelle verwendet und ob das Setup versucht, AEM- und dokumentbasierte Quellen in einem Projekt zu kombinieren. - Überprüfen Sie, ob die für das EU-Authoring erforderlichen Metadaten auf Seitenebene über BYOM verfügbar gemacht werden, einschließlich eines
page-metadataund aller vorlagenspezifischen Modelle. Bestätigen Sie, dasstemplate= Seitentyp in den Seitenmetadaten gespeichert wird, wenn eine Vorlage erforderlich ist.
Lösung resolution
-
Erzwingen Sie die Regel für eine einzige Inhaltsquelle. EDS unterstützt eine primäre Inhaltsquelle pro Projekt. Wenn im Projekt Quellen kombiniert werden - z. B. AEM und dokumentbasierte Inhaltserstellung -, erstellen Sie zwei separate EDS-Sites und verwenden Sie CDN-Routing, um Traffic zwischen ihnen zu leiten. Die native hybride Verwendung sowie dokumentbasierte Bearbeitung in einem einzigen Repository werden nicht unterstützt.
-
Offenlegung der für das EU-Authoring über BYOM erforderlichen Metadaten. Überprüfen Sie, ob ein
page-metadatavorhanden ist, und definieren Sie bei Bedarf ein vorlagenspezifisches Metadatenmodell. Bestätigen Sie, dass die Seiteneigenschaften von AEM dentemplateMetadatenwert verfügbar machen, den die Blöcke erwarten. -
Anzeigen benutzerdefinierter JSON- oder Konfigurationsdaten in Abhängigkeit davon, ob sie von der Autoreninstanz bearbeitbar oder statisch sind:
- Wenn die Daten von der Autoreninstanz bearbeitet werden können, verwenden Sie strukturierte Inhalte des EDS und definieren Sie ein Schema.
- Wenn die Daten statisch sind, speichern Sie die JSON im EDS-Repository oder in AEM DAM mit expliziten Zuordnungen.
Bestätigen Sie, dass die resultierende Endpunkt-URL erreichbar ist, damit UE und die Blöcke die Daten abrufen können.
4. Korrektes Verarbeiten der dynamischen Dropdown-Liste oder der Feldpopulation. EDS unterstützt keine Granite-Benutzeroberflächen-Datenquellen, daher können dynamische Dropdown-Optionen nicht auf diese Weise geladen werden. Verwenden Sie stattdessen die Erweiterbarkeit des universellen Editors mit benutzerdefinierten Feldern und Client-seitigen API-Aufrufen, wofür eine UE-Erweiterung implementiert werden muss.
5. Überprüfen des Vorlagen- und Blockverhaltens für Sites, für die mehrere Seitenvorlagen erforderlich sind. Markieren Sie die entsprechenden AEMSeiten als „Als Vorlage verwenden und legen Sie die Vorlagenmetadaten (CSS-Klasse) für die Formatierung fest. Erstellen Sie eine Seite aus der Vorlage und bestätigen Sie, dass sie den richtigen anfänglichen Inhalt und die richtigen Metadaten enthält.
Validierung
- Öffnen Sie die Seite im universellen Editor und bestätigen Sie, dass alle erwarteten Metadatenfelder und Blockkonfigurationsfelder sichtbar sind.
- Laden Sie die Seite in die
.pageDomain und bestätigen Sie, dass dynamische Metadaten oder JSON-Daten in den Seitenkopf gerendert werden. - Bestätigen Sie,
fetch()Aufrufe an JSON-Endpunkte den erwarteten Inhalt zurückgeben. - Bestätigen Sie, dass Blöcke nach der erneuten Veröffentlichung mit der dynamischen Konfiguration korrekt gerendert werden.