Résolution des problèmes d’accès et de configuration de l’éditeur universel lorsqu’AEM est la source de contenu EDS
Lorsque Edge Delivery Services (EDS) utilise AEM comme source de contenu, les auteurs ne voient pas les champs de métadonnées attendus, les valeurs de configuration de bloc, les variations de modèle ou les données JSON dans l’éditeur universel. La cause est presque toujours une incohérence de l’architecture ou de la configuration : un projet EDS ne prend en charge qu’une seule source de contenu principale, les modèles BYOM (Bring Your Own Model) doivent exposer explicitement les métadonnées à l’éditeur universel, la population des champs dynamiques nécessite une extension d’éditeur universel personnalisée et les données JSON ou de configuration doivent être exposées intentionnellement via le référentiel EDS, le contenu structuré ou les mappages DAM. La confirmation du mode de création, l’application de la règle de source unique et l’exposition des métadonnées et des données requises restaurent les champs d’éditeur manquants.
Description description
Problème : l’éditeur universel n’affiche pas les métadonnées, les champs de bloc ou les données JSON lorsqu’AEM est la source de contenu EDS
Description
Lorsque vous utilisez Edge Delivery Services (EDS) et l’éditeur universel (UE), les auteurs ne voient pas les champs de métadonnées attendus, les valeurs de configuration de bloc, les variations de modèle ni les données JSON dans l’éditeur. Les pages ne se chargent pas correctement dans l’interface utilisateur, ou les auteurs ne peuvent pas configurer les options de blocs, de champs dynamiques ou de métadonnées au niveau de la page. Dans d’autres cas, les clients tentent des modèles architecturaux non pris en charge, par exemple le mélange d’un éditeur universel et de la création basée sur des documents dans un seul projet EDS, ou la configuration de plusieurs sources de contenu dans le même fstab.yaml. Ces erreurs de configuration entraînent un rendu incohérent, des métadonnées manquantes, l’impossibilité d’utiliser certaines interfaces de création ou des blocs qui ne parviennent pas à utiliser les entrées requises d’AEM.
Environnement :
- Adobe Experience Manager as a Cloud Service (AEMaaCS)
- AEM Managed Services
- AEM as a Cloud Service — Sites
- Edge Delivery Services (EDS)
- Éditeur universel
Problème/Symptômes :
- L’éditeur universel se charge, mais les champs de métadonnées ou les champs de configuration de bloc n’apparaissent pas, sans erreur.
- Le rendu des blocs échoue en raison de l’absence de métadonnées au niveau de la page ou du bloc dans BYOM.
- Les auteurs s’attendent à la création basée sur des documents et sur l’expérience utilisateur dans un seul projet EDS, mais une seule source est reconnue.
- Les données JSON ou de configuration personnalisées ne sont pas disponibles dans l’éditeur universel, même si le fichier existe dans la gestion des ressources numériques (DAM) ou GitHub.
- Les options de boîte de dialogue/liste déroulante dynamique pour les blocs ne sont jamais renseignées dans l’UE.
Cause principale :
EDS et l’éditeur universel suivent un modèle architectural strict. Un seul projet EDS n’a qu’une seule source de contenu principale. Les modèles BYOM doivent exposer explicitement les métadonnées dans l’éditeur universel, le remplissage dynamique des champs nécessite des extensions d’éditeur universel personnalisées et les données JSON ou d’autres données de configuration doivent être intentionnellement exposées par le biais du référentiel EDS, du contenu structuré ou des mappages DAM. La configuration incorrecte de l’une de ces zones entraîne l’absence de métadonnées, un accès aux données de configuration ou des configurations hybrides non prises en charge.
Comment confirmer
- Vérifiez le mode de création utilisé par le projet (éditeur universel, basé sur des documents ou les deux) pour déterminer si l’éditeur universel est activé et s’il doit fonctionner pour la page en question. Si ce n’est pas clair, capturez l’URL exacte ouverte en UE.
- Passez en revue les exigences du
fstab.yamlou du projet pour confirmer que le projet EDS n’utilise qu’une seule source de contenu principale et si la configuration tente de combiner AEM et des sources basées sur des documents dans un seul projet. - Vérifiez si les métadonnées au niveau de la page nécessaires à la création UE sont exposées via BYOM, y compris un modèle de
page-metadatade base et des modèles spécifiques au modèle. Vérifiez quetemplate= page-type est stocké dans les métadonnées de la page si un modèle est requis.
Résolution resolution
-
Appliquez la règle de source de contenu unique. EDS prend en charge une source de contenu principale par projet. Si le projet associe des sources (telles qu’AEM et la création basée sur des documents), créez deux sites EDS distincts et utilisez le routage CDN pour diriger le trafic entre eux. L’UE hybride natif ainsi que la création basée sur des documents dans un seul référentiel ne sont pas pris en charge.
-
Exposez les métadonnées requises pour la création de contenu utilisateur via BYOM. Vérifiez qu’un modèle de
page-metadatade base existe et définissez un modèle de métadonnées spécifique au modèle, le cas échéant. Confirmez les propriétés de page AEM et exposez la valeur de métadonnéestemplateattendue par les blocs. -
Exposez les données JSON ou de configuration personnalisées selon qu’elles sont modifiables par l’auteur ou statiques :
- Si les données peuvent être modifiées par l’auteur, utilisez du contenu structuré EDS et définissez un schéma.
- Si les données sont statiques, stockez le fichier JSON dans le référentiel EDS ou dans la gestion des ressources numériques AEM avec des mappages explicites.
Vérifiez que l’URL du point d’entrée obtenu est accessible afin que l’UE et les blocs puissent récupérer les données.
4. Gérer correctement la liste déroulante dynamique ou la population de champs. EDS ne prend pas en charge les sources de données de l’interface utilisateur Granite. Par conséquent, les options de liste déroulante dynamique ne peuvent pas être chargées de cette manière. Utilisez plutôt l’extensibilité de l’éditeur universel avec des champs personnalisés et des appels d’API côté client, ce qui nécessite l’implémentation d’une extension UE.
5. Vérifiez le comportement des modèles et des blocs pour les sites qui ont besoin de plusieurs modèles de page. Marquez les pages AEM appropriées comme Utiliser comme modèle et définissez les métadonnées du modèle (classe CSS) pour la mise en forme. Créez une page à partir du modèle et vérifiez qu’elle contient le contenu initial et les métadonnées corrects.
Validation
- Ouvrez la page dans l’éditeur universel et vérifiez que tous les champs de métadonnées et de configuration de bloc attendus sont visibles.
- Chargez la page sur le domaine
.pageet confirmez le rendu des métadonnées dynamiques ou des données JSON dans l’en-tête de la page. - Confirmez
fetch()les appels aux points d’entrée JSON renvoient le contenu attendu. - Confirmez que les blocs utilisent correctement le rendu de la configuration dynamique après la republication.