AEM Los modelos de fragmentos de contenido de la definición de la estructura de contenido para su contenido en la fragmentos de contenido, servir como base del contenido sin encabezado.
Para usar modelos de fragmentos de contenido, haga lo siguiente:
Vaya a Herramientas, Assets, luego abra Modelos de fragmento de contenido.
Vaya a la carpeta adecuada para su configuración.
Use Crear para abrir el asistente.
Si no se ha habilitado el uso de modelos de fragmentos de contenido, la opción Crear no estará disponible.
Especifique el Título del modelo. También puede añadir Etiquetas, una Descripción y seleccionar Habilitar modelo para activar el modelo, si es necesario.
Use Crear para guardar el modelo vacío. Un mensaje indica el éxito de la acción. Puede seleccionar Abrir para editar de inmediato el modelo o Listo para volver a la consola.
El modelo de fragmento de contenido define de manera 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.
Editar un modelo de fragmento de contenido existente puede afectar a los fragmentos dependientes.
Vaya a Herramientas, Assets, luego abra Modelos de fragmento de contenido.
Vaya a la carpeta que contiene el modelo de fragmento de contenido.
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:
Cuando un campo es 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 añadido un campo al modelo, el panel derecho mostrará 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.
Escribir una Etiqueta de campo autocompletará el Nombre de propiedad si está vacío, y se puede actualizar de forma manual más tarde.
Al actualizar de forma manual la propiedad Nombre de propiedad para un tipo de datos, tenga en cuenta que los nombres solo deben contener 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, toque o haga clic en 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.
Hay disponible una selección de tipos de datos para definir el modelo:
Permite la introducción de pestañas para utilizarlas al editar el contenido del fragmento de contenido.
Esto se mostrará como un divisor en el editor de modelos, que separa 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 aparecerá como una pestaña.
Este tipo de datos se utiliza exclusivamente para dar formato; el esquema AEM GraphQL lo ignora.
Muchas propiedades se explican por sí mismas; para otras, a continuación se proporcionan detalles adicionales:
Nombre de propiedad
Cuando actualice manualmente esta propiedad para un tipo de datos, tenga en cuenta que los nombres deben contener solo 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.
Representar 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.
Etiqueta de campo
Introducir una
Etiqueta de campo generará 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:
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 Country
en el modelo de fragmentos de contenido no puede tener el valor Japan
en dos fragmentos de contenido dependientes. Se emitirá una advertencia cuando se intente la segunda instancia.
La unicidad se garantiza por cada raíz de idioma.
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.
Varios tipos de datos ahora incluyen la posibilidad de definir los requisitos de validación cuando el contenido se introduce en el fragmento resultante:
Los fragmentos de contenido pueden formar contenido anidado mediante cualquiera de los siguientes tipos de datos:
Referencia a fragmento (fragmentos anidados)
Hace referencia a otros fragmentos, según los modelos específicos definidos.
Permite incluir o recuperar datos estructurados.
Este método reviste especial interés en conjunción con la Entrega de contenido sin encabezado mediante fragmentos de contenido con GraphQL.
AEM tiene una protección contra recurrencias para lo siguiente:
Referencias de contenido
Esto evita que el usuario agregue una referencia al fragmento actual. Esto puede dar lugar a 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.
La referencia de contenido le permite procesar contenido de otra fuente; por ejemplo, imagen o fragmento de contenido.
Además de las propiedades estándar, puede especificar las siguentes:
La referencia a fragmento hace 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:
type EmployeeModel {
name: String
firstName: String
company: CompanyModel
}
type CompanyModel {
name: String
street: String
city: String
}
Esto reviste especial interés en conjunción con la Entrega de contenido sin encabezado mediante fragmentos de contenido con GraphQL.
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 crear el fragmento de contenido, se debe haber creado cualquier fragmento referenciado mediante estos modelos.
Ruta raíz:
Esto especifica una ruta raíz para los fragmentos a los que se hace referencia.
Permitir creación de fragmentos
Esto permitirá al autor del fragmento crear un nuevo fragmento basado en el modelo adecuado.
Existe un mecanismo de protección contra la recurrencia. Prohíbe que el usuario seleccione el fragmento de contenido actual en la Referencia a fragmento. Esto puede dar lugar a un cuadro de diálogo vacío del selector de referencia a fragmento.
También existe una protección contra la recurrencia para las referencias a fragmento en GraphQL. Si crea una consulta profunda en dos fragmentos de contenido que se hacen referencia entre sí, devolverá un valor nulo.
Para tener un control total sobre el uso de los modelos de fragmentos de contenido, estos tienen un estado que puede configurar.
Una vez creado un modelo, debe activarse para que:
Para habilitar un modelo marcado como lo siguiente:
Utilice la opción Habilitar desde:
Un modelo también se puede desactivar para que:
Para desactivar un modelo marcado como Habilitado utilice la opción Deshabilitar desde:
Para implementar el control de contenido, puede configurar las Directivas en la carpeta Recursos para controlar qué modelos de fragmento de contenido están permitidos para la creación de fragmentos en esa carpeta.
El mecanismo es similar a permitir plantillas de página para una página, y sus elementos secundarios, en propiedades avanzadas de una página.
Para configurar las Directivas para Modelos de fragmento de contenido permitidos:
Navegar y abrir Propiedades para la carpeta de recursos necesaria.
Abra la pestaña Directivas, donde puede configurar lo siguiente:
Heredado de<folder>
Las directivas se heredan automáticamente al crear nuevas carpetas secundarias; la directiva se puede reconfigurar (y la herencia se rompe) si las subcarpetas necesitan permitir modelos diferentes de la carpeta principal.
Modelos de fragmento de contenido permitidos por ruta
Se pueden permitir varios modelos.
Modelos de fragmento de contenido permitidos por etiquetas
Se pueden permitir varios modelos.
Guardar cualquier cambio.
Los modelos de fragmento de contenido permitidos para una carpeta se resuelven de la siguiente manera:
La eliminación de un modelo de fragmento de contenido puede afectar a los fragmentos dependientes.
Para eliminar un modelo de fragmento de contenido, haga lo siguiente:
Vaya a Herramientas, Assets, luego abra Modelos de fragmento de contenido.
Vaya a la carpeta que contiene el modelo de fragmento de contenido.
Seleccione el modelo, seguido de Eliminar en la barra de herramientas.
Si se hace referencia al modelo, se envía una advertencia. Tome las medidas adecuadas.
Los modelos de fragmento de contenido deben publicarse cuando se publican fragmentos de contenido dependientes, o antes de hacerlo.
Para publicar un modelo de fragmento de contenido, haga lo siguiente:
Vaya a Herramientas, Assets, luego abra Modelos de fragmento de contenido.
Vaya a la carpeta que contiene el modelo de fragmento de contenido.
Seleccione el modelo, seguido de Publicación en la barra de herramientas.
El estado publicado se indica en la consola.
Si publica un fragmento de contenido para el que el modelo aún no se ha publicado, la lista de selección lo indicará y el modelo se publicará con el fragmento.
Los modelos de fragmento de contenido se pueden cancelar si ningún fragmento hace referencia a ellos.
Para cancelar la publicación de un modelo de fragmento de contenido:
Vaya a Herramientas, Assets, luego abra Modelos de fragmento de contenido.
Vaya a la carpeta que contiene el modelo de fragmento de contenido.
Seleccione el modelo, seguido de Cancelar la publicación en la barra de herramientas.
El estado publicado se indica en la consola.
Puede editar las Propiedades de un modelo de fragmento de contenido: