DokumentationAEMBenutzerhandbuch

Inhaltsfragmentmodelle, persistierte Abfragen und Inhaltspakete content-fragment-models-persisted-queries-and-content-packages

Letzte Aktualisierung: 26. Oktober 2026
  • Gilt für:
  • Experience Manager as a Cloud Service

Erstellt für:

  • Admin
  • Entwicklerin/Entwickler

Inhaltsfragmentmodelle und persistierte GraphQL-Abfragen sind Inhalte, die Sie erstellen und aktualisieren können:

  • Inhaltsfragmentmodelle: /conf/<config>/settings/dam/cfm/models)
  • Persistierte GraphQL-Abfragen: (/conf/<config>/settings/graphql/persistentQueries)

Viele Projekte behalten sie in Git und versenden sie in einem Inhaltspaket. Der Filtermodus eines solchen Pakets bestimmt, was geschieht (einschließlich der Modelle und Abfragen, die auf der Autoreninstanz erstellt wurden):

  • mode="replace"

    • Jeder Knoten:

      1. Vom Filter abgedeckt
      2. aber nicht im Paket enthalten
      3. wird in der Autoren- und Veröffentlichungsinstanz gelöscht, sobald das Paket während einer Cloud Manager-Bereitstellung installiert wird

    • ist der Standardmodus, wenn kein Modus explizit definiert ist.

Persistierte Abfragen, die von einem auf diese Weise gelöschten Modell abhängen, schlagen mit Schema provider failed fehl.

FileVault wendet den ersten Filtereintrag an, wenn der Stamm einen Pfad abdeckt, sodass die Reihenfolge der Filtereinträge wichtig ist. Ein breiter Eintrag wie /conf/<config> hat Vorrang, wenn er vor einem spezifischeren Eintrag platziert wird.

Empfohlene Setups, je nachdem, wem die Modelle und Abfragen gehören:

  • In Git verwaltet:

    • Ein Filterstamm pro Modell oder persistierte Abfrage, deren Eigentümer das Paket ist, und der vor breiteren /conf platziert wird.
      Dann ist der auf der Autoreninstanz erstellte Inhalt nicht betroffen.
    • Wenn conf Einträge mit einem breiteren Bereich vorhanden sind, können Sie sicherstellen, dass diese einen nicht löschenden Modus verwenden, z. B. update_properties, oder einfach bestimmte Inhalte im Besitz der Autorin oder des Autors ausschließen.

  • Gemischte Eigentümerschaft:

    • mode="update_properties": fügt hinzu und aktualisiert, löscht jedoch nie.

      Der Nachteil besteht darin, dass ein in Git entferntes Modell oder Feld in AEM verbleibt.

  • Im Besitz von Autoren:

    • Schließen Sie sie nicht in die Packung ein oder senden Sie sie nur einmal mit mode="merge_properties"

      Die Zusammenführung ist nicht für Modelle geeignet, die in Git gepflegt werden, da vorhandene Knoten unberührt bleiben und Modelländerungen nie bereitgestellt werden. FileVault hat auch die Zusammenführung und Aktualisierung zugunsten von merge_properties und update_properties eingestellt.

Beispiel für ein Projekt, das zwei Modelle in Git verwaltet und es Autoren ermöglicht, andere zu erstellen:

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

Weitere Ressourcen further-resources

Siehe auch:

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