Solução de problemas do Agente de modernização de experiência troubleshooting
Encontre o sintoma e siga sua seção. A maioria dos problemas vem do acesso ao site de origem, das contas que gravam código e conteúdo no site do Adobe Experience Manager Edge Delivery Services ou de uma diferença entre o espaço de trabalho do console e o que é salvo no Git e na fonte de conteúdo.
Antes de redefinir, descartar, substituir ou substituir qualquer item, preserve o trabalho afetado. O código e o conteúdo são recuperados separadamente; consulte Liberação, Recuperação e Entrega.
Se esta página não resolver o problema, solicite suporte no console ou selecione Obter ajuda nas páginas do modo Automático.
Falha ao importar import-fails
Mantenha o erro e o URL de origem exato e verifique se o URL abre em um navegador. Se as páginas exigirem entrada, ou se uma captura mostrar uma página de entrada em vez do conteúdo, configure a autenticação de site protegida. Se o site de origem bloquear o acesso automatizado, consulte Source Sites com Proteção de Bot. Se a fonte estiver acessível, forneça o erro ao agente e peça que ele corrija a importação dessa página. Tente novamente uma página afetada antes de repetir um lote.
Source Sites com proteção de bot bot-protection
A proteção de bot em uma rede de entrega de conteúdo (CDN) ou em um firewall de aplicativo da Web (WAF) pode bloquear ou desafiar as solicitações do agente para um site de origem em cada fluxo de trabalho: descoberta de URL, catálogo do site, captura de página e importação. Sinais típicos são erros de acesso negado, como HTTP 403, 429 ou 503, URLs ausentes após a descoberta, páginas com falha ou uma página de desafio ou verificação capturada em vez do conteúdo da página.
Migre somente os sites que você possui ou que estão autorizados a migrar. Organize o acesso com o administrador do site em vez de trabalhar com a proteção:
- Peça ao administrador para permitir o acesso pelo período de migração, por exemplo, WAF os endereços de back-end na CDN ou no incluir na lista de permissões.
- Se, em vez disso, a proteção aceitar uma credencial, como um cabeçalho de solicitação secreta, insira-a nos controles de autenticação oferecidos pelo seu fluxo de trabalho, como Autenticação de site protegida nas configurações do console. Use uma credencial com escopo e remova-a quando a migração estiver concluída.
- Se o administrador fornecer um host de origem ou de preparo acessível com o mesmo conteúdo, use-o como a origem e registre de qual host o conteúdo veio.
- Se apenas a descoberta estiver bloqueada, forneça a lista de URLs de página que serão migrados.
Verifique uma página, incluindo suas imagens e outros ativos, antes de iniciar um catálogo ou execução em lote. Depois de alterar o acesso, tente novamente as páginas com falha e verifique as capturas de páginas de desafio ou acesso negado antes de aceitar o conteúdo.
Incluir na lista de permissões Endereços IP allowlist-ip-addresses
Com a aprovação do administrador do site de origem, inclua na lista de permissões esses endereços de backend para a extração de origem:
34.228.136.11254.90.51.393.224.194.242
Os Incluir na lista de permissões do fornecem somente acesso à rede: a origem ainda deve estar acessível pela internet e as páginas protegidas ainda precisam da Autenticação de Site Protegida.
Uma Alteração Está Ausente missing-change
O código e o conteúdo são salvos em locais diferentes, portanto, marque cada um deles: o espaço de trabalho do console, o conteúdo carregado, a ramificação enviada e a página visualizada. Uma reimportação substitui as alterações de conteúdo local; portanto, carregue ou reconcilie as edições antes de importar uma página novamente. Para comparar a visualização do console com o site de visualização, consulte Visualização do Console Difere do Site.
A visualização do console é diferente do site preview-differs
A visualização do console e o site de visualização renderizam diferentes cópias do conteúdo e do código, como Saiba qual resultado você está visualizando explica. Procure uma dessas causas:
- Conteúdo não carregado: páginas alteradas no console ainda não estão no Experience Workspace. Carregue-os com Sincronizar > Push > Conteúdo.
- Conteúdo editado em outro lugar: Páginas alteradas no Experience Workspace ainda não estão no espaço de trabalho do console. Pull com Sync > Pull > Content, que substitui edições locais para essas páginas; Refresh apenas recarregará a renderização.
- Código diferente: O código não é enviado por push ou a URL de visualização usa outra ramificação. Pressione o código e abra o URL de visualização da ramificação que o contém.
- Largura diferente: a visualização do console preenche o painel por padrão. Compare na mesma largura, usando o menu Viewport.
- Marcação removida pelo site de visualização: o Edge Delivery Services mantém somente seções, blocos e conteúdo padrão, portanto, o estilo dentro da marcação da página é perdido. Peça ao agente para movê-lo para o CSS do projeto. Consulte Como funciona a visualização.
Falha nas gravações de conteúdo write-errors
O código e o conteúdo usam contas diferentes. O código é enviado por meio de sua conexão GitHub ou de sua conexão Cloud Manager para outros hosts Git. O conteúdo é gravado na Experience Workspace com a conta da Adobe com a qual você fez logon. Um push de código pode, portanto, ser bem-sucedido enquanto um upload de conteúdo falhar, ou o contrário.
Se um upload, pull ou transferência indicar que a sessão de Criação de documentos expirou, entre novamente e tente novamente. O console mostra a mesma mensagem quando a sessão é válida, mas sua conta do Adobe não tem acesso de gravação ao conteúdo do site. Se persistir, peça ao administrador do site para confirmar que sua conta, com o endereço de email e a organização usados no console, pode gravar no site no Experience Workspace. O acesso ao Experience Manager no Adobe Admin Console não concede acesso de gravação ao conteúdo de um site. Se o console indicar que você tem taxa limitada, aguarde um minuto e tente novamente.
Problemas de conexão do Git git-connection
Para ver o que cada aplicativo GitHub faz, consulte Iniciar de um Repositório.
https://{branch}--{site}--{organization}.aem.page.Para alterações conflitantes e ramificações protegidas, consulte Alterações do código de push.
A configuração do Workspace leva tempo ou falha workspace-setup
A preparação de um espaço de trabalho leva até 10 minutos, na primeira vez que você entra e após uma redefinição. Se todos os espaços de trabalho estiverem em uso, o console informará isso e começará a configurar o seu assim que um estiver disponível; não será necessário tentar novamente. Se precisar dele antes, selecione Solicitar suporte. Se a configuração falhar, o console se oferece para tentar novamente. Se continuar falhando, use o link Solicitar suporte na tela de configuração. Se o console informar que sua conta não pode usá-lo, entre em contato com a equipe de conta da Adobe. Para um espaço de trabalho que mostra Seu espaço de trabalho está pausado, consulte Abrir o Console de Modernização da Experiência.
O projeto parece estar ausente missing-workspace
Se você pertencer a várias organizações da Adobe, o projeto poderá estar no espaço de trabalho do console de outra organização. Faça logoff, entre com a mesma conta e escolha o perfil da organização que você usou antes. Não redefina o espaço de trabalho enquanto investiga: uma redefinição exclui o trabalho que você não enviou. Se o projeto ainda estiver ausente, solicite suporte com o nome do projeto e a URL de visualização. O código enviado e o conteúdo carregado estão seguros no repositório Git e na fonte de conteúdo de qualquer maneira.
Falha ao enviar mensagem send-failed
Falha ao enviar mensagem. Tente novamente. significa que o console não pôde entregar seu prompt ao agente. A mensagem não fornece a causa, que pode ser sua conexão de rede, um logon expirado ou um problema de serviço temporário.
- Verifique sua conexão de rede e envie o prompt novamente. O console não tenta novamente automaticamente.
- Se falhar novamente, copie o prompt, recarregue a página e entre, se solicitado. Seu histórico de bate-papo é mantido.
- Se ainda falhar após alguns minutos, use Solicitar suporte em Configurações, com a hora da falha e o nome do seu projeto.
Se, em vez disso, o console indicar que está na capacidade total, consulte A instalação do Workspace leva tempo ou falha.
Remover páginas remove-pages
Uma proteção no console impede que o agente exclua arquivos na pasta de conteúdo do projeto, para que o conteúdo migrado não seja removido por engano. Solicitar que o agente exclua páginas, portanto, não funciona. Remova-os você mesmo, em cada lugar onde eles existem:
- Espaço de trabalho do console: Em uma exibição de conteúdo, selecione a página e use Excluir, uma página de cada vez. Isso remove apenas a cópia do espaço de trabalho do console.
- Fonte de conteúdo: exclua as páginas carregadas na Experience Workspace ou na instância do autor. Até que você faça isso, uma página excluída no console reaparecerá na exibição de conteúdo com um ícone de nuvem.
- Visualizar e sites ao vivo: Desfazer a publicação ou excluir páginas visualizadas e publicadas com o AEM Sidekick.
Se as páginas foram importadas para o caminho errado, importe-as novamente para o caminho correto, verifique-as e exclua as cópias no caminho errado.