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 fragmento 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 Equipo El modelo de datos de tiene nombre, nombre corto y descripción y hace referencia al Persona modelo de datos, 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 da por hecho que una AEM El entorno de autor de la página está 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.
- Comprender cómo define el modelo de fragmento de contenido ambos el esquema de datos y 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 creando modelo de fragmento de contenido.
-
AEM Inicie sesión en la Autor entorno (p. ej.,
https://author-pYYYY-eXXXX.adobeaemcloud.com/
) -
AEM En la pantalla Inicio de la, vaya a Herramientas > General > Explorador de configuración.
-
Clic Crear, en la esquina superior derecha
-
En el cuadro de diálogo resultante, introduzca:
- Título*: Mi proyecto
- Nombre*: my-project (prefiera utilizar 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.)
- Marque Modelos de fragmento de contenido
- Marque Consultas persistentes de GraphQL
Crear los modelos de fragmentos de contenido
A continuación, cree dos modelos para una Equipo y una Persona.
Creación del modelo de persona
Creación de un modelo para una Persona, que es el modelo de datos que representa a una persona que forma parte de un equipo.
-
AEM En la pantalla Inicio de la, vaya a Herramientas > General > Modelos de fragmento de contenido.
-
Vaya a Mi proyecto carpeta.
-
Tocar Crear en la esquina superior derecha para que aparezca el Crear modelo asistente.
-
Entrada Título de modelo , introduzca Persona y pulse Crear. En el cuadro de diálogo resultante, pulse Abrir, para crear el modelo.
-
Arrastrar y soltar una Texto de línea única en el panel principal. Introduzca las siguientes propiedades en la Propiedades pestaña:
- Etiqueta de campo: Nombre completo
- Nombre de propiedad:
fullName
- Marque Requerido
El Nombre de propiedad AEM define el nombre de la propiedad a la que se mantiene el acceso de forma. El Nombre de propiedad también define la variable key nombre para esta propiedad como parte del esquema de datos. Esta key se utiliza cuando los datos del fragmento de contenido se exponen a través de las API de GraphQL.
-
Pulse el botón Tipos de datos y arrastre y suelte una Texto de varias líneas campo debajo de Nombre completo field. Introduzca las siguientes propiedades:
- Etiqueta de campo: Biografía
- Nombre de propiedad:
biographyText
- Tipo predeterminado: Texto enriquecido
-
Haga clic en Tipos de datos y arrastre y suelte una Referencia de contenido field. Introduzca las siguientes propiedades:
- Etiqueta de campo: Imagen de perfil
- Nombre de propiedad:
profilePicture
- Ruta raíz:
/content/dam
Al configurar el Ruta raíz, puede hacer clic en carpeta para que aparezca un modal y seleccione la ruta. Esto restringe las carpetas que los autores pueden utilizar para rellenar la ruta.
/content/dam
es 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 los tipos de contenido de Imágenes se puede utilizar para rellenar el campo.
-
Haga clic en Tipos de datos y arrastre y suelte una Enumeración Tipo de datos debajo de Referencia de imagen field. Introduzca las siguientes propiedades:
- Procesar como: Casillas
- Etiqueta de campo: Ocupación
- Nombre de propiedad:
occupation
-
Añadir varios Opciones uso del Añadir una opción botón. Utilice el mismo valor para Etiqueta de opción y Valor de opción:
Artista, Influenciador, Fotógrafo, Viajero, Escritor, YouTuber
-
La final Persona El modelo debe tener el siguiente aspecto:
-
Clic Guardar para guardar los cambios.
Crear el modelo de equipo
Creación de un modelo para una 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 el Mi proyecto carpeta, pulse Crear en la esquina superior derecha para que aparezca el Crear modelo asistente.
-
Entrada Título de modelo , introduzca Equipo y pulse Crear.
Tocar Abrir en el cuadro de diálogo resultante, para abrir el modelo recién creado.
-
Arrastrar y soltar una Texto de línea única en el panel principal. Introduzca las siguientes propiedades en la Propiedades pestaña:
- Etiqueta de campo: Título
- Nombre de propiedad:
title
- Marque Requerido
-
Pulse el botón Tipos de datos y arrastre y suelte una Texto de línea única en el panel principal. Introduzca las siguientes propiedades en la Propiedades pestaña:
- Etiqueta de campo: Nombre corto
- Nombre de propiedad:
shortName
- Marque Requerido
- Marque Único
- En, Tipo de validación > elegir Personalizado
- En, Régimen de validación personalizado > introducir
^[a-z0-9\-_]{5,40}$
: esto garantiza que solo se puedan introducir valores alfanuméricos en minúsculas y guiones de 5 a 40 caracteres.
El
shortName
proporciona una forma de consultar a un equipo individual en función de una ruta abreviada. El Único La configuración de garantiza que el valor siempre sea único para cada fragmento de contenido de este modelo. -
Pulse el botón Tipos de datos y arrastre y suelte una Texto de varias líneas campo debajo de Nombre corto field. Introduzca las siguientes propiedades:
- Etiqueta de campo: Descripción
- Nombre de propiedad:
description
- Tipo predeterminado: Texto enriquecido
-
Haga clic en Tipos de datos y arrastre y suelte una Referencia a fragmento field. Introduzca las siguientes propiedades:
- Procesar como: Campo múltiple
- Etiqueta de campo: Miembros del equipo
- Nombre de propiedad:
teamMembers
- Modelos permitidos de fragmento de contenido: utilice el icono de la carpeta para seleccionar el Persona modelo.
-
La final Equipo El modelo debe tener el siguiente aspecto:
-
Clic 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 el Project Configuration
& Content Fragment Model
-
AEM En la pantalla Inicio de la, vaya a Herramientas > General > Explorador de configuración.
-
Pulse la casilla que hay junto a Mi proyecto y pulse Publish
-
AEM En la pantalla Inicio de la, vaya a Herramientas > General > Modelos de fragmento de contenido.
-
Vaya a Mi proyecto carpeta.
-
Tocar Persona y Equipo modelos y pulse Publish
Enhorabuena. congratulations
¡Enhorabuena, acaba de crear sus primeros modelos de fragmentos de contenido!
Pasos siguientes next-steps
En el capítulo siguiente, Creación de modelos de fragmentos de contenido, puede crear y editar un nuevo fragmento de contenido basado en un modelo de fragmento de contenido. También aprenderá a crear variaciones de Fragmentos de contenido.