Show Menu
SUJETS×

Résolution des problèmes liés à l’appli de bureau Adobe Experience Manager

L’appli de bureau Adobe Experience Manager (AEM) se connecte à un référentiel de gestion des ressources numériques (DAM) d’un déploiement Experience Manager distant. L’appli récupère les informations du référentiel et les résultats de la recherche sur votre ordinateur, télécharge et charge les fichiers et les dossiers, et inclut des fonctionnalités de gestion des conflits avec l’interface utilisateur d’AEM Assets.
Lisez la suite de cette section pour résoudre les problèmes de l’application, découvrir les bonnes pratiques et connaître les limites.

Bonnes pratiques

Observez les bonnes pratiques suivantes pour éviter certains problèmes courants et relatifs au dépannage.
  • Comprendre le fonctionnement de l’appli de bureau  : avant de commencer à utiliser l’application, consacrez quelques minutes à en découvrir le fonctionnement. Découvrez comment fonctionne la liaison entre l’interface utilisateur web et de bureau Experience Manager, le mappage de référentiel, la mise en cache de ressources, l’enregistrement en local ainsi que le chargement en arrière-plan. Voir Fonctionnement .
  • Éviter les caractères non pris en charge dans les noms de dossier  : n’utilisez pas d’espaces ni de caractères non valides lors de la création ou du chargement de dossiers. Consultez la liste des caractères dans Création de dossiers dans Experience Manager Assets . Certains cas d’utilisation d’Adobe Experience Manager peuvent être affectés par la présence de caractères non pris en charge dans le nom du dossier.
  • Bonnes pratiques pour éviter les conflits  : pour éviter les éventuels conflits lors de la collaboration sur plusieurs ressources, voir Éviter les conflits de modification .
  • Utiliser le chargement de dossiers pour les dossiers hiérarchiques volumineux  : au lieu d’utiliser l’interface web d’Assets ou d’autres méthodes, utilisez l’appli de bureau Experience Manager pour charger les dossiers volumineux. L’appli charge les ressources en arrière-plan avec journalisation et surveillance. Voir Chargement en masse de ressources .
  • Utiliser la dernière version  : utilisez la dernière version de l’application et vérifiez toujours la compatibilité avant d’installer une nouvelle version de l’application ou de procéder à une mise à niveau vers une nouvelle version d’Adobe Experience Manager. Voir les notes de mise à jour .
  • Utiliser la même lettre de lecteur  : utilisez la même lettre de lecteur dans toute l’entreprise pour procéder à un mappage sur le DAM Adobe Experience Manager. Pour l’affichage des ressources placées par d’autres utilisateurs, les chemins d’accès doivent être identiques. L’utilisation de la même lettre de lecteur garantit un chemin constant vers les ressources DAM. Les ressources demeurent placées et ne sont pas supprimées même si des lettres de lecteur différentes sont utilisées par des utilisateurs différents.
  • Penser au réseau  : les performances réseau sont essentielles aux performances de l’appli de bureau Experience Manager. Si vous obtenez une réponse ralentie aux transferts de fichiers ou aux opérations en masse, désactivez les fonctionnalités ou les applications susceptibles d’entraîner un trafic réseau important.
  • Cas d’utilisation non pris en charge pour l’appli de bureau  : n’utilisez pas l’application pour la migration des ressources (celle-ci nécessite une planification et d’autres outils) ; pour les opérations de gestion des ressources numériques lourdes (par exemple, déplacement de dossiers volumineux, chargements volumineux, recherche de fichiers à l’aide d’une recherche de métadonnées avancée) ; et en tant que client de synchronisation (les principes de conception et les modèles d’utilisation sont différents des clients synchronisés tels que Microsoft OneDrive ou Adobe Creative Cloud Desktop Sync).
  • Délai d’expiration  : actuellement, l’appli de bureau ne dispose pas d’une valeur de délai d’expiration configurable qui déconnecte l’appli de bureau du serveur Experience Manager après un temps donné. Lors du chargement de ressources volumineuses, si la connexion expire au bout d’un certain temps, l’application tente à nouveau de charger la ressource plusieurs fois en augmentant le délai d’expiration du chargement. Il n’existe aucun moyen recommandé de modifier les paramètres de délai d’expiration par défaut.

Comment résoudre les problèmes

Pour résoudre les problèmes liés à l’appli de bureau, tenez compte des informations suivantes. Celles-ci vous prépareront également à mieux expliquer les problèmes à l’Assistance clientèle d’Adobe si vous choisissez de demander de l’aide.

Activation du mode de débogage

Pour résoudre les problèmes, vous pouvez activer le mode de débogage et obtenir plus d’informations dans les journaux. Pour exécuter l’application en mode de débogage sous Mac, utilisez les options de ligne de commande suivantes dans un terminal ou à l’invite de commandes : AEM_DESKTOP_LOG_LEVEL=DEBUG open /Applications/Adobe\ Experience\ Manager\ Desktop.app .
Pour activer le mode de débogage sous Windows, procédez comme suit :
  1. Recherchez le fichier Adobe Experience Manager Desktop.exe.config dans le dossier d’installation de votre application de bureau. Par défaut, ce dossier est C:\Program Files\Adobe\Adobe Experience Manager Desktop .
  2. Recherchez l’entrée <level value="INFO"/> qui se situe vers la fin du fichier. Remplacez la valeur INFO par DEBUG , qui est <level value="DEBUG"/> . Enregistrez et fermez le fichier
  3. Recherchez le fichier logging.json dans le dossier d’installation de votre application de bureau. Par défaut, ce dossier est C:\Program Files\Adobe\Adobe Experience Manager Desktop\javascript\ .
  4. Dans le fichier logging.json , recherchez toutes les instances de "level": "info" . Remplacez les valeurs info par debug , de la façon suivante : "level": "debug" . Enregistrez et fermez le fichier
  5. Effacez les répertoires mis en cache qui se trouvent à l’emplacement défini dans les Préférences de l’application.
  6. Redémarrez l’application de bureau.

Emplacement des fichiers journaux

Vous trouverez les fichiers journaux de l’appli de bureau AEM aux emplacements ci-dessous. Lorsque de nombreuses ressources sont chargées, si le chargement de certains fichiers échoue, reportez-vous au fichier backend.log pour identifier les chargements ayant échoué.
  • Chemin sous Windows : %LocalAppData%\Adobe\AssetsCompanion\Logs
  • Chemin sous Mac : ~/Library/Logs/Adobe\ Experience\ Manager\ Desktop
Lorsque vous travaillez avec l’Assistance clientèle d’Adobe sur une demande/un ticket d’assistance, vous serez peut-être invité à fournir les fichiers journaux pour l’aider à comprendre le problème. Archivez le dossier Logs entier et fournissez-le au représentant de l’Assistance clientèle.

Effacer le cache

L’effacement du cache de l’appli de bureau AEM est une tâche de résolution de problème préliminaire qui permet de résoudre plusieurs problèmes. Effacez le cache des préférences de l’application. Voir Définition des préférences . L’emplacement par défaut du dossier de cache est :
  • Sous Windows : %LocalAppData%\Adobe\AssetsCompanion\Cache\
  • Sous Mac : ~/Library/Group/Containers/group.com.adobe.aem.desktop/cache/
Toutefois, l’emplacement peut varier en fonction du point de terminaison AEM configuré de l’appli de bureau AEM. La valeur est une version codée de l’URL ciblée. Par exemple, si l’application cible est http://localhost:4502 , le nom du répertoire est http%3A%2F%2Flocalhost%3A4502%2F . Pour effacer le cache, supprimez le dossier approprié. Une autre raison de vider le cache est de libérer de l’espace disque lorsque l’espace disque est insuffisant.
Si vous effacez le cache de l’appli de bureau AEM, les modifications de ressource locales qui ne sont pas synchronisées avec le serveur AEM seront définitivement perdues.

Connaître la version de l’appli de bureau AEM

Cliquez sur pour ouvrir le menu de l’application et cliquez sur Help  > About .

Impossible de voir les ressources importées

Si vous ne pouvez pas voir les ressources que vous ou d’autres professionnels de la création avez placées dans les fichiers de support (fichiers INDD, par exemple), vérifiez les éléments suivants :
  • Connexion au serveur. Une connectivité réseau défaillante peut bloquer les téléchargements de ressources.
  • Taille de fichier. Le téléchargement et l’affichage des ressources volumineuses prennent plus de temps.
  • Cohérence des lettres de lecteur. Si vous ou un autre collaborateur avez placé les ressources tout en mappant le DAM AEM sur une autre lettre de lecteur, les ressources placées ne s’affichent pas.
  • Permissions. Pour vérifier que vous êtes autorisé à récupérer les ressources placées, contactez votre administrateur AEM.

Problèmes lors de la mise à niveau sous MacOS

Des problèmes peuvent parfois survenir lors de la mise à niveau de l’appli de bureau AEM sous macOS. Cela est dû au dossier système hérité de l’appli de bureau AEM, qui empêche le chargement correct des nouvelles versions de l’application. Pour y remédier, les dossiers et fichiers suivants peuvent être supprimés manuellement.
Avant d’exécuter les étapes suivantes, faites glisser l’application Adobe Experience Manager Desktop du dossier des applications MacOS vers la corbeille. Ouvrez ensuite le terminal, exécutez la commande suivante et saisissez votre mot de passe lorsque vous y êtes invité.
sudo rm -rf ~/Library/Application\ Support/com.adobe.aem.desktop
sudo rm -rf ~/Library/Preferences/com.adobe.aem.desktop.plist
sudo rm -rf ~/Library/Logs/Adobe\ Experience\ Manager\ Desktop

sudo find /var/folders -type d -name "com.adobe.aem.desktop" | xargs rm -rf
sudo find /var/folders -type d -name "com.adobe.aem.desktop.finderintegration-plugin" | xargs rm -rf

Chargement des fichiers impossible

Si vous utilisez une appli de bureau avec AEM 6.5.1 ou version ultérieure, mettez à niveau S3 ou le connecteur Azure vers la version 1.10.4 ou ultérieure. Cela aura pour effet de résoudre le problème d’échec de chargement de fichier lié à OAK-8599 . Voir Instructions d’installation .

Problème de configuration SSL

Les bibliothèques utilisées par l’appli de bureau AEM pour les communications HTTP appliquent le protocole SSL de manière stricte. Parfois, une connexion peut réussir en utilisant un navigateur, mais échouer avec l’appli de bureau AEM. Pour configurer SSL convenablement, installez le certificat intermédiaire manquant dans Apache. Voir Comment installer un certificat d’autorité de certification intermédiaire dans Apache .

L’application ne répond pas

L’application risque rarement de ne plus répondre, d’afficher uniquement un écran blanc ou d’afficher une erreur au bas de l’interface sans aucune option. Procédez comme suit dans l’ordre :
  • Cliquez avec le bouton droit sur l’interface de l’application et cliquez sur Refresh .
  • Quittez l’application et redémarrez-la.
Dans les deux méthodes, l’application démarre au dossier DAM racine.