- Tutorial Overview
- Part 1 - Installing AEM Content Services
- Part 2 - Defining FAQ Content Fragment Models
- Part 3 - Authoring FAQ Content Fragments
- Part 4 - Defining Content Services Templates
- Part 5 - Authoring Content Services Pages
- Part 6 - Exposing the Content on AEM Publish
- Part 7 - Consuming AEM Content Services from a 3rd Party App
With a FAQ Content Fragment Model created and the AEM Configuration for We.Retail applied to the /content/dam/we-retail Asset folder (via the cq:conf property), a FAQ Content Fragment can be created.
Content Fragments, which are a type of Asset, should be organized and managed in AEM Assets just like other assets.
- Use locale folders in the Assets folder structure if translation is (or may be) required
- Logically organize Content Fragments so they are easy to locate and manage
In this step, a FAQ addressing how "users can find their order status" is created under an Assets folder heirarchy: /content/dam/we-retail/en/faqs/orders
Within Assets > Files > We.Retail > English > FAQs > Orders create a new Content Fragment of type FAQ with a title of Order Status.
The Title and Description collected during the New Content Fragment wizard are stored as Asset Metadata and are not used to populate the actual Content Fragment Model fields (ie. Question an Answer).
Author the newly created FAQ Content Fragment.
- Question: Where can I find the status of my order?
- Answer: Upon completing an order, you will be e-mailed a copy of your order to your registered e-mail address.
You can find the status of your order by logging in to your account on our Web site and select My Account > My Open Orders
Select the order in question for details.
Tap Save in the top action bar to save changes.
Using AEM's Package Manager, install the package below on AEM Author. This package contains a number of FAQ Content Fragments for Orders, Shipping and Returns and Company, as well as as We.Retail logo image.
This section is informational only and meant to socialize the underlying JCR structure of Content Fragments made from Content Fragment Models.
Beneath the data node select the master node and review the properties. This node contains the data collected when an instance of the FAQ Content Fragment Model is authored. Note the two properties and their values:
The JCR property names correspond to the Content Fragment Model property name's, and the values correspond to the authored values of the "Order Status" FAQ content fragment.
Lastly, open then renditions node under the order-status/jcr:content node.
Note that there are NO renditions, not even an original rendition. Take note of this as Assets tyically have at least an original rendition, and if custom code exists that makes this assumtion, ensure it it adjusted to handle this case or exclude Content Fragments made from Content Fragment Models.
Make sure the aem-content-services-tutorial.part3 package is installed on AEM Author as it contains a larger set of Content Fragments.