Dépannage de Dynamic Media

La rubrique suivante décrit la résolution des problèmes liés à Dynamic Media.

Nouvelle configuration Dynamic Media

Voir Résolution des problèmes liés à une nouvelle configuration Dynamic Media.

Général (toutes les ressources)

Vous trouverez ci-après quelques astuces et conseils généraux concernant toutes les ressources.

Propriétés de l’état de synchronisation des ressources

Vous pouvez passer en revue les propriétés de ressource suivantes dans CRXDE Lite pour vérifier que la synchronisation de la ressource depuis Adobe Experience Manager vers Dynamic Media s’est déroulée correctement :

Propriété Exemple Description
<object_node>/jcr:content/metadata/dam:scene7ID **`a 364266`**
<object_node>/jcr:content/metadata/dam:scene7FileStatus PublishComplete ou texte d’erreur Statut du téléchargement de la ressource vers Dynamic Media.
<object_node>/jcr:content/metadata/dam:scene7File myCompany/myAssetID Doit être renseigné pour générer des URL vers la ressource distante de Dynamic Media.
<object_node>/jcr:content/dam:lastSyncStatus succès ou échec :<error text> Statut de synchronisation des visionneuses (visionneuses à 360°, visionneuses d’images, etc.), des paramètres prédéfinis d’image, des paramètres prédéfinis de visionneuse, des mises à jour de zone cliquable pour une ressource ou des images ayant été modifiées.

Journalisation de la synchronisation

Les erreurs et problèmes de synchronisation sont consignés dans le fichier error.log (répertoire de serveur Experience Manager /crx-quickstart/logs/). La journalisation est suffisante pour déterminer la cause de la plupart des problèmes. Vous pouvez toutefois augmenter le niveau de journalisation sur DEBUG sur le package com.adobe.cq.dam.ips via la console Sling (https://localhost:4502/system/console/slinglog) pour collecter davantage d’informations.

Gestion de version

Lors du remplacement d’une ressource Dynamic Media (nom et emplacement identiques), vous pouvez conserver les deux ressources ou remplacer et créer une version :

  • Si vous conservez les deux, une nouvelle ressource est créée avec un nom unique pour l’URL de ressource publiée. Par exemple, image.jpg est la ressource d’origine et image1.jpg est la ressource qui vient d’être chargée.

  • La création d’une version n’est pas prise en charge dans Dynamic Media. La nouvelle version remplace la ressource existante lors de la diffusion.

Images et visionneuses

Si des problèmes surviennent avec les images et les visionneuses, reportez-vous aux conseils de dépannage ci-dessous.

Problème Débogage Solution
Impossible d’accéder au bouton Copier l’URL/Incorporer en mode Détails de la ressource

  1. Accédez à CRX/DE :

    • Vérifiez si le paramètre prédéfini dans le JCR /etc/dam/presets/viewer/<preset> has lastReplicationAction est défini. Cet emplacement s’applique si vous avez effectué la mise à niveau d’Experience Manager 6.x vers la version 6.4 et si vous avez choisi de ne pas utiliser la migration. Dans le cas contraire, l’emplacement est /conf/global/settings/dam/dm/presets/viewer.
    • Vérifiez que la ressource dans le JCR présente dam:scene7FileStatus sous Métadonnées défini sur PublishComplete.

Actualisez la page ou accédez à une autre page et revenez sur la page (le code JSP de rail latéral doit être recompilé)

Si cela ne fonctionne pas :

  • Publiez la ressource.
  • Rechargez la ressource et publiez-la.
La zone réactive du carrousel se déplace après le basculement entre les diapositives

Vérifiez que toutes les diapositives ont la même taille.

Utilisez uniquement des images de la même taille pour le carrousel.
L’image n’est pas prévisualisée avec la visionneuse Dynamic Media

Vérifiez que la ressource contient dam:scene7File dans les propriétés de métadonnées (CRXDE Lite).

Vérifiez que le traitement de toutes les ressources est terminé.
La ressource téléchargée ne s’affiche pas dans le sélecteur de ressources

Vérifiez que la ressource présente la propriété jcr:content > dam:assetState = processed (CRXDE Lite)

Vérifiez que le traitement de toutes les ressources est terminé.
La bannière en mode Carte s’affiche Nouveau lorsque le traitement de la ressource n’a pas commencé Vérifiez que la ressource jcr:content > dam:assetState = if unprocessed n’a pas été sélectionnée par le workflow. Attendez que la ressource soit récupérée par le workflow.
Les images ou les visionneuses n’affichent pas l’URL de la visionneuse ou le code intégré Vérifiez si le paramètre prédéfini de visionneuse a été publié.

Accédez à Outils > Ressources > Paramètres prédéfinis de la visionneuse et publiez le paramètre prédéfini de la visionneuse.

Vidéo

Si vous êtes confronté à des problèmes au niveau de la vidéo, reportez-vous aux conseils de dépannage ci-dessous.

Problème Débogage Solution
La vidéo ne peut pas être prévisualisée
  • Vérifiez que le dossier est associé à un profil vidéo (dans le cas d’un format de fichier non pris en charge). Si elle n’est pas prise en charge, seule une image s’affiche.
  • Le profil vidéo doit contenir plusieurs paramètres prédéfinis de codage pour générer un ensemble AVS (les codages uniques sont traités comme du contenu vidéo pour les fichiers MP4 ; pour les fichiers non pris en charge, traité de la même manière que les fichiers non traités).
  • Vérifiez que le traitement de la vidéo est terminé en confirmant dam:scene7FileAvs de dam:scene7File dans les métadonnées.
  1. Affectez un profil vidéo au dossier.
  2. Modifiez le profil vidéo pour inclure plusieurs paramètres prédéfinis de codage.
  3. Attendez que le traitement de la vidéo soit terminé.
  4. Avant de recharger la vidéo, assurez-vous que le workflow Vidéo de codage de média dynamique n’est pas en cours d’exécution.
  5. Rechargez la vidéo.
La vidéo n’est pas codée.
  • Vérifiez que le Cloud Service Dynamic Media est configuré.
  • Vérifiez qu’un profil vidéo est associé au dossier de transfert.
  1. Vérifiez que la configuration Dynamic Media sous Cloud Service est correctement effectuée.
  2. Vérifiez que le dossier contient un profil vidéo. Vérifiez également le profil vidéo.
Le traitement vidéo prend trop de temps.

Pour déterminer si le codage vidéo est toujours en cours ou s’il est à l’état d’échec :

  • Vérifiez l’état de la vidéo https://localhost:4502/crx/de/index.jsp#/content/dam/folder/videomp4/jcr%3Acontent > dam:assetState
Rendu vidéo manquant

Lorsque la vidéo est téléchargée, mais qu’il n’y a aucun rendu codé :

  • Vérifiez qu’un profil vidéo est affecté au dossier.
  • Vérifiez que le traitement de la vidéo est terminé en confirmant dam:scene7FileAvs dans les métadonnées.
  1. Affectez un profil vidéo au dossier.
  2. Attendez que le traitement de la vidéo soit terminé.

Visionneuses

Si vous rencontrez des problèmes avec les visionneuses, reportez-vous aux conseils de dépannage ci-dessous.

Problème : les paramètres prédéfinis de la visionneuse ne sont pas publiés.

Débogage

  1. Accédez à la page de diagnostic du gestionnaire d’échantillons : https://localhost:4502/libs/dam/gui/content/s7dam/samplemanager/samplemanager.html

  2. Observez les valeurs calculées. Lorsque le fonctionnement est correct, les éléments suivants s’affichent : _DMSAMPLE status: 0 unsyced assets - activation not necessary _OOTB status: 0 unsyced assets - 0 unactivated assets.

    REMARQUE

    Environ 10 minutes peuvent être nécessaires après la configuration des paramètres cloud de Dynamic Media pour que les ressources de visionneuse se synchronisent.

  3. S’il reste des ressources non activées, sélectionnez l’un des boutons Répertorier toutes les ressources non activées pour afficher des informations détaillées.

Solution

  1. Accédez à la liste des paramètres prédéfinis de la visionneuse dans les outils d’administration : https://localhost:4502/libs/dam/gui/content/s7dam/samplemanager/samplemanager.html
  2. Sélectionnez tous les paramètres prédéfinis de visionneuse, puis sélectionnez Publier.
  3. Revenez au gestionnaire d’échantillons et notez que le nombre de ressources non activées est maintenant égal à zéro.

Problème : le paramètre prédéfini de visionneuse retourne 404 à partir de l’aperçu des détails de ressource ou de la copie d’URL/de code intégré.

Débogage

Dans CRXDE Lite, procédez comme suit :

  1. Accédez au dossier <sync-folder>/_CSS/_OOTB dans votre dossier de synchronisation Dynamic Media (par exemple, /content/dam/_CSS/_OOTB).

  2. Recherchez le nœud de métadonnées de la ressource qui pose problème (par exemple, <sync-folder>/_CSS/_OOTB/CarouselDotsLeftButton_dark_sprite.png/jcr:content/metadata/).

  3. Vérifiez que les propriétés dam:scene7* sont présentes. Si la ressource a été correctement synchronisée et publiée, dam:scene7FileStatus est défini sur PublishComplete.

  4. Essayez de demander l’illustration directement à partir de Dynamic Media en concaténant les valeurs des propriétés suivantes et des littéraux de chaîne :

    • dam:scene7Domain
    • "is/content"
    • dam:scene7Folder
    • <asset-name>
      Exemple :
      https://<server>/is/content/myfolder/_CSS/_OOTB/CarouselDotsLeftButton_dark_sprite.png

Solution

Si les exemples de ressources ou l’illustration du paramètre prédéfini de la visionneuse n’ont pas été synchronisés ou publiés, redémarrez le processus de copie ou de synchronisation entier :

  1. Accédez à CRXDE Lite.
  2. Supprimez <sync-folder>/_CSS/_OOTB.
  3. Accédez au gestionnaire de packages CRX : https://localhost:4502/crx/packmgr/.
  4. Recherchez le package de visionneuse dans la liste ; il commence par cq-dam-scene7-viewers-content.
  5. Sélectionnez Réinstaller.
  6. Sous Services cloud, accédez à la page Configuration de Dynamic Media, puis ouvrez la boîte de dialogue de configuration correspondant à la configuration S7 de Dynamic Media.
  7. N’effectuez aucune modification, sélectionnez Enregistrer.
    Cette sauvegarde a pour effet de déclencher à nouveau la logique pour créer et synchroniser les exemples de ressources, la feuille CSS du paramètre prédéfini de la visionneuse et l’illustration.

Problème : l’aperçu de l’image ne se charge pas dans la création des paramètres prédéfinis de la visionneuse.

Solution

  1. Dans Experience Manager, sélectionnez le logo d’Experience Manager pour accéder à la console de navigation globale, puis accédez à Outils > Général > CRXDE Lite.

  2. Dans le rail de gauche, accédez au dossier de contenu d’exemple à l’emplacement suivant :

    /content/dam/_DMSAMPLE

  3. Supprimez le dossier _DMSAMPLE.

  4. Dans le rail de gauche, accédez au dossier des paramètres prédéfinis à l’emplacement suivant :

    /conf/global/settings/dam/dm/presets/viewer

  5. Supprimez le dossier viewer.

  6. Dans le coin supérieur gauche de la page CRXDE Lite, sélectionnez Tout enregistrer.

  7. Dans le coin supérieur gauche de la page CRXDE Lite, sélectionnez l’icône Retour à l’accueil.

  8. Recréez une configuration Dynamic Media dans les services cloud.

Sur cette page