Modelos de fragmento de contenido 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.
Para usar modelos de fragmentos de contenido, haga lo siguiente:
- Habilite la funcionalidad de modelos de fragmentos de contenido para la instancia.
- Cree y configure sus modelos de fragmentos de contenido.
- Habilite los modelos de fragmento de contenido para usar al crear fragmentos de contenido
- Permita los modelos de fragmentos de contenido en las carpetas de recursos necesarias configurando Políticas.
Creación de un modelo de fragmento de contenido creating-a-content-fragment-model
-
Vaya a Herramientas, General y, a continuación, abra Modelos de fragmentos de contenido.
-
Vaya a la carpeta adecuada para su configuración o subconfiguración.
-
Use Crear para abrir el asistente.
note caution CAUTION Si no se ha habilitado el uso de modelos de fragmento de contenido, la opción Crear no estará disponible. -
Especifique Título de modelo.
También puede definir varias propiedades; por ejemplo, agregar Etiquetas, una Descripción, seleccionar Habilitar modelo para habilitar el modelo si es necesario y definir el
Patrón de URL de vista previa predeterminado.note note NOTE Consulte Modelo de fragmento de contenido: propiedades para obtener información detallada. -
Use Crear para guardar el modelo vacío. Un mensaje indica el éxito de la acción. Puede seleccionar Abrir para editar inmediatamente el modelo o Listo para volver a la consola.
Modelo de fragmento de contenido: propiedades content-fragment-model-properties
Estas propiedades se definen al crear un modelo y se pueden editar más adelante con la opción Propiedades para el modelo de fragmento de contenido:
-
Básico
-
Título de modelo
-
Etiquetas
-
Descripción
-
Habilitar modelo
-
Patrón de URL de vista previa predeterminado
El editor de fragmentos de contenido permite a los autores previsualizar su contenido en una aplicación de front-end externa. Una vez configurado el servicio de vista previa, agregue la dirección URL de la aplicación de front-end.La URL de vista previa debe seguir este patrón:
https://<preview_url>?param=${expression}
Las expresiones disponibles son:
${contentFragment.path}
${contentFragment.model.path}
${contentFragment.model.name}
${contentFragment.variation}
${contentFragment.id}
-
Cargar imagen
-
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.
-
Vaya a Herramientas, General y, a continuación, abra Modelos de fragmentos 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:
- 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.
-
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 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
-
Referencia a fragmento
-
Referencias a otros fragmentos de contenido; se pueden usar para crear contenido anidado
-
El campo se puede configurar para que los autores de fragmentos puedan hacer lo siguiente:
- Editar directamente el fragmento referenciado
- Crear un nuevo fragmento de contenido basado en el modelo adecuado
- Crear nuevas instancias del campo
-
-
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 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
Country
en el modelo de fragmentos de contenido no puede tener el valorJapan
en 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.
- 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.
-
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
La referencia de contenido le permite 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 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
La referencia a fragmento hace referencia a uno o varios 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 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.
Activación o desactivación de un modelo de fragmento de contenido enabling-disabling-a-content-fragment-model
Puede Habilitar o Deshabilitar sus modelos de fragmentos de contenido para tener un control total sobre su uso.
Activación de un modelo de fragmento de contenido enabling-a-content-fragment-model
Una vez creado un modelo, debe activarse para que:
- Está disponible para su selección al crear un fragmento de contenido.
- Se pueda hacer referencia a él desde un modelo de fragmento de contenido.
- Esté disponible para GraphQL y por lo tanto, se genere el esquema.
Para habilitar un modelo marcado como lo siguiente:
- Borrador : nuevo (nunca habilitado).
- Desactivado: se ha deshabilitado específicamente.
Utilice la opción Habilitar desde:
- La barra de herramientas superior, cuando se selecciona el Modelo requerido.
- La Acción rápida correspondiente (pase el ratón sobre el Modelo requerido).
Desactivación de un modelo de fragmento de contenido disabling-a-content-fragment-model
Un modelo también se puede desactivar para que:
-
El modelo ya no esté disponible como base para la creación de nuevos fragmentos de contenido.
-
Sin embargo:
- El esquema de GraphQL se siga generando y aún se pueda consultar (para evitar afectar a la API de JSON).
- Cualquier fragmento de contenido basado en el modelo se puede consultar y devolver desde el extremo de GraphQL.
-
Ya no se puede hacer referencia al modelo, pero las referencias existentes no se tocan y aún se pueden consultar y devolver desde el extremo GraphQL.
Para deshabilitar un modelo marcado como Habilitado, use la opción Deshabilitar desde:
- La barra de herramientas superior, cuando se selecciona el Modelo requerido.
- La Acción rápida correspondiente (pase el ratón sobre el Modelo requerido).
Permitir modelos de fragmento de contenido en la carpeta de recursos allowing-content-fragment-models-assets-folder
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.
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:
- Las Directivas para los Modelos de fragmento de contenido permitidos.
- Si está vacío, intente determinar la directiva utilizando las reglas de herencia.
- Si la cadena de herencia no proporciona un resultado, consulte la configuración de Cloud Services para esa carpeta (primero directamente y luego mediante herencia).
- Si ninguno de los anteriores proporciona ningún resultado, no hay modelos permitidos para esa carpeta.
Eliminación de un modelo de fragmento de contenido deleting-a-content-fragment-model
Para eliminar un modelo de fragmento de contenido:
-
Vaya a Herramientas, General y, a continuación, abra Modelos de fragmentos 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.
note note NOTE Si se hace referencia al modelo, se envía una advertencia para que pueda realizar las acciones adecuadas.
Publicación de un modelo de fragmento de contenido publishing-a-content-fragment-model
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:
-
Vaya a Herramientas, General y, a continuación, abra Modelos de fragmentos 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 muestra en la consola.note note NOTE 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.
Cancelación de la publicación de un modelo de fragmento de contenido unpublishing-a-content-fragment-model
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, General y, a continuación, abra Modelos de fragmentos 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.
Si intenta cancelar la publicación de un modelo que actualmente utiliza uno o varios fragmentos, se muestra una advertencia de error. Por ejemplo:
El mensaje sugiere que verifique el panel Referencias para investigar más a fondo:
Modelos de fragmento de contenido bloqueados (publicados) locked-published-content-fragment-models
Esta funcionalidad proporciona control para los modelos de fragmento de contenido que se han publicado.
Desafíos the-challenge
-
Los modelos de fragmentos de contenido determinan el esquema de las consultas de GraphQL en AEM.
-
Los esquemas de GraphQL de AEM se crean en cuanto se genera un modelo de fragmento de contenido y pueden existir en entornos de creación y publicación.
-
Los esquemas en la publicación son los más críticos, ya que proporcionan la base para la entrega en directo de contenido de fragmento de contenido en formato JSON.
-
-
Pueden producirse problemas cuando se modifican los modelos de fragmento de contenido o, dicho de otro modo, se editan. Esto significa que el esquema cambia, lo que a su vez puede afectar a las consultas de GraphQL existentes.
-
La adición de nuevos campos a un modelo de fragmento de contenido no debería (normalmente) tener ningún efecto perjudicial. Sin embargo, si se modifican los campos de datos existentes (por ejemplo, su nombre) o se eliminan las definiciones de campos, las consultas de GraphQL existentes se romperán al solicitar estos campos.
Requisitos the-requirements
-
Para concienciar a los usuarios sobre los riesgos que se plantean al editar modelos que ya se utilizan para la entrega de contenido en directo (es decir, modelos que se han publicado).
-
Además, para evitar cambios no deseados.
Cualquiera de estos criterios podría generar consultas si se vuelven a publicar los modelos modificados.
Solución the-solution
Para solucionar estos problemas, los modelos de fragmentos de contenido son bloqueados en modo de SOLO LECTURA en el autor, tan pronto como se hayan publicado. Este estado está indicado por Bloqueado:
Cuando el modelo es Bloqueado (en modo de SOLO LECTURA), puede ver el contenido y la estructura de los modelos, pero no puede editarlos.
Puede administrar modelos Bloqueados desde la consola o desde el editor de modelos:
-
Consola
Desde la consola, puede administrar el modo de SOLO LECTURA con las acciones Desbloquear y Bloqueo de la barra de herramientas:
-
Puede Desbloquear un modelo para activar las ediciones.
Si selecciona Desbloquear, se mostrará una advertencia y deberá confirmar la acción Desbloquear:
A continuación, puede abrir el modelo para editarlo.
-
También puede Bloquear el modelo después.
-
Volver a publicar el modelo inmediatamente lo devuelve al modo Bloqueado (SOLO LECTURA).
-
-
Editor de modelo
-
Al abrir un modelo bloqueado, se le avisará y se le presentarán tres acciones: Cancelar, Ver solo lectura, Editar:
-
Si selecciona Ver solo lectura, podrá ver el contenido y la estructura del modelo:
-
Si seleccionas Editar, puedes editar y guardar tus actualizaciones:
note note NOTE Puede que todavía haya una advertencia en la parte superior, pero es cuando el modelo ya está siendo utilizado por fragmentos de contenido existentes. -
Cancelar le devuelve a la consola.
-