DocumentationAEMGuide de l’application de bureau

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

Last update: Fri Jul 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Utilisateur ou utilisatrice
  • Administration

L’appli de bureau Adobe Experience Manager se connecte à un référentiel de gestion des actifs 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 les fichiers et les dossiers, et inclut des 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. Découvrez comment fonctionne la liaison entre l’interface web Experience Manager et le 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 Adobe Experience Manager Assets. Les caractères non pris en charge dans le nom du dossier peuvent avoir une incidence sur certains cas d’utilisation de 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 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’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 de l’application ou avant de procéder à la mise à niveau vers une version Experience Manager plus récente. 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 rencontrez 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 : évitez d’utiliser l’application pour la migration des ressources, car elle nécessite des outils de planification et d’autres outils. Il n’est pas non plus adapté aux opérations de gestion des ressources numériques intensives, telles que le déplacement de dossiers volumineux, les chargements volumineux ou les recherches de métadonnées avancées. De plus, ne l’utilisez pas comme client de synchronisation, car ses principes de conception et ses schémas d’utilisation diffèrent des clients de synchronisation tels que Microsoft OneDrive ou la synchronisation de bureau Adobe Creative Cloud.

  • 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 Experience Manager 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 à mieux transmettre les problèmes au service clientèle si vous choisissez d’en faire Adobe.

Emplacement des fichiers journaux check-log-files-v2

L’appli 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’appli 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’appli 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 manuellement le cache, procédez comme suit :

CAUTION
Ces étapes sont une opération potentiellement destructrice. Si des modifications de fichier locales ne sont pas téléchargées vers Adobe Experience Manager, ces modifications 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.

    Dans ce répertoire, il existe des sous-répertoires nommés d’après les points d’entrée Adobe Experience Manager codés. Les noms sont une version codée de l’URL Adobe Experience Manager ciblée. Par exemple, si l’application cible 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é. Sinon, la suppression de l’intégralité du répertoire spécifié dans les préférences efface le cache de toutes les instances 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 sur 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. Selon la taille et la complexité d’un fichier, le transfert de la nouvelle version d’un fichier vers Adobe Experience Manager prend beaucoup de temps. L’application est conçue pour minimiser le nombre de transferts de fichiers, plutôt que de charger automatiquement les fichiers en fonction de l’achèvement estimé 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

Des problèmes peuvent parfois survenir lors de la mise à niveau de l’appli de bureau Experience Manager sur macOS. Les dossiers système hérités de l’appli de bureau Experience Manager entraînent ces problèmes. Les dossiers empêchent le chargement correct des nouvelles versions de l’appli 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 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 upload-fails

Si vous utilisez l’appli de bureau avec Experience Manager 6.5.1 ou version ultérieure, mettez à niveau le connecteur Azure ou S3 vers la version 1.10.4 ou ultérieure. Elle résout le problème d’échec de 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 généraux de connectivité, voici quelques moyens d’obtenir plus d’informations sur ce que fait l’appli de bureau Experience Manager.

Vérification du journal des requêtes

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

  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 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 d’accès initialement demandé. Ou, la dernière redirection est vers un hôte différent de celui configuré dans l’appli 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’appli 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 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 de log de l’application.

  4. Pour Windows :

    1. Ouvrez "aemcompanionlog.txt".

    2. Recherchez des 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. Dans 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 des 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 utilisées par l’appli de bureau Experience Manager pour les communications HTTP appliquent le protocole SSL de manière stricte. Parfois, une connexion peut réussir en utilisant un navigateur, mais échouer lors de l’utilisation de l’appli 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 utilisées par l’appli de bureau Experience Manager pour les communications HTTP appliquent le protocole SSL de manière stricte. Il peut donc y avoir des cas où les connexions SSL réussies par le biais d’un navigateur échouent avec l’appli de bureau Adobe Experience Manager. Ce résultat est positif, car il encourage une configuration correcte du protocole SSL et renforce la sécurité, mais peut s’avérer 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’appli 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 principale d’un protocole 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 (selon le 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’appli 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

Lors de l’exploration de ressources à partir de l’interface utilisateur de 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 des ressources expirées lors de l’accès à partir de l’appli de bureau et 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