Cómo modelar el contenido model-your-content
En esta parte del Recorrido para desarrolladores de contenido sin encabezado de AEM, puede aprender a modelar la estructura de contenido. A continuación, observe esa estructura para Adobe Experience Manager (AEM) mediante los modelos de fragmentos de contenido y los fragmentos de contenido, para reutilizarla en todos los canales.
La historia hasta ahora story-so-far
Al principio, Obtenga información acerca de CMS sin encabezado, abarcaba la entrega de contenido sin encabezado y por qué se debía utilizar. A continuación, la Introducción al contenido sin encabezado de AEM as a Cloud Service describía el contenido sin encabezado de AEM en el contexto de su propio proyecto.
En el documento anterior del recorrido del contenido sin encabezado de AEM, Ruta hacia la primera experiencia al usar contenido sin encabezado de AEM, aprendió los pasos necesarios para implementar su primer proyecto. Después de leerlo, puede hacer lo siguiente:
- Comprender y explicar las consideraciones de planificación importantes para diseñar su contenido.
- Comprender los pasos para implementar contenido sin encabezado según los requisitos de nivel de integración.
- Configurar las herramientas y configuraciones de AEM 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.
Este artículo se basa en estos fundamentos para que entienda cómo preparar su propio proyecto de AEM sin encabezado.
Objetivo objective
-
Audiencia: principiante
-
Objetivo: aprenda a modelar la estructura de contenido y, a continuación, a llevar a cabo esa estructura utilizando modelos de fragmentos de contenido y fragmentos de contenido de AEM.
- Introduzca conceptos y terminología relacionados con el modelado de datos/contenido.
- Descubra por qué se necesita el modelado de contenido para la entrega de contenido sin encabezado.
- Aprenda a llevar a cabo esta estructura utilizando modelos de fragmento de contenido de AEM (y a crear contenido con fragmentos de contenido).
- Aprenda a modelar el contenido y los principios con muestras básicas.
Modelado de contenido content-modeling
Es un mundo grande y peligroso.
Quizás sí, pero quizás no. Lo cierto es que el mundo es muy complicado y el modelado de datos se utiliza para definir una representación simplificada de una subsección muy pequeña, utilizando la información específica necesaria para un fin determinado.
Por ejemplo:
Hay muchas escuelas, pero todas tienen varias cosas en común.
- Una ubicación,
- un director
- muchos profesores,
- muchos miembros del personal no docente,
- muchos alumnos,
- muchos exprofesores,
- muchos exalumnos,
- muchos salones,
- muchos libros,
- mucho equipamiento,
- muchas actividades extraescolares,
- etc…
Incluso en un ejemplo tan pequeño, la lista puede parecer interminable. Pero si simplemente desea que la aplicación realice una tarea sencilla, debe limitar la información a lo esencial.
Por ejemplo, anunciar eventos especiales para todas las escuelas de la zona:
- Nombre del colegio
- Ubicación
- Director
- Tipo de evento
- Fecha del evento
- Profesor que organiza el evento
Conceptos concepts
Lo que desea describir se denominan Entidades, que son básicamente las “cosas” sobre las que deseamos almacenar información.
La información que deseamos almacenar son los Atributos (propiedades), como el Nombre y las Cualificaciones del profesorado.
A continuación, hay varias Relaciones entre las entidades. Por ejemplo, normalmente una escuela tiene un director y varios profesores (normalmente, el director también suele ser un profesor).
El proceso de análisis y definición de esta información, junto con las relaciones entre ellos se denomina Modelado de contenido.
Datos básicos basics
A menudo, es necesario empezar por elaborar un Esquema conceptual que describa las entidades y sus relaciones. Normalmente es de alto nivel conceptual.
Cuando haya terminado, puede convertir los modelos en un Esquema lógico que describe las entidades, junto con los atributos y las relaciones. En este nivel, debe examinar detenidamente las definiciones para eliminar la duplicación y optimizar el diseño.
Por ejemplo, ¿necesita entidades independientes para Head Teacher y Teacher, o simplemente un atributo adicional en el modelo Teacher?
Garantía de integridad de los datos data-integrity
La integridad de los datos es necesaria para garantizar la precisión y coherencia del contenido durante todo su ciclo de vida. Esto incluye garantizar que los autores de contenido puedan comprender fácilmente qué almacenar y dónde, por lo que los elementos siguientes son vitales:
- una estructura clara,
- una estructura lo más concisa posible (sin sacrificar la precisión),
- validación de campos individuales,
- cuando proceda, restringir el contenido de campos específicos a lo que sea significativo.
Eliminación de la redundancia de datos data-redundancy
La redundancia de datos se produce cuando la misma información se almacena dos veces dentro de la estructura de contenido. Esto debe evitarse, ya que puede provocar confusión al crear el contenido y errores en la consulta; sin mencionar el uso indebido del espacio de almacenamiento.
Optimización y rendimiento optimization-and-performance
Al optimizar su estructura, puede mejorar el rendimiento, tanto para la creación de contenido como para realizar consultas.
Todo es un acto de equilibrio, pero crear una estructura que sea demasiado compleja o con demasiados niveles puede resultar confuso para los autores que generan los contenidos. Y puede afectar gravemente al rendimiento si la consulta tiene que acceder a varios fragmentos de contenido anidados (referenciados) para recuperar el contenido necesario.
Modelado de contenido sin encabezado de AEM content-modeling-for-aem-headless
El modelado de datos es un conjunto de técnicas establecidas, que a menudo se utilizan cuando se han desarrollado bases de datos de relaciones; por consiguiente, ¿qué significa el modelado de contenido sin encabezado de AEM?
¿Por qué? why
Para garantizar que su aplicación pueda solicitar y recibir de forma consistente y eficiente el contenido necesario de AEM, debe estar estructurado.
Esto significa que la aplicación conoce de antemano la forma de respuesta y, por lo tanto, cómo procesarla. Esto es mucho más fácil que recibir contenido de forma libre, que debe analizarse para determinar qué contiene y, por lo tanto, cómo puede utilizarse.
Introducción a ¿Cómo hacerlo? how
AEM utiliza fragmentos de contenido para proporcionar las estructuras necesarias para la entrega sin encabezado del contenido en las aplicaciones.
La estructura del modelo de contenido:
- Se consigue mediante la definición del modelo de fragmento de contenido.
- Se utiliza como base de los fragmentos de contenido utilizados para la generación de contenido.
Las solicitudes de contenido se realizan mediante la API de AEM, GraphQL, una implementación personalizada de la API de GraphQL estándar. La API de AEM GraphQL permite realizar consultas (complejas) en los fragmentos de contenido, y cada consulta se realiza de acuerdo con un tipo de modelo específico.
Las aplicaciones pueden utilizar el contenido devuelto.
Creación de la estructura con modelos de fragmento de contenido create-structure-content-fragment-models
Los modelos de fragmento de contenido proporcionan varios mecanismos que permiten definir la estructura del contenido.
Un modelo de fragmento de contenido describe una entidad.
Dentro de un modelo:
- Los Tipos de datos permiten definir los atributos individuales.
Por ejemplo, defina el campo que contiene el nombre de un profesor como Texto y sus años de servicio como un Número. - Los tipos de datos Referencia de contenido y Referencia de fragmento permiten crear relaciones con otro contenido dentro de AEM.
- El tipo de datos referencia de fragmento le permite obtener varios niveles de estructura anidando los fragmentos de contenido (según el tipo de modelo). Esto es importante para el modelado de contenido.
Por ejemplo:
Tipos de datos data-types
AEM proporciona los siguientes tipos de datos para modelar el contenido:
- Texto de una sola línea
- Texto de varias líneas
- Número
- Booleano
- Fecha y hora
- Lista desglosada
- Etiquetas
- Referencia de contenido
- Referencia al fragmento
- Objeto JSON
Referencias y contenido anidado references-nested-content
Dos tipos de datos proporcionan referencias al contenido fuera de un fragmento específico:
-
Referencia de contenido
Proporciona una sencilla referencia a otro contenido de cualquier tipo.
Por ejemplo, puede hacer referencia a una imagen en una ubicación específica. -
Referencia de fragmento
Proporciona referencias a otros fragmentos de contenido.
Este tipo de referencia se utiliza para crear contenido anidado e introduce las relaciones necesarias para modelar el contenido.
El tipo de datos se puede configurar para que los autores de fragmentos puedan hacer lo siguiente:- Editar directamente el fragmento al que se hace referencia.
- Crear un nuevo fragmento de contenido basado en el modelo apropiado
Creación de modelos de fragmento de contenido creating-content-fragment-models
Al principio, debe habilitar Modelos de fragmento de contenido para el sitio. Esto se realiza en el Explorador de configuración en Herramientas > General > Explorador de configuración. Puede seleccionar la configuración de la entrada global o crear una configuración. Por ejemplo:
A continuación, se pueden crear los modelos de fragmento de contenido y definir la estructura. Esto se puede hacer en Herramientas > General > Modelos de fragmento de contenido. Por ejemplo:
Uso del modelo para crear contenido con fragmentos de contenido use-content-to-author-content
Los fragmentos de contenido se basan siempre en un modelo de fragmento de contenido. El modelo proporciona la estructura, el fragmento incluye el contenido.
Selección del modelo apropiado select-model
El primer paso para crear el contenido es crear un fragmento de contenido. Esto se realiza mediante Crear > Fragmento de contenido en la carpeta necesaria en Recursos > Archivos. El asistente le guiará a través de los pasos.
Un fragmento de contenido se basa en un modelo de fragmento de contenido específico que se selecciona como primer paso del proceso de creación.
Creación y edición de contenido estructurado create-edit-structured-content
Una vez creado el fragmento, puede abrirlo en el Editor de fragmentos de contenido. Aquí puede hacer lo siguiente:
- Editar el contenido en modo normal o pantalla completa.
- Dar formato al contenido como Texto completo, Texto sin formato o Markdown.
- Crear y administrar Variaciones del contenido.
- Asociar contenido.
- Editar los metadatos.
- Mostrar la estructura de árbol.
- Previsualizar la representación JSON.
Creación de fragmentos de contenido creating-content-fragments
Después de seleccionar el modelo adecuado, se abre un fragmento de contenido para editarlo en el Editor de fragmentos de contenido:
Introducción a algunos ejemplos getting-started-examples
Para obtener una estructura básica como ejemplo, consulte La estructura del fragmento de contenido de muestra.
Siguientes pasos whats-next
Ahora que ha aprendido a modelar su estructura y a crear contenido en función de ella, el siguiente paso es Aprender a utilizar las consultas de GraphQL para acceder al contenido de los fragmentos de contenido y recuperarlo. Esto presenta y explica GraphQL, luego se ven algunas consultas de ejemplo para ver cómo funciona todo en la práctica.
Recursos adicionales additional-resources
-
Trabajar con fragmentos de contenido: la página de inicio de los fragmentos de contenido
- Fragmentos de contenido en el explorador de configuración: habilitar la funcionalidad Fragmento de contenido en el explorador de configuración
- Modelos de fragmentos de contenido: creación y edición de modelos de fragmentos de contenido
- Administración de fragmentos de contenido: creación de fragmentos de contenido; esta página le llevará a otras secciones detalladas
-
Esquemas de GraphQL de AEM: cómo GraphQL realiza modelos
-
Introducción al contenido sin encabezado de AEM: una breve serie de tutoriales de vídeo que ofrecen información general sobre el uso de las funciones de AEM sin encabezado, incluidos el modelado de contenido y GraphQL.
- Conceptos básicos de modelado de GraphQL: aprenda a definir y utilizar fragmentos de contenido en Adobe Experience Manager (AEM) para su uso con GraphQL.