Ruta hacia la primera experiencia para usar AEM sin encabezado
Última actualización: 2023-11-21
Temas:
Creado para:
En esta parte del Recorrido para desarrolladores de AEM sin encabezado comprenderá los pasos para aplicar su primera experiencia sin encabezado en AEM, incluidas las consideraciones de planificación, y también aprenderá las prácticas recomendadas para que su ruta sea lo más fluida posible.
La historia hasta ahora
En el documento anterior del recorrido de contenido sin encabezado de AEM, Introducción a AEM sin encabezado as a Cloud Service aprendió la teoría básica de lo que es un CMS sin encabezado y ahora debería poder hacer lo siguiente:
Comprender los conceptos básicos de las características de AEM sin encabezado.
Conozca los requisitos previos para utilizar las características de AEM sin encabezado.
Tener en cuenta los niveles de integración de AEM sin encabezado.
Ser capaz de definir el proyecto en términos del ámbito.
Este artículo se basa en estos fundamentos para que entienda cómo preparar su propio proyecto de AEM sin encabezado.
Objetivo
Este documento le ayudará a comprender los pasos necesarios para implementar su primer proyecto. Después de leerlo, debería poder hacer lo siguiente:
Comprender las consideraciones de planificación importantes para diseñar su contenido.
Comprender los pasos para implementar contenido sin encabezado en AEM.
Conocer qué herramientas y configuraciones de AEM son necesarias.
Conocer las prácticas recomendadas para que su recorrido sin encabezado sea fluido, mantenga la eficiencia de la generación de contenido y asegurarse de que el contenido se entregue rápidamente.
Requisitos
Antes de continuar con este documento, asegúrese de haber revisado el documento anterior en el Recorrido para desarrolladores de contenido sin encabezado de AEM, Introducción a AEM sin encabezado as a Cloud Service para lograr lo siguiente:
Cumplir los requisitos enumerados.
Tener en cuenta su propia definición de proyecto, en la que se incluya ámbito, funciones y rendimiento.
Planificación para el éxito
Para iniciar su primer proyecto de AEM sin encabezado debe asegurarse de que dispone de un modelo de contenido que admita la personalización y las actualizaciones que desee realizar en todos los canales.
Independientemente de AEM, también debe asegurarse de tener configurado un entorno de desarrollo adecuado si está creando una aplicación del lado del cliente para poder probarlo frente a llamadas de API a AEM as a Cloud Service.
Definición de los modelos de contenido y las API
Debe impulsar una experiencia coherente y administrar campañas personalizadas en todos los canales, de modo que pueda ver cada canal individual y superficie como su propia estructura de contenido distinta a la que enviar. Sin embargo, tener cada canal con su propio modelo de contenido es difícil de mantener.
En su lugar, debe tener en cuenta cómo se relaciona el contenido en diferentes superficies basándose en los principios de la organización, como jerarquías de productos y marcas, categorías de bienes o superficies o pasos en el recorrido del cliente. Por ejemplo, si tiene un conjunto de superficies que admiten una marca específica de automóviles que fabrica, puede que desee comenzar con un modelo de contenido para obtener información general que sea verdadera para todo el automóvil, y que luego tenga elementos más específicos, como el contenido necesario, desde cuando el automóvil comience a funcionar hasta que haya problemas con el servicio. Este modelo impondrá la herencia del contenido general de la marca del automóvil, al tiempo que permitirá cambios basados en el contexto específico necesario. También le ayudará a gestionar las actualizaciones de este contenido en el futuro, ya que puede aplicar un control basándose en las funciones como la de experto en marketing general o gestor de productos para toda la marca, frente a un autor responsable de la experiencia de “arrancar el automóvil”.
Después de tener el modelo de contenido y una vista clara de los distintos clientes a los que debe mostrarse el contenido, debe asegurarse de que las GraphQL/API asociadas con el acceso a varios de los modelos de contenido se publiquen en todos los clientes que necesitan este contenido. Existen diferentes opciones para acceder a cierto contenido. Puede solicitar un contenido específico que sea estático y que permita el almacenamiento en caché del contenido y un rendimiento superior. También puede solicitar contenido que se genere dinámicamente y que requiera más procesamiento. Asegúrese de que los clientes utilicen las API más eficientes para sus necesidades comerciales.
Explicación de los entornos
Dentro de AEM hay tres tipos de entornos: de desarrollo, ensayo y producción.
Los entornos de desarrollo (puede tener varios) son un lugar seguro para experimentar y probar ideas. Durante la fase inicial del proyecto, Adobe recomienda utilizar los entornos de desarrollo para probar variaciones de modelos de contenido y ver cuáles proporcionan la salida deseada para las superficies.
El entorno de ensayo de los proyectos sin encabezado se utiliza para validar las nuevas versiones de productos de AEM antes de que se implementen en la producción. Mantenga una lista actualizada de los modelos de contenido de producción y un subconjunto del contenido, de modo que pueda tener archivos JSON procesados para comparar si siguen proporcionando la misma salida, a medida que realiza cambios o que la versión de AEM introduce cambios.
La producción es donde los autores de contenido crean y administran su contenido real. Los cambios de modelo en la producción deben llevarse a cabo con cuidado y teniendo en cuenta la compatibilidad con versiones anteriores.
Durante la fase de desarrollo, se recomienda trabajar con un entorno de desarrollo y ensayo. Al pasar a las pruebas de rendimiento, tendrá que pasar al entorno de producción.
Cooperación entre desarrolladores y autores de contenido
Los desarrolladores necesitan un entorno de desarrollo de AEM configurado con los modelos de contenido rellenados. El desarrollador desarrolla el cliente que consumirá el contenido desde AEM sin in encabezado, ya que los autores de contenido siguen creándolo. Por eso las definiciones de API son muy importantes. AEM Mediante el SDK de la, el desarrollador puede crear un vínculo de prueba para que las pruebas de cliente y de unidad se puedan crear y garantizar que el cliente pueda procesar correctamente el contenido.
Los autores de contenido crean contenido en función de los modelos de contenido que se han definido en el entorno de ensayo. Con la herramienta de creación de fragmentos de contenido, el autor crearía un fragmento de contenido o editaría uno existente. Antes de publicarlo, el autor puede obtener una previsualización del aspecto que tendrá para el cliente si trabaja con el desarrollador para impulsar el modelo de contenido al desarrollo o configurar un entorno de desarrollador solo para que los autores puedan obtener una vista previa del aspecto que tendría para el cliente.
Configuración
Antes de empezar con el contenido sin encabezado de AEM, debe asegurarse de que todas las funciones necesarias estén habilitadas. Esta sección describe lo que se requiere. Los pasos reales para realizar estos pasos se detallan más adelante en la sección Recorrido para desarrolladores de AEM sin encabezado.
También puede consultar opcionalmente los recursos adicionales para obtener más información sobre temas individuales.
Configuración
Habilitar los fragmentos de contenido
Habilitar GraphQL
Configurar el SDK sin encabezado
Implementación de su primera aplicación de AEM sin encabezado
Se trata de información general de lo que necesita para implementar su primera aplicación de AEM sin encabezado para entregar su contenido. La forma de llevar a cabo estos pasos se describe en detalle en partes posteriores del Recorrido sin encabezado para desarrolladores.
Crear los modelos de fragmentos de contenido
Crear fragmentos de contenido
Consultar contenido con GraphQL
Prácticas recomendadas
Un proyecto sin encabezado no solo es exitoso debido a la tecnología implementada, sino también debido a la buena planificación y gestión de los proyectos. Las siguientes son varias prácticas recomendadas que los autores y desarrolladores de contenido deben tener en cuenta al planificar el proyecto.
Organización del contenido
Haga su estructura tan compleja como sea necesario, pero manténgala lo más simple posible. Las estructuras de contenido más sencillas ayudan la gestión del contenido y a mejorar el rendimiento del sistema.
Priorice la reutilización del contenido en su estrategia. Cree submodelos y referencias de contenido que se puedan reutilizar en varios modelos y canales de nivel superior.
Haga que las estructuras de contenido sean lo más evidentes posible para que los autores de contenido puedan aprender y adaptarse rápidamente a las tareas de creación.
Si tiene restricciones de acceso, intente alinear su modelo de contenido con los requisitos de acceso.
Cuando tiene requisitos de acceso, deben dirigir su jerarquía de contenido. Agrupe el contenido que edita el mismo grupo de personas.
Agrupe contenido similar en una carpeta.
Es más probable que un autor de contenido copie y pegue el contenido existente para crear contenido nuevo. Por lo tanto, hacer esto en la misma carpeta lo hace más eficiente.
AEM permite establecer los modelos permitidos por carpeta, de modo que el botón Crear nuevo solo muestra los modelos compatibles con esa ubicación.
La creación del editor de fragmentos de contenido en línea de nuevos fragmentos de contenido se puede simplificar si la carpeta raíz está configurada en el modelo. A continuación, el profesional no tiene que elegir una ubicación, sino que solo tiene que proporcionar un nombre y puede empezar a editar la nueva referencia.
Creación de contenido
Para versiones específicas del canal de su contenido, considere la posibilidad de utilizar variaciones de fragmento de contenido. Las variaciones se sincronizan con el contenido principal para racionalizar la administración de cambios de contenido.
Invite a otros productores de contenido a revisar contenido y dar comentarios.
Mantenga las cosas en movimiento con el menor número posible de elementos obligatorios. Los elementos obligatorios pueden bloquear el flujo de trabajo.
Creación de contenido global
Establezca reglas de gestión para la traducción de contenido. Para reducir la carga del sistema, establezca la traducción como un proceso asincrónico que se pueda ejecutar en intervalos más largos. Espere un tiempo para el control de calidad de la localización y la corrección de errores.
Aproveche todas las funcionalidades proporcionadas por su sistema de tecnología de traducción que puede integrar con AEM, como la memoria de traducción.
Comprenda si el contenido con medios enriquecidos, como imágenes y vídeos, necesita ser localizado.
Siguientes pasos
Ahora que ha completado esta parte del recorrido para desarrolladores de AEM sin encabezado, debería poder hacer lo siguiente:
Comprender las consideraciones de planificación importantes para diseñar su contenido.
Comprender los pasos para implementar contenido sin encabezado en AEM.
Conocer qué herramientas y configuraciones de AEM son necesarias.
Conocer las prácticas recomendadas para que su recorrido sin encabezado sea fluido, mantenga la eficiencia de la generación de contenido y asegurarse de que el contenido se entregue rápidamente.
Queremos que a partir de estos conocimientos básicos comprenda plenamente el potencial y la flexibilidad de AEM sin encabezado, de modo que pueda aprovecharlos para sus propios proyectos. Para ello, tiene varias opciones.
Elija su propia aventura
Sea cual sea su estilo de aprendizaje, Adobe quiere que tenga éxito a la hora de empezar a trabajar con su proyecto AEM sin encabezado.
Si prefiere continuar con la información sobre los conceptos y las tecnologías sin encabezado de AEM, debe continuar con su recorrido sin encabezado de AEM revisando el documento Modelo del contenido como modelos de contenido de AEM donde aprenderá a modelar la estructura de contenido en AEM.
Si prefiere aprender practicando, puede ir al Tutorial práctico Introducción a AEM sin encabezado donde irá directamente al desarrollo de AEM sin encabezadoimplementando un proyecto simple para exponer contenido sin encabezado de AEM.
Recursos adicionales
Aunque se recomienda pasar a la siguiente parte del recorrido de desarrollo sin encabezado revisando el documento Modelo del contenido como modelos de contenido de AEM, a continuación se incluyen algunos recursos opcionales adicionales que profundizan en varios conceptos mencionados en este documento, pero que no son necesarios para continuar el recorrido sin encabezado.
Recorrido de traducción de AEM sin encabezado: este recorrido de documentación le ofrece una amplia descripción de la tecnología sin encabezado, cómo sirve AEM el contenido sin encabezado y cómo puede traducirlo.
Tutoriales de contenido sin encabezado de AEM: utilice estos tutoriales prácticos para explorar cómo utilizar las distintas opciones para enviar contenido a puntos de conexión sin encabezado con AEM y elegir el más adecuado para usted.
