Show Menu
SUJETS×

Résolution des problèmes liés à l’appli de bureau AEM

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 distant AEM. 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. Sachez comment fonctionne la liaison entre l’interface utilisateur web et de bureau, le mappage de référentiel, la mise en cache de ressources, l’enregistrement en local et 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 AEM Assets . Certains cas d’utilisation d’AEM 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 des conflits potentiels 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 AEM 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’AEM. 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 AEM. 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 AEM. 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).

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, utilisez les options de ligne de commande suivantes dans un terminal ou à l’invite de commandes.
  • Sous Windows : SET AEM_DESKTOP_LOG_LEVEL=DEBUG & "C:\Program Files\Adobe\Adobe Experience Manager Desktop\Adobe Experience Manager Desktop.exe"
  • Sous Mac : AEM_DESKTOP_LOG_LEVEL=DEBUG open /Applications/Adobe\ Experience\ Manager\ Desktop.app

Emplacement des fichiers journaux

Vous trouverez les fichiers journaux de l’appli de bureau AEM aux emplacements ci-dessous. Lors du téléchargement de nombreuses ressources, si le chargement de certains fichiers échoue, reportez-vous au fichier backend.log à l’emplacement ci-dessus pour identifier les chargements ayant échoué.
  • Sous Windows : %LocalAppData%\Adobe\AssetsCompanion\Logs
  • 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 aider l’équipe d’assistance à comprendre le problème. Archivez le dossier Logs entier et fournissez-le à 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 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 :
  1. Cliquez avec le bouton droit sur l’interface de l’application et cliquez sur Refresh .
  2. Quittez l’application et redémarrez-la.
Dans les deux méthodes, l’application démarre au dossier DAM racine.