DocumentaciónAEMGuía del usuario

[AEM Sites]{class="badge positive" title="(Se aplica a AEM Sites)."}

Definición de los modelos de fragmento de contenido defining-content-fragment-models

Última actualización: 19 de mayo de 2026
  • Se aplica a:
  • Experience Manager as a Cloud Service

Creado para:

  • User
  • Developer

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.

NOTE
Tenga en cuenta las Prácticas recomendadas al trabajar con los modelos de fragmentos de contenido y los fragmentos de contenido.
CAUTION
Si va a consultar varios fragmentos a los que se hace referencia, no se recomienda que los distintos modelos de fragmento tengan nombres de campo con el mismo nombre, pero con tipos diferentes.
Para obtener más información, consulte API de AEM GraphQL para uso con fragmentos de contenido: limitaciones
NOTE
Si crea un modelo con este nuevo editor, siempre debe utilizar este editor para ese modelo.
Si abre el modelo con el editor de modelos original, verá el siguiente mensaje:
  • "Este modelo tiene configurado un esquema de IU personalizado. Es posible que el orden de los campos mostrados en esta interfaz de usuario no coincida con el esquema de la interfaz de usuario. Para ver los campos alineados con el esquema de la interfaz de usuario, debe cambiar al nuevo Editor de fragmentos de contenido".

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.

CAUTION
Editar un modelo que ya se utiliza en fragmentos de contenido existentes puede afectar a esos fragmentos dependientes.

  1. 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
    También puede abrir un modelo directamente después de crearlo.

  2. Abra el modelo necesario para Edit; utilice uno de los vínculos de acción rápida o seleccione el modelo y, a continuación, la acción en la barra de herramientas.

    Propiedades

    Una vez abierto, el editor de modelos muestra lo siguiente:

    • superior:

      • Icono Inicio
      • opción para alternar entre original y el nuevo editor
      • Cancelar
      • Guardar

    • izquierda: Tipos de datos disponibles para crear campos

    • en el medio: campos ya definidos junto con la opción Agregar

    • a la derecha: usando los iconos del extremo derecho puede seleccionar entre:

      • Propiedades: defina y vea las propiedades del campo seleccionado
      • Detalles del modelo: mostrar el estado Habilitado, Título del modelo, Etiquetas, Descripción y URL de vista previa

  3. Adición de un campo

    • O bien, haga lo siguiente:

      • Arrastre un tipo de datos desde el panel izquierdo a la ubicación requerida para un campo del panel central.
      • Seleccione el icono + por tipo de datos para agregarlo al final de la lista de campos.
      • Seleccione Agregar en el panel central y, a continuación, el tipo de datos requerido de la lista desplegable resultante para agregar un campo al final de la lista.
      note
      NOTE
      Los campos de marcador de posición de tabulación siempre deben aparecer encima de los campos existentes.

    • Puede cambiar la posición de un campo mediante la formación de puntos a la izquierda del cuadro de campo:

      Mover campo

    • Una vez agregado un campo al modelo (y seleccionado), 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 el específico
      field.

      • 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:

      Propiedades de campo

      note
      NOTE
      Cuando un campo se define como Obligatorio, la Etiqueta indicada en el panel central se marca con un asterisco (*).

  4. Eliminación de un campo

    Seleccione el icono de la papelera para el campo correspondiente en el panel central.

    Quitar

  5. Añada todos los campos obligatorios y defina las propiedades relacionadas, según sea necesario.

  6. 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
    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

  • Enumeración

    • 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

  • Etiquetas

    • Permite a los autores de fragmentos acceder y seleccionar áreas de etiquetas

  • Referencia al 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

    note
    NOTE
    AEM tiene protección contra recurrencias para:

    • 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 referencias 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.
    note caution
    CAUTION
    Si va a consultar varios fragmentos a los que se hace referencia, no se recomienda que los distintos modelos de fragmento tengan nombres de campo con el mismo nombre, pero con tipos diferentes.
    Para obtener más información, consulte API de AEM GraphQL para uso con fragmentos de contenido: limitaciones

    Referencia de contenido content-reference

    El tipo de datos 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 o representa dónde almacenar el contenido referenciado

      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
      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 del contenido

    Referencia a fragmento (fragmentos anidados) fragment-reference-nested-fragments

    El tipo de datos Referencia a fragmento puede 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).
    code language-xml 
    type EmployeeModel {
    name: String
    firstName: String
    company: CompanyModel
}

type CompanyModel {
    name: String
    street: String
    city: String
}
    note
    NOTE
    Las referencias a fragmento son de particular interés para 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
      Se pueden 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.

      Referencia a fragmento

    note
    NOTE
    Existe un mecanismo de protección contra la periodicidad. Prohíbe que el usuario seleccione el fragmento de contenido actual en la Referencia a fragmento y puede provocar un cuadro de diálogo vacío del selector de Referencia a fragmento.
    También hay protección contra recurrencias 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.
recommendation-more-help
experience-manager-cloud-service-help-main-toc