Immerse 2016 Efficient publishing with content fragments

A virtual developer conference for Adobe Experience Manager

Efficient Publishing with Content FragmentsStefan Grimm | Senior Developer

Efficient Publishing with Content Fragments

1 | Welcome and Overview

2 | Content Fragments - a brief introduction

3 | Use case: A news site

4 | Implementing an efficient workflow

5 | Q&A

Content FragmentsA brief introduction

Ecosystem

Simple fragment template Generic component Typical AEM workflow required First, create the fragment Then, create a page, add the fragment to the page, configure it, etc.

Some use-cases require a more efficient workflow. OOTB component can be too generic Too much flexibility Not enough flexibility

ข Some use-cases require customization

Customizing the component Implement a specific workflow

Context

Use-case:A (imaginary) news site

Our goal …

Create article. Enter title. Teaser. Text. Assign image(s). Classify. Save. Create page. Add Content Fragment. Reference article. Publish.

Efficiency!

let’s get rid of these steps!

add this new feature

Our news site

Section

Teaser

Fragment Elements Title Teaser Text

Metadata Section

Associated Content Image (tagged)

Articles

defining the article imagedefining the article image

Article template Article component Page component A patched version of the CFM implementation bundle Required for AEM 6.2 only, will be included in upcoming releases

Prerequistes

Introduced in the ”Introducing Content Fragment” session

Hands on …Prerequisites

Implementation

No production-ready codein this session!

Disclaimer

Problems & solutions

How to determine the article image? Only collections, no 1:1 assignment for associated content

How to automate …? page creation adding Content Fragment component referencing & configuring the article fragment publishing the page

Problems ...

Article image Use tagging to classify the images main image part of image gallery …

Component queries associated content uses first image tagged as “main image”.

Automating workflow launcher triggers workflow create page if necessary publish fragment, page & dependency several other stuff

... and solutions

Finding the article image

Getting associated collections:Iterator<Resource> collections = fragment.getAssociatedContent();

Getting all associated resources:SlingScriptHelper ssh = getSlingScriptHelper();ContentFragmentManager cfm = ssh.getService(ContentFragmentManager.class);List<Resource> assets = cfm.resolveAssociatedContentFlat(fragment);

API – Accessing associated content

Hands on ...Finding the article image

Workflow commons

Can be registered on low level events node create node update

Can‘t use directly intermediate saves but workflow should only be triggered on “save”

Workflow launcher

On save Timestamp is persisted (only if content has been modified) jcr:content/lastFragmentSave (*)

Each workflow process Executes only if there has been a “save” since the last publish workflow has been finished jcr:content/lastFragmentSave > jcr:content/lastFragmentPublish

At the end of the publish workflow Updates publish timestamp jcr:content/lastFragmentPublish

(*) patched CFM implementation bundle required

Solution

Hands on ...Workflow commons

com.adobe.immerse2016.cfm_ep.workflow.AbstractFragmentProcesscom.adobe.immerse2016.cfm_ep.workflow.FinishArticleProcess

Workflow process:Resolving associated

content

Problem:

Article image defined via collection Collections should not be used on publish

Solution:

Determine article image on save Persist path to image on fragment jcr:content/articleImage

Article image

Hands on ...Resolving dependencies

com.adobe.immerse2016.cfm_ep.workflow.ResolveDataProcess

Workflow process:Creating the article

Check if a page for the article has already been created If not, create a page, … Path: /<root>/<section>/<year>/<month>/<day>/<article.name>

... create the article paragraph jcr:content/par/<article.name>

... reference the article fragment. jcr:content/par/<article.name>/fileReference

Page on demand

Hands on ...Auto-create article page

com.adobe.immerse2016.cfm_ep.workflow.CreateOnDemandProcess

Workflow process:Publishing the article

Publish Content Fragment Page Article Image

In a clean implementation … … publish references (Tags, ...) … replicate only if modified

Publishing

Hands on ...Publish article process

com.adobe.immerse2016.cfm_ep.workflow.PublishArticleProcess

And … Action!The new, effective publishing

process

Article image Part of a collection Identified by tag Resolve collection/tag to image path for publish instance

Publishing workflow Triggered by workflow launcher Processes check for “save” event by comparing save/publish timestamps Page created on demand using a fixed/hardcoded pattern Fragment & collaterals published programmatically

Epilogue

Not mentioned in this session …

Dispatcher invalidation No easy OOTB solution for invalidating referencing pages Can be solved using path-based dispatcher rules

Resources

Content Package with example code available from the “Resources” pod in Adobe Connect

Documentation Overview/Authoring Editor - https://docs.adobe.com/docs/en/aem/6-2/author/assets/content-fragments.html Page Authoring - https://docs.adobe.com/docs/en/aem/6-2/author/page-authoring/content-

fragments.html Development Templates - https://docs.adobe.com/docs/en/aem/6-2/develop/templates/content-fragment-

templates.html Extending (WIP) - https://docs.adobe.com/docs/en/aem/6-2/develop/extending/content-fragments.html

Stefan Grimmsgrimm@adobe.com

Immerse 2016 Efficient publishing with content fragments

Technology

FUN WITH FRAGMENTS Exploring Sentences and Sentence Fragments

7. Fragments

Immerse yourself in Facebook - Nia

Interesting fragments

Editorial 1DNanomaterials - Hindawi Publishing Corporationdownloads.hindawi.com/journals/jnm/2010/597851.pdf · heightens the stochastic energetics of chemical fragments, which has

Immerse 2015

IMMERSE YOURSELF IN 3D-SOUND

Submerge vs Immerse

EXPLORE, IMMERSE and LEARN

Hi arm immerse

Immerse Yourself with His Promises

Android Fragments · Android Fragments. In this Lecture, you will learn: Fragments Creating Fragments Adding Fragment to Activity Communicating with the Activity Mobile Application

GMA IMMERSE 2014 Program Book

Granular Fragments

IMMERSE - web.stanford.edu

Tables - Haworthmedia.haworth.com/asset/88294/Immerse-BrochureFINAL2.pdf · Immerse With Immerse tables, creativity and collaboration can take shape at a moment’s notice. Designed

To immerse oneself

Playing (with) fragments · good degree of probability are rare. Fragments are usually distinguished as either book fragments or archaeological fragments. The former are quotations

Erciyes Fragments

Sentence Fragments Overview - What is a “fragment” - Types of fragments - How to fix fragments - Activity