Show Menu
TÓPICOS×

Troubleshoot Adobe Experience Manager desktop app

O aplicativo de desktop Adobe Experience Manager (AEM) se conecta a um repositório DAM (Digital Asset Management, gerenciamento de ativos digitais) de implantação remota. O aplicativo obtém informações do repositório e resultados da pesquisa em seu computador, baixa e carrega arquivos e pastas e inclui recursos para gerenciar conflitos com a interface do usuário do AEM Assets.
Leia para solucionar problemas do aplicativo, aprender as práticas recomendadas e descobrir as limitações.

Best practices

Siga as práticas recomendadas a seguir para evitar alguns problemas comuns e a solução de problemas.
  • Entenda como o aplicativo de desktop funciona : Antes de começar a usar o aplicativo, passe alguns momentos sabendo como ele funciona. Saiba mais sobre a vinculação entre a interface da Web do Experience Manager e o desktop, o mapeamento do repositório, o armazenamento em cache de ativos, a gravação local e o upload em segundo plano. Veja como funciona .
  • Evite caracteres não suportados em nomes de pastas: Não use espaços em branco e caracteres inválidos ao criar ou carregar pastas. Consulte uma lista de caracteres em Criar pastas em Ativos Experience Manager. Alguns casos de uso do Adobe Experience Manager podem ser afetados por caracteres não suportados no nome da pasta.
  • Práticas recomendadas para evitar conflitos : Para evitar conflitos em potencial ao colaborar em vários ativos, consulte evitar conflitos de edição.
  • Use o upload de pasta para pastas grandes e hierárquicas: Em vez de usar a interface da Web do Assets ou outros métodos, use o aplicativo de desktop Experience Manager para fazer upload de pastas grandes. O aplicativo carrega os ativos em segundo plano com o registro e o monitoramento. Consulte fazer upload de ativos em massa.
  • Use a versão mais recente: Use a versão mais recente do aplicativo e sempre verifique a compatibilidade antes de instalar uma nova versão do aplicativo ou antes de atualizar para uma versão mais recente do Adobe Experience Manager. See release notes .
  • Use a mesma letra de unidade: Use a mesma letra de unidade em uma organização para mapear para o Adobe Experience Manager DAM. Para ver os ativos colocados por outros usuários, os caminhos devem ser os mesmos. Usar a mesma letra de unidade garante um caminho constante para ativos DAM. Os ativos permanecem posicionados e não são removidos mesmo se letras de unidade diferentes forem usadas por usuários diferentes.
  • Lembre-se da rede : O desempenho da rede é essencial para o desempenho do aplicativo de desktop Experience Manager. Se você enfrentar uma resposta lenta a transferências de arquivos ou operações em massa, desative os recursos ou aplicativos que podem causar muito tráfego de rede.
  • Casos de uso não suportados para aplicativos de desktop: Não use o aplicativo para a migração do Assets (ele precisa de planejamento e outras ferramentas); para operações DAM de uso intenso (como mover pastas grandes, uploads grandes, localizar arquivos usando pesquisas avançadas de metadados); e como um cliente de sincronização (os princípios de design e os padrões de uso são diferentes dos clientes em sincronia, como o Microsoft OneDrive ou o Adobe Creative Cloud Desktop Sync).
  • Tempo limite : Atualmente, o aplicativo de desktop não tem um valor de tempo limite configurável que desconecta a conexão entre o servidor de Experience Manager e o aplicativo de desktop após um intervalo de tempo fixo. Ao fazer upload de ativos grandes, se a conexão expirar depois de algum tempo, o aplicativo tentativas fazer upload do ativo algumas vezes aumentando o tempo limite de upload. Não há uma maneira recomendada de alterar as configurações de tempo limite padrão.

Como solucionar problemas

Para solucionar problemas com o aplicativo de desktop, tenha em mente as seguintes informações. Além disso, ele o prepara para transmitir melhor os problemas ao Atendimento ao cliente da Adobe se você optar por buscar suporte.

Localização dos ficheiros de registro

Experience Manager o aplicativo desktop armazena seus arquivos de registro nos seguintes locais, dependendo do sistema operacional:
No Windows: %LocalAppData%\Adobe\AssetsCompanion\Logs
No Mac: ~/Library/Logs/Adobe\ Experience\ Manager\ Desktop
Ao fazer upload de muitos ativos, se alguns arquivos não forem carregados, consulte o backend.log arquivo para identificar os uploads que falharam.
Ao trabalhar com o Atendimento ao cliente do Adobe em uma solicitação de suporte ou ticket, você pode ser solicitado a compartilhar os arquivos de registro para ajudar a equipe do Atendimento ao cliente a entender o problema. Arquive a Logs pasta inteira e compartilhe-a com seu contato com o Atendimento ao cliente.

Alterar o nível de detalhes nos arquivos de registro

Para alterar o nível de detalhes nos arquivos de registro:
  1. Verifique se o aplicativo não está em execução.
  2. No sistema Windows:
    1. Abra uma janela de comando.
    2. Inicie o aplicativo Adobe Experience Manager desktop executando o comando:
    set AEM_DESKTOP_LOG_LEVEL=DEBUG&"C:\Program Files\Adobe\Adobe Experience Manager Desktop.exe
    
    
    No sistema Mac:
    1. Abra uma janela de terminal.
    2. Inicie o aplicativo Adobe Experience Manager desktop executando o comando:
    AEM_DESKTOP_LOG_LEVEL=DEBUG open /Applications/Adobe\ Experience\ Manager\ Desktop.app
    
    
Os níveis de log válidos são DEBUG, INFO, WARN ou ERROR. A verbosidade dos registros é mais alta em DEBUG e mais baixa em ERROR.

Ativar o modo de depuração

Para solucionar problemas, você pode ativar o modo de depuração e obter mais informações nos registros.
Os níveis de log válidos são DEBUG, INFO, WARN ou ERROR. A verbosidade dos registros é mais alta em DEBUG e mais baixa em ERROR.
Para usar o aplicativo no modo de depuração no Mac:
  1. Abra uma janela de terminal ou um prompt de comando.
  2. Inicie o aplicativo para Experience Manager desktop executando o seguinte comando:
    AEM_DESKTOP_LOG_LEVEL=DEBUG open /Applications/Adobe\ Experience\ Manager\ Desktop.app .
Para ativar o modo de depuração no Windows:
  1. Abra uma janela de comando.
  2. Inicie o aplicativo Experience Manager desktop executando o seguinte comando:
AEM_DESKTOP_LOG_LEVEL=DEBUG&"C:\Program Files\Adobe\Adobe Experience Manager Desktop.exe .

Limpar cache

Execute as seguintes etapas:
  1. Start o aplicativo e conecte uma instância AEM.
  2. Abra as preferências do aplicativo clicando nas elipses no canto superior direito e selecionando Preferences.
  3. Localize a entrada que exibe a Current Cache Size. Clique no ícone de lixeira ao lado desse elemento.
Para limpar manualmente o cache, siga as etapas abaixo.
Esta é uma operação potencialmente destrutiva. Se houver alterações no arquivo local para as quais não foi feito upload, Adobe Experience Manageressas alterações serão perdidas prosseguindo.
O cache é limpo excluindo o diretório de cache do aplicativo, que é encontrado nas preferências do aplicativo.
  1. Start do aplicativo.
  2. Abra as preferências do aplicativo selecionando as elipses no canto superior direito e selecionando Preferences.
  3. Observe o Cache Directory valor.
    Neste diretório, há subdiretórios nomeados após os Adobe Experience Manager Endpoints Codificados. Os nomes são uma versão codificada do Adobe Experience Manager URL direcionado. Por exemplo, se o aplicativo estiver direcionando, localhost:4502 o nome do diretório será localhost_4502 .
Para limpar o cache, exclua o diretório Endpoint Adobe Experience Manager codificado desejado. Como alternativa, a exclusão do diretório inteiro especificado nas preferências limpará o cache para todas as instâncias que foram usadas pelo aplicativo.
Limpar o cache Adobe Experience Manager do aplicativo desktop é uma tarefa preliminar de solução de problemas que pode resolver vários problemas. Limpe o cache das preferências do aplicativo. Consulte Definir preferências . O local padrão da pasta de cache é:

Conheça a versão do aplicativo para Adobe Experience Manager desktop

Para ver o número da versão:
  1. Start do aplicativo.
  2. Clique nas elipses no canto superior direito, passe o mouse sobre Helpe clique em About.
    O número da versão é listado nesta tela.

Não é possível ver ativos colocados

Se você não conseguir ver os ativos que você ou outros profissionais criativos colocaram nos arquivos de suporte (por exemplo, arquivos INDD), verifique o seguinte:
  • Conexão com o servidor. A conectividade de rede flexível pode paralisar os downloads de ativos.
  • Tamanho de arquivo. Ativos grandes demoram mais para serem baixados e exibidos.
  • Aumente a consistência da letra. Se você ou outro colaborador colocou os ativos ao mapear o DAM AEM para uma letra de unidade diferente, os ativos colocados não serão exibidos.
  • Permissões. Para verificar se você tem permissões para buscar os ativos inseridos, entre em contato com o administrador do AEM.

As edições em arquivos na interface do usuário do aplicativo de desktop não são refletidas Adobe Experience Manager imediatamente em

Adobe Experience Manager o aplicativo de desktop deixa ao usuário a decisão de quando todas as edições em um arquivo são concluídas. Dependendo do tamanho e da complexidade de um arquivo, leva um tempo significativo para transferir a nova versão de um arquivo de volta para Adobe Experience Manager. O design do aplicativo solicita a minimização do número de vezes que um arquivo é transferido para frente e para trás, em vez de adivinhar quando as edições do arquivo são concluídas e carregadas automaticamente. Recomenda-se que o usuário inicie a transferência do arquivo de volta para Adobe Experience Manager o, escolhendo fazer upload das alterações do arquivo.

Problemas ao atualizar no macOS

Ocasionalmente, podem ocorrer problemas ao atualizar AEM aplicativo desktop no macOS. Isso é causado pela pasta herdada do sistema para AEM aplicativo desktop que impede que novas versões do aplicativo AEM desktop sejam carregadas corretamente. Para resolver esse problema, as pastas e os arquivos a seguir podem ser removidos manualmente.
Antes de executar as etapas a seguir, arraste o Adobe Experience Manager Desktop aplicativo da pasta Aplicativos MacOS para a lixeira. Em seguida, abra o terminal, execute o seguinte comando e forneça sua senha quando solicitado.
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

Não é possível carregar arquivos

Se você estiver usando um aplicativo de desktop com AEM 6.5.1 ou posterior, atualize o conector S3 ou Azure para a versão 1.10.4 ou posterior. Ele resolve o problema de falha de carregamento de arquivo relacionado ao OAK-8599 . Consulte as instruções de instalação .

Experience Manager problemas de conexão do aplicativo de desktop

Se você estiver enfrentando problemas gerais de conectividade, veja algumas maneiras de obter mais informações sobre o que o aplicativo para Experience Manager desktop está fazendo.
Verificar o registro de solicitações
Experience Manager o aplicativo desktop registra todas as solicitações que envia, juntamente com o código de resposta de cada solicitação, em um arquivo de log dedicado.
  1. Abra request.log o diretório de log do aplicativo para ver essas solicitações.
  2. Cada linha no registro representa uma solicitação ou uma resposta. As solicitações terão um > caractere seguido do URL solicitado. As respostas terão um < caractere seguido pelo código de resposta e o URL solicitado. As solicitações e a resposta podem ser correspondidas usando o GUID de cada linha.
Verificar solicitações carregadas pelo navegador incorporado do aplicativo
A maioria das solicitações do aplicativo é encontrada no registro de solicitações. No entanto, se não houver informações úteis, então pode ser útil investigar as solicitações enviadas pelo navegador incorporado do aplicativo. Consulte a seção A autenticação de logon SAML não está funcionando SAML para obter instruções sobre como visualização essas solicitações.

A autenticação de logon SAML não está funcionando

Se o aplicativo de Experience Manager Adobe Experience Manager desktop não se conectar à sua instância habilitada por SSO (SAML), leia esta seção para solucionar problemas. Os processos SSO são variados, às vezes complexos, e o design do aplicativo faz o melhor para acomodar esses tipos de conexões. No entanto, algumas configurações exigem solução de problemas adicional.
Às vezes, o processo SAML não redireciona para o caminho solicitado originalmente, ou o redirecionamento final é para um host diferente do configurado no aplicativo Adobe Experience Manager desktop. Para verificar se não é esse o caso:
  1. Abra um navegador da Web.
  2. Insira o URL <AEM host>/content/dam.json na barra de endereços.
    Substitua <AEM host> pela instância do público alvo Adobe Experience Manager , por exemplo http://localhost:4502/content/dam.json .
  3. Faça logon na Adobe Experience Manager instância.
  4. Quando o logon for concluído, verifique o endereço atual do navegador na barra de endereços. Deve corresponder exatamente ao URL que foi digitado inicialmente.
  5. Verifique também se tudo antes corresponde /content/dam.json ao valor do público alvo Adobe Experience Manager configurado nas configurações do aplicativo Adobe Experience Manager desktop.
O processo de logon SAML funciona corretamente de acordo com as etapas acima, mas os usuários ainda não conseguem fazer logon
A janela dentro do aplicativo de Adobe Experience Manager Adobe Experience Manager desktop que exibe o processo de login é simplesmente um navegador da Web que exibe a interface do usuário da Web da instância do público alvo:
  • A versão Mac usa um WebView .
  • A versão do Windows usa o CefSharp baseado em Chromo.
Verifique se o processo SAML suporta esses navegadores.
Para solucionar problemas ainda mais, é possível visualização os URLs exatos que o navegador está tentando carregar. Para ver essas informações:
  1. Siga as instruções para iniciar o aplicativo no modo de depuração.
  2. Reproduza a tentativa de login.
  3. Navegue até o diretório de log do aplicativo
  4. Para Windows:
    1. Abra "aemcompanionlog.txt".
    2. Procure mensagens que comecem com "Endereço do navegador de logon alterado para". Essas entradas também contêm o URL que o aplicativo carregou.
    Para Mac:
    1. com.adobe.aem.desktop-nnnnnnnn-nnnnnn.log , em que n é substituído por qualquer número que esteja no nome de arquivo mais recente.
    2. Procure mensagens que comecem com "quadro carregado". Essas entradas também contêm o URL que o aplicativo carregou.
Analisar a sequência de URL que está sendo carregada pode ajudar a solucionar problemas no fim do SAML para determinar o que está errado.

Problema de configuração de SSL

As bibliotecas que AEM aplicativo de desktop usa para comunicação HTTP utilizam imposição rigorosa de SSL. Às vezes, uma conexão pode ser bem-sucedida usando um navegador, mas falha ao usar AEM aplicativo de desktop. Para configurar o SSL adequadamente, instale o certificado intermediário ausente no Apache. Consulte Como instalar um certificado CA intermediário no Apache .
As bibliotecas que AEM desktop usa para a comunicação HTTP utilizam imposição rigorosa de SSL. Portanto, pode haver casos em que as conexões SSL que têm sucesso por meio de um navegador falham com o aplicativo Adobe Experience Manager desktop. Isso é bom porque incentiva a configuração correta do SSL e aumenta a segurança, mas pode ser frustrante quando o aplicativo não consegue se conectar.
A abordagem recomendada neste caso é usar uma ferramenta para analisar o certificado SSL de um servidor e identificar problemas para que eles possam ser corrigidos. Há sites que verificam o certificado de um servidor ao fornecer seu URL.
Como medida temporária, é possível desativar a imposição SSL estrita em aplicativos para Adobe Experience Manager desktop. Esta não é uma solução de longo prazo recomendada, pois reduz a segurança ocultando a causa raiz do SSL configurado incorretamente. Para desativar a imposição estrita:
  1. Use o editor de sua escolha para editar o arquivo de configuração JavaScript do aplicativo, que é encontrado (por padrão) nos seguintes locais (dependendo do sistema operacional):
    No Mac: /Applications/Adobe Experience Manager Desktop.app/Contents/Resources/javascript/lib-smb/config.json
    No Windows: C:\Program Files (x86)\Adobe\Adobe Experience Manager Desktop\javascript\config.json
  2. Localize a seguinte seção no arquivo:
    ...
    "assetRepository": {
        "options": {
    ...
    
    
  3. Modifique a seção adicionando "strictSSL": false o seguinte:
    ...
    "assetRepository": {
        "options": {
            "strictSSL": false,
    ...
    
    
  4. Salve o arquivo e reinicie o aplicativo da Adobe Experience Manager área de trabalho.

O aplicativo não está respondendo

Raramente, o aplicativo pode ficar sem resposta, exibir apenas uma tela branca ou exibir um erro na parte inferior da interface, sem nenhuma opção na interface. Tente o seguinte na ordem:
  • Clique com o botão direito do mouse na interface do aplicativo e clique em Refresh .
  • Saia do aplicativo e abra-o novamente.
Em ambos os métodos, os start do aplicativo na pasta DAM raiz.

Precisa de ajuda adicional com o aplicativo Experience Manager de desktop

Crie um ticket Jira com as seguintes informações:
  • Use DAM - Companion App como o Component.
  • Etapas detalhadas para reproduzir o problema em Description.
  • Registros de nível DEBUG capturados durante a reprodução do problema.
  • Versão AEM público alvo.
  • Versão do sistema operacional.
  • Adobe Experience Manager versão do aplicativo para desktop. Para saber a versão do aplicativo, consulte encontrar a versão do aplicativo para desktop.