DocumentationExperience Cloud KCS

AEM : échecs de prévisualisation et de modification des ressources DAM après la mise à niveau de DITA dans DEV/STAGE/PROD

Dernière mise à jour : 17 juillet 2026

Cet article traite des problèmes liés à la fonctionnalité de prévisualisation et de modification des ressources de gestion des ressources numériques dans les environnements Adobe Experience Manager.

Description description

Environnement


Adobe Experience Manager (AEM) (toutes les versions)

problème/symptômes


Dans l’interface utilisateur d’administration d’AEM Assets, l’aperçu de certaines images (par exemple : cliquer sur la ressource) peut afficher brièvement la ressource, puis l’aperçu devient vide. Le problème est généralement limité à des ressources spécifiques, tandis que d’autres ressources du même environnement peuvent continuer à afficher un aperçu normalement.

Les traces réseau du navigateur pour les ressources affectées affichent une requête de visionneuse Dynamic Media ayant échoué, similaire à :

GET /is/image/content/dam/<asset-path>?req=set,json,UTF-8&handler=s7viewerss7sdkJSONResponse

La requête renvoie :

HTTP 404
No preview server defined for root ID referenced in net path

Les journaux AEM associés peuvent contenir :

Unable to forward request for root [ content] , no preview servlet defined for [ content]

Résolution resolution

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

  1. Inspectez les métadonnées Dynamic Media de la ressource affectée Ouvrez le nœud de métadonnées de la ressource et vérifiez les propriétés suivantes sous :

    code language-none 
    /content/dam/<asset-path>/jcr:content/metadata

    Vérifiez ces champs en particulier :

    • dam:scene7FileStatus
    • dam:scene7File
    • dam:scene7ID
    • dam:scene7Domain
    • dam:scene7CloudConfigPath
    • dam:scene7APIServer
    • dam:scene7Type

    Une ressource saine doit normalement comporter les éléments suivants :

    • dam:scene7FileStatus = PublishComplete
    • dam:scene7File renseigné
    • dam:scene7ID renseigné

  2. Comparer à une ressource en cours d’utilisation Si possible, comparez la ressource en échec à une autre image dans le même environnement qui affiche correctement l’aperçu. Dans la plupart des cas, il manquera une ou plusieurs propriétés de dam:scene7* à la ressource défaillante, ou dam:scene7FileStatus sera défini sur une valeur non intègre telle que :

    • NeedsReupload
    • PublishIncomplete
    • UploadFailed
    • UploadStart
    • ReprocessStart

  3. Charger à nouveau ou retraiter la ressource affectée Le rechargement ou le retraitement de la ressource force AEM/Dynamic Media à régénérer les métadonnées de liaison Scene7 manquantes. Dans le cas validé, le rechargement a modifié la ressource à partir de :

    • dam:scene7FileStatus = NeedsReupload
    • dam:scene7File manquant
    • dam:scene7ID manquant

    à un état d’intégrité avec :

    • dam:scene7FileStatus = PublishComplete
    • dam:scene7File renseignées
    • dam:scene7ID renseignées

  4. Si la ressource a été introduite par la copie de contenu, l’installation ou la migration d’un package, retraitez les ressources affectées dans l’environnement cible Assets copiée à partir d’un autre environnement peut conserver des métadonnées Dynamic Media obsolètes ou incomplètes ou contourner l’ingestion Dynamic Media normale dans l’environnement cible. Le rechargement ou le retraitement dans l’environnement cible régénère les métadonnées de dam:scene7* locales appropriées.

  5. Valider la récupération de l’aperçu Après le rechargement ou le retraitement :

    • Vérifiez que l’aperçu de la ressource fonctionne dans Détails de la ressource.
    • Confirmez que la ressource n’émet plus de demande de prévisualisation en échec pour :
    code language-none 
    /is/image/content/dam/<asset-path>?req=set,json,UTF-8&handler=s7viewerss7sdkJSONResponse
    • Confirmez que la ressource est maintenant résolue à l’aide d’un handle Scene7 valide dans dam:scene7File.

  6. Pour un impact en masse, identifiez les ressources similaires par statut Si plusieurs ressources sont affectées, recherchez les ressources présentant des valeurs de dam:scene7FileStatus incorrectes et retraitez ce sous-ensemble, plutôt que l’arborescence complète de la gestion des ressources numériques.

Cause

Le problème est dû au fait que la ressource affectée est dans un état de synchronisation Dynamic Media incomplet ou obsolète. Dans ce cas, la ressource existe dans AEM, mais il lui manque les métadonnées de liaison Scene7 valides requises pour la résolution d’aperçu des détails de la ressource, telles que dam:scene7File, dam:scene7ID ou une dam:scene7FileStatus saine.

Par conséquent, la fonctionnalité Détails de la ressource tente de charger l’aperçu Dynamic Media à l’aide d’un chemin de référentiel sous /content/dam/... au lieu d’un handle de ressource Scene7 valide, et la requête d’aperçu échoue, ce qui vide la zone d’aperçu.

Cet état est généralement introduit lorsque :

  • La synchronisation/le chargement Dynamic Media ne s’est pas correctement terminé.
  • La ressource a été copiée ou migrée à partir d’un autre environnement.
  • Les métadonnées dam:scene7* obsolètes ont été transférées à partir d’un autre environnement.
  • La ressource n’a pas été entièrement retraitée dans l’environnement cible après la migration ou la copie de contenu.
recommendation-more-help
experience-cloud-kcs-help-kbarticles