Definición de los modelos de fragmento de contenido content-fragment-models
En este capítulo, aprenderá a modelar contenido y a crear un esquema con Modelos de fragmentos de contenido. Obtenga información sobre los diferentes tipos de datos que se pueden utilizar para definir un esquema como parte del modelo.
Creamos dos modelos simples, Equipo y Persona. El modelo de datos Equipo tiene nombre, nombre corto y descripción y hace referencia al modelo de datos Persona, que tiene nombre completo, detalles biológicos, imagen de perfil y lista de ocupaciones.
También puede crear su propio modelo siguiendo los pasos básicos y modificar los pasos respectivos, como consultas de GraphQL y código de aplicación de React, o simplemente seguir los pasos descritos en estos capítulos.
Requisitos previos prerequisites
Este es un tutorial de varias partes y se supone que hay un entorno de creación de AEM disponible.
Objetivos objectives
- Cree un modelo de fragmento de contenido.
- Identifique los tipos de datos y las opciones de validación disponibles para crear modelos.
- Comprenda cómo el modelo de fragmento de contenido define tanto el esquema de datos como la plantilla de creación de un fragmento de contenido.
Crear una configuración de proyecto
Una configuración de proyecto contiene todos los modelos de fragmento de contenido asociados a un proyecto concreto y proporciona un medio para organizar los modelos. Debe crearse al menos un proyecto antes de que cree el modelo de fragmento de contenido.
-
Inicie sesión en el entorno de AEM Author (p. ej.
https://author-pYYYY-eXXXX.adobeaemcloud.com/) -
En la pantalla de inicio de AEM, vaya a Herramientas > General > Explorador de configuración.
-
Haga clic en Crear, en la esquina superior derecha
-
En el cuadro de diálogo resultante, introduzca:
- Título*: Mi proyecto
- Nombre*: my-project (prefiera usar todas las minúsculas usando guiones para separar las palabras). Esta cadena influye en el extremo único de GraphQL con el que las aplicaciones cliente realizan solicitudes.)
- Comprobar modelos de fragmentos de contenido
- Comprobar consultas persistentes de GraphQL
Crear los modelos de fragmentos de contenido
A continuación, crea dos modelos para un equipo y una persona.
Creación del modelo de persona
Cree un modelo para una persona, que es el modelo de datos que representa a una persona que forma parte de un equipo.
-
En la pantalla de inicio de AEM, vaya a Herramientas > General > Modelos de fragmentos de contenido.
-
Vaya a la carpeta Mi proyecto.
-
Pulse Crear en la esquina superior derecha para que aparezca el asistente Crear modelo.
-
En el campo Título de modelo, escriba Persona y pulse Crear. En el cuadro de diálogo resultante, pulse Abrir para generar el modelo.
-
Arrastre y suelte un elemento Texto de una sola línea en el panel principal. Escriba las siguientes propiedades en la ficha Propiedades:
- Etiqueta de campo: Nombre completo
- Nombre de propiedad:
fullName - Comprobación Requerida
Nombre de propiedad define el nombre de la propiedad que se mantiene en AEM. El Nombre de propiedad también define el nombre de clave para esta propiedad como parte del esquema de datos. Esta clave key se usa cuando los datos del fragmento de contenido se exponen a través de las API de GraphQL.
-
Pulse la pestaña Tipos de datos y arrastre y suelte un campo de Texto de varias líneas debajo del campo Nombre completo. Introduzca las siguientes propiedades:
- Etiqueta de campo: Biografía
- Nombre de propiedad:
biographyText - Tipo predeterminado: Texto enriquecido
-
Haga clic en la pestaña Tipos de datos y arrastre y suelte un campo de Referencia de contenido. Introduzca las siguientes propiedades:
- Etiqueta de campo: Imagen de perfil
- Nombre de propiedad:
profilePicture - Ruta raíz:
/content/dam
Al configurar la Ruta raíz, puede hacer clic en el icono carpeta para que aparezca un modal y seleccione la ruta. Esto restringe las carpetas que los autores pueden utilizar para rellenar la ruta.
/content/dames la raíz en la que se almacenan todos los AEM Assets (imágenes, vídeos y otros fragmentos de contenido). -
Agregue una validación a la Referencia de imagen para que solo se puedan usar los tipos de contenido de Imágenes para rellenar el campo.
-
Haga clic en la ficha Tipos de datos y arrastre y suelte un tipo de datos Enumeración debajo del campo Referencia de imagen. Introduzca las siguientes propiedades:
- Procesar Como: Casillas
- Etiqueta de campo: Ocupación
- Nombre de propiedad:
occupation
-
Agregar varias Opciones mediante el botón Agregar una opción. Use el mismo valor para Etiqueta de opción y Valor de opción:
Artista, Influencer, Fotógrafo, Viajero, Escritor, YouTuber
-
El modelo final de persona debe tener el siguiente aspecto:
-
Haga clic en Guardar para guardar los cambios.
Crear el modelo de equipo
Cree un modelo para un equipo, que es el modelo de datos para un equipo de personas. El modelo Equipo hace referencia al modelo Persona para representar a los miembros del equipo.
-
En la carpeta Mi proyecto, pulsa Crear en la esquina superior derecha para que aparezca el asistente Crear modelo.
-
En el campo Título de modelo, escribe Equipo y pulsa Crear.
Pulse Abrir en el cuadro de diálogo resultante para abrir el modelo recién creado.
-
Arrastre y suelte un elemento Texto de una sola línea en el panel principal. Escriba las siguientes propiedades en la ficha Propiedades:
- Etiqueta de campo: Título
- Nombre de propiedad:
title - Comprobación Requerida
-
Pulse la pestaña Tipos de datos y arrastre y suelte un elemento de Texto de una sola línea en el panel principal. Escriba las siguientes propiedades en la ficha Propiedades:
- Etiqueta de campo: Nombre corto
- Nombre de propiedad:
shortName - Comprobación Requerida
- Seleccionar Único
- En, Tipo de validación > elija Personalizado
- En, Expresión regular de validación personalizada > escriba
^[a-z0-9\-_]{5,40}$: esto garantiza que solo se puedan escribir valores alfanuméricos en minúsculas y guiones de 5 a 40 caracteres.
La propiedad
shortNameproporciona una forma de consultar a un equipo individual en función de una ruta de acceso abreviada. La configuración Único garantiza que el valor siempre sea único por fragmento de contenido de este modelo. -
Pulse la pestaña Tipos de datos y arrastre y suelte un campo de Texto de varias líneas debajo del campo Nombre corto. Introduzca las siguientes propiedades:
- Etiqueta de campo: Descripción
- Nombre de propiedad:
description - Tipo predeterminado: Texto enriquecido
-
Haga clic en la pestaña Tipos de datos y arrastre y suelte un campo Referencia de fragmento. Introduzca las siguientes propiedades:
- Procesar Como: Campo Múltiple
- Etiqueta de campo: Miembros del equipo
- Nombre de propiedad:
teamMembers - Modelos de fragmento de contenido permitidos: use el icono de carpeta para seleccionar el modelo Persona.
-
El modelo final de equipo debería tener el siguiente aspecto:
-
Haga clic en Guardar para guardar los cambios.
-
Ahora debería tener dos modelos desde los que trabajar:
Publicar configuración de proyecto y modelos de fragmentos de contenido
Tras la revisión y verificación, publique Project Configuration y Content Fragment Model
-
En la pantalla de inicio de AEM, vaya a Herramientas > General > Explorador de configuración.
-
Puntee en la casilla que está junto a Mi proyecto y luego en Publicar
-
En la pantalla de inicio de AEM, vaya a Herramientas > General > Modelos de fragmentos de contenido.
-
Vaya a la carpeta Mi proyecto.
-
Pulse Persona y Equipo modelos y pulse Publicar
Enhorabuena. congratulations
¡Enhorabuena, acaba de crear sus primeros modelos de fragmentos de contenido!
Siguientes pasos next-steps
En el capítulo siguiente, Creación de modelos de fragmentos de contenido, crea y edita un nuevo fragmento de contenido basado en un modelo de fragmento de contenido. También aprenderá a crear variaciones de Fragmentos de contenido.