Dépannage des erreurs de publication
La publication d’une carte est généralement simple. Ouvrez la carte, sélectionnez un paramètre prédéfini de sortie et générez la sortie. Cependant, si une carte ou ses rubriques comportent des erreurs, la génération de sortie peut échouer. Lorsque cela se produit, il est important de savoir comment résoudre les problèmes.
Préparation de l’exercice
Vous pouvez télécharger des fichiers d’exemple pour l’exercice ici.
Causes courantes des erreurs de publication
Des erreurs peuvent être introduites dans le contenu source. Par exemple :
-
Référence de chemin de fichier mal nommée
-
Dossier mal nommé
-
Graphique ou fichier manquant
-
Référence de contenu mal configurée
-
Référence croisée rompue
-
Erreurs dans les valeurs d’un attribut (par exemple, une chaîne plutôt qu’un nombre)
-
Configuration incorrecte des composants utilisés par AEM Guides
Impact des erreurs
Une erreur peut être mineure et se traduire par une simple note vous informant qu’un fichier n’a pas été correctement empaqueté ou suffisamment grave pour entraîner l’échec complet de la génération de la sortie. L’onglet Sorties affiche des icônes codées par couleur pour indiquer les performances, les erreurs ou les échecs liés à la génération de la sortie.
Ouverture et révision des logs d’erreur
Le fichier journal généré peut être ouvert pour révision.
-
Dans l’onglet Sorties , cliquez sur la date/heure sous Generated At.
-
Faites défiler le journal des erreurs.
Affichage et masquage des types d’erreur
Le journal des erreurs affiche chaque type d’erreur dans une couleur unique.
-
Sélectionnez ou désélectionnez tout type d’erreur pour afficher ou masquer la mise en surbrillance.
-
Parcourez les erreurs à l'aide des boutons next ou previous (flèches).
Résolution des erreurs
Selon le type d’erreur, la résolution peut être simple ou complexe. Il peut être terminé par un auteur dans l’éditeur XML ou demander à un administrateur de travailler avec AEM Guides. Les corrections spécifiques dépendent de l’erreur, de l’impact et des workflows de votre organisation.
-
Référence de chemin de fichier mal nommée
code language-none Les auteurs peuvent mettre à jour la référence du chemin dans le document source. -
Dossier mal nommé
code language-none Les auteurs peuvent mettre à jour le nom du dossier ou déplacer des fichiers si nécessaire. -
Graphique ou fichier manquant
code language-none Les auteurs peuvent charger un graphique/fichier manquant, renommer un graphique/fichier ou déplacer un graphique/fichier -
Référence de contenu mal configurée
code language-none Les auteurs peuvent corriger l’emplacement du contenu référencé ou modifier le chemin d’accès à la référence du contenu. -
Référence croisée rompue
code language-none Les auteurs peuvent corriger l’emplacement vers lequel pointe la référence croisée ou modifier le nom ou les propriétés du fichier de destination -
Erreurs dans les valeurs d’un attribut (par exemple, une chaîne plutôt qu’un nombre)
code language-none Les auteurs peuvent mettre à jour l'attribut vers une valeur correcte ou les administrateurs peuvent mettre à jour le système pour prendre en charge de nouvelles valeurs. -
Configuration incorrecte des composants utilisés par AEM Guides
code language-none Les administrateurs peuvent mettre à jour l'installation du système, de ses composants ou des autorisations.