Correction des échecs de post-traitement DITA dus aux erreurs d’index B-tree dans AEM Guides

Le post-traitement des fichiers DITA et DITAMAP dans Adobe Experience Manager (AEM) Guides peut échouer en raison d’incohérences dans l’index de référence B-tree, souvent après la suppression et le rechargement du contenu dans la gestion des ressources numériques. Pour résoudre ce problème, chargez et extrayez le contenu vers un nouvel emplacement de la gestion des ressources numériques.

Description description

Environnement

Guides de Adobe Experience Manager (AEM)

Symptômes

Des échecs de post-traitement peuvent se produire dans AEM Guides lors de l’utilisation de fichiers DITA et DITAMAP qui ont été supprimés et réingérés dans la gestion des ressources numériques (DAM). Ce problème se produit généralement lorsque les propriétés attendues sont absentes du nœud jcr:content des fichiers concernés et que les tentatives répétées d’ouverture ou d’enregistrement de ces fichiers déclenchent la même erreur.

Le problème est souvent lié à la méthode utilisée pour supprimer le contenu, en particulier si la suppression a été effectuée en dehors de l’interface utilisateur AEM standard, ce qui peut laisser l’index de référence B-tree dans un état incohérent. Par conséquent, le post-traitement ne peut pas se terminer correctement et les fichiers restent dans un état d’erreur.

Résolution resolution

Pour résoudre ce problème, procédez comme suit.

  1. Supprimez le fichier ZIP concerné et tout le contenu extrait de la gestion des ressources numériques.

  2. Chargez et extrayez le fichier ZIP dans un nouveau dossier ou un autre chemin d’accès dans la gestion des ressources numériques (ne réutilisez pas le dossier d’origine).

  3. Après l’extraction, vérifiez que le post-traitement se termine correctement pour les fichiers du nouvel emplacement.

  4. (Facultatif) Utilisez les points d’entrée suivants pour vérifier et tenter de réparer l’index de référence B-tree :

    • GET /bin/fmdita/validatebtree?operation=validate (signale les références de contenu rompues)
    • GET /bin/fmdita/validatebtree?operation=patch (tente de corriger les références rompues)

    Remarque : ces opérations peuvent fournir des informations de diagnostic, mais ne résolvent pas toujours le problème.

  5. Vérifiez que les suppressions de contenu sont effectuées à l’aide de l’interface utilisateur d’AEM, et non directement via CRX/DE, afin d’éviter les incohérences d’index à l’avenir.

  6. Si le problème persiste après avoir suivi ces étapes, rassemblez les journaux d’erreurs complets couvrant le processus de chargement et d’extraction, et contactez l’assistance ​ pour obtenir de l’aide.

Pour vérifier la résolution, vérifiez que le post-traitement se termine sans erreur et que les propriétés attendues sont présentes sur le nœud jcr:content des fichiers ingérés.

recommendation-more-help
experience-cloud-kcs-help-kbarticles