Solucionar problemas do aplicativo de desktop Adobe Experience Manager troubleshoot-v2

O aplicativo de desktop Adobe Experience Manager se conecta a um repositório DAM (Gerenciamento de ativos digitais) da implantação Experience Manager. O aplicativo busca informações do repositório e resultados de pesquisa em seu computador, baixa e carrega arquivos e pastas, além de recursos para gerenciar conflitos com a interface do usuário do Assets.

Leia para solucionar problemas do aplicativo, conhecer as práticas recomendadas e descobrir as limitações.

Práticas recomendadas best-practices-to-prevent-troubles

Siga as práticas recomendadas a seguir para evitar alguns problemas comuns e solução de problemas.

  • Entenda como o aplicativo de desktop funciona: Antes de começar a usar o aplicativo, passe alguns minutos sabendo como ele funciona. Saiba mais sobre a vinculação entre a interface da Web do Experience Manager e a área de trabalho, o mapeamento do repositório, o armazenamento em cache de ativos, o salvamento local e o carregamento em segundo plano. Consulte como funciona.

  • Evite caracteres não suportados nos nomes de pastas: não use espaços em branco e caracteres inválidos ao criar ou carregar pastas. Veja uma lista de caracteres em Criar pastas em Adobe Experience Manager Assets. Caracteres não suportados no nome da pasta podem afetar alguns casos de uso de Experience Manager.

  • Práticas recomendadas para evitar conflitos: para evitar possíveis conflitos ao colaborar em vários ativos, acesse evitar conflitos de edição.

  • Usar o carregamento de 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 carregar pastas grandes. O aplicativo carrega os ativos em segundo plano com registro e monitoramento. Consulte carregar ativos em massa.

  • Usar a última versão: usar a última versão do aplicativo. Sempre verifique a compatibilidade antes de instalar uma nova versão do aplicativo ou antes de atualizar para uma versão mais recente do Experience Manager. Consulte as notas de versão.

  • Usar a mesma letra de unidade: usar a mesma letra de unidade em uma organização para mapear para o DAM Experience Manager. 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 os ativos do DAM. Os ativos permanecem inseridos e não são removidos mesmo se letras de unidade diferentes forem usadas por usuários diferentes.

  • Atenção à rede: o desempenho da rede é essencial para o desempenho do aplicativo de desktop Experience Manager. Se você enfrentar uma resposta lenta para 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 sem suporte para o aplicativo de desktop: evite usar o aplicativo para migração de ativos, pois ele requer ferramentas de planejamento e adicionais. Também não é adequado para operações DAM complexas, como mover pastas grandes, uploads grandes ou pesquisas avançadas de metadados. Além disso, não o use como um cliente de sincronização, pois seus princípios de design e padrões de uso diferem dos clientes de sincronização como o Microsoft OneDrive ou o Adobe Creative Cloud desktop sync.

  • Tempo limite: no momento, o aplicativo de área de trabalho não tem um valor de tempo limite configurável que desconecte a conexão entre o servidor Experience Manager e o aplicativo de área de trabalho após um intervalo de tempo fixo. Ao fazer upload de ativos grandes, se a conexão atingir o tempo limite após um tempo, o aplicativo tentará fazer upload do ativo algumas vezes, aumentando o tempo limite do upload. Não há uma maneira recomendada de alterar as configurações padrão de tempo limite.

Como solucionar problemas troubleshooting-prep

Para solucionar problemas do aplicativo de desktop, esteja ciente das seguintes informações. Além disso, ele prepara você para encaminhar melhor os problemas ao Suporte ao cliente do Adobe, caso deseje obter suporte.

Local dos arquivos de log check-log-files-v2

Dependendo do sistema operacional, o aplicativo de desktop Experience Manager armazena seus arquivos de log nos seguintes locais:

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

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

Ao carregar muitos ativos, se alguns arquivos não forem carregados, consulte o arquivo backend.log para identificar os uploads com falha.

NOTE
Ao trabalhar com o Suporte ao cliente do Adobe em uma solicitação de suporte ou tíquete, você pode ser solicitado a compartilhar os arquivos de log para ajudar a equipe de Suporte ao cliente a entender o problema. Arquive toda a pasta Logs e compartilhe-a com o contato do Suporte ao Cliente.

Alterar nível de detalhes nos arquivos de log level-of-details-in-log

Para alterar o nível de detalhes nos arquivos de log:

  1. Certifique-se de que o aplicativo não esteja em execução.

  2. No sistema Windows:

    1. Abra uma janela de comando.

    2. Inicie o aplicativo de desktop Adobe Experience Manager executando o comando:

    code language-shell
    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 de desktop Adobe Experience Manager executando o comando:

    code language-shell
    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. O detalhamento dos logs é mais alto em DEBUG e mais baixo em ERROR.

Ativar modo de depuração enable-debug-mode

Para solucionar problemas, você pode ativar o modo de depuração e obter mais informações nos logs.

NOTE
Os níveis de log válidos são DEBUG, INFO, WARN ou ERROR. O detalhamento dos logs é mais alto em DEBUG e mais baixo 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 de desktop Experience Manager 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 de desktop Experience Manager executando o seguinte comando:

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

Conhecer a versão do aplicativo de desktop Adobe Experience Manager know-app-version-v2

Para ver o número da versão:

  1. Inicie o aplicativo.

  2. Clique nas reticências no canto superior direito, passe o mouse sobre Help e clique em About.

    O número da versão está listado nesta tela.

Limpar o cache clear-cache-v2

Execute as seguintes etapas:

  1. Inicie o aplicativo e conecte a uma instância de Experience Manager.

  2. Abra as preferências do aplicativo clicando nas reticências no canto superior direito e selecionando Preferences.

  3. Localize a entrada que exibe o Current Cache Size. Clique no ícone de lixeira ao lado desse elemento.

Para limpar o cache manualmente, faça o seguinte:

CAUTION
Essas etapas são uma operação potencialmente destrutiva. Se houver alterações de arquivo local que não foram carregadas em Adobe Experience Manager, elas serão perdidas.

O cache é limpo excluindo o diretório de cache do aplicativo, que se encontra nas preferências do aplicativo.

  1. Inicie o aplicativo.

  2. Abra as preferências do aplicativo selecionando as reticências no canto superior direito e Preferences.

  3. Anote o valor Cache Directory.

    Neste diretório, há subdiretórios nomeados de acordo com os Pontos de Extremidade Adobe Experience Manager Codificados. Os nomes são uma versão codificada da URL Adobe Experience Manager de destino. Por exemplo, se o aplicativo for direcionado a localhost:4502, o nome do diretório será localhost_4502.

Para limpar o cache, exclua o diretório de Ponto de Extremidade Adobe Experience Manager Codificado desejado. Como alternativa, a exclusão de todo o diretório especificado nas preferências limpa o cache de todas as instâncias que foram usadas pelo aplicativo.

Limpar o cache do aplicativo de desktop Adobe Experience Manager é uma tarefa preliminar de solução de problemas que pode resolver vários problemas. Limpe o cache nas preferências do aplicativo. Consulte definir preferências. O local padrão da pasta de cache é:

Não é possível ver os ativos colocados placed-assets-missing

Se você não conseguir ver os ativos que você ou outros profissionais de criação colocaram nos arquivos de suporte (ou seja, arquivos INDD), verifique o seguinte:

  • Conexão com o servidor. A conectividade instável da rede pode paralisar os downloads de ativos.

  • Tamanho do arquivo. Os ativos grandes demoram mais para serem baixados e exibidos.

  • Consistência da letra de unidade. Se você ou outro colaborador tiver colocado os ativos ao mapear o DAM Experience Manager 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 colocados, contate o administrador do Experience Manager.

Edições feitas em arquivos na interface do usuário do aplicativo de desktop não se refletem no Adobe Experience Manager imediatamente changes-on-da-not-visible-on-aem

O aplicativo de desktop Adobe Experience Manager 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 aplicativo foi projetado para minimizar o número de transferências de arquivos, em vez de carregar automaticamente arquivos com base na conclusão estimada de edições. É recomendável que o usuário inicie a transferência do arquivo de volta para Adobe Experience Manager optando por carregar as alterações de um arquivo.

Problemas ao atualizar no macOS issues-when-upgrading-on-macos

Ocasionalmente, podem ocorrer problemas ao atualizar o aplicativo de desktop Experience Manager no macOS. As pastas de sistema herdadas do aplicativo de desktop Experience Manager causam esses problemas. As pastas impedem que novas versões do aplicativo de desktop Experience Manager sejam carregadas corretamente. Para solucionar esse problema, as seguintes pastas e arquivos podem ser removidos manualmente.

Antes de executar as etapas a seguir, arraste o aplicativo Adobe Experience Manager Desktop da pasta Aplicativos macOS para a Lixeira. Em seguida, abra o terminal, execute o comando a seguir 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 upload-fails

Se você estiver usando o aplicativo de desktop com o Experience Manager 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 connection-issues

Se você estiver com problemas gerais de conectividade, veja a seguir algumas maneiras de obter mais informações sobre o que o aplicativo de desktop Experience Manager está fazendo.

Verificar o log da solicitação

O aplicativo de desktop Experience Manager registra todas as solicitações enviadas, juntamente com o código de resposta de cada solicitação, em um arquivo de log dedicado.

  1. Abra request.log no diretório de log do aplicativo para ver essas solicitações.

  2. Cada linha no log representa uma solicitação ou uma resposta. As solicitações têm um caractere > seguido pela URL que foi solicitada. As respostas têm um caractere < seguido pelo código de resposta e pela URL solicitada. As solicitações e as respostas podem ser correspondidas usando o GUID de cada linha.

Solicitações de verificação carregadas pelo navegador inserido do aplicativo

A maioria das solicitações do aplicativo é encontrada no log de solicitações. No entanto, se não houver informações úteis, pode ser útil examinar as solicitações enviadas pelo navegador incorporado do aplicativo.
Consulte a seção SAML para obter instruções sobre como exibir essas solicitações.

A autenticação de login do SAML não está funcionando da-connection-issue-with-saml-aem

O aplicativo de desktop Experience Manager pode não se conectar à implantação do Adobe Experience Manager habilitada para SSO (SAML). O design do aplicativo tenta acomodar as variações e complexidades das conexões e dos processos de SSO. No entanto, uma configuração pode exigir solução de problemas adicional.

Às vezes, o processo SAML não redireciona de volta para o caminho solicitado originalmente. Ou o redirecionamento final é para um host diferente do configurado no aplicativo de desktop Adobe Experience Manager. Para verificar se esse não é o caso, faça o seguinte:

  1. Abra um navegador da Web. Acessar URL https://[aem_server]:[port]/content/dam.json.

  2. Faça logon na implantação Adobe Experience Manager.

  3. Quando o logon for concluído, verifique o endereço atual do navegador na barra de endereços. Ele deve corresponder exatamente ao URL inserido inicialmente.

  4. Verifique também se tudo antes de /content/dam.json corresponde ao valor de Adobe Experience Manager de destino configurado nas configurações do aplicativo de desktop Adobe Experience Manager.

O processo SAML de logon funciona corretamente de acordo com as etapas acima, mas os usuários ainda não podem fazer logon

A janela no aplicativo de desktop Adobe Experience Manager que exibe o processo de logon é simplesmente um navegador da Web que está exibindo a interface de usuário da Web da instância Adobe Experience Manager de destino:

  • A versão do Mac usa um WebView.

  • A versão para Windows usa o CefSharp baseado em Chromium.

Verifique se o processo SAML é compatível com esses navegadores.

Para solucionar mais problemas, é possível visualizar as URLs exatas 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 logon.

  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 o Mac:

    1. Em com.adobe.aem.desktop-nnnnnnnn-nnnnnn.log, qualquer número que esteja no nome de arquivo mais recente substitui n.

    2. Procure mensagens que comecem com "quadro carregado". Essas entradas também contêm o URL que o aplicativo carregou.

Observar a sequência de URL que está sendo carregada pode ajudar a solucionar problemas na extremidade do SAML para determinar o que está errado.

Problema de configuração do SSL ssl-config-v2

As bibliotecas que o aplicativo de desktop Experience Manager usa para comunicação HTTP usam imposição SSL estrita. Às vezes, uma conexão pode ter êxito usando um navegador, mas falha ao usar o aplicativo de desktop Experience Manager. 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 o aplicativo de desktop Experience Manager usa para comunicação HTTP usam imposição SSL estrita. Portanto, pode haver instâncias em que as conexões SSL bem-sucedidas por meio de um navegador falhem com o aplicativo de desktop Adobe Experience Manager. Esse resultado é 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 inspecionam um certificado de servidor fornecendo o URL.

Como medida temporária, é possível desabilitar a imposição estrita de SSL no aplicativo de desktop Adobe Experience Manager. Essa abordagem não é uma solução de longo prazo recomendada, pois reduz a segurança ao ocultar 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 do 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:

    code language-shell
    ...
    "assetRepository": {
        "options": {
    ...
    
  3. Modifique a seção adicionando "strictSSL": false da seguinte maneira:

    code language-shell
    ...
    "assetRepository": {
        "options": {
            "strictSSL": false,
    ...
    
  4. Salve o arquivo e reinicie o aplicativo de desktop Adobe Experience Manager.

Problemas de logon ao alternar para um servidor diferente cannot-login-cookies-issue

Depois de usar um servidor Experience Manager, ao tentar alterar a conexão para um servidor diferente, você pode encontrar problemas de logon. Isso se deve à interferência de cookies antigos na nova autenticação. Uma opção do menu principal para Clear Cookies ajuda. Faça logoff da sessão atual no aplicativo e selecione Clear Cookies antes de continuar a conexão.

Limpar cookies ao alternar o servidor

O aplicativo não está respondendo unresponsive

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 na interface do aplicativo e clique em Refresh.
  • Saia do aplicativo e abra-o novamente.

Em ambos os métodos, o aplicativo é iniciado na pasta raiz do DAM.

Ocultar ativos expirados hide-expired-assets

Ao navegar pelos ativos na interface do usuário do Experience Manager, os ativos expirados não são exibidos. Os administradores podem definir configurações para impedir a exibição, pesquisa e busca de ativos expirados ao navegar pelo aplicativo de desktop e pelo Asset Link. Isso garante que os ativos expirados não estejam acessíveis durante essas operações. A configuração funciona para todos os usuários, independentemente do privilégio de administrador.

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