AEMaaCS : l’API de publication de fragment de contenu échoue en raison d’un fragment non valide
✨ Ce contenu est généré par l’IA et peut être inexact. Termes IA génératifs
Cet article explique comment résoudre les échecs de publication d’un fragment de contenu à l’aide de l’API AEM as a Cloud Service /adobe/sites/cf/fragments/publish, où le fragment est supprimé de l’arborescence de publication en raison d’erreurs de validation.
Description description
Environnement
Adobe Experience Manager as a Cloud Service (AEMaaCS), toutes les versions.
Symptômes
Lors de la tentative de publication d’un fragment de contenu à l’aide de l’API /adobe/sites/cf/fragments/publish, le fragment ne parvient pas à être envoyé aux environnements de prévisualisation ou de publication. L’avertissement suivant s’affiche dans le journal des erreurs :
Fragment ’
Le fragment n’est pas publié, et le rendu des pages de contenu qui en dépendent peut échouer, ce qui a un impact sur le niveau de préparation à la publication. Ce problème est spécifique aux fragments qui font référence à d’autres fragments ou ressources. L’erreur ne spécifie pas le champ ou la règle dont la validation a échoué. D’autres fragments peuvent être publiés avec succès ou échouer avec des messages différents, tels que « références non valides ».
Cause
Le fragment n’a pas pu être validé par rapport à son modèle de fragment de contenu en raison d’un ou de plusieurs problèmes au niveau du champ, tels que le dépassement des limites de caractères, des valeurs d’énumération non valides, des champs obligatoires manquants ou des modèles référencés interdits. Le workflow de publication supprime les fragments non valides de l’arborescence de publication afin d’éviter tout déploiement de contenu incohérent.
Résolution resolution
Suivez les étapes ci-dessous pour résoudre le problème.
-
Exécutez une requête GET à
/adobe/sites/cf/fragments/<fragment-uuid>dans l’environnement de création. -
Consultez la section
validationStatusde la réponse pour plus d’informations sur le ou les champs dont la validation a échoué. -
Vous pouvez également ouvrir le fragment dans l’éditeur de fragment de contenu et vérifier le gabarit et toutes les variations à la recherche d’erreurs de validation.
-
Traiter les champs marqués, par exemple :
-
Champs de texte monoligne dépassant 255 caractères (limite par défaut si elle n’est pas définie dans le modèle).
-
Champs déroulants (énumération) avec des valeurs non autorisées par le modèle actuel.
-
Champs obligatoires laissés vides dans toute variation.
-
Champs contenant plus d’éléments que le modèle n’autorise.
-
Chemins d’accès à la ressource ou à l’image qui n’existent pas.
-
Fragments référencés dont les modèles ne sont pas autorisés pour le champ.
-
-
Données de champ qui ne sont plus définies dans le modèle actuel (par exemple, après un changement de modèle).
5. Enregistrez le fragment après avoir apporté des corrections.
6. Republiez le fragment à l’aide de l’API /adobe/sites/cf/fragments/publish ou de l’interface utilisateur d’AEM.
7. Vérifiez que le fragment est maintenant disponible dans l’environnement de prévisualisation/publication et que le contenu dépendant s’affiche comme prévu.