Thursday 31 May 2018

AEM 6.4 Content Fragment output as JSON

AEM Content Fragments can be accessed through JSON file URL's.

Create Content Fragments : Step By Step Tutorial

Why we need JSON Formats?
Content Fragments are not just for web pages. A Content Fragment is made available to external applications through JSON format delivery methods. These applications could be,
  • Single Page Applications
  • Native Mobile Applications
  • other channels and touch-points external to AEM
[Click on image to see it big]





AEM 6.4 core components having the capability to export its data to JSON format. This structured content can then be used to deliver to cross channels other than AEM pages. 

Difference between Content Fragment & Experience Fragment
Major difference between Content Fragment & Experience Fragment is that Content Fragment is pure content, without design and layout, but Experience Fragments are fully laid out content - a fragment/portion of a web page.

There are 2 types of content fragments

Simple fragments : Which does not have any predefined structure(only text, and images). Simple Fragment template is the supporting element for this.

Fragments that contain structured content: This is based on a content fragment model. This model will give defined structure.

How do we generate JSON format of a Content Fragment?

AEM 6.4 version also supports JSON Exporter with Content Fragment Core Components. Using this AEM JSON exporter, we can deliver the contents of an AEM page in JSON data model format. This can then be consumed by any third party applications other than AEM.

JSON Exporter is supported by suffixing a url with '.model.json'

Access JSON Format of a Content Fragment

Say we have created 'My Simple Fragment(my-simple-fragment)' Content Fragment,

We can see the complete content using url,
http://localhost:4502/content/dam/my-simple-fragment/_jcr_content/model.json


As you see the output

    {
        "jcr:primaryType": "nt:unstructured",
        "jcr:title": "Simple Fragment",
        "version": 2,
        "jcr:description": "A simple fragment, containing one single element and no predefined variations",
        "precreateElements": true
    }

   
Accessing the JSON output of a Content Fragment authored on a page.


Step1: Access the page JSON

Now I have authored my previously created 'My Simple Fragment(my-simple-fragment)' in We-retail site.(/content/we-retail/language-masters/en/men.html)

Its JSON output can be access through url,
http://localhost:4502/content/we-retail/language-masters/en/men.model.json

Step2: Access the Content Fragment JSON
We can see the content fragment in this page as shown.





To get the authored 'Content Fragment JSON', access the '.model.json' url of the content fragment as below,

http://localhost:4502/content/we-retail/language-masters/en/men/jcr:content/root/responsivegrid/contentfragment_1655772226.model.json

As you see the JSON will have all elements including variations created/authored.





Create Content Fragments : Step By Step Tutorial

Wednesday 30 May 2018

How to create a Content Fragment in AEM 6.4? Step by step tutorial

Content Fragment helps to author content without creating a Page. The advantage with Content Fragment is that same content can be shared across various channels without worrying about the display part.

What type of data, a Content Fragment can hold?

Content Fragment has well defined content structure, which can hold text segments and references to assets likes images, videos etc.

Steps to create Content Fragments

To start with , go to Assets > Files > Click on Create , Content Fragment

[click on images to see it big]
Content Fragment


Select the template as shown(Default Simple Fragment Template). We can either have our new templates created based on the content requirement or use the default one. Click on Next





In 'Properties' section fill up the basic details of this fragment.




Advanced section will have an auto populated name. We can edit it in case we need our custom property/url here.




Click on 'Create' will show you the success message as shown below. On clicking 'Done' will show the new Content Fragment.



There are many options for a Content Fragment once created. The header bar will have options like download, checkout, edit, manage tags, adding collections copy, move, publish, un-publish delete etc.



Edit options for a content fragment is quiet flexible, through which we can update the textual content, create variations, add / edit metadata etc.



Through 'Create variation' we can create different version of content based on our requirement. These variations are used across different channels.



Now the variation created  will have below action items.



Clicking the 'folder' icon provides us the option to associate content with this content fragment.



On clicking 'metadata' section helps to update the metadata associate with the fragment.




Once all updates are done, save the content fragment to ensure all changes are submitted to crx. The new content fragment created can be found at path '/content/dam'.

YouTube demo videos for Content Fragments:

Download a Content Fragment

The created Content Fragment can be downloaded as shown below. The downloaded fragment can have all related information selected while creation. Unzipping the fragment displays the folder contents.




Unzipped file will have a metadata file with all information.



Deleting a Content Fragment

In the Assets console navigate to the location of the content fragment, Select the fragment and click on delete from tool bar menu.



In the upcoming posts I will be explaining authoring and utilization of Content Fragments.

Read about Content Services in AEM 6.4 and demo

Thursday 17 May 2018

Test the configuration for AEM 6.4 Personalization

PREVIOUS: Create a Sample Personalization in AEM 6.4

In AEM 6.4 personalization works based on;
  • Experience, 
  • Activities and 
  • ContextHub. 
Let us see how can we test a basic Personalization in AEM 6.4 by creating a sample. AEM 6.4 configuration is almost same as in AEM 6.3.  

Below are the steps to create personalization in Latest AEM.
  
How to test personalization in AEM 6.4.
In this post we are explaining about the testing of personalization. Hope you have gone through the article for creating personalization in AEM 6.4  

Open the page where targeting is enabled and Experiences are authored.

  • Go to preview mode of the page. You can see the default image which was authored is displayed. In this case user persona is anonymous.



  • Click on persona so that other users appears.



  • Select a male user and see the image is updated as per the experience defined(Male)



  • Select a female user from persona and see the experience s updated.



 This ensures that our previously configured sample personalization is working fine in AEM 6.4

Demo Video:
 
Read More:

Personalization Basics & Steps to create Personalization in AEM 6.4

Create ContextHub in AEM 6.4

Create Brands in AEM 6.4  

Create Activity in AEM 6.4

Create Offers in AEM 6.4

Steps to configure personalization from brands, activity with a sample 

Test Configured personalization

Personalization in AEM 6.4 - Basic Configurations with example

Let us create a sample personalization component in 'We.Retail' site. We.Retail is a demo site pre-configured in AEM 6.4.

Ensure you have gone through Personalization Basics & Steps to create Personalization in AEM 6.4 before starting with this tutorial

We have authored the sample component in page : http://[host]:[port]/editor.html/content/we-retail/us/en/men.html


Once we open a We.Retail page we can see the  Edit option as below.




Selecting Targeting option as above image.
By default BRAND is selected with value 'We-Retail' as shown below.




All the Activities are listed for the selected brand as shown. We can also create a new activity by clicking on the (+) icon directly.




Since we have already created a brand and activity, I am going to select and proceed with it.

Now in Targeting mode, click on 'Start Targeting', A default experience will be always enabled. Now add new experience by clicking on  '+ Add Experience Targeting'




Next window allows to add an experience. We can either select default or click on 'Add Experience Targeting' to create new if its not already created. Since I have already created an activity(Male) for my brand, I will select that. Click Next.



I can see my already configured experience here. If required, we can edit the settings in this section.



To test personalization we need atleast two experiences. I have a male experience available already. Click on Add experience and select female audiences.



Now the target section looks as below.



Leave the next screen as it is.




On clicking save, we get a message, 'Your activity was saved'.

Now go back to edit mode , author an image component in empty area of the page.



Now go back to target mode



Click on 'Start Targeting',



Click on Target icon, we get a message that component is now targeted.



From next screen select Male and author a male image.



Now Select Female and author a female image.



Click Next and save the targeting.

We are done with our Personalization Targeting using ContextHub and experiences. Let us test it now.

NEXT: In my next post I will explain how to test it.

Demo Video:
 

Read More:

Personalization Basics & Steps to create Personalization in AEM 6.4

Create ContextHub in AEM 6.4

Create Brands in AEM 6.4  

Create Activity in AEM 6.4

Create Offers in AEM 6.4

Steps to configure personalization from brands, activity with a sample 

Test Configured personalization

Personalization in AEM 6.4 - Basic Understanding

PREVIOUS: Create Activity in AEM 6.4

Personalization in AEM 6.4 can be done through Targets or ContextHubs


In AEM 6.4 personalization works based on;
  • Experience, 
  • Activities and 
  • ContextHub. 
Let us see how can we test a basic Personalization in AEM 6.4 by creating a sample. AEM 6.4 configuration is almost same as in AEM 6.3.  

Below are the steps to create personalization in Latest AEM.
  
 Let us understand some basic terms of personalization.


Follow the 'Read More' section in order to understand the steps involved in AEM 6.4 personalization.

NEXT:Detailed steps of creating Personalization is given in this post with an example.


Watch the demo video:
 

Read More:

Personalization Basics & Steps to create Personalization in AEM 6.4

Create ContextHub in AEM 6.4

Create Brands in AEM 6.4  

Create Activity in AEM 6.4

Create Offers in AEM 6.4

Steps to configure personalization from brands, activity with a sample 

Test Configured personalization

Create Offers For Personalization in AEM 6.4

 PREVIOUS: Create Brands in AEM 6.4  

Below are the steps to create personalization in Latest AEM.
  
In This post we are going to explain the Offers creation. As mentioned in our previous post,we can create activity through Activity or Offers section of Personalization.

Steps to create an Offer.
  • Traverse through Personalization > Offers






  • Select already created brand and click on create > Folder or Offer



  • Select Offer Page template under section 'Template' then click next.



  • Enter a title for the offer in properties section. Click on create.



  • Click on Open the page



  • The page will be opened with a basic templates


 

  • Sample components are authored as shown; (sample text and image).




This offers can now be authored/configured for personalization.

NEXT: Steps to configure personalization from brands, activity with a sample  

Video Demo: Offer Creation
 

Read More:

Personalization Basics & Steps to create Personalization in AEM 6.4

Create ContextHub in AEM 6.4

Create Brands in AEM 6.4  

Create Activity in AEM 6.4

Create Offers in AEM 6.4

Steps to configure personalization from brands, activity with a sample 

Test Configured personalization

Create Activity For Personalization in AEM 6.4

PREVIOUS: Create Brands in AEM 6.4  

Below are the steps to create personalization in Latest AEM.
   
In This post we are going to explain the Activity creation. As mentioned in the previous post,we can create activity through Activity or offers section of Personalization.

Steps to create an activity.

  • Go to the previously created brand, click on create > Create Activity.


  • In Details page fill out the details. Ensure ContextHub is selected as a target engine. We have 'client side AEM rules' and 'Adobe Target' as additional options.


  • In Target section, click on add experience and select an experience as per your needs.




  • (We have selected male)



  • Click on 'Add Experience' and provide an Experience Name and click OK.



  • Now the target section looks like this.



  • In Goals & Settings section update the duration and priority if required. Click on Save.



  • Now the newly created activity is listed below.



  • We also have edit options on selecting the created activity.




Read More:

Personalization Basics & Steps to create Personalization in AEM 6.4

Create ContextHub in AEM 6.4

Create Brands in AEM 6.4  

Create Activity in AEM 6.4

Create Offers in AEM 6.4

Steps to configure personalization from brands, activity with a sample 

Test Configured personalization