Résolution des problèmes liés à Adobe Asset Link

Ce document contient des informations sur le dépannage des problèmes que vous pouvez rencontrer lors de l’utilisation d’Adobe Asset Link.

À propos du panneau Adobe Asset Link

Adobe Asset Link est installé en tant qu’extension dans vos applications Adobe Creative Cloud : Photoshop, Illustrator, InDesign et XD.

Une fois installé et configuré, vous pouvez ouvrir le panneau Adobe Asset Link dans Adobe Illustrator et InDesign en choisissant Fenêtre Extensions Adobe Asset Link.

Pour ouvrir le panneau Adobe Asset Link dans Photoshop, choisissez Fenêtre > Extensions (héritées) > Adobe Asset Link.

Pour ouvrir le panneau Adobe Asset Link dans Adobe XD, choisissez Plug-ins > Adobe Asset Link.

Utilisez Adobe Asset Link pour accéder aux ressources numériques stockées dans Adobe Experience Manager Assets, les réutiliser et les modifier. Vous pouvez importer de nouvelles ressources dans Experience Manager Assets. Suivez le lien pour en savoir plus sur la gestion des ressources dans Adobe Asset Link.

Remarque :
  • Si vous ne voyez pas les miniatures des ressources lors de la navigation, mais que vous pouvez afficher leur aperçu, contactez l’administrateur pour mettre à jour Adobe Experience Manager Managed Services (AMS) avec les derniers packs de service.
  • Si vous ne parvenez pas à accéder au panneau Adobe Asset Link, contactez votre administrateur pour obtenir des conseils sur la procédure de dépannage à suivre.

Avant de commencer le dépannage

Si vous ne pouvez pas utiliser le panneau Adobe Asset Link, effectuez ces étapes avant de commencer à résoudre une erreur spécifique.

  1. Pour actualiser le cache dans les applications Creative Cloud, fermez les applications avant d’installer ou de réinstaller Adobe Asset Link.

  2. Vérifiez si Adobe Asset Link est installé dans le dossier com.adobe.assetlink à l’emplacement suivant :

    • macOS : /Library/Application Support/Adobe/CEP/extensions.
    • Windows : C:\Program Files (x86)\Common Files\Adobe\CEP\extensions.

    Si vous rencontrez des problèmes, essayez de supprimer les versions existantes d’Adobe Asset Link avant de réinstaller ou d’installer la nouvelle version. Pour supprimer la version existante, supprimez le dossier com.adobe.assetlink. Installez ensuite la dernière version d’Adobe Asset Link.

  3. Vérifiez que le fichier assetlink-settings.json est présent à l’emplacement suivant :

    • macOS : /Users/<username>/Library/Application Support/Adobe/CEP/extensions
    • Windows : C:\Users\<username>\AppData\Roaming\Adobe\CEP\extensions
  4. Assurez-vous d’être connecté avec un Enterprise ID ou un Federated ID dans l’application pour postes de travail Creative Cloud.

  5. Assurez-vous que la synchronisation de fichiers est activée dans l’application pour postes de travail Creative Cloud.

  6. À l’aide du moniteur d’activité (pour macOS) ou du gestionnaire de tâches (pour Windows), assurez-vous qu’un processus nommé CoreSync est en cours d’exécution.

  7. Si vous êtes un administrateur, assurez-vous de ce qui suit :

  8. Si vous utilisez Adobe Asset Link avec Experience Manager 6.5.5 (ou version ultérieure) déployé avec S3 comme magasin de données, vérifiez si l’API Platform fonctionne correctement.

    Accédez à l’adresse https://<server>:<port>/platform/content/dam pour vérifier les problèmes de connexion. Si l’API Platform fonctionne correctement, la réponse est une représentation JSON des objets DAM de niveau supérieur. Tout dysfonctionnement de l’API Platform génère une erreur avec le code de réponse 500 et Adobe Asset Link ne parvient pas à se connecter à Experience Manager. Pour résoudre l’erreur, mettez à niveau le connecteur de magasins de données S3 vers la version 1.10.12 ou ultérieure.

  9. Pour qu’Adobe Asset Link soit compatible avec Adobe Illustrator, InDesign et XD sur les appareils Apple M1, mettez à niveau Adobe Asset Link et Asset Link pour Adobe XD vers la dernière version disponible. Adobe Asset Link prend en charge Adobe Photoshop sur les appareils M1 en mode d'émulation Rosetta. Pour découvrir comment exécuter Photoshop dans Rosetta, reportez-vous à Photoshop pour Apple Silicon.

Types d’erreurs rencontrées

Voici quelques scénarios d’erreur que vous pouvez rencontrer lors de l’utilisation du panneau Adobe Asset Link et les étapes pour y remédier.

Erreur

Une erreur Abort trap: 6 se produit lorsque vous installez l’extension à l’aide de l’outil de ligne de commande Adobe Extension Manager (ExManCmd).

Raison

L’installation d’Adobe Asset Link échoue sur macOS. Sur Windows, l’installation échoue sans afficher aucune erreur.

Pour résoudre ce problème, procédez comme suit.

  1. Quittez l’application de bureau Creative Cloud.

  2. Supprimez ExMan.db depuis l’emplacement suivant :

    macOS : /Library/Application Support/Adobe/Extension Manager CC/Configuration/DB.

    Windows : C:\ProgramData\Adobe\Extension Manager CC\Configuration\DB.

  3. Relancez Creative Cloud pour postes de travail et connectez-vous avec les mêmes informations d’identification que celles utilisées à l’étape 1.

  4. Réinstallez le pack contenant l’extension Adobe Asset Link. Le panneau Adobe Asset Link est installé.

Erreur

Connectez-vous à votre compte Creative Cloud avec un Enterprise ID ou un Federated ID pour accéder à ce service. Contactez votre administrateur informatique si vous ne disposez pas de compte d’entreprise Creative Cloud.

Raison

Cette erreur apparaît lorsque vous êtes déconnecté d’Adobe Creative Cloud ou que le panneau Adobe Asset Link ne parvient pas à accéder à votre identité.

Pour remédier à cette erreur, procédez comme suit :

  1. Assurez-vous que vous êtes connecté à votre application Creative Cloud.

  2. Quittez et relancez l’application Creative Cloud avec laquelle vous travaillez.

  3. Vérifiez si vous pouvez accéder au site web d’Adobe.

Erreur

Adobe Asset Link prend uniquement en charge les utilisateurs Business, Enterprise ou Federated. Si vous êtes connecté avec un Adobe ID, déconnectez-vous et identifiez-vous à nouveau avec un Enterprise ID ou un Federated ID. Pour en savoir plus sur les types d’identité pris en charge par Adobe, consultez la section Gérer les types d’identité.

Raison

Cette erreur apparaît si vous essayez de vous connecter et d’accéder à Adobe Asset Link avec un Adobe ID. Contactez votre administrateur informatique si vous ne disposez pas d’un compte Creative Cloud abonnement Entreprise.

Erreur

Si vous n’avez pas accès à ce service, contactez votre administrateur informatique pour qu’il vous accorde des droits d’accès.

Raison

Cette erreur apparaît si vous ne disposez pas des autorisations requises pour accéder au serveur Experience Manager.

Pour remédier à cette erreur, contactez votre administrateur informatique si le serveur Experience Manager est opérationnel.

Erreur

Le serveur Experience Manager Assets que vous essayez d’atteindre est inaccessible. Contactez votre administrateur Adobe Experience Manager pour plus de détails.

Raison

Cette erreur apparaît si la connexion réseau est interrompue lors de la connexion au serveur Experience Manager ou si le serveur Experience Manager n’est pas disponible.

Pour corriger cette erreur, assurez-vous que vous êtes connecté à Internet et procédez comme suit :

  1.  Vérifiez que le serveur Experience Manager est opérationnel.

  2. Quittez et relancez l’application Creative Cloud avec laquelle vous travaillez.

  3. Lancez le panneau Adobe Asset Link.

Erreur

Votre compte Creative Cloud abonnement Entreprise peut ne pas être autorisé à accéder au serveur Experience Manager Assets. Contactez votre administrateur Adobe Experience Manager pour plus d’assistance.

Raison

Cette erreur apparaît si votre compte Creative Cloud abonnement Entreprise n’est pas autorisé à accéder au serveur Experience Manager Assets.

Une erreur d’autorisation peut également se produire si un ou plusieurs paramètres de votre fichier local assetlink-settings.json sont incorrects (voir la documentation pour en savoir plus). Contactez votre administrateur Experience Manager pour plus d’assistance. En particulier, cette erreur se produit dans les scénarios suivants :

  • L’utilisateur n’est pas autorisé à accéder au serveur Experience Manager.
  • Le compte d’utilisateur n’est pas ajouté au groupe IMS configuré dans Experience Manager.
  • Le groupe IMS ajouté au compte d’utilisateur ne correspond pas au groupe Experience Manager IMS.
  • Le fichier assetlink-settings.json comprend un aemPort incorrect.
  • La valeur aemServer est manquante dans le fichier assetlink-settings.json.
Remarque :

Les clients disposant d’environnements proxy ne peuvent pas utiliser Adobe Asset Link. Les environnements proxy ne sont pas encore pris en charge avec Adobe Asset Link.

Si l’utilisateur n’est pas autorisé à accéder à Experience Manager, ou si son compte n’est pas ajouté à un groupe IMS ou n’y correspond pas dans Experience Manager :

  1. Sur la page Utilisateurs du portail Admin Console, recherchez le compte utilisateur.

    1. Dans la liste des utilisateurs, cliquez sur le nom de l’utilisateur concerné.

    2. Sous Groupes d’utilisateurs, vérifiez si le groupe IMS associé correspond à Experience Manager.

      Vous pouvez vérifier les mappages de groupe Experience Manager sous aem-instance/system/console/configMgr > Fournisseur IMS Adobe Granite OAuth > Mappages de groupes.

      Remarque :

      Pour Experience Manager 6.4 et versions ultérieures, si le mappage de groupe n’est pas défini, assurez-vous que le groupe d’utilisateurs IMS fait partie du groupe dam-users dans Experience Manager.

    3. Si l’utilisateur n’est pas associé au groupe IMS dans Experience Manager, modifiez les groupes d’utilisateurs et attribuez le groupe d’utilisateurs avec lequel Experience Manager est configuré.

      Pour en savoir plus, reportez-vous à la section Création d’un groupe d’utilisateurs.

Consultez Configurer le fichier assetlink-settings.json et l’ajouter à tous les appareils pour vous assurer que les valeurs aemPort et aemServer du fichier assetlink-settings.json sont correctes. Si une erreur persiste, contactez votre administrateur informatique pour vérifier les éléments suivants :

  • Vous disposez des autorisations nécessaires pour accéder au serveur Experience Manager.
  • Vous n’êtes pas ajouté au groupe IMS configuré dans Experience Manager.

En tant que nouvel utilisateur, si vous voyez la vue Ajouter un nouvel environnement (au lieu de la vue Accueil) lorsque vous lancez Adobe Asset Link, effectuez l’une des opérations suivantes :

  • Passez à la dernière version d’Adobe Asset Link.
  • Assurez-vous que le dossier CEP > Extensions est présent à l’emplacement suivant sur votre appareil, selon le système d’exploitation. Créez le dossier s’il n’est pas déjà présent.
    • Windows : C:\Users\<username>\AppData\Roaming\Adobe\CEP\extensions
    • macOS : /Users/<username>/Library/Application Support/Adobe/CEP/extensions

Erreur

Le serveur Experience Manager Assets que vous essayez d’atteindre ne répond pas. Contactez votre administrateur Adobe Experience Manager pour plus de détails.

Raison

Cette erreur apparaît lorsque vous ne pouvez pas vous connecter au serveur Experience Manager.

Pour remédier à cette erreur, contactez votre administrateur informatique pour vérifier si le serveur Experience Manager est opérationnel.

Erreur

Aucune connexion Internet.

Raison

Cette erreur apparaît lorsque vous n’êtes pas connecté à Internet.

Pour remédier à cette erreur, assurez-vous que l’ordinateur est connecté à Internet.

Vous pouvez rencontrer l’erreur suivante lors de l’utilisation de l’option Importer et lier du menu contextuel Adobe Asset Link dans InDesign 2020 ou version ultérieure. Vérifiez que l’ID client InDesign, InDesignAem2, est ajouté à la liste approuvée directement dans le serveur Experience Manager.

Pour en savoir plus sur l’ajout de l’ID client à la liste approuvée, voir Configurer Experience Manager à l’aide du pack de configuration .

Remarque :

Cela n’est pas obligatoire si vous disposez d’une instance Experience Manager Assets en tant que service cloud. Cela s’applique uniquement à AMS et aux instances sur site d’Experience Manager Assets.

Les modifications apportées aux ressources liées sur Experience Manager ne sont parfois pas visibles pour les utilisateurs dans InDesign, à moins qu’ils ne suppriment le cache InDesign local. Le problème peut être dû à des autorisations insuffisantes sur les métadonnées des ressources liées.

Pour résoudre ce problème, assurez-vous que l’utilisateur dispose d’un accès en modification dans le nœud /content/dam/dam:batch dans CRxDe.

Si vos recherches de ressources dans Experience Manager Assets et Adobe Asset Link renvoient des résultats différents, essayez d’effectuer une recherche basée sur la similitude visuelle pour obtenir des résultats plus cohérents.

Essayez cette procédure pour résoudre ce problème :

  1. Connectez-vous en tant qu’administrateur à l’instance d’auteur AEM et supprimez l’utilisateur AEM qui n’arrive pas à archiver des ressources.

    Supprimez toutes les autres entrées (le cas échéant) liées à cet utilisateur.

  2. L’utilisateur devra se reconnecter à l’instance d’auteur AEM avec ses informations d’identification et essayer d’archiver des ressources dans Adobe Asset Link. Cette opération met à jour les dernières informations utilisateur provenant d’IMS.

Activation des journaux côté client

L’activation des journaux côté client aide à résoudre les problèmes de connexion, car les journaux client et serveur sont tous deux nécessaires pour diagnostiquer ce type d’erreur.

Il est facile d’activer la journalisation côté client au niveau DEBUG ou TRACE pour l’extension Adobe Asset Link dans les applications Creative Cloud : Photoshop, InDesign et Illustrator. Créez simplement un fichier texte sur une seule ligne assetlink-override.json.

Le fichier comprend uniquement la ligne de code suivante pour le niveau de consignation DEBUG- :

     {"LOG_LEVEL":"DEBUG"}

Pour activer le niveau de consignation TRACE-, modifiez la valeur sur trace, comme suit :

     {"LOG_LEVEL":"TRACE"}

Placez le fichier au même emplacement que votre fichier assetlink-settings.json

  • macOS : /Users/<username>/Library/Application Support/Adobe/CEP/extensions
  • Windows : C:\Users\<username>\AppData\Roaming\Adobe\CEP\extensions

Dans ce cas, username correspond à l’ID de connexion sur votre appareil.

Redémarrez votre application Creative Cloud (Photoshop, InDesign, Illustrator). Lorsqu’Adobe Asset Link se rouvre, il crée un fichier journal dans le répertoire temporaire avec le niveau de consignation approprié. 

Selon le système d’exploitation, le répertoire temporaire est disponible à l’emplacement suivant :

  • macOS : /tmp
  • Windows : %TEMP% (qui se résout généralement en C:\Users\username\AppData\Local\Temp)

Le nom du fichier journal est adobe-assetlink-APPN-99.9.9.log .

APPN est l’un de ces noms PHXS, IDSN ou ILST. Les chiffres 99 correspondent au numéro de version de l’application Creative Cloud. Voici un exemple de nom de fichier pour Photoshop.

     adobe-assetlink-PHXS-19.1.2.log

Le fichier journal ne fait que quelques kilo-octets.

Le journal client aide à déboguer les problèmes de connexion car les journaux client et serveur sont nécessaires pour diagnostiquer les erreurs de connexion.

Pour activer la consignation côté client au niveau DEBUG ou TRACE pour Adobe Asset Link dans Adobe XD, créez un fichier texte d’une seule ligne appelé assetlink-override.json.

Le fichier comprend uniquement la ligne de code suivante pour le niveau de consignation DEBUG- :

     {"LOG_LEVEL":"DEBUG"}

Pour activer le niveau de consignation TRACE-, modifiez la valeur sur trace, comme suit :

     {"LOG_LEVEL":"TRACE"}

Placez le fichier au même emplacement que votre fichier storage.json

  • macOS : ~/Library/Application/Support/Adobe/UXP/PluginsStorage/SPRK/External/61d229b9/PluginData
  • Windows : C:\Users\<username>\AppData\Roaming\Adobe\UXP\PluginsStorage\SPRK\External\61d229b9\PluginData

Dans ce cas, username correspond à l’ID de connexion sur votre appareil.

Redémarrez Adobe XD. Lorsqu’Adobe Asset Link se rouvre, il crée un fichier journal dans l’emplacement suivant avec le niveau d’enregistrement approprié :

  • macOS : ~/Library/Application/Support/Adobe/UXP/PluginsStorage/SPRK/External/61d229b9/PluginData/logs
  • Windows : C:\Users\<user>\AppData\Roaming\Adobe\UXP\PluginsStorage\SPRK\External\61d229b9\PluginData\logs

Le fichier journal s’appelle adobe-assetlink-XD-4X.X.XX.XX.xxx.log.

Le fichier journal ne fait que quelques kilo-octets.

Remarque :

La valeur de X varie en fonction de la version d’Adobe XD que vous utilisez. Cependant, vous devez utiliser la version Adobe XD 41.0 ou ultérieure.

Configuration manuelle de points de terminaison avec assetlink-settings.json

Pour chaque nouvel utilisateur, vous pouvez configurer un ordinateur avant que le compte de l’utilisateur en question ne soit créé. Selon votre système d’exploitation, copiez le fichier assetlink-settings.json dans l’un des emplacements suivants :

  • macOS : /Library/Application Support/Adobe/CEP/extensions.
  • Windows : \Program Files (x86)\Common Files\Adobe\CEP\extensions.

Lorsque le nouvel utilisateur lance le programme Adobe Asset Link, celui-ci recherche le fichier de paramètres dans le dossier système. Ensuite, en fonction du système d’exploitation, il copie le fichier dans l’un des emplacements utilisateur suivants :

  • macOS : ../Library/Application Support/Adobe/CEP/extensions
  • Windows : ..\AppData\Adobe\CEP\extensions

Assurez-vous que les utilisateurs disposent d’autorisations en lecture sur le dossier contenant le fichier assetlink-settings.json. Assurez-vous également que tous les futurs utilisateurs de l’ordinateur de déploiement ont un accès en lecture au dossier.

Remarque :

Si le chemin d’accès du dossier n’est pas disponible sur un appareil, créez le dossier CEP > extensions manuellement.

  1. Téléchargez l’exemple de fichier assetlink-settings.json et ouvrez-le dans un éditeur de texte.

  2. Modifiez le fichier pour inclure un ou plusieurs points d’entrée Experience Manager Assets.

    {"aemServer":"SERVERNAME","aemPort":"SERVERPORT","aemScheme":"PROTOCOL"}

    Paramètres

    Description

    SERVERNAME

    Nom ou URL du serveur Experience Manager

    SERVERPORT

    Numéro de port du serveur Experience Manager

    PROTOCOL

    Schéma de protocole de l’URL du serveur Experience Manager. Utilisez HTTP ou HTTPS.

    Par exemple, si l’URL de votre serveur Experience Manager est http://content.demo.com:4502, le fichier .json doit contenir le code suivant :

    • {"aemServer":"content.demo.com","aemPort":"4502","aemScheme":"http"}

    Voici d’autres exemples de fichiers .json :

    • {"aemServer" : "author.customer.com", "aemPort" : "443", "aemScheme" : "https"}
    • {"aemServer" : "localhost", "aemPort" : "4502", "aemScheme" : "http"}
    • {"aemServer":"author-nossl.customer.com","aemPort":"80","aemScheme":"http"}

Ajout d'environnements Experience Manager dans Asset Link pour Adobe XD à l'aide d'un fichier json

Pour ajouter des environnements Experience Manager dans Asset Link pour Adobe XD, mettez à jour le fichier assetlink-settings.json avec l'URL de l'environnement spécifique.

Configurez le fichier assetlink-settings.json de sorte qu'il pointe vers la nouvelle instance Experience Manager. Lancez Adobe XD et ouvrez le fichier storage.json à partir de l’emplacement suivant :

  • macOS : Users/<username>/Library/Application/Support/Adobe/UXP/PluginsStorage/SPRK/External/61d229b9/PluginData
  • Windows : C:\Users\<username>\AppData\Roaming\Adobe\UXP\PluginsStorage\SPRK\External\61d229b9\PluginData

Le fichier comprend l’entrée 

               {"aemEnvironments": [{  "root": url, "title": title }],

                "activeAemEnvironmentRoot": url,

                "viewMode": "grid}

Remplacez « url » par l’URL de votre instance d’Experience Manager Assets. Placez l’URL entre guillemets. Enregistrez et fermez le fichier. Quittez, puis redémarrez Adobe XD pour qu’il se connecte à Experience Manager Assets.

Remarque :

Si le fichier assetlink-settings.json est différent, Asset Link pour Adobe XD est redirigé vers le workflow du service de découverte.

Recevez de l’aide plus rapidement et plus facilement

Nouvel utilisateur ?