Documentation AEM as a Cloud Service User Guide

Content Fragments - Setup

Last update: June 21, 2024

Topics:
Content Fragments

CREATED FOR:

Developer

Content Fragments within Adobe Experience Manager (AEM) as a Cloud Service allow you to prepare content ready for use in multiple locations, and over multiple channels. This is ideal for headless delivery, and page authoring.

To enable your instance for the Content Fragment functionality you need to enable:

Content Fragment Models - mandatory
CAUTION
If you do not enable Content Fragment Models:
the Create option will not be available for creating models.

you will not be able to select the Sites configuration to create the related end-point.
GraphQL Persisted Queries - optional

Setting up your instance is done:

by enabling functionality in the Configuration Browser
then applying the configuration to your individual Assets folders

Enable Content Fragment Functionality in the Configuration Browser

To use the Content Fragment functionality, of Content Fragment Models and GraphQL Persisted Queries, you must first enable them via the Configuration Browser:

NOTE

For more details, see Configuration Browser.

NOTE

Subconfigurations (a configuration nested within another configuration) are fully supported for use with Content Fragments, Content Fragment Models and GraphQL queries.

Just to note that:

After creating models in a subconfiguration, it is NOT possible to move or copy the model to another subconfiguration.
A GraphQL endpoint will (still) be based on a parent (root) configuration.
Persisted queries will (still) be saved relevant to the parent (root) configuration.

Navigate to Tools, General, then open the Configuration Browser.
Use Create to open the dialog, where you:
1. Specify a Title.
2. Upon creation, the Name becomes the node name in the repository.
  You can enter a name. If you leave the field blank it is automatically generated based on the title, then adjusted according to AEM naming conventions; you can adjust the result if necessary.
3. To enable their use select
  - Content Fragment Models
  - GraphQL Persisted Queries
Select Create to save the definition.

Apply the Configuration to your Folder

When the configuration global is enabled for Content Fragment functionality, it then applies to any Assets folder - accessible through the Assets console.

To use other configurations (therefore excluding global) with a comparable Assets folder, you have to define the connection. Do this by selecting the appropriate Configuration in the Cloud Services tab of the Folder Properties of the appropriate folder.

Apply configuration