Documentation

Assets a ignoré le post-traitement DXML en raison de la mise en cache dans AEM Guides.

Last update: Thu Oct 23 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Le post-traitement DXML dans AEM Guides joue un rôle essentiel pour s’assurer que les métadonnées des ressources, telles que les titres, les états des documents et les références de liaison, sont correctement synchronisées et rendues dans l’interface utilisateur. Cela permet un affichage précis et une navigation fiable dans le contenu créé. Si des ressources d’AEM Guides ne sont pas traitées correctement (par exemple, des métadonnées manquantes, des liens de rubrique rompus ou des paramètres prédéfinis de sortie incomplets), le problème peut provenir de chemins mis en cache dans le post-processeur DXML. Cet article explique comment identifier les chemins ignorés dans le référentiel et les supprimer pour restaurer le traitement des ressources et la synchronisation des métadonnées appropriés.

Description description

Environnement

  • Produit : Adobe Experience Manager (AEM) Managed Services
  • Version : AEM 6.5, Guides 4.0+

Problèmes/Symptômes

  • Le champ Titre dans les fichiers DITA ne conserve pas les mises à jour et revient à son état précédent après actualisation.
  • Le champ État du document est absent de la console Propriétés mais est visible dans le panneau Propriétés du fichier.
  • Les fichiers apparaissent sous la forme Fichier au lieu du type Rubrique attendu dans les guides.
  • Les rubriques ajoutées aux cartes sont affichées en rouge, indiquant les liens rompus ou indisponibles, au lieu du bleu.
  • Les paramètres prédéfinis de sortie peuvent être manquants pour les mappages nouvellement créés si les ressources résident dans des chemins d’accès répertoriés sous le nœud /var/dxml/postprocess/ignoredPaths dans CRX/DE. Ces chemins sont traités comme exclus du post-traitement DXML et le problème peut se produire à n’importe quel emplacement défini dans ce nœud.
  • Les références Utilisé dans et Liens sortants sous Propriétés du fichier ne sont pas correctement mises à jour.

Résolution resolution

La cause première de ce problème est que les workflows de post-traitement ignorent les chemins spécifiques en raison des chemins d’accès aux ressources mis en cache. AEM Guides fournit une configuration OSGi qui permet aux administrateurs de spécifier les dossiers à exclure du post-traitement. Voir Désactiver le post-traitement pour un dossier dans la documentation AEM Guides. Outre cette configuration, le référentiel contient un nœud à l’/var/dxml/postprocess/ignoredPaths qui agit comme un cache de chemins d’accès à ignorer. Si une ressource réside dans l’un de ces chemins, elle est ignorée lors du post-traitement DXML, et des messages du journal au niveau INFO tels que les suivants peuvent apparaître :

[POSTPROCESSING ] chemin ignoré en raison de la configuration du cache
[ DU POST-TRAITEMENT ] le post-traitement de la payload est ignoré : /content/dam/< path-to-asset>

Étapes à résoudre

  1. Vérifiez que les chemins concernés sont répertoriés sous /var/dxml/postprocess/ignoredPaths dans CRX/DE. Accédez à ce nœud et recherchez les propriétés correspondant aux chemins ignorés. Pour connaître les étapes, reportez-vous à la section Prise en main de CRXDE Lite dans le Guide de l’utilisateur d’AEM as a Cloud Service.

  2. Supprimez les entrées inutiles du nœud ignoredPaths : conserver uniquement les /content/dam/projects/translation_output, qui est une valeur par défaut. Pour connaître les étapes, reportez-vous à la section Comment supprimer des propriétés et des nœuds avec cURL dans le guide d’utilisation d’AEM 6.5. Si vous POST une propriété avec une valeur vide à un nœud, AEM supprime cette propriété. Pour supprimer une propriété d’un nœud donné, utilisez le format suivant :

    code language-none 
    curl -u 'userId:password' \
-F "propertyName=" \
http://localhost:4502/path/to/node

    propertyName doit être remplacé par le nom de la propriété que vous souhaitez supprimer.

    path/to/node doit correspondre au chemin d’accès au référentiel où se trouve la propriété . Si vous laissez la valeur après le signe égal (=) vide, AEM supprime la propriété spécifiée.

    Remarque : vous devez répéter la commande pour chaque propriété que vous souhaitez supprimer du nœud.

  3. Supprimez toutes les autres entrées liées aux chemins concernés. Vous pouvez également supprimer uniquement les chemins d’accès qui provoquent l’ignorance de vos ressources affectées. Pour connaître les étapes, reportez-vous à la section Contenu Sling dans le Guide de l’utilisateur d’AEM 6.5.

  4. Réexécutez le workflow Ressource de mise à jour de la gestion des ressources numériques sur toutes les ressources sous les chemins d’accès concernés. Cela permet de générer des métadonnées et de traiter correctement les ressources. Pour connaître les étapes, reportez-vous à la section Exécution du workflow Ressource de mise à jour de gestion des ressources numériques dans le tutoriel AEM Assets.

  5. Vérifiez que :

    1. Les titres persistent après les mises à jour.

    2. Le champ État du document s’affiche correctement dans les interfaces.

    3. Les icônes de fichier s’affichent sous la forme Rubrique .

    4. Les rubriques apparaissent en bleu lorsqu'elles sont ajoutées aux cartes.

    5. Tous les paramètres prédéfinis de sortie sont disponibles pour les nouveaux mappages.

    6. Les références (utilisées dans , liens sortants) se mettent à jour avec précision.

      Reportez-vous à la section Rapports dans AEM Guides de la documentation AEM Guides pour développer une liste de contrôle de validation, vérifiant les états de contenu, les références et les propriétés liées à la sortie sur les ressources et les mappages.

Après avoir effacé les chemins ignorés et réexécuté les workflows de ressources, les ressources et métadonnées manquantes précédemment réapparaîtront et s’afficheront correctement dans AEM Guides. Les titres, les états du document, les liens et les paramètres prédéfinis de sortie seront mis à jour comme prévu, confirmant que le traitement a repris normalement.

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f