Solução de problemas do Adobe Asset Link

Este documento contém informações sobre soluções de problemas que você pode enfrentar ao usar o Adobe Asset Link.

Sobre o painel Adobe Asset Link

O Adobe Asset Link é instalado como uma extensão em seus aplicativos da Adobe Creative Cloud: Photoshop, Illustrator, InDesign e XD.

Depois de instalado e configurado, você pode abrir o painel Adobe Asset Link no Adobe Illustrator e InDesign escolhendo Janela Extensões Adobe Asset Link.

Para abrir o painel Adobe Asset Link no Photoshop, escolha Janela > Extensões (legado) > Adobe Asset Link.

Para abrir o painel Adobe Asset Link no Adobe XD, escolha Plug-ins > Adobe Asset Link.

Use o Adobe Asset Link para acessar, utilizar e editar ativos digitais armazenados no Adobe Experience Manager Assets. Você pode fazer upload de novos ativos no Experience Manager Assets. Saiba mais sobre como gerenciar ativos usando o Adobe Asset Link.

Observação:
  • Se as miniaturas dos ativos não aparecerem ao navegar, mas as visualizações dos ativos estiverem disponíveis, entre em contato com o administrador para atualizar o Adobe Experience Manager Managed Services (AMS) com os pacotes de serviço mais recentes.
  • Se você não conseguir acessar o painel Adobe Asset Link, entre em contato com o administrador para obter orientações sobre etapas de solução de problemas.

Antes de começar a solução de problemas

Se você não conseguir usar o painel Adobe Asset Link, siga estas etapas antes de começar a solucionar um erro específico.

  1. Para atualizar o cache dos aplicativos da Creative Cloud, feche-os antes de instalar/reinstalar o Adobe Asset Link.

  2. Verifique se o Adobe Asset Link está instalado na pasta com.adobe.assetlink no seguinte local:

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

    Se você encontrar problemas, tente remover as versões existentes do Adobe Asset Link antes de reinstalar ou instalar a nova versão. Para remover a versão existente, exclua a pasta com.adobe.assetlink. Em seguida, instale a versão mais recente do Adobe Asset Link.

  3. Verifique se o arquivo assetlink-settings.json está presente no seguinte local:

    • macOS: /Users/<nome do usuário>/Library/Application Support/Adobe/CEP/extensions
    • Windows: C:\Usuários\<nome do usuário>\AppData\Roaming\Adobe\CEP\extensions
  4. Confira se você fez logon usando uma Enterprise ID ou Federated ID no aplicativo de desktop da Creative Cloud.

  5. Verifique se a sincronização de arquivos está ativada no aplicativo de desktop da Creative Cloud.

  6. Usando o Monitor de Atividade (no macOS) ou o Gerenciador de Tarefas (no Windows), verifique se um processo chamado CoreSync está em execução.

  7. Se você for um administrador, confira o seguinte:

  8. Se você estiver usando o Adobe Asset Link com o Experience Manager 6.5.5 (ou posterior) implantado com S3 como o armazenamento de dados, verifique se a API Platform está funcionando corretamente.

    Acesse https://<servidor>:<porta>/platform/content/dam para verificar se há problemas de conexão. Se a API Platform estiver funcionando corretamente, a resposta será uma representação JSON dos objetos DAM de nível superior. No caso de mau funcionamento na API Platform, um erro com o código de resposta 500 é gerado, e o Adobe Asset Link não consegue se conectar ao Experience Manager. Para resolver o erro, atualize o conector de armazenamento de dados S3 para a versão 1.10.12 ou posterior.

  9. Para que o Adobe Asset Link seja compatível com o Adobe Illustrator, o InDesign e o XD em dispositivos Apple M1, atualize o Adobe Asset Link e Adobe Asset Link para XD para a versão mais recente. O Adobe Asset Link é compatível com o Adobe Photoshop em dispositivos M1 no modo de emulação Rosetta. Para saber como executar o Photoshop no Rosetta, consulte Photoshop para Apple Silicon.

Cenários de erro

Veja alguns cenários de erro que você pode encontrar ao usar o painel Adobe Asset Link e as etapas para resolvê-los.

Erro

O erro Abort trap: 6 aparece quando você instala a extensão usando a ferramenta de linha de comando do Adobe Extension Manager (ExManCmd).

Motivo

O Adobe Asset Link não é instalado no macOS. No Windows, a instalação falha sem nenhum erro.

Para resolver o problema, faça o seguinte:

  1. Saia da Creative Cloud para desktop.

  2. Exclua ExMan.db do local:

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

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

  3. Reinicie a Creative Cloud para desktop e faça logon com as mesmas credenciais usadas na etapa 1.

  4. Reinstale o pacote que contém a extensão Adobe Asset Link. O painel Adobe Asset Link será instalado.

Erro

Faça logon em sua conta da Creative Cloud com uma Enterprise ID ou Federated ID para acessar o serviço. Entre em contato com o administrador de TI se você não tiver uma conta corporativa da Creative Cloud.

Motivo

Este erro aparece quando você é desconectado da Adobe Creative Cloud ou quando o painel Adobe Asset Link não consegue acessar sua identidade.

Para corrigir esse erro, faça o seguinte:

  1. Confira se você fez logon no aplicativo da Creative Cloud.

  2. Feche e abra novamente o aplicativo da Creative Cloud com o qual está trabalhando.

  3. Veja se você consegue abrir o site da Adobe.

Erro

O Adobe Asset Link aceita somente usuários com Business ID, Enterprise ID ou Federated ID. Se você estiver conectado com uma Adobe ID, faça logoff e logon novamente com uma Enterprise ID ou Federated ID. Para obter mais informações sobre os tipos de identidade aceitas pela Adobe, consulte Gerenciar tipos de identidade.

Motivo

Este erro aparece ao tentar fazer logon e acessar o Adobe Asset Link com uma Adobe ID. Se você não tiver uma conta da Creative Cloud para corporações, entre em contato com o administrador de TI.

Erro

Se você não tiver acesso a este serviço, entre em contato com o administrador de TI para obter acesso.

Motivo

Este erro aparece caso você não tenha as permissões necessárias para acessar o servidor do Experience Manager.

Para corrigir esse erro, entre em contato com o administrador de TI para verificar se o servidor do Experience Manager está funcionando.

Erro

O servidor do Experience Manager Assets que você está tentando acessar está inacessível. Entre em contato com o administrador do Adobe Experience Manager para obter mais detalhes.

Motivo

Este erro aparece quando a conexão de rede é interrompida durante a conexão com o servidor do Experience Manager ou quando o servidor do Experience Manager está indisponível.

Para corrigir o erro, verifique se você está conectado à Internet e faça o seguinte:

  1.  Verifique se o servidor do Experience Manager está funcionando.

  2. Feche e abra novamente o aplicativo da Creative Cloud com o qual está trabalhando.

  3. Abra o painel Asset Link.

Erro

Sua conta da Creative Cloud para corporações pode não ter permissão para acessar este servidor do Experience Manager Assets. Entre em contato com o administrador do Adobe Experience Manager para obter ajuda.

Motivo

Este erro aparece quando sua conta da Creative Cloud para corporações não tem permissão para acessar o servidor do Experience Manager Assets.

Um erro de autorização também pode ocorrer caso uma ou mais configurações em seu arquivo local assetlink-settings.json estiverem incorretas (consulte a documentação para obter informações). Entre em contato com o administrador do Experience Manager para obter ajuda. Esse erro ocorre especialmente nos seguintes cenários:

  • O usuário não está autorizado a acessar o servidor do Experience Manager.
  • A conta do usuário não está adicionada ao grupo do IMS configurado no Experience Manager.
  • O grupo do IMS adicionado à conta do usuário não corresponde ao grupo do IMS no Experience Manager.
  • O arquivo assetlink-settings.json inclui um aemPort incorreto.
  • O valor de aemServer está faltando no arquivo assetlink-settings.json.
Observação:

Os clientes que têm ambientes proxy estão impedidos de usar o Adobe Asset Link. Ambientes proxy ainda não são aceitos no Adobe Asset Link.

Se o usuário não estiver autorizado a acessar o Experience Manager ou sua conta não for adicionada ou não corresponder a um grupo do IMS no Experience Manager:

  1. Na página Usuários, no Admin Console, procure a conta de usuário.

    1. Na lista de usuários, clique no nome do usuário relevante.

    2. Em Grupos de usuários, verifique se o grupo do IMS associado corresponde ao Experience Manager.

      Você pode verificar os mapeamentos do grupo do Experience Manager em aem-instance/system/console/configMgr > Adobe Granite OAuth IMS Provider > Mapeamentos de grupo.

      Observação:

      No Experience Manager 6.4 e superior, se o mapeamento do grupo não estiver explicitamente definido, verifique se o grupo de usuários do IMS faz parte do grupo dam-users no Experience Manager.

    3. Se o usuário não estiver associado ao grupo do IMS no Experience Manager, edite os Grupos de usuários e atribua o grupo de usuários com o qual o Experience Manager está configurado.

      Para obter mais informações, consulte Criar um grupo de usuários.

Consulte Configurar o arquivo assetlink-settings.json e adicionar a todos os dispositivos para conferir se os valores de aemPort e aemServer no arquivo assetlink-settings.json estão corretos. Se você ainda receber um erro, entre em contato com o administrador de TI para verificar o seguinte:

  • Você tem as permissões corretas para acessar o servidor do Experience Manager.
  • Você é adicionado ao grupo do IMS configurado no Experience Manager.

Como novo usuário, se aparecer a exibição Adicionar novo ambiente (em vez da exibição inicial) ao iniciar o Adobe Asset Link, execute um dos seguintes procedimentos:

  • Atualize para a versão mais recente do Adobe Asset Link.
  • Confira se a pasta CEP > extensions está presente no seguinte local no computador, de acordo com o sistema operacional. Crie a pasta se ela já não estiver presente.
    • Windows: C:\Usuários\<nome do usuário>\AppData\Roaming\Adobe\CEP\extensions
    • macOS: /Usuários/<nome do usuário>/Library/Application Support/Adobe/CEP/extensions

Erro

O servidor do Experience Manager Assets que você está tentando acessar não está respondendo. Entre em contato com o administrador do Adobe Experience Manager para obter mais detalhes.

Motivo

Este erro aparece quando você não consegue se conectar ao servidor do Experience Manager.

Para corrigir o erro, entre em contato com o administrador de TI para verificar se o servidor do Experience Manager está funcionando.

Erro

Sem conexão à Internet.

Motivo

Este erro aparece quando você não está conectado à Internet.

Para corrigir o erro, verifique se o computador está conectado à Internet.

Este erro pode ser encontrado ao usar a opção Inserir vinculado pelo menu de contexto do Adobe Asset Link no InDesign 2020 ou posterior. Verifique se a Client ID do InDesign, InDesignAem2, está adicionada na lista aprovada diretamente no servidor do Experience Manager.

Para obter informações sobre como adicionar a Client ID à lista aprovada, consulte Configurar o Experience Manager usando o pacote de configuração.

Observação:

Isso não é necessário se você tiver uma instância do Experience Manager Assets as a Cloud Service. Aplica-se somente ao AMS e instâncias locais do Experience Manager Assets.

As alterações em ativos vinculados no Experience Manager às vezes não são visíveis aos usuários no InDesign, a menos que excluam o cache local do InDesign. O problema pode ser devido a permissões insuficientes nos metadados de ativos vinculados.

Para resolver esse problema, verifique se o usuário tem acesso de modificação no nó /content/dam/dam:batch no CRxDe.

Se as pesquisas de ativos no Experience Manager Assets e no Adobe Asset Link retornarem resultados diferentes, tente realizar uma pesquisa por semelhança visual para obter resultados consistentes. 

Para resolver o problema, siga estas etapas:

  1. Faça logon como administrador na instância do autor do AEM e exclua o usuário do AEM que está com problema de check-in.

    Exclua todas as outras entradas (se houver) desse usuário.

  2. O usuário precisa fazer logon novamente na instância do autor do AEM usando suas credenciais e tentar fazer check-in dos ativos no Adobe Asset Link. Isso atualiza as informações mais recentes do usuário do IMS.

Habilitar logs do lado do cliente

Habilitar logs do lado do cliente ajuda a depurar problemas de conexão porque é necessário que os logs do cliente e do servidor façam o diagnóstico dos erros de conexão.

É fácil habilitar o registro do lado do cliente no nível DEBUG ou TRACE para a extensão do Adobe Asset Link nos aplicativos da Creative Cloud: Photoshop, InDesign e Illustrator. Basta criar um arquivo de texto de uma linha assetlink-override.json.

O arquivo inclui apenas a seguinte linha de código para o registro no nível DEBUG:

     {"LOG_LEVEL":"DEBUG"}

Para ativar o registro no nível TRACE, altere o valor para TRACE:

     {"LOG_LEVEL":"TRACE"}

Coloque o arquivo no mesmo local do arquivo assetlink-settings.json

  • macOS: /Users/<nome do usuário>/Library/Application Support/Adobe/CEP/extensions
  • Windows: C:\Users\<nome do usuário>\AppData\Roaming\Adobe\CEP\extensions

Nesse caso, nome do usuário é a ID de logon no seu computador.

Reinicie o aplicativo da Creative Cloud (Photoshop, InDesign, Illustrator). Quando o Adobe Asset Link for reaberto, ele criará um arquivo de registro no diretório temporário com o nível de registro apropriado 

Conforme o sistema operacional, o diretório temporário ficará disponível no seguinte local:

  • macOS: /tmp
  • Windows: %TEMP% (que geralmente redireciona para C:\Usuários\nome do usuário\AppData\Local\Temp)

O nome do arquivo de registro é adobe-assetlink-APPN-99.9.9.log.

APPN é um destes nomes: PHXS, IDSN ou ILST. Os dígitos 99 são o número da versão do aplicativo da Creative Cloud. Veja um nome de arquivo de exemplo do Photoshop.

     adobe-assetlink-PHXS-19.1.2.log

O tamanho do arquivo de registro é de apenas alguns kilobytes.

O registro do cliente ajuda a depurar problemas de conexão, porque tanto os registros do cliente como os do servidor são necessários para diagnosticar erros de conexão.

Para habilitar o registro do lado do cliente no nível DEBUG ou TRACE para o Adobe Asset Link no Adobe XD, crie um arquivo de texto de linha única assetlink-override.json.

O arquivo inclui apenas a seguinte linha de código para o registro no nível DEBUG:

     {"LOG_LEVEL":"DEBUG"}

Para ativar o registro no nível TRACE, altere o valor para TRACE:

     {"LOG_LEVEL":"TRACE"}

Coloque o arquivo no mesmo local do arquivo storage.json

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

Nesse caso, nome do usuário é a ID de logon no seu computador.

Reinicie o Adobe XD. Quando o Adobe Asset Link é reaberto, ele cria um arquivo de registro no seguinte local com o nível de registro apropriado:

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

O nome do arquivo de registro é adobe-assetlink-XD-4X.X.XX.XX.xxx.log.

O tamanho do arquivo de registro é de apenas alguns kilobytes.

Observação:

O valor de X varia de acordo com a versão do Adobe XD que você está usando. No entanto, você deve usar o Adobe XD versão 41.0 ou superior.

Configurar manualmente pontos de extremidade usando assetlink-settings.json

Para novos usuários, você pode fornecer um computador antes que a conta do usuário seja criada. Dependendo do sistema operacional, copie o arquivo assetlink-settings.json em um desses locais:

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

Quando o novo usuário inicia o Adobe Asset Link, ele procura o arquivo de configurações no local do sistema. Em seguida, dependendo do sistema operacional, o arquivo é copiado para uma das seguintes áreas de usuário:

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

Conceda aos usuários permissões de leitura para a pasta que contém o arquivo assetlink-settings.json. Certifique-se também de que os futuros usuários do computador com a implantação tenham acesso de leitura à pasta.

Observação:

Se o caminho da pasta não estiver disponível em um dispositivo, crie a pasta CEP > extensions manualmente.

  1. Baixe o arquivo de exemplo assetlink-settings.json e abra-o em um editor de texto.

  2. Modifique o arquivo para incluir um ou mais pontos de extremidade do Experience Manager Assets.

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

    Parâmetros

    Descrição

    SERVERNAME

    Nome ou URL do servidor do Experience Manager

    SERVERPORT

    Número da porta para o servidor do Experience Manager

    PROTOCOL

    Esquema de protocolo do URL do servidor do Experience Manager. Use HTTP ou HTTPS.

    Por exemplo, se o URL do servidor do Experience Manager for: http://content.demo.com:4502, o arquivo .json deve incluir o seguinte código:

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

    Veja a seguir mais alguns exemplos de arquivos .json:

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

Adição de ambientes do Experience Manager no Adobe Asset Link para XD usando arquivo json

Para adicionar ambientes do Experience Manager no Adobe Asset Link for XD, atualize o arquivo assetlink-settings.json com o URL do ambiente específico.

Configure o arquivo assetlink-settings.json para indicar a nova instância do Experience Manager. Inicie o Adobe XD e abra o arquivo storage.json no seguinte local:

  • macOS: Users/<nome de usuário>/Library/Application/Support/Adobe/UXP/PluginsStorage/SPRK/External/61d229b9/PluginData
  • Windows: C:\Users\<nome de usuário>\AppData\Roaming\Adobe\UXP\PluginsStorage\SPRK\External\61d229b9\PluginData

O arquivo inclui a entrada 

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

                "activeAemEnvironmentRoot": url,

                "viewMode": "grid}

Substitua “url” pelo URL da instância do Experience Manager Assets. Coloque o URL entre aspas. Salve e feche o arquivo. Saia e reinicie o Adobe XD para que ele se conecte ao Experience Manager Assets.

Observação:

Se o arquivo assetlink-settings.json for diferente, o Adobe Asset Link para XD é redirecionado para o fluxo de trabalho do serviço de descoberta.

Receba ajuda com mais rapidez e facilidade

Novo usuário?