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.

Exercise-Download

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.

error-impact

Ouverture et révision des logs d’erreur

Le fichier journal généré peut être ouvert pour révision.

  1. Dans l’onglet Sorties , cliquez sur la date/heure sous Generated At.

    error-log

  2. 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.

navigate-errors

  1. Sélectionnez ou désélectionnez tout type d’erreur pour afficher ou masquer la mise en surbrillance.

  2. 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.
    
recommendation-more-help
5d77304e-09c3-49ad-9381-b66e7cbd5f86