DocumentaciónAEMGuía del usuario

Modelos de fragmentos de contenido, consultas persistentes y paquetes de contenido content-fragment-models-persisted-queries-and-content-packages

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

Creado para:

  • Administrador
  • Desarrollador

Los modelos de fragmentos de contenido y las consultas de GraphQL persistentes son contenido que se puede crear y actualizar:

  • Modelos de fragmento de contenido: /conf/<config>/settings/dam/cfm/models)
  • consultas de GraphQL persistentes: (/conf/<config>/settings/graphql/persistentQueries)

Muchos proyectos los mantienen en Git y los envían en un paquete de contenido. El modo de filtro de un paquete de este tipo determina lo que sucede (incluidos los modelos y las consultas creadas en el autor):

  • mode="replace"

    • cada nodo:

      1. cubierto por el filtro
      2. pero no incluido en el paquete
      3. se elimina en la creación y publicación siempre que el paquete se instala durante una implementación de Cloud Manager

    • es el modo predeterminado cuando no se define explícitamente ningún modo.

Las consultas persistentes que dependen de un modelo eliminado de esta manera fallan con Schema provider failed.

FileVault aplica la primera entrada de filtro cuando la raíz cubre una ruta, por lo que el orden de las entradas de filtro importa. Una entrada amplia como /conf/<config> tendrá prioridad cuando se coloque antes de una entrada más específica.

Configuraciones recomendadas, según a quién pertenezcan los modelos y las consultas:

  • Se mantiene en Git:

    • una raíz de filtro por modelo o consulta persistente que posee el paquete, colocada antes de las /conf entradas más amplias.
      A continuación, el contenido creado en el autor no se ve afectado.
    • Si existen conf entradas con un ámbito más amplio, puede asegurarse de que utilicen un modo de no eliminación, como update_properties, o simplemente excluir contenido específico propiedad del autor.

  • Propiedad mixta:

    • mode="update_properties": agrega y actualiza, pero nunca elimina.

      La contrapartida es que un modelo o campo eliminado en Git permanece en AEM.

  • Propiedad de los autores:

    • No los incluya en el paquete ni los envíe una sola vez con mode="merge_properties"

      La combinación no es adecuada para los modelos que se mantienen en Git, ya que los nodos existentes no se tocan y los cambios de modelo nunca se implementan. FileVault también dejó de utilizar combinar y actualizar en favor de merge_properties y update_properties.

Ejemplo de un proyecto que mantiene dos modelos en Git y permite a los autores crear otros:

<filter root="/conf/wknd/settings/dam/cfm/models/article"/>
<filter root="/conf/wknd/settings/dam/cfm/models/author"/>
<filter root="/conf/wknd" mode="update_properties"/>

Otros recursos further-resources

Consulte también lo siguiente:

recommendation-more-help
experience-manager-cloud-service-help-main-toc