Introducción al Agente de modernización de experiencias para proyectos de creación de Experience Manager getting-started-aem-authoring

NOTE
Con esta configuración, el contenido se almacena en el repositorio de contenido Java (JCR) de la instancia de autor de Adobe Experience Manager as a Cloud Service, los autores lo editan con el editor universal y Edge Delivery Services entrega las páginas. Esta configuración se llamaba anteriormente Crosswalk. Para ver el almacenamiento que Adobe recomienda para las nuevas implementaciones, consulte Dónde se almacena el contenido y cómo lo editan los autores.

Utilice este flujo de trabajo cuando un requisito dependa de que el contenido permanezca en el JCR. El Editor universal es el editor visual de Adobe para el contenido en Experience Manager. Esto no es una migración a una entrega basada en HTL y la tecnología del sitio web de origen no determina dónde se almacena el contenido.

Necesita acceso a la consola, permisos de repositorio y permiso para crear o actualizar contenido y recursos en la instancia de autor de destino. Registre el host, el identificador de sitio, la raíz de página, el destino DAM (la carpeta Experience Manager Assets para imágenes y archivos), el repositorio de código y la rama de trabajo de la instancia de autor antes de realizar la importación. El modo automático produce contenido basado en documentos, por lo que no se aplica a esta configuración.

Crear su repositorio de proyecto de Edge Delivery Services create-repo

Para un nuevo proyecto:

  1. Utilice el repositorio aem-block-collection-xwalk como plantilla en lugar de la plantilla basada en documentos. Las plantillas para la creación de Experience Manager tienen xwalk, abreviatura de Cruce, en sus nombres.
  2. Compruebe que fstab.yaml, el archivo que señala Edge Delivery Services al origen de contenido del sitio, hace referencia al host, al propietario de Git y al repositorio de Git de la instancia de autor. Revise y confirme la configuración en la rama utilizada para la instalación.
  3. Siga el tutorial del editor universal para configurar su repositorio.
    • Deténgase cuando se le pida que cree un sitio en Experience Manager.
  4. Para esta configuración de nuevo proyecto, quite paths.json de la plantilla y confirme el cambio. No elimine las asignaciones de rutas de un sitio existente sin revisar su propósito y reemplazo.
  5. Agregue la aplicación AEM Code Connector a su repositorio para que la consola pueda insertar cambios. Para saber en qué se diferencia de la sincronización de código de AEM, consulte Iniciar desde un repositorio.

Para un proyecto existente que almacena su contenido en el JCR, reutilice su configuración y modelos de contenido. No vuelva a crear el sitio ni reemplace su repositorio por la plantilla. Confirme la sincronización de código y el acceso al repositorio sin repetir la configuración basada en documentos.

Creación de un nuevo sitio en Experience Manager create-site

  1. En la consola Sitios, seleccione Crear > Sitio a partir de la plantilla.

  2. Seleccione el sitio de AEM con la plantilla Edge Delivery Services.

  3. Para esta configuración de plantilla, mantenga el nombre del sitio (no el título) tal como se proporcionó.

    • El nombre del sitio se utiliza como identificador único.
    • El título se puede cambiar para mostrarlo.
  4. Seleccione Crear.

    • Se le redirigirá a la página de Sites.
    • Actualice la página si el nuevo sitio no aparece inmediatamente.

Omita la creación del sitio si el sitio de destino ya existe. Confirme su identificador y destinos en su lugar; no cambie el nombre de un sitio activo para que quepa un ejemplo.

Conectar el sitio e importar una página continue

Los pasos de la consola son los mismos que en la guía principal. Solo difieren la solicitud de importación y las comprobaciones.

  1. Abre la consola y conecta tu sitio.

  2. Pida al agente que importe una página y que indique que el contenido se almacena en el JCR. Sustituya la URL de ejemplo:

    • “Migrar solamente https://www.example.com/about a la raíz de página acordada en este proyecto de Experience Manager Authoring. Conservar contenido y vínculos. Reutilice los modelos de bloque del proyecto y valide la conversión JCR. No cargue, inserte ni publique”.

    Contenido importado

  3. Valide el contenido, cárguelo como un paquete de contenido y compruebe que los autores puedan editarlo y previsualizarlo.

  4. Solicite el estilo, como en los pasos de estilo de Importar una página paso a paso y inserte el código.

Validar contenido validate-content

Valide la página seleccionada en el panel de contenido. Use Markdown view, JCR XML view y Errors para comprobar el contenido y la conversión. Use Agregar al chat para apuntar una corrección a una página o a uno de los scripts de importación que genera el agente.

En los proyectos de creación de Experience Manager, cada bloque también tiene un modelo: la configuración que define los campos que editan los autores para ese bloque en el Editor universal. El editor universal edita únicamente los campos que define el modelo de un bloque, de modo que una página puede procesarse correctamente en la vista previa de HTML mientras que los bloques que no coinciden con sus modelos no pueden editarse. Pida al agente que compruebe que los modelos de bloque de origen, las definiciones de componentes y la configuración de agregados generada coinciden. Actualice la configuración de origen a través del flujo de trabajo de generación del proyecto en lugar de corregir solo un archivo generado. Compruebe las asignaciones de campos y las sugerencias de creación, las rutas de página, las referencias de imagen y los destinos de sitio/DAM deseados.

Resuelva los errores de conversión en una página de muestra antes de crear un paquete más grande.

Chat contextual

Cargar contenido upload-content

La carga de paquetes escribe contenido en la instancia de autor. Confirme las páginas, el host, el sitio, la raíz de página y el destino del recurso seleccionados con el propietario del destino. Conservar el contenido existente antes de reemplazarlo; la validación local no garantiza la sobrescritura.

La carga utiliza su inicio de sesión de Adobe, por lo que la instancia de autor aplica sus propios permisos a las páginas y los recursos. Consulte Permisos de inserción de contenido.

  1. Asegúrese de que está en una vista de Contenido y seleccione el botón Cargar contenido en la parte superior derecha.

  2. En el cuadro de diálogo Crear paquete de contenido, elija las páginas que desea incluir en el paquete.

    • Si lo desea, escriba un nombre de paquete (de manera predeterminada, el nombre del sitio si se deja vacío).
    • Use Seleccionar todo, Borrar selección, Expandir todo o Contraer todo para administrar la lista.
  3. Seleccione Crear paquete.

    Crear paquete de contenido: elija páginas y cree

  4. Una vez creado el paquete, el cuadro de diálogo Cargar paquete de contenido mostrará que el paquete está listo.

    1. Puede descargar el paquete para guardarlo localmente o continuar con la carga.
    2. En Cargar a AEM, confirme el sitio de AEM y el host de AEM (rellenados previamente a partir de la configuración de su proyecto).
      • Si lo desea, deje Cargar imágenes marcadas para incluir imágenes.
    3. Seleccione Cargar a AEM.

    Paquete listo para cargar o descargar

  5. El cuadro de diálogo muestra el progreso de carga a medida que las páginas y los recursos se envían a la instancia de autor. Revise el registro de carga, incluidos los errores individuales, antes de cerrar el cuadro de diálogo.

    Progreso y finalización de la carga

Para una carga de paquete o imagen fallida, conserve el registro y las rutas seleccionadas. Corrija la conversión, las credenciales, los permisos o los destinos según se indique y, a continuación, vuelva a intentar el ámbito afectado. Una descarga de paquete por sí sola no importa contenido en la instancia de autor. Confirme qué páginas y recursos llegaron antes de volver a intentar evitar reemplazos no deseados.

Si Crear paquete informa de Falta la configuración del sitio, la consola no conoce la ruta de acceso del sitio del proyecto, /content/{site-name}, ni la carpeta DAM, /content/dam/{folder-name}. Los encuentra buscando el sitio en la instancia de autor a la que apunta el origen de contenido del proyecto, según se ha establecido en fstab.yaml o en la configuración del sitio. Compruebe que el sitio exista en la instancia de autor y que la cuenta de Adobe con la que inició sesión pueda acceder a él y, a continuación, vuelva a cargar la consola. Si el mensaje persiste, solicite soporte técnico. Si informa de Falta la dirección URL de base del sitio, escriba la dirección URL de origen del sitio de origen, como https://www.example.com, como URL de base del sitio en Configuración.

Si el entorno de as a Cloud Service de Experience Manager está en hibernación, el cuadro de diálogo de carga y la configuración lo indicarán y lo vincularán a Developer Console. Cancele la hibernación del entorno y vuelva a intentar la carga. Ver Anular la hibernación de un programa de zona protegida desde Developer Console.

Revise y inserte el código y la configuración coincidentes mediante la directiva de repositorio del proyecto. Esto es independiente de la carga del paquete; consulte Cómo se activan los cambios.

Validar creación y previsualización preview-site

  1. En la consola Sitios, busque la página importada en la raíz del sitio acordada.
  2. Ábralo en el editor universal. Compruebe que los campos y bloques esperados se pueden seleccionar y editar, no solo procesarse.
  3. Cambiar texto y una imagen, guardar y volver a abrir la página. Confirme que el contenido y las referencias de recursos persisten.
  4. Utilice el flujo de trabajo de vista previa configurado del proyecto (las páginas de vista previa se proporcionan en *.aem.page). Compruebe la página con la rama de código deseada y el diseño, los vínculos y las imágenes adaptables.
  5. Para la producción, complete las comprobaciones antes de la versión y luego publique las páginas desde el editor universal o la consola Sites. Ver Publicación de contenido con el editor universal.

La carga correcta del paquete, la creación correcta, la previsualización y la publicación son puntos de comprobación distintos. Si la edición falla, vuelva a visitar las asignaciones del modelo y la configuración generada; no acepte una vista previa estática como finalización.

Registre el paquete cargado, las rutas, la revisión de código, las direcciones URL de autor/vista previa, los errores restantes y el propietario de la recuperación en el traspaso. La reversión de código no restaura páginas JCR ni recursos DAM; recupere estos elementos por separado mediante el proceso aprobado del entorno de destino.

Recursos adicionales additional-resources

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