Planificar una migración con el catálogo del sitio site-catalog-skill
El catálogo de sitios de Experience Modernization Agent enumera las páginas de un sitio que tiene autorización para migrar y las agrupa antes de importar nada. Las páginas que comparten un diseño de bloques forman una plantilla. Bloques similares en todas las páginas forman una variante de bloque: una versión de un bloque que difiere en la estructura o el aspecto del contenido. En la importación, una variante cuyos campos son diferentes se convierte en un bloque propio. Con esta agrupación, migre y compruebe una página de muestra por plantilla y, a continuación, importe el resto de la plantilla de forma masiva. Las plantillas, los bloques y las configuraciones regionales que encuentra el catálogo también le dan una estimación del proyecto, y su informe se puede compartir con las partes interesadas que no usen la consola.
El catálogo lee el sitio de origen y no importa nada. Para todo el flujo de trabajo de migración, consulte Migrar un sitio de producción.
Iniciar planificación invoking
Compruebe que tiene autorización para leer el sitio de origen y que la consola puede llegar a él. A continuación, comience a planificar en la consola de modernización de la experiencia de cualquiera de estas formas:
-
Abra la vista de Planning. Si el proyecto aún no tiene ningún plan, se muestra Planifique la migración. Escriba la dirección del sitio y seleccione Planificar mi migración. Comience con la página de inicio; el agente encuentra las otras páginas.
-
Pregunte al agente en el chat:
scope site https://www.example.com
Mientras se ejecuta la planificación, la vista Planning muestra Planificando la migración con el paso actual, el número de páginas encontradas y leídas, y el tiempo transcurrido. Puede revisar los resultados antes de que finalice la ejecución.
El agente analiza todas las páginas que detecta. Cuando encuentra más de 1000 páginas, indica aproximadamente cuánto tiempo tardará el análisis y continúa. Para un sitio muy grande, pídale al agente que le proponga cómo dividir la migración y, a continuación, catalogar las secciones que elija.
Para detener una ejecución, utilice el control de detención del gráfico. A continuación, la vista Planificación muestra Planificación detenida antes de que finalice, y puede continuar desde donde lo dejó o volver a empezar. El hilo de chat muestra lo que ocurrió antes de que se detuviera.
La planificación se ejecuta en cuatro fases:
- Análisis: El agente carga cada página, toma una captura de pantalla y divide la página en bloques en función de su contenido editable por el autor. Las capturas de pantalla no incluyen banners de cookies ni otros cuadros de diálogo de gran tamaño que cubran la página. El análisis excluye el encabezado y el pie de página del sitio, ya que un sitio de Edge Delivery Services los crea una vez a partir de contenido de navegación y pie de página independientes.
- Catálogo de bloques: El agente agrupa bloques similares entre páginas en variantes de bloques, asigna cada variante a un bloque de la biblioteca de bloques y le asigna un nombre.
- Plantillas: El agente agrupa páginas que comparten el mismo diseño de bloques en candidatos a plantillas.
- Nomenclatura: El agente combina candidatos de plantilla que son estructuralmente iguales y le da a cada plantilla un nombre significativo.
Resultados y estado output
Cuando finaliza la ejecución, el agente publica un resumen en el chat: el número de páginas, plantillas y variantes de bloque, un desglose por configuración regional y el estado de la ejecución. La vista Planning muestra el mismo estado.
Una ejecución de complete puede seguir teniendo páginas con errores, así que revise las direcciones URL con errores de todos modos. Compare las direcciones URL descubiertas con el ámbito acordado: las páginas que no tienen vínculos para necesitar una decisión propia. Mantenga separados los recuentos de páginas descubiertas, analizadas, importadas y cerradas.
La vista de Planning planning-ui
La vista Planning del panel del área de trabajo muestra las plantillas, páginas y bloques que el agente identificó con capturas de pantalla para que pueda corregirlos antes de migrar. Cada paso posterior se basa en esta agrupación, por lo que debe revisarla antes de importar páginas. La vista no está relacionada con el modo Plan del chat, en el que el agente propone su enfoque a una solicitud antes de cambiar los archivos.
Abrir la vista de Planning accessing-planning-ui
- En el encabezado del panel del área de trabajo, abra el selector de vistas y seleccione Planificación en Proyecto. Siempre está ahí; no es necesario que lo encienda.
- Vaya a
https://aemcoder.adobe.io/chat/project/plan. - Cuando finalice una ejecución, selecciona Ver plan en la notificación Su plan de migración está listo.
Si no ha catalogado un sitio en el proyecto actual, la vista le pide la dirección del sitio para que pueda comenzar a planear.
La vista muestra un plan de migración por espacio de trabajo de la consola, a partir de los archivos de la carpeta catalog/. No puede mantener varios planes en paralelo, por ejemplo, uno por sitio de país. Planifique y migre los sitios uno tras otro y descargue el paquete de informes de cada plan si desea mantener un registro de él.
Panel de control dashboard
El tablero resume el sitio catalogado. Su encabezado muestra el título del sitio, el estado de ejecución y la fecha de análisis. Seleccione Abrir sitio en el encabezado del área de trabajo para abrir el sitio de origen en una nueva pestaña.
Las tarjetas del tablero muestran:
- Contenido: se detectaron direcciones URL, se identificaron plantillas, se analizaron páginas y se encontraron documentos.
- Páginas: Las páginas analizadas y con errores, y cómo se descubrieron las direcciones URL, como del mapa del sitio o mediante los siguientes vínculos. Seleccione el recuento de errores para abrir las direcciones URL con errores.
- Bloques: Los bloques y las variantes de bloque identificados.
- Configuraciones regionales: Las páginas por configuración regional. Esta tarjeta solo se muestra para un sitio con más de una configuración regional.
Debajo de las tarjetas, un conmutador cambia la tabla entre Plantillas, con la descripción y el número de páginas de cada plantilla, y Bloques, con cada bloque y sus variantes. Seleccione un nombre de plantilla para abrir sus detalles de plantilla o una variante para ver sus instancias. Ambas tablas se pueden buscar y ordenar. Seleccione Expandir tabla para ocultar las tarjetas y dar más espacio a la tabla.
Tabla de bloques blocks-table
La tabla de bloques muestra una fila expansible por bloque, con las variantes del bloque anidadas debajo. Para cada bloque, muestra el número de variantes, páginas y plantillas en las que se encuentra y su estado de código.
Cada bloque muestra su nombre y el tipo de bloque de la biblioteca de bloques en la que se basa, por ejemplo un bloque cards-story de tipo cards. Sus variantes se enumeran debajo de por su clase de variante, como .with-button. Una variante sin clase es la predeterminada del bloque. El encabezado de página, el pie de página y el contenido predeterminado, como los encabezados sin formato y el texto, no se muestran como bloques.
La columna Código muestra si se ha generado código para el bloque.
Listo significa solamente que el código existe. Si los autores pueden editar el bloque y si funciona son parte de las comprobaciones antes de la versión.
La columna Confianza muestra la seguridad del agente de que una variante de bloque se agrupó y clasificó correctamente:
- Alto o Bajo se establece mediante catalogación. Seleccione el icono de información situado junto al nivel para leer el motivo. Revise primero las variantes Low.
- Usuario significa que una persona ha confirmado o cambiado la variante, por ejemplo a través de una revisión guiada o una acción de refinamiento.
Una vez generado el código con contenido de muestra, seleccione Ver muestra en el menú de acciones de un bloque para abrir la página de muestra del bloque en la vista previa.
Los detalles de plantilla y página muestran la misma tabla de bloques, limitada a esa plantilla o página.
Detalles de la plantilla template-details
Seleccione una plantilla para ver todas las páginas que la utilizan, con la ruta de la página, el título y el número de bloques. Seleccione una ruta de página para abrir sus detalles de página. Use la opción Páginas / Bloques para cambiar a los bloques que usa la plantilla.
Una vez que se migran las páginas de una plantilla, la plantilla muestra cuántas páginas se importaron y cuántas fallaron, y cada página muestra su estado de importación. El estado se actualiza mientras se ejecuta la importación.
Un guión significa que la plantilla de la página no forma parte de la migración actual.
Detalles de página page-details
Los detalles de la página enumeran los bloques encontrados en la página, con detalles del análisis como el número de secciones y bloques. Seleccione Ver captura de pantalla en el encabezado para ver la captura de pantalla de la página completa. Seleccione Localizar en la página de una variante de bloque para ver la captura de pantalla con ese bloque resaltado.
Instancias de variante variant-instances
Seleccione una variante de bloque para ver cada instancia en el sitio en paralelo, con la cantidad de instancias, páginas y plantillas en las que aparece. Se destaca una instancia en el grupo incorrecto.
El menú de acciones de cada instancia permite ver su captura de pantalla, localizarla en su página, abrir los detalles de su página o abrir la página de origen.
Para corregir la agrupación, seleccione una o varias instancias y elija una de estas acciones:
- Dividir en una nueva variante: Mueve las instancias seleccionadas a una nueva variante.
- Mover a otra variante: Mueve las instancias seleccionadas a una variante existente.
Al menos una instancia debe permanecer en la variante original. Para mover cada instancia de una variante, usa Dale a esta variante su propio bloque o Haz de esta una variante de otro bloque en la variante en su lugar. Los cambios de división y movimiento se conservan cuando se regenera el catálogo.
URL con errores failed-urls
La lista de direcciones URL con errores muestra todas las páginas que no se pudieron analizar, con el motivo y la hora. Los archivos que no son páginas, como imágenes y documentos, se omiten, se cuentan por separado y no se enumeran.
Revisar el catálogo review-catalog
Cuando finalice la planificación, el agente ofrece Revisar los resultados de ámbito. Utilícelo como punto de partida para consultar el catálogo, especialmente para sitios grandes.
- Elija Revisar cada paso para responder a las preguntas del agente, o Piloto automático para que decida.
- En primer lugar, el agente soluciona los problemas que solo tienen una respuesta razonable y le informa de los cambios. Por ejemplo, mueve los periféricos a la variante en la que caben, convierte vínculos y botones independientes en texto de página, combina variantes similares y corrige nombres no válidos.
- A continuación, le pregunta sobre los elementos restantes de uno en uno, empezando por errores claros. Cada pregunta muestra las capturas de pantalla y la sugerencia del agente, y usted responde en un solo paso. Pregúntale por qué si quieres su razonamiento.
- Seleccione Finalizar para mí en cualquier paso para permitir que el agente complete el resto de la revisión sin más preguntas.
- La revisión finaliza con un breve informe de los cambios y las comprobaciones del plan. Los elementos sobre los que el agente sigue sin estar seguro se dejan sin cambios y se marcan. Seleccione Revisar los elementos restantes para continuar con ellos o Iniciar la migración del sitio cuando el catálogo esté listo.
La revisión solo cambia el catálogo. No importa páginas ni genera código.
Iniciar migración de sitios migra una plantilla a la vez. El agente pregunta por qué plantilla comenzar y, a continuación, utiliza las páginas y bloques del catálogo para ella. Compruebe las páginas de esa plantilla antes de continuar con la siguiente y espere corregir algunas de ellas.
Refinamiento del catálogo planning-actions
Abrir el menú de acciones (…) de cualquier plantilla, página, bloque o variante y seleccione acciones de IA para ver las acciones disponibles para ella. También puede seleccionar hasta 20 elementos para actuar en consecuencia juntos.
Al elegir una acción, la consola agrega los elementos seleccionados al chat con una solicitud. Revise su ámbito y los cambios propuestos antes de confirmar. También puedes elegir Agregar al chat y escribir tu propio mensaje, incluyendo lo que no debe cambiar y si el agente puede subir contenido.
Algunas acciones solo muestran dónde se aplican. Por ejemplo, Generar código de bloque y Cambiar nombre de bloque solo están disponibles para bloques cuyo tipo se ha clasificado y Asigne a esta variante su propio bloque solo para variantes que tengan una clase de variante.
En Migrar página a AEM y Migrar plantilla a AEM, AEM hace referencia al proyecto conectado a la consola. El contenido importado permanece en el espacio de trabajo de la consola hasta que se carga: en Experience Workspace para proyectos basados en documentos o en la instancia de autor para la creación de Experience Manager.
Las correcciones de agrupación y nomenclatura cambian el catálogo, no las páginas que ya ha importado. Generar código de bloque cambia el código y las acciones de migración importan el contenido, por lo que debe revisar el resultado por separado. Un refactor estructural en el catálogo no es un refactor del código de bloque; para eso, vea Refactorizar sin cambiar el resultado.
Volver a ejecutar una fase additional-prompts
Para volver a ejecutar una fase, por ejemplo, después de que el sitio de origen haya cambiado, pida al agente que lo repita por el nombre:
repeat block cataloging
El agente también vuelve a ejecutar cada fase posterior y mantiene las anteriores. Los cambios que ha realizado en la vista Planning, como dividir o mover instancias de bloque, se mantienen.
Si la vista Planning muestra que el catálogo de bloques no está actualizado , el catálogo se creó con un formato anterior que la versión actual no puede leer. Vuelva a ejecutar la planeación desde el chat con scope site y la dirección del sitio. Si la planificación se detuvo antes de que finalizara, Empiece de nuevo en la vista Planificación también iniciará una nueva ejecución para el mismo sitio.
Flujo de trabajo de importación masiva bulk-import
Para migrar una plantilla de sitio completa por plantilla:
- Ejecute el catálogo del sitio para obtener las plantillas y las variantes de bloque.
- Revíselos en la vista de Planning y corrija los errores que se identificaron incorrectamente. La revisión guiada es la forma más rápida de empezar.
- Genere el código de los bloques que necesite. Puede seleccionar varios bloques y generar código solo para ellos.
- Para cada plantilla, abra sus detalles de plantilla y use Migrar página a AEM en una o dos páginas de muestra. Restrinja la importación hasta que el resultado sea correcto.
- Use Migrar plantilla a AEM para importar las páginas restantes de esa plantilla. Siga el estado de importación de cada página y vuelva a intentar las páginas con errores después de corregir la causa.
- Repita el proceso para cada plantilla.
Si el resultado de una plantilla es incorrecto, corríjalo en una página de muestra antes de importar más páginas. Si el análisis falla, compruebe las direcciones URL con errores, corrija el acceso al origen y vuelva a intentar las páginas. Volver a importar una página sobrescribe las ediciones realizadas por los autores desde entonces; consulte Importar en lotes.
Archivos de catálogo catalog-files
La mayoría de los usuarios solo necesita la vista de Planning. Para compartir un informe sin conexión o utilizar los datos de otras herramientas, busque el resultado sin procesar en la carpeta catalog/ de su proyecto.
template-catalog-report-bundle.zipsummary.jsontemplate-catalog.jsonblock-catalog.jsonurls-all.jsoncatalog.logLa carpeta también contiene archivos intermedios, incluidos análisis por página y capturas de pantalla de .pages/ y metadatos por variante en .blocks/.
Limitaciones limitations
- Acceso a Source: El agente lee el origen desde su entorno hospedado, por lo que al iniciar sesión en el origen desde su propio explorador no se le concede acceso. Para las páginas que requieren inicio de sesión o un encabezado secreto, configure autenticación de sitio protegido y compruebe una página protegida antes de iniciar una ejecución completa. No suponga que la autenticación configurada para el modo automático también se aplica a la catalogación. Si la fuente bloquea a los visitantes automatizados, consulta Sitios Source con protección para bots.
- Contenido tras interacciones: El catálogo carga cada página en un explorador, como lo hace la importación, de modo que el contenido que aparece solo después de que un visitante haga clic o escriba no se captura. Compruebe las capturas de pantalla con el origen. Ver limitaciones.
- Cobertura: El descubrimiento usa el mapa del sitio o sigue los vínculos de la página de inicio, por lo que no encuentra páginas que no incluyan listas ni vínculos a, como las páginas de aterrizaje de la campaña. Compare el resultado con su propia lista de URL y registre errores, direcciones URL que faltan y exclusiones aprobadas.
Para entregar el análisis, registre su fecha, el ámbito de origen, el informe, las correcciones, las direcciones URL sin resolver y las páginas de muestra que comprobó en el traspaso del proyecto.