Planejar uma migração com o catálogo do site site-catalog-skill

O catálogo do site do Agente de modernização de experiência lista as páginas de um site que você está autorizado a migrar e as agrupa antes de qualquer importação. Páginas que compartilham um layout de blocos formam um modelo. Blocos semelhantes em todas as páginas formam uma variante de bloco: uma versão de um bloco que difere na estrutura do conteúdo ou na aparência. Na importação, uma variante cujos campos diferem se torna um bloco próprio. Com esse agrupamento, você migra e verifica uma página de amostra por modelo e, em seguida, importa o restante do modelo em massa. Os modelos, blocos e localidades encontrados pelo catálogo também fornecem uma estimativa do projeto, e seu relatório pode ser compartilhado com as partes interessadas que não usam o console.

O catálogo lê o site de origem e não importa nada. Para todo o fluxo de trabalho de migração, consulte Migrar um Site de Produção.

Iniciar planejamento invoking

Verifique se você está autorizado a ler o site de origem e se o console pode acessá-lo. Em seguida, comece a planejar no Console de Modernização da Experiência das seguintes maneiras:

  • Abra o modo de exibição de Planejamento. Se o projeto ainda não tiver um plano, ele mostrará Planejar a migração. Digite o endereço do site e selecione Planejar minha migração. Comece com a home page; o agente encontra as outras páginas.

  • Pergunte ao agente no chat:

    scope site https://www.example.com

Enquanto o Planning é executado, o modo de exibição Planning mostra Planejando sua migração com a etapa atual, o número de páginas encontradas e lidas e o tempo decorrido. Você pode revisar os resultados antes que a execução seja concluída.

O agente analisa todas as páginas que encontra. Quando encontra mais de 1.000 páginas, informa aproximadamente quanto tempo levará a análise, e continua. Em um site muito grande, peça ao agente para propor como dividir a migração e, em seguida, catalogar as seções escolhidas.

Para interromper uma execução, use o controle de interrupção no chat. O modo de exibição Planning mostra O Planning parou antes de terminar e você pode continuar de onde parou ou recomeçar. A thread do chat mostra o que aconteceu antes de parar.

O planejamento é executado em quatro fases:

  1. Análise: o agente carrega cada página, faz uma captura de tela e divide a página em blocos com base em seu conteúdo editável pelo autor. As capturas de tela deixam de fora banners de cookies e outras grandes caixas de diálogo que cobrem a página. A análise deixa de fora o cabeçalho e o rodapé do site, porque um site do Edge Delivery Services os cria uma vez a partir de navegação separada e conteúdo de rodapé.
  2. Catálogo de blocos: o agente agrupa blocos semelhantes entre páginas em variantes de blocos, mapeia cada variante para um bloco da biblioteca de blocos e a nomeia.
  3. Modelo: o agente agrupa páginas que compartilham o mesmo layout de blocos em candidatos a modelo.
  4. Nomeação: o agente mescla candidatos a modelo estruturalmente iguais e dá a cada modelo um nome significativo.

Resultados e Status output

Quando a execução for concluída, o agente postará um resumo no bate-papo: o número de páginas, modelos e variantes de blocos, um detalhamento por localidade e o status da execução. A exibição Planning mostra o mesmo status.

Status
Significado
concluído
Todas as páginas foram analisadas ou 10% ou menos falharam.
incompleto
Mais de 10% das páginas falharam ou a detecção de blocos falhou em mais da metade delas. Os resultados são úteis, mas parciais.
falhou
Nenhuma página foi analisada.

Uma execução de concluída ainda pode ter páginas com falha, portanto, revise as URLs com falha de qualquer forma. Compare os URLs descobertos com o escopo acordado: páginas que não têm links para precisarem de uma decisão própria. Separe as contagens de páginas descobertas, analisadas, importadas e aprovadas.

A Visão de Planejamento planning-ui

O modo de exibição Planejamento do painel do espaço de trabalho mostra os modelos, as páginas e os blocos que o agente identificou, com capturas de tela, para que você possa corrigi-los antes de migrar. Cada etapa posterior se baseia nesse agrupamento, portanto, revise-o antes de importar páginas. A exibição não está relacionada ao modo de chat Plan, no qual o agente propõe sua abordagem para uma solicitação antes de alterar qualquer arquivo.

Abrir a Exibição de Planejamento accessing-planning-ui

  • No cabeçalho do painel do espaço de trabalho, abra o seletor de exibições e selecione Planejamento em Projeto. Está sempre lá; você não precisa ativá-lo.
  • Ir para https://aemcoder.adobe.io/chat/project/plan.
  • Quando uma execução for concluída, selecione Exibir plano na notificação Seu plano de migração está pronto.

Selecionando a exibição do Planning no seletor de exibição

Se você não tiver catalogado um site no projeto atual, a exibição solicitará o endereço do site para que você possa iniciar o planejamento.

A exibição mostra um plano de migração por espaço de trabalho de console, dos arquivos na pasta catalog/. Não é possível manter vários planos lado a lado, por exemplo, um por site de país. Planeje e migre os sites um após o outro e baixe o conjunto de relatórios de cada plano se quiser manter um registro dele.

Painel dashboard

O painel resume o site catalogado. Seu cabeçalho mostra o título do site, o status de execução e a data da análise. Selecione Abrir site no cabeçalho do espaço de trabalho para abrir o site de origem em uma nova guia.

Painel de planejamento do site

Os cartões de painel mostram:

  • Conteúdo: as URLs descobertas, os modelos identificados, as páginas analisadas e os documentos encontrados.
  • Páginas: As páginas analisadas e com falha, e como as URLs foram descobertas, por exemplo, a partir do mapa de site ou pelos links a seguir. Selecione a contagem de falhas para abrir as URLs com falha.
  • Blocos: os blocos e variantes de blocos identificados.
  • Localidades: As páginas por localidade. Este cartão é exibido apenas para um site com mais de uma localidade.

Abaixo dos cartões, um alternador alterna a tabela entre Modelos, com a descrição e o número de páginas de cada modelo, e Blocos, com cada bloco e suas variantes. Selecione um nome de modelo para abrir seus detalhes do modelo, ou uma variante para ver suas instâncias. Ambas as tabelas podem ser pesquisadas e classificadas. Selecione Expandir tabela para ocultar os cartões e dar mais espaço à tabela.

Tabela de blocos blocks-table

A tabela de blocos mostra uma linha expansível por bloco, com as variantes do bloco aninhadas abaixo. Para cada bloco, ele mostra o número de variantes, páginas e modelos em que é encontrado e seu status do código.

Tabela de blocos na exibição do Planning

Cada bloco mostra seu nome e o tipo de bloco da biblioteca de blocos em que ele se baseia, por exemplo, um bloco cards-story do tipo cards. Suas variantes são listadas abaixo por sua classe de variante, como .with-button. Uma variante sem uma classe é o padrão do bloco. O cabeçalho da página, o rodapé e o conteúdo padrão, como títulos simples e texto, não são listados como blocos.

A coluna Código mostra se o código foi gerado para o bloco.

Status
Significado
Pronto
O código de bloco foi gerado.
Precisa ser atualizado
O código de bloco existe, mas ainda não abrange todas as variantes do bloco.
Não está pronto
O código de bloqueio ainda não foi gerado.
Nome inválido
O nome do bloco ou da variante não pode ser usado como uma pasta de blocos ou nome de classe CSS. Renomeie o bloco ou a variante para corrigi-lo.
Não classificado
O tipo de bloco não foi identificado, portanto, nenhum código será gerado para ele. Use Classificar tipo de bloco para corrigir.

Pronto significa apenas que o código existe. Se os autores podem editar o bloco e se ele funciona fazem parte das verificações antes do lançamento.

A coluna Confidence mostra como o agente tem certeza de que uma variante de bloco foi agrupada e classificada corretamente:

  • Alto ou Baixo é definido pelo catálogo. Selecione o ícone de informações ao lado do nível para ler o motivo. Revise primeiro as variantes Baixo.
  • Usuário significa que uma pessoa confirmou ou alterou a variante, por exemplo, por meio de uma revisão guiada ou uma ação de refinamento.

Depois que o código tiver sido gerado com conteúdo de exemplo, selecione Exibir exemplo no menu de ações de um bloco para abrir a página de exemplo do bloco na visualização.

Os detalhes do modelo e da página mostram a mesma tabela de blocos, limitada a esse modelo ou página.

Detalhes do modelo template-details

Selecione um modelo para ver todas as páginas que o utilizam, com o caminho, o título e o número de blocos da página. Selecione um caminho de página para abrir seus detalhes de página. Use o botão de alternância Páginas / Blocos para alternar para os blocos que o modelo usa.

Detalhes do modelo no modo de exibição de Planejamento

Quando as páginas de um modelo estiverem sendo migradas, o modelo mostrará quantas páginas foram importadas e quantas falharam, e cada página mostrará o status de importação. O status é atualizado enquanto a importação é executada.

Status
Significado
Importado
Página importada. Selecione o rótulo para abrir a página importada na pré-visualização.
Falha ao importar
Falha na importação. O motivo é mostrado no status.
Não importado
A página faz parte da migração, mas ainda não foi importada.

Um traço significa que o modelo da página não faz parte da migração atual.

Detalhes da página page-details

Detalhes da página listam os blocos encontrados na página, com detalhes da análise como o número de seções e blocos. Selecione Exibir captura de tela no cabeçalho para ver a captura de tela de página inteira. Selecione Localizar na página em uma variante de bloco para ver a captura de tela com esse bloco realçado.

Detalhes da página no modo de exibição de Planejamento

Instâncias variantes variant-instances

Selecione uma variante de bloco para ver cada instância dela no site lado a lado, com o número de instâncias, páginas e modelos nos quais ela aparece. Uma instância no grupo errado se destaca.

Instâncias variantes na exibição do Planning

O menu de ações de cada instância permite visualizar a captura de tela, localizá-la na página, abrir os detalhes da página ou abrir a página de origem.

Para corrigir o agrupamento, selecione uma ou mais instâncias e escolha uma destas ações:

  • Dividir em uma nova variante: Move as instâncias selecionadas para uma nova variante.
  • Mover para outra variante: Move as instâncias selecionadas para uma variante existente.

Pelo menos uma instância deve permanecer na variante original. Para mover cada instância de uma variante, use Dar a esta variante seu próprio bloco ou Torná-la uma variante de outro bloco na variante. As alterações de divisão e movimentação são mantidas quando o catálogo é gerado novamente.

URLs com falha failed-urls

A lista de URLs com falha mostra cada página que não pôde ser analisada, com o motivo e a hora. Os arquivos que não são páginas, como imagens e documentos, são ignorados, contados separadamente e não são listados.

Revisar o catálogo review-catalog

Ao concluir o planejamento, o agente oferece a Analisar os resultados do escopo. Use-o como ponto de partida para verificar o catálogo, especialmente em sites grandes.

  1. Escolha Revisar cada etapa para responder às perguntas do agente ou Piloto automático para deixá-lo decidir.
  2. Primeiro, o agente corrige problemas que têm apenas uma resposta sensata e informa o que mudou. Por exemplo, ela move outliers para a variante onde eles se encaixam, transforma links e botões solitários em texto de página, combina variantes semelhantes e corrige nomes inválidos.
  3. Em seguida, ele pergunta sobre os itens restantes, um de cada vez, começando com erros claros. Cada pergunta mostra as capturas de tela e a sugestão do agente e você responde em uma etapa. Pergunte por quê se você quer o seu raciocínio.
  4. Selecione Concluir para mim em qualquer etapa para permitir que o agente conclua o restante da revisão sem mais perguntas.
  5. A revisão termina com um breve relatório sobre o que foi alterado e o que deve ser verificado no plano. Os itens sobre os quais o agente ainda não tem certeza são deixados inalterados e sinalizados. Selecione Revisar itens restantes para continuar com eles ou Iniciar migração de site quando o catálogo estiver pronto.

A revisão altera somente o catálogo. Ele não importa páginas nem gera código.

Iniciar migração do site migra um modelo de cada vez. O agente pergunta com qual modelo começar e, em seguida, usa as páginas e os blocos do catálogo para ele. Verifique as páginas desse modelo antes de continuar com a próxima e corrija algumas delas.

Refinamento do catálogo planning-actions

Abrir o menu de ações (…) de qualquer modelo, página, bloco ou variante e selecione ações de IA para ver as ações disponíveis para elas. Você também pode selecionar até 20 itens para atuarem em conjunto.

Quando você escolhe uma ação, o console adiciona os itens selecionados ao bate-papo com uma solicitação. Analise seu escopo e quaisquer alterações propostas antes de confirmar. Você também pode escolher Adicionar ao chat e escrever seu próprio prompt, incluindo o que não deve ser alterado e se o agente pode carregar conteúdo.

Item
Ações
Modelo
Migrar modelo para AEM, Renomear modelo, Adicionar páginas ao modelo, Criar um novo modelo a partir de um subconjunto, Sugerir refatores estruturais
Página
Migrar página para AEM, Mover para outro modelo, Revisar estrutura da página
Bloco
Gerar código de bloco, Classificar tipo de bloco, Renomear bloco, Tornar esta uma variante de outro bloco
Bloquear variante
Renomear variante, Dar a esta variante seu próprio bloco, Tornar esta uma variante de outro bloco
Bloquear em uma página
Classificar tipo de bloco
Instâncias variantes
Dividir em uma nova variante, Mover para outra variante

Algumas ações mostram somente onde se aplicam. Por exemplo, Gerar código de bloco e Renomear bloco estão disponíveis somente para blocos cujo tipo foi classificado, e Dar a esta variante seu próprio bloco somente para variantes que tenham uma classe de variante.

Em Migrar página para AEM e Migrar modelo para AEM, AEM refere-se ao projeto conectado ao console. O conteúdo importado permanece no espaço de trabalho do console até que você o carregue: no Experience Workspace para projetos baseados em documento ou na instância de criação para criação no Experience Manager.

As correções de agrupamento e nomenclatura alteram o catálogo, não as páginas que você já importou. Gerar código de bloco altera o código e as ações de migração importam conteúdo, portanto, revise sua saída separadamente. Uma refatoração estrutural no catálogo não é uma refatoração de código de bloco; para isso, consulte Refatorar sem alterar o resultado.

Reexecutar uma fase additional-prompts

Para executar novamente uma fase, por exemplo, depois que o site de origem tiver sido alterado, peça ao agente para repeti-la pelo nome:

repeat block cataloging

O agente também executa novamente cada fase posterior e mantém as anteriores. As alterações feitas no modo de exibição Planejamento, como divisão ou movimentação de instâncias de bloco, são mantidas.

Se a exibição Planning mostrar O catálogo de Bloqueios está desatualizado, o catálogo foi criado em um formato anterior que a versão atual não pode ler. Execute o planejamento novamente a partir do chat com scope site e o endereço do site. Se o planejamento for interrompido antes de ser concluído, o Recomeçar no modo de exibição Planejamento também iniciará uma nova execução para o mesmo site.

Fluxo de trabalho de importação em massa bulk-import

Para migrar um modelo de site completo por modelo:

  1. Execute o catálogo de sites para obter os modelos e bloquear variantes.
  2. Revise-as no modo de exibição de Planejamento e corrija todas as que foram identificadas incorretamente. A revisão guiada é a maneira mais rápida de começar.
  3. Gere o código dos blocos necessários. Você pode selecionar vários blocos e gerar código apenas para eles.
  4. Para cada modelo, abra os detalhes do modelo e use a Página de migração para o AEM em uma ou duas páginas de exemplo. Refine a importação até que a saída esteja correta.
  5. Use Migrar modelo para o AEM para importar as páginas restantes desse modelo. Siga o status de importação de cada página e tente novamente as páginas com falha depois de corrigir a causa.
  6. Repita o procedimento para cada modelo.

Se a saída de um modelo estiver incorreta, corrija-a em uma página de exemplo antes de importar mais páginas. Se a análise falhar, verifique as URLs com falha, corrija o acesso de origem e tente novamente essas páginas. Importar uma página novamente substitui as edições que os autores fizeram nela desde então; consulte Importar em Lotes.

Arquivos do catálogo catalog-files

A maioria dos usuários precisa apenas da exibição do Planning. Para compartilhar um relatório offline ou usar os dados em outras ferramentas, localize a saída bruta na pasta catalog/ do seu projeto.

Arquivo
Descrição
template-catalog-report-bundle.zip
Um relatório interativo do HTML com capturas de tela que você pode baixar, abrir localmente e compartilhar com as partes interessadas que não usam o console
summary.json
Totais e status da execução
template-catalog.json
Cada modelo com os URLs que o usam
block-catalog.json
Cada variante de bloco com seu nome, tipo e capturas de tela
urls-all.json
Cada URL descoberto
catalog.log
Log de execução

A pasta também contém arquivos intermediários, incluindo análise por página e capturas de tela em .pages/ e metadados por variante em .blocks/.

Limitações limitations

  • Acesso ao Source: o agente lê a origem de seu ambiente hospedado, portanto, entrar na origem em seu próprio navegador não lhe dá acesso. Para páginas que exigem entrada ou um cabeçalho secreto, configure a autenticação de site protegida e verifique uma página protegida antes de iniciar uma execução completa. Não presuma que a autenticação configurada para o modo Automático também se aplica à catalogação. Se a origem bloquear visitantes automatizados, consulte Source Sites com Proteção de Bot.
  • Conteúdo por trás das interações: o catálogo carrega cada página em um navegador, como faz a importação, de modo que o conteúdo que aparece somente depois que um visitante clica ou digita não é capturado. Verifique as capturas de tela em relação à origem. Consulte Limitações.
  • Cobertura: a descoberta usa o mapa do site ou segue links da página inicial, de modo que não encontra páginas que nem listam nem vinculam, como páginas de aterrissagem de campanha. Compare o resultado com sua própria lista de URLs e registre falhas, URLs ausentes e exclusões aprovadas.

Para entregar a análise, registre sua data, o escopo de origem, o relatório, suas correções, as URLs não resolvidas e as páginas de exemplo que você marcou na entrega do projeto.

recommendation-more-help
experience-manager-cloud-service-help-main-toc