Learn the Content Modeling Basics for Headless with AEM

The Story so Far

At the beginning of the AEM Headless Content Architect Journey the Introduction covered the basic concepts and terminology relevant to modeling content for headless.

This article builds on these so you understand how to model your content for your AEM headless project.

Objective

• Audience: Beginner
• Objective: Introduce the concepts of Content Modeling for Headless CMS.

Content Modeling with Content Fragment Models

Content (Data) Modeling is a set of established techniques, often used when developed relationship databases, so what does Content Modeling mean for AEM Headless?

Why?

To ensure that your application can consistently and efficiently request and receive the required content from AEM, this content must be structured.

This means that your application knows in advance the form of response and therefore, how to process it. This is much easier than receiving free-form content, which has to be parsed to determine what it contains and therefore, how it can be used.

Introduction to How?

AEM uses Content Fragments to provide the structures needed for Headless delivery of your content to your applications.

The structure of your content model is:

• realized by the definition of your Content Fragment Model,
• used as a basis of the Content Fragments used for your content generation.

Requests for your content are made using the AEM GraphQL API, a customized implementation of the standard GraphQL API. The AEM GraphQL API allows applications to perform (complex) queries on your Content Fragments, with each query being according to a specific model type.

The content returned can then be used by your applications.

Creating the Structure with Content Fragment Models

Content Fragment Models provide various mechanisms that let you define the structure of your content.

A Content Fragment Model describes an entity.

Within a model:

1. Data Types let you define the individual attributes.
   For example, define the field holding a teacher’s name as Text and their years of service as Number.
2. The data types Content Reference and Fragment Reference let you create relationships to other content within AEM.
3. The Fragment Reference data type lets you realize multiple levels of structure by nesting your Content Fragments (according to the model type). This is vital for your content modeling.

For example:

Data Types

AEM provides the following data types for you to model your content:

• Single line text
• Multi line text
• Number
• Boolean
• Date and time
• Enumeration
• Tags
• Content Reference
• Fragment Reference
• JSON Object

References and Nested Content

Two data types provide references to content outside a specific fragment:

• Content Reference
  This provides a simple reference to other content of any type.
  For example, you can reference an image at a specified location.

• Fragment Reference
  This provides references to other Content Fragments.
  This type of reference is used to create nested content, introducing the relationships needed to model your content.
  The data type can be configured to allow fragment authors to:

  • Edit the referenced fragment directly.
  • Create a content fragment, based on the appropriate model

Levels of Structure (Nested Fragments)

For content modeling the Fragment Reference data type lets you create multiple levels of structure and relationships.

With this reference you can connect various Content Fragment Models to represent interrelationships. This allows the headless application to follow the connections and access the content as necessary.

Fragment References do just that - they let you reference another fragment.

For example, you might have the following Content Fragment Models defined:

• City
• Company
• Person
• Awards

Seems pretty straightforward, but a Company has both a CEO and Employees…and these are all people, each defined as a Person.

And a Person can have an Award (or maybe two).

• My Company - Company
  • CEO - Person
  • Employee(s) - Person
    • Personal Award(s) - Award

And that’s just for starters. Depending on the complexity, an Award could be Company-specific, or a Company could have its main office in a specific City.

Representing these interrelationships can be achieved with Fragment References, as they are understood by you (the architect), your content author and the headless applications.

What’s Next

Now that you have learned the basics, the next step is to Learn about Creating Content Fragment Models in AEM. This will introduce and discuss the various references available, and how to create levels of structure with the Fragment References - a key part of modeling for headless.

Additional Resources

• Content Fragment Models

  • Content Fragment Models - Data Types

• Authoring Concepts

• Basic Handling - this page is primarily based on the Sites console, but many/most features are also relevant for authoring Content Fragments under the Assets console.

• Working with Content Fragments