Cómo modelar el contenido

En esta parte del AEM Recorrido para desarrolladores sin encabezado, 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

Al principio Obtenga información sobre el desarrollo sin encabezado de CMS abarcaba el envío de contenido sin encabezado y por qué debería usarse. A continuación, Introducción a AEM sin encabezado como Cloud Service describió AEM sin encabezado en el contexto de su propio proyecto.

En el documento anterior del recorrido sin AEM encabezado, Ruta a la primera experiencia con AEM sin encabezado, se han aprendido los pasos necesarios para implementar el primer proyecto. Después de leerlo, debe:

  • Comprender las consideraciones de planificación importantes para diseñar el contenido
  • Comprender los pasos para implementar sin encabezado según los requisitos de nivel de integración.
  • Configure las herramientas y configuraciones de AEM necesarias.
  • Conozca las prácticas recomendadas para que su recorrido sin objetivos sea fluido, mantenga la eficiencia de la generación de contenido y asegúrese de que el contenido se entregue rápidamente.

Este artículo se basa en estos fundamentos para que entienda cómo preparar su propio AEM proyecto sin objetivos.

Objetivo

  • Audiencia: Principiante
  • Objetivo: Aprenda a modelar la estructura de contenido y luego a comprender esa estructura utilizando AEM modelos de fragmentos de contenido y fragmentos de contenido:
    • 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 realizar esta estructura utilizando AEM modelos de fragmento de contenido (y cree contenido con fragmentos de contenido).
    • Aprenda a modelar el contenido; principios con muestras básicas.
NOTA

El modelado de datos es un campo muy grande, ya que se utiliza al desarrollar bases de datos relacionales. Hay muchos libros, y fuentes de información en línea, disponibles.

Solo se tendrán en cuenta los aspectos que son de interés al modelar datos para su uso con AEM sin encabezado.

Modelado de contenido

Es un mundo grande, malo allá afuera.

Tal vez, quizás no, pero ciertamente es un mundo complicado y el modelado de datos se utiliza para definir una representación simplificada de una subsección muy (muy) pequeña, utilizando la información específica que se necesita para un determinado propósito.

NOTA

Como AEM trata del contenido, nos referimos a Modelado de datos como Modelado de contenido.

Por ejemplo:

Hay muchas escuelas, pero todas tienen varias cosas en común:

  • Una ubicación
  • Un profesor jefe
  • Muchos profesores
  • Muchos miembros del personal no docente
  • Muchos alumnos
  • Muchos ex profesores
  • Muchos ex alumnos
  • Muchas aulas
  • Muchos (muchos) libros
  • Muchos (muchos) equipos
  • Muchas actividades extracurriculares
  • y así sucesivamente…

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, la publicidad de eventos especiales para todas las escuelas de la zona:

  • Nombre del colegio
  • Ubicación del colegio
  • Profesor jefe
  • Tipo de evento
  • Fecha del evento
  • Profesor organizando el evento

Conceptos

Lo que desea describir se denomina Entities, básicamente las "cosas" sobre las que queremos almacenar información.

La información que queremos almacenar sobre ellos son los Atributos (propiedades), como Nombre y Cualificaciones para los profesores.

Luego hay varias Relaciones entre las entidades. Por ejemplo, normalmente una escuela tiene un solo profesor jefe y muchos maestros (y normalmente el profesor jefe también es 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

A menudo, es necesario empezar por elaborar un Esquema conceptual que describa las entidades y sus relaciones. Normalmente es de alto nivel (conceptual).

Una vez estable, puede traducir los modelos a un Esquema lógico que describa 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.

NOTA

A veces, estos dos pasos se combinan, a menudo según la complejidad del escenario.

Por ejemplo, ¿necesita entidades independientes para Head Teacher y Teacher o simplemente un atributo adicional en el modelo Teacher?

Garantizar la integridad de los datos

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, por lo que lo siguiente es vital:

  • 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

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 al consultar; sin mencionar el uso indebido del espacio de almacenamiento.

Optimización y rendimiento

Al optimizar su estructura, puede mejorar el rendimiento, tanto para la creación de contenido como para las consultas.

Todo es un acto de equilibrio, pero la creación de una estructura demasiado compleja o con demasiados niveles puede:

  • Sea confuso para los autores que generan el contenido.

  • Afecta gravemente al rendimiento si la consulta tiene que acceder a varios fragmentos de contenido anidados (referenciados) para recuperar el contenido requerido.

Modelado de contenido para AEM sin encabezado

El modelado de datos es un conjunto de técnicas establecidas, que a menudo se utilizan cuando se desarrollan bases de datos de relaciones, por lo que ¿qué significa el modelado de contenido para AEM sin encabezado?

¿Por qué?

Para garantizar que su aplicación pueda solicitar y recibir de forma consistente y eficiente el contenido necesario de AEM, este contenido 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 How?

AEM utiliza los fragmentos de contenido para proporcionar las estructuras necesarias para la entrega sin encabezado de su contenido a sus aplicaciones.

La estructura del modelo de contenido es:

  • realizado 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.
NOTA

Los modelos de fragmento de contenido también se utilizan como base de los esquemas AEM de GraphQL, que se utilizan para recuperar contenido; más información al respecto en una sesión posterior.

Las solicitudes de contenido se realizan mediante la API de AEM GraphQL, una implementación personalizada de la API estándar de GraphQL. La API de AEM GraphQL permite realizar consultas (complejas) en los fragmentos de contenido, cada una de las cuales depende de un tipo de modelo específico.

Las aplicaciones pueden utilizar el contenido devuelto.

Creación de la estructura con modelos de fragmento de contenido

Los modelos de fragmento de contenido proporcionan varios mecanismos que le permiten definir la estructura del contenido.

Un modelo de fragmento de contenido describe una entidad.

NOTA

Debe habilitar la funcionalidad Fragmento de contenido en el navegador de configuración para poder crear nuevos modelos.

SUGERENCIA

Se debe asignar un nombre al modelo para que el autor del contenido sepa qué modelo seleccionar al crear un fragmento de contenido.

Dentro de un modelo:

  1. Los tipos de datos permiten definir los atributos individuales.
    Por ejemplo, defina el campo que contiene el nombre de un profesor como Text y sus años de servicio como Number.
  2. Los tipos de datos Content Reference y Fragment Reference permiten crear relaciones con otro contenido dentro de AEM.
  3. 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 vital para el modelado de contenido.

Por ejemplo:
Modelado de contenido con fragmentos de contenido

Tipos de datos

AEM proporciona los siguientes tipos de datos para modelar el contenido:

  • Texto de línea única
  • Texto multilínea
  • Número
  • Booleano
  • Fecha y hora
  • Enumeración
  • Etiquetas
  • Referencia de contenido
  • Referencia al fragmento
  • Objeto JSON

Referencias y contenido anidado

Dos tipos de datos proporcionan referencias al contenido fuera de un fragmento específico:

  • Content
    ReferenceEsta opción 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
    fragmentoEsta opción proporciona referencias a otros fragmentos de contenido.
    Este tipo de referencia se utiliza para crear contenido anidado y presenta las relaciones necesarias para modelar el contenido.
    El tipo de datos se puede configurar para que los autores de fragmentos puedan:

    • Edite directamente el fragmento al que se hace referencia.
    • Cree un nuevo fragmento de contenido basado en el modelo apropiado

Creación de modelos de fragmento de contenido

Desde el principio, debe habilitar los modelos de fragmento de contenido para su sitio, esto se hace en el navegador de configuración; en Herramientas -> General -> Explorador de configuración. Puede seleccionar para configurar la entrada global o crear una nueva configuración. Por ejemplo:

Definir configuración

NOTA

Consulte Recursos adicionales: Fragmentos de contenido en el navegador de configuración

A continuación, se pueden crear los modelos de fragmentos de contenido y definir la estructura. Esto se puede hacer en Herramientas -> Recursos -> Modelos de fragmento de contenido. Por ejemplo:

Modelo de fragmento de contenido

NOTA

Consulte Recursos adicionales: Modelos de fragmento de contenido.

Uso del modelo para crear contenido con fragmentos de contenido

Los fragmentos de contenido siempre se basan en un modelo de fragmento de contenido. El modelo proporciona la estructura, el fragmento alberga el contenido.

Selección del modelo apropiado

El primer paso para crear el contenido es crear un fragmento de contenido. Esto se realiza mediante Crear -> Fragmento de contenido en la carpeta requerida en Assets -> Archivos. El asistente lo 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

Una vez creado el fragmento, puede abrirlo en el Editor de fragmentos de contenido. Aquí puede hacer lo siguiente:

  • Edite el contenido en modo normal o de pantalla completa.
  • Dé formato al contenido como Texto completo, Texto sin formato o Marcado.
  • Cree y administre Variaciones de su contenido.
  • Asociar contenido.
  • Edite los metadatos.
  • Mostrar la estructura de árbol.
  • Obtenga una vista previa de la representación JSON.

Creación de fragmentos de contenido

Después de seleccionar el modelo adecuado, se abre un fragmento de contenido para editarlo en el Editor de fragmentos de contenido:

Editor de fragmento de contenido

NOTA

Consulte Recursos adicionales: Uso de fragmentos de contenido.

Introducción a algunos ejemplos

Para obtener una estructura básica como ejemplo, consulte La estructura del fragmento de contenido de ejemplo.

Siguientes pasos

Ahora que ha aprendido a modelar su estructura y a crear contenido en función de eso, el siguiente paso es Aprenda a utilizar las consultas de GraphQL para acceder y recuperar el contenido de los fragmentos de contenido. Esto presentará y analizará GraphQL, y luego verá algunas consultas de ejemplo para ver cómo funcionan las cosas en la práctica.

Recursos adicionales

En esta página