DocumentazioneAEMGuida utente

Modelli per frammenti di contenuto, query persistenti e pacchetti di contenuti content-fragment-models-persisted-queries-and-content-packages

Ultimo aggiornamento: 26 ottobre 2026
  • Si applica a:
  • Experience Manager as a Cloud Service

Creato per:

  • Amministratore
  • Sviluppatore

I modelli per frammenti di contenuto e le query GraphQL persistenti sono contenuti che puoi creare e aggiornare:

  • Modelli per frammenti di contenuto: /conf/<config>/settings/dam/cfm/models)
  • query GraphQL persistenti: (/conf/<config>/settings/graphql/persistentQueries)

Molti progetti li mantengono in Git e li spediscono in un pacchetto di contenuti. La modalità filtro di un pacchetto di questo tipo determina cosa accade (inclusi modelli e query creati durante l’authoring):

  • mode="replace"

    • ogni nodo:

      1. coperti dal filtro
      2. ma non contenuti nella confezione
      3. viene eliminato durante l’authoring e la pubblicazione ogni volta che il pacchetto viene installato durante una distribuzione Cloud Manager

    • è la modalità predefinita quando non è definita esplicitamente alcuna modalità.

Le query persistenti che dipendono da un modello eliminato in questo modo non riescono con Schema provider failed.

FileVault applica la prima voce di filtro quando la radice copre un percorso, pertanto l’ordine delle voci di filtro è importante. Una voce ampia come /conf/<config> avrà la priorità se posizionata prima di una voce più specifica.

Impostazioni consigliate, a seconda del proprietario dei modelli e delle query:

  • Mantenuto in Git:

    • una radice di filtro per modello o una query persistente di proprietà del pacchetto, posizionata prima di /conf voci più ampie.
      Il contenuto creato durante l’authoring non sarà quindi interessato.
    • Se sono presenti conf voci con un ambito più ampio, è possibile assicurarsi che utilizzino una modalità non di eliminazione, ad esempio update_properties, oppure che escludano semplicemente specifici contenuti di proprietà dell’autore.

  • Proprietà mista:

    • mode="update_properties": aggiunge e aggiorna ma non elimina mai.

      Il compromesso è che un modello o un campo rimosso in Git rimane in AEM.

  • Di proprietà degli autori:

    • Non includerli nel pacchetto o eseguirne il seeding una sola volta con mode="merge_properties"

      L’unione non è adatta per i modelli mantenuti in Git, in quanto i nodi esistenti vengono lasciati intatti e le modifiche al modello non vengono mai distribuite. FileVault ha inoltre dichiarato obsolete l’unione e l’aggiornamento a favore di merge_properties e update_properties.

Esempio per un progetto che mantiene due modelli in Git e consente agli autori di crearne altri:

<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"/>

Ulteriori risorse further-resources

Consulta anche:

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