DocumentationAEMGuide de l’application de bureau

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

Last update: Thu Jul 31 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Utilisateur ou utilisatrice
  • Administration

Adobe Experience Manager’application de bureau se connecte au référentiel de gestion des ressources numériques (DAM) d’un déploiement Experience Manager. L’application récupère les informations du référentiel et les résultats de recherche sur votre ordinateur, télécharge et charge des fichiers et des dossiers et dispose de fonctionnalités de gestion des conflits avec l’interface utilisateur d’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 best-practices-to-prevent-troubles

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. Connaître les liens entre l'interface web Experience Manager et le bureau, le mappage de référentiel, la mise en cache de ressources, l'enregistrement 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 Adobe Experience Manager Assets. Les caractères non pris en charge dans le nom du dossier peuvent avoir un impact sur certains cas d’utilisation Experience Manager.

  • Bonnes pratiques pour éviter les conflits : pour éviter les conflits potentiels lors de la collaboration sur plusieurs ressources, accédez à éviter les conflits de modification.

  • Utiliser le chargement de dossiers pour les dossiers volumineux et hiérarchiques : au lieu d’utiliser l’interface web d’Assets ou d’autres méthodes, utilisez l’application de bureau Experience Manager pour charger des dossiers volumineux. L’application 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. Vérifiez toujours la compatibilité avant d'installer une nouvelle version d'application ou d'effectuer la mise à niveau vers une version plus récente d'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 d’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 faites face à un ralentissement de la réponse aux transferts de fichiers ou aux opérations en bloc, désactivez les fonctionnalités ou les applications qui peuvent entraîner un trafic réseau important.

  • Cas d’utilisation non pris en charge pour l’application de bureau : évitez d’utiliser l’application pour la migration des ressources, car elle nécessite une planification et des outils supplémentaires. Il ne convient pas non plus aux opérations de gestion des ressources numériques complexes, telles que le déplacement de dossiers volumineux, les chargements volumineux ou les recherches avancées de métadonnées. En outre, ne l’utilisez pas comme client de synchronisation, car ses principes de conception et ses modèles d’utilisation diffèrent des clients de synchronisation tels que Microsoft OneDrive ou la synchronisation de bureau Adobe Creative Cloud.

  • Délai d’expiration : l’application de bureau ne dispose actuellement pas d’une valeur de délai d’expiration configurable qui déconnecte la connexion entre Experience Manager serveur et l’application de bureau après un intervalle de temps fixe. 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 troubleshooting-prep

Pour résoudre les problèmes liés à l’appli de bureau, tenez compte des informations suivantes. En outre, il vous prépare à transmettre ces problèmes au service clientèle d’Adobe si vous choisissez de demander de l’aide.

Emplacement des fichiers journaux check-log-files-v2

L’application de bureau Experience Manager stocke ses fichiers journaux aux emplacements suivants en fonction du système d’exploitation :

Sous Windows : %LocalAppData%\Adobe\AssetsCompanion\Logs

Sous Mac : ~/Library/Logs/Adobe\ Experience\ Manager\ Desktop

Lorsque de nombreuses ressources sont chargées, si le chargement de certains fichiers échoue, reportez-vous au fichier backend.log pour identifier ceux qui ont échoué.

NOTE
Lorsque vous travaillez avec le Service clientèle d’Adobe sur une requête ou un ticket d’assistance, vous serez peut-être invité à fournir les fichiers journaux pour l’aider à comprendre le problème. Archivez l’ensemble du dossier Logs et transmettez-le à votre contact du Service clientèle.

Modifier le niveau de détails dans les fichiers journaux level-of-details-in-log

Pour modifier le niveau de détails dans les fichiers journaux :

  1. Vérifiez que l’application n’est pas en cours d’exécution.

  2. Sous le système Windows :

    1. Ouvrez une fenêtre de commande.

    2. Lancez l’application de bureau Adobe Experience Manager en exécutant la commande :

    code language-shell 
    set AEM_DESKTOP_LOG_LEVEL=DEBUG&"C:\Program Files\Adobe\Adobe Experience Manager Desktop.exe

    Sous le système Mac :

    1. Ouvrez une fenêtre de terminal.

    2. Lancez l’application de bureau Adobe Experience Manager en exécutant la commande :

    code language-shell 
    AEM_DESKTOP_LOG_LEVEL=DEBUG open /Applications/Adobe\ Experience\ Manager\ Desktop.app

Les niveaux de journal valides sont DEBUG, INFO, WARN ou ERROR. La prolixité des journaux est maximale pour le niveau DEBUG et minimale pour le niveau ERROR.

Activation du mode de débogage enable-debug-mode

Pour résoudre les problèmes, vous pouvez activer le mode de débogage et obtenir plus d’informations dans les journaux.

NOTE
Les niveaux de journal valides sont DEBUG, INFO, WARN ou ERROR. La prolixité des journaux est maximale pour le niveau DEBUG et minimale pour le niveau ERROR.

Pour utiliser l’appli en mode de débogage sous Mac :

  1. Ouvrez une fenêtre de terminal ou une invite de commande.

  2. Lancez l’appli de bureau Experience Manager en exécutant la commande suivante :

    AEM_DESKTOP_LOG_LEVEL=DEBUG open /Applications/Adobe\ Experience\ Manager\ Desktop.app.

Pour activer le mode de débogage sous Windows :

  1. Ouvrez une fenêtre de commande.

  2. Lancez l’appli de bureau Experience Manager en exécutant la commande suivante :

AEM_DESKTOP_LOG_LEVEL=DEBUG&"C:\Program Files\Adobe\Adobe Experience Manager Desktop.exe.

Connaître la version de l’appli de bureau Adobe Experience Manager know-app-version-v2

Pour afficher le numéro de version :

  1. Démarrez l’application.

  2. Cliquez sur les ellipses dans l’angle supérieur droit, placez le pointeur sur Help, puis cliquez sur About.

    Le numéro de version est affiché sur cet écran.

Effacer le cache clear-cache-v2

Exécutez les étapes suivantes :

  1. Démarrez l’application et connectez-vous à une instance de Experience Manager.

  2. Ouvrez les préférences de l’application en cliquant sur les ellipses situées dans le coin supérieur droit et en sélectionnant Preferences.

  3. Localisez l’entrée affichant la Current Cache Size. Cliquez sur l’icône représentant une corbeille en regard de cet élément.

Pour effacer le cache manuellement, procédez comme suit :

CAUTION
Ces étapes constituent une opération potentiellement destructive. Si des modifications apportées à des fichiers locaux ne sont pas téléchargées sur Adobe Experience Manager, elles sont perdues.

Le cache est effacé lors de la suppression du répertoire de cache de l’application, qui peut être trouvé dans les préférences de celle-ci.

  1. Démarrez l’application.

  2. Ouvrez les préférences de l’application en sélectionnant les ellipses situées dans le coin supérieur droit, puis l’option Preferences.

  3. Notez la valeur Cache Directory.

    Ce répertoire contient des sous-répertoires nommés en fonction des points d’entrée Adobe Experience Manager codés. Les noms sont une version codée de l’URL de Adobe Experience Manager ciblée. Par exemple, si l’application cible des localhost:4502, le nom du répertoire est localhost_4502.

Pour effacer le cache, supprimez le répertoire Point d’entrée Adobe Experience Manager codé. Vous pouvez également supprimer l’intégralité du répertoire spécifié dans les préférences pour vider le cache de toutes les instances qui ont été utilisées par l’application.

L’effacement du cache de l’appli de bureau Adobe Experience Manager est une tâche préliminaire de résolution de problème 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 :

Impossible de voir les ressources importées placed-assets-missing

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 d’Experience Manager sur une autre lettre de lecteur, les ressources placées ne s’affichent pas.

  • Autorisations. Pour vérifier que vous êtes autorisé à récupérer les ressources placées, contactez votre administrateur Experience Manager.

Les modifications apportées aux fichiers de l’interface utilisateur de l’appli de bureau ne sont pas répercutées immédiatement dans Adobe Experience Manager changes-on-da-not-visible-on-aem

L’appli de bureau Adobe Experience Manager laisse à l’utilisateur le soin de décider le moment où toutes les modifications apportées à un fichier sont terminées. En fonction de la taille et de la complexité d’un fichier, le transfert de la nouvelle version d’un fichier vers Adobe Experience Manager prend un temps considérable. L’application est conçue pour réduire au minimum le nombre de transferts de fichiers, plutôt que de charger automatiquement des fichiers en fonction de l’achèvement supposé des modifications. Il est conseillé à l’utilisateur de déclencher le transfert de retour du fichier vers Adobe Experience Manager en choisissant de télécharger les modifications d’un fichier.

Problèmes lors de la mise à niveau sous MacOS issues-when-upgrading-on-macos

Parfois, des problèmes peuvent survenir lors de la mise à niveau de l’application de bureau Experience Manager sur macOS. Les dossiers système hérités de l’application de bureau Experience Manager sont à l’origine de ces problèmes. Les dossiers empêchent le chargement correct des nouvelles versions de l’application de bureau Experience Manager. 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 Applications macOS vers la corbeille. Ouvrez ensuite le terminal, exécutez la commande suivante et indiquez 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 upload-fails

Si vous utilisez l’application de bureau avec Experience Manager 6.5.1 ou une version ultérieure, mettez à niveau S3 ou le connecteur Azure vers la version 1.10.4 ou une version ultérieure. Il résout le problème d’échec du chargement de fichier lié à OAK-8599. Voir Instructions d’installation.

Problèmes de connexion à l’appli de bureau Experience Manager connection-issues

Si vous rencontrez des problèmes de connectivité généraux, voici quelques moyens d’obtenir plus d’informations sur les opérations de l’application de bureau Experience Manager.

Vérification du journal des requêtes

L’application de bureau Experience Manager consigne toutes les requêtes qu’elle envoie, ainsi que le code de réponse de chaque requête, dans un fichier journal dédié.

  1. Ouvrez le répertoire des journaux de l’application request.log pour afficher ces requêtes.

  2. Chaque ligne du journal représente une requête ou une réponse. Les requêtes comportent un caractère > suivi de l’URL qui a été demandée. Les réponses comportent un caractère < suivi du code de réponse et de l’URL demandée. Les demandes et les réponses peuvent être corrélées à l’aide de l’identifiant unique (GUID) de chaque ligne.

Vérifier les requêtes chargées par le navigateur intégré de l’application

La majorité des requêtes de l’application se trouvent dans le journal des requêtes. Toutefois, s’il n’existe aucune information pertinente à ce sujet, il peut être utile de consulter les requêtes envoyées par le navigateur intégré de l’application.
Consultez la section SAML pour savoir comment afficher ces requêtes.

L’authentification de la connexion SAML ne fonctionne pas da-connection-issue-with-saml-aem

L’appli de bureau Experience Manager peut ne pas se connecter à votre déploiement Adobe Experience Manager compatible SSO (SAML). La conception de l’application s’efforce de tenir compte des variations et des complexités des connexions et des processus d’authentification unique. Cependant, sa configuration peut nécessiter certaines mesures de dépannage supplémentaires.

Parfois, le processus SAML ne redirige pas vers le chemin demandé à l’origine. Ou, la redirection finale est vers un hôte différent de celui configuré dans l’application de bureau Adobe Experience Manager. Pour vérifier que ce problème n’est pas le cas, procédez comme suit :

  1. Ouvrez un navigateur web. Accédez à l’URL https://[aem_server]:[port]/content/dam.json.

  2. Connectez-vous au déploiement Adobe Experience Manager.

  3. Une fois la connexion terminée, examinez l’adresse actuelle du navigateur dans la barre d’adresse. Elle doit correspondre exactement à l’URL que vous avez saisie initialement.

  4. Vérifiez également que tout ce qui précède /content/dam.json correspond à la valeur Adobe Experience Manager cible configurée dans les paramètres de l’appli de bureau Adobe Experience Manager.

Le processus SAML de connexion fonctionne correctement selon les étapes ci-dessus, mais les utilisateurs ne peuvent toujours pas se connecter

La fenêtre de l’application de bureau Adobe Experience Manager qui affiche le processus de connexion est simplement un navigateur web qui affiche l’interface utilisateur web de l’instance de Adobe Experience Manager cible :

  • La version Mac utilise un composant WebView.

  • La version Windows utilise CefSharp, basé sur le navigateur Chromium.

Vérifiez que le processus SAML prend en charge ces navigateurs.

Pour résoudre d’autres problèmes, il est possible d’afficher les URL exactes que le navigateur tente de charger. Pour afficher ces informations :

  1. Suivez la procédure pour lancer l’application en mode débogage.

  2. Reproduisez la tentative de connexion.

  3. Accédez au répertoire des journaux de l’application.

  4. Pour Windows :

    1. Ouvrez « aemcompanionlog.txt ».

    2. Recherchez les messages commençant par « L’adresse du navigateur de connexion a été remplacée par ». Ces entrées contiennent également l’URL chargée par l’application.

    Pour Mac :

    1. En com.adobe.aem.desktop-nnnnnnnn-nnnnnn.log, les numéros qui se trouvent dans le nom de fichier le plus récent remplacent n.

    2. Recherchez les messages commençant par « cadre chargé ». Ces entrées contiennent également l’URL chargée par l’application.

L’examen de la séquence d’URL en cours de chargement peut aider à résoudre les problèmes du côté SAML afin de déterminer ce qui ne va pas.

Problème de configuration SSL ssl-config-v2

Les bibliothèques que l’application de bureau Experience Manager utilise pour la communication HTTP utilisent une application SSL stricte. Parfois, une connexion peut réussir à l’aide d’un navigateur, mais échouer lors de l’utilisation de l’application de bureau Experience Manager. Pour configurer SSL de manière appropriée, installez le certificat intermédiaire manquant dans Apache. Voir Comment installer un certificat d’autorité de certification intermédiaire dans Apache.

Les bibliothèques que l’application de bureau Experience Manager utilise pour la communication HTTP utilisent une application SSL stricte. Ainsi, il peut y avoir des instances où les connexions SSL qui réussissent via un navigateur échouent avec l’application de bureau Adobe Experience Manager. Ce résultat est positif, car il encourage une configuration correcte du SSL et renforce la sécurité, mais peut être frustrant lorsque l’application ne parvient pas à se connecter.

Dans ce cas, l’approche recommandée consiste à utiliser un outil pour analyser le certificat SSL d’un serveur et identifier les problèmes afin de les corriger. Certains sites Web inspectent le certificat d'un serveur en fournissant son URL.

À titre de mesure temporaire, il est possible de désactiver l’application SSL stricte dans l’application de bureau Adobe Experience Manager. Cette approche n’est pas une solution recommandée à long terme, car elle réduit la sécurité en masquant la cause première de SSL mal configuré. Pour désactiver la mise en œuvre stricte :

  1. Utilisez l’éditeur de votre choix pour modifier le fichier de configuration JavaScript de l’application, qui se trouve (par défaut) aux emplacements suivants (en fonction du système d’exploitation) :

    Sous Mac : /Applications/Adobe Experience Manager Desktop.app/Contents/Resources/javascript/lib-smb/config.json

    Sous Windows : C:\Program Files (x86)\Adobe\Adobe Experience Manager Desktop\javascript\config.json

  2. Recherchez la section suivante dans le fichier :

    code language-shell 
    ...
"assetRepository": {
    "options": {
...

  3. Modifiez la section en ajoutant "strictSSL": false comme suit :

    code language-shell 
    ...
"assetRepository": {
    "options": {
        "strictSSL": false,
...

  4. Enregistrez le fichier et redémarrez l’application de bureau Adobe Experience Manager.

Problèmes de connexion lors du passage à un autre serveur cannot-login-cookies-issue

Après avoir utilisé un serveur Experience Manager, lorsque vous tentez de modifier la connexion à un autre serveur, vous pouvez rencontrer des problèmes de connexion. Ils résultent d’une interférence des anciens cookies avec la nouvelle authentification. Une option du menu principal de Clear Cookies aide à résoudre le problème. Déconnectez-vous de la session active dans l’appli et sélectionnez Clear Cookies avant de vous connecter.

Effacez les cookies lors du changement de serveur

L’application ne répond pas unresponsive

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.

Masquer les actifs parvenus à expiration hide-expired-assets

Lorsque vous parcourez les ressources depuis l’interface utilisateur d’Experience Manager, les ressources expirées ne s’affichent pas. Les administrateurs peuvent configurer des paramètres pour empêcher l’affichage, la recherche et la récupération de ressources expirées lors de la navigation à partir de l’appli de bureau et d’Asset Link. Cela permet de s’assurer que les ressources expirées ne sont pas accessibles pendant ces opérations. La configuration fonctionne pour tous les utilisateurs, quel que soit le privilège d’administrateur.

Related Articles
recommendation-more-help
d27c3dc5-a94a-4e63-a6d5-c47555beb65d