Definición de los modelos de fragmento de contenido defining-content-fragment-models
Los modelos de fragmentos de contenido de Adobe Experience Manager (AEM) as a Cloud Service definen la estructura del contenido de sus fragmentos de contenido. Estos fragmentos se pueden utilizar para la creación de páginas o como base para el contenido sin encabezado.
Esta página cubre cómo definir el modelo de fragmento de contenido mediante el editor dedicado. Consulte Administración de los modelos de fragmentos de contenido para obtener más información sobre las tareas y opciones disponibles una vez creados los fragmentos, incluidas las acciones disponibles en la consola Fragmentos de contenido, permitir el modelo en la carpeta y publicar el modelo.
Definición del modelo de fragmento de contenido defining-your-content-fragment-model
El modelo de fragmento de contenido define de forma efectiva la estructura de los fragmentos de contenido resultantes mediante una selección de tipos de datos. Con el editor de modelos puede añadir instancias de los tipos de datos y, a continuación, configurarlos para crear los campos obligatorios.
-
En la consola Fragmento de contenido, seleccione el panel de Modelos de fragmento de contenido y vaya a la carpeta que contiene el modelo de fragmento de contenido.
note note NOTE También puede abrir un modelo directamente después de crearlo. -
Abra el modelo necesario para Editar; utilice la acción rápida o seleccione el modelo y, después, la acción en la barra de herramientas.
Una vez abierto, el editor de modelos muestra lo siguiente:
- A la izquierda: los campos ya definidos.
- A la derecha: los Tipos de datos disponibles para crear campos (y Propiedades para su uso una vez creados los campos)
note note NOTE Cuando un campo se define como Obligatorio, la Etiqueta indicada en el panel izquierdo se marca con un asterisco (*). 
-
Adición de un campo
-
Arrastre un tipo de datos requerido a la ubicación requerida para un campo.
-
Una vez agregado un campo al modelo, el panel derecho muestra las Propiedades que se pueden definir para ese tipo de datos en particular. Aquí puede definir lo que se requiere para ese campo.
-
Muchas propiedades se explican por sí mismas; para obtener más información, consulte Propiedades (tipos de datos).
-
Escribir una Etiqueta de campo autocompleta Nombre de propiedad, si está vacío, y se puede actualizar de forma manual posteriormente.
note caution CAUTION Al actualizar manualmente la propiedad Nombre de propiedad para un tipo de datos, los nombres deben contener solamente caracteres latinos, dígitos numéricos y guiones bajos "_" como carácter especial. Si los modelos creados en versiones anteriores de AEM contienen caracteres no permitidos, elimínelos o actualícelos.
Por ejemplo:
-
-
-
Eliminación de un campo
Seleccione el campo requerido y, a continuación, seleccione el icono de la papelera. Se le solicitará que confirme la acción.
-
Añada todos los campos obligatorios y defina las propiedades relacionadas, según sea necesario. Por ejemplo:
-
Seleccione Guardar para mantener la definición.
Tipos de datos data-types
Hay disponible una selección de tipos de datos para definir el modelo:
-
Texto de línea única
- Agregue un campo para una sola línea de texto; se puede definir la longitud máxima
- El campo se puede configurar para permitir que los autores de fragmentos creen nuevas instancias del campo
-
Texto multilínea
- Un área de texto que puede ser Texto enriquecido, Texto sin formato o Markdown
- El campo se puede configurar para permitir que los autores de fragmentos creen nuevas instancias del campo
note note NOTE Si el área de texto es Texto enriquecido, Texto sin formato o Markdown, se define en el modelo mediante la propiedad Tipo predeterminado. Este formato no se puede cambiar desde el editor de fragmentos de contenido, sino solamente desde el modelo. -
Número
- Añadir un campo numérico
- El campo se puede configurar para permitir que los autores de fragmentos creen nuevas instancias del campo
-
Booleana
- Adición de una casilla de verificación booleana
-
Fecha y hora
- Adición de un campo de fecha u hora
-
Lista desglosada
- Agregar un conjunto de campos de casilla de verificación, botones de opción o desplegables
- Puede especificar las opciones disponibles para el autor del fragmento
- Agregar un conjunto de campos de casilla de verificación, botones de opción o desplegables
-
Etiquetas
- Permite a los autores de fragmentos acceder y seleccionar áreas de etiquetas
-
Referencia a fragmento
-
Referencias a otros fragmentos de contenido; se pueden usar para crear contenido anidado
-
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 adecuado
- Crear nuevas instancias del campo
-
La referencia especifica la ruta al recurso al que se hace referencia; por ejemplo
/content/dam/path/to/resource
-
-
Referencia de fragmento (UUID)
-
Referencias a otros fragmentos de contenido; se pueden usar para crear contenido anidado
-
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 adecuado
- Crear nuevas instancias del campo
-
En el editor, la referencia especifica la ruta al recurso al que se hace referencia; internamente, la referencia se mantiene como un ID único universal (UUID) que hace referencia al recurso
- No es necesario conocer el UUID; en el editor de fragmentos puede buscar el fragmento requerido
-
-
Referencia de contenido
- Referencias a otros contenidos, de cualquier tipo; se pueden usar para crear contenido anidado
- Si se hace referencia a una imagen, puede optar por mostrar una miniatura
- El campo se puede configurar para permitir que los autores de fragmentos creen nuevas instancias del campo
- La referencia especifica la ruta al recurso al que se hace referencia; por ejemplo
/content/dam/path/to/resource
-
Referencia de contenido (UUID)
- Referencias a otros contenidos, de cualquier tipo; se pueden usar para crear contenido anidado
- Si se hace referencia a una imagen, puede optar por mostrar una miniatura
- El campo se puede configurar para permitir que los autores de fragmentos creen nuevas instancias del campo
- En el editor, la referencia especifica la ruta al recurso al que se hace referencia; internamente, la referencia se mantiene como un ID único universal (UUID) que hace referencia al recurso
- No necesita conocer el UUID; en el editor de fragmentos puede navegar hasta el recurso de recurso requerido
-
Objeto JSON
-
Permite al autor del fragmento de contenido introducir la sintaxis JSON en los elementos correspondientes de un fragmento.
- Para permitir que AEM almacene el JSON directo que ha copiado/pegado desde otro servicio.
- El JSON se pasará y se emitirá como JSON en GraphQL.
- Incluye resaltado de sintaxis JSON, autocompletado y resaltado de errores en el editor de fragmentos de contenido.
-
-
Marcador de posición de pestaña
-
Permite la introducción de pestañas para utilizarlas al editar el contenido del fragmento de contenido.
- Se muestran como divisores en el editor de modelos, que separan las secciones de la lista de tipos de datos de contenido. Cada instancia representa el inicio de una nueva pestaña.
- En el editor de fragmentos, cada instancia aparece como una pestaña.
note note NOTE Este tipo de datos se utiliza exclusivamente para dar formato; el esquema AEM GraphQL lo ignora.
-
Propiedades (tipos de datos) properties
Muchas propiedades se explican por sí mismas; para otras, a continuación se proporcionan detalles adicionales:
-
Nombre de propiedad
Al actualizar manualmente esta propiedad para un tipo de datos, los nombres debe contener solamente caracteres latinos, dígitos numéricos y guiones bajos "_" como carácter especial.
note caution CAUTION Si los modelos creados en versiones anteriores de AEM contienen caracteres no permitidos, elimínelos o actualícelos. -
Procesar Como
Las distintas opciones para realizar/procesar el campo en un fragmento. A menudo, esto le permite definir si el autor verá una sola instancia del campo o si se le permitirá crear varias instancias. Cuando se usa Campo múltiple, puede definir el número mínimo y máximo de elementos; consulte Validación para obtener más información.
-
Etiqueta de campo
La introducción de Etiqueta de campo genera automáticamente un Nombre de propiedad, que se puede actualizar de forma manual si es necesario. -
Validación
La validación básica está disponible mediante mecanismos como la propiedad Requerido. Algunos tipos de datos tienen campos de validación adicionales. Consulte Validación para obtener más información. -
Para el tipo de datos Texto multilínea es posible definir el tipo predeterminado como el siguiente:
- Texto enriquecido
- Markdown
- Texto sin formato
Si no se especifica, el valor predeterminado Texto enriquecido es el empleado para este campo.
Cambiar el tipo predeterminado en un modelo de fragmento de contenido solo surtirá efecto en un fragmento de contenido existente relacionado después de que dicho fragmento se abra en el editor y se guarde.
-
Único
El contenido (para el campo específico) debe ser único en todos los fragmentos de contenido creados a partir del modelo actual.Se utiliza para garantizar que los autores de contenido no puedan repetir el contenido ya añadido en otro fragmento del mismo modelo.
Por ejemplo, un campo de Texto de una sola línea llamado
Countryen el modelo de fragmentos de contenido no puede tener el valorJapanen dos fragmentos de contenido dependientes. Se emitirá una advertencia cuando se intente la segunda instancia.note note NOTE La unicidad se garantiza por cada raíz de idioma. note note NOTE Las variaciones pueden tener el mismo valor único como variaciones del mismo fragmento, pero no del mismo valor que se utiliza en cualquier variación de otros fragmentos. -
Consulte Referencia de contenido para obtener más información acerca de ese tipo de datos específico y sus propiedades.
-
Consulte Referencia a fragmento (fragmentos anidados) para obtener más información acerca de ese tipo de datos específico y sus propiedades.
-
Traducible
Marcar la casilla de verificación Traducible en un campo del editor de modelos de fragmentos de contenido provocará lo siguiente:
- Asegurará que el nombre de propiedad del campo se añade a la configuración de traducción y contexto
/content/dam/<sites-configuration>, si no están presentes. - Para GraphQL: establecerá una propiedad
<translatable>en el campo Fragmento de contenido enyes, para permitir que la consulta GraphQL filtre la salida JSON solo con contenido traducible.
- Asegurará que el nombre de propiedad del campo se añade a la configuración de traducción y contexto
Validación validation
Varios tipos de datos ahora incluyen la posibilidad de definir los requisitos de validación cuando el contenido se introduce en el fragmento resultante:
-
Texto de línea única
- Compare con un regex predefinido.
-
Número
- Compruebe si hay valores específicos.
-
Referencia de contenido
- Pruebe tipos de contenido específicos.
- Solo se puede hacer referencia a los recursos con un tamaño de archivo especificado o más pequeño.
- Solo se puede hacer referencia a las imágenes con un intervalo predefinido de anchura o altura (en píxeles).
-
Referencia a fragmento
- Pruebe un modelo de fragmento de contenido específico.
-
Número mínimo de elementos / Número máximo de elementos
Los campos que se han definido como un campo múltiple (configurado con Procesar como) tienen las opciones:
- Número mínimo de elementos
- Número máximo de elementos
Se validan en el Editor de fragmentos de contenido.
Uso de referencias para formar contenido anidado using-references-to-form-nested-content
Los fragmentos de contenido pueden formar contenido anidado mediante cualquiera de los siguientes tipos de datos:
-
-
Proporciona una sencilla referencia a otro contenido; de cualquier tipo.
-
Proporcionado por los tipos de datos:
- Referencia de contenido - basado en ruta
- Referencia de contenido (UUID) - basada en UUID
-
Se puede configurar para una o varias referencias (en el fragmento resultante).
-
-
Referencia a fragmento (fragmentos anidados)
-
Hace referencia a otros fragmentos, según los modelos específicos definidos.
-
Proporcionado por los tipos de datos:
- Referencia de fragmento - basado en ruta
- Referencia de fragmento (UUID) - basado en UUID
-
Permite incluir o recuperar datos estructurados.
note note NOTE Este método es de particular interés cuando se usa Entrega de contenido sin encabezado mediante fragmentos de contenido con GraphQL. * Se puede configurar para una o varias referencias (en el fragmento resultante).
-
-
Referencias de contenido
Esto evita que el usuario agregue una referencia al fragmento actual y puede provocar un cuadro de diálogo vacío del selector de referencia a fragmento. -
Referencias a fragmento en GraphQL
Si crea una consulta profunda que devuelve varios fragmentos de contenido referenciados entre sí, devolverá un valor nulo en la primera ocurrencia.
Referencia de contenido content-reference
Los tipos de datos Referencia de contenido y Referencia de contenido (UUID) le permiten procesar contenido de otra fuente; por ejemplo, imagen, página o Fragmento de experiencia.
Además de las propiedades estándar, puede especificar las siguentes:
-
La Ruta raíz, que especifica o representa dónde almacenar el contenido referenciado
note note NOTE Esto es obligatorio si desea cargar directamente y hacer referencia a imágenes en este campo al utilizar el editor de fragmentos de contenido. Consulte Imágenes de referencia para obtener más información. -
Los tipos de contenido a los que se puede hacer referencia
note note NOTE Deben incluir Image si desea cargar directamente y hacer referencia a las imágenes de este campo al utilizar el editor de fragmentos de contenido. Consulte Imágenes de referencia para obtener más información. -
Las limitaciones de los tamaños de archivo
-
Si se hace referencia a una imagen:
- Mostrar miniatura
- Restricciones de imagen de altura y anchura
Referencia a fragmento (fragmentos anidados) fragment-reference-nested-fragments
Los tipos de datos Referencia de fragmento y Referencia de fragmento (UUID) pueden hacer referencia a uno o más fragmentos de contenido. Esta función es de especial interés cuando se recupera contenido para utilizarlo en la aplicación, ya que le permite recuperar datos estructurados con varias capas.
Por ejemplo:
- Un modelo que define los detalles de un empleado, lo que incluye:
- Una referencia al modelo que define al empleador (compañía).
type EmployeeModel {
name: String
firstName: String
company: CompanyModel
}
type CompanyModel {
name: String
street: String
city: String
}
Además de las propiedades estándar, puede definir las siguientes:
-
Procesar como:
-
Multicampo: el autor del fragmento puede crear varias referencias individuales.
-
fragmentreference: permite al autor del fragmento seleccionar una sola referencia a un fragmento.
-
-
Tipo de modelo:
sueden seleccionar varios modelos. Al añadir referencias a un fragmento de contenido, cualquier fragmento al que se haga referencia debe haberse creado con estos modelos. -
Ruta raíz
Esto especifica o representa una ruta raíz para los fragmentos a los que se hace referencia. -
Permitir creación de fragmentos
Esto permite al autor del fragmento crear un fragmento basado en el modelo adecuado.
- fragmentreferencecomposite: permite al autor del fragmento crear un compuesto seleccionando varios fragmentos.
