Experience League | Image

Getting Started with AEM 6.5

Table of Contents

Lab Overview

New to Experience Manager? This introductory session highlights its support for fluid experiences. Highlights: • Introduction to Connected DAM in Experience Manager • Assets integration with Adobe Stock and custom tagging • Using workflows for fluid experiences...

Key Takeaways

  • Identify usecases to choose between Experience Fragmenst & Content Fragments.
  • Introduction to Connected DAM in AEM
  • Adobe Stock Integration Integration and custom tagging

Prerequisites

  • AEM 6.5 L22
  • Configuration of AEM with Adobe Stock
  • Configuration of Smart Tagging

Lesson 1 - Using Content Fragments in AEM

Objective

  1. Determine usage of content fragments
  2. Create content fragment models.
  3. Create content fragments using content fragment model
  4. Add variations in content fragments.
  5. Download Content Fragments
  6. Use editing capabilities of content fragments
  7. Expose JSON from Content Fragments

Lesson Context

In this lesson , we will learn how to use content fragments in AEM, and explore their benefitss. We will create content fragments using an underlying schema conten defined in the content fragment model. We will also explore variations and a few other features of content fragments.

Exercise 1.1

In this exercise we will create an initial Content Fragment Model .

  1. Go to AEM > Tools > Assets > Content Fragment Models

    Figure 1: Content Fragment Models

  2. Double click to open the We.Retail folder.

  3. Press the Create button to create a model

    Figure 1: Content Fragment Models Create Button

  4. Provide model details

    • Model Title : Article
    • Description : Content Fragment Model for Articles in We.Retail (optional)

  5. Press Create Button and you should get a success message.

    Figure 1: Content Fragment Models Create Button

  6. Press Open button in success message.

Exercise 1.2

In this exercise we will add fields to the Article Content Fragment Model.

  1. On your screen you should see Content Fragment Model Editor . It is divided into two sections, the left-one is canvas where will add fields and on the right side we have Data Type lists which shows us list of all data types which can be added to content fragments.

Figure 1: Content Fragment Models Editor

  1. Click on Single line text data type and drag it on canvas to add it.

  2. Go to Properties tab and add following details

    • Field Label :Article Title
    • Property Name : articleTitle (required field)
    • Placeholder : Enter Article Title
    • Required : Checked

Figure 1: Single Line Text

  1. Select Data Types to return to the field selection area. Add another Single line text to the canvas with the following properties

    • Field Label :Article Author
    • Property Name : articleAuthor (required field)
    • Placeholder : Enter Article Author Name
    • Required : Unchecked

  2. Add Multi line text to the canvas with following properties

    • Field Label :Article Body
    • Property Name : articleBody (required field)

Figure 1: Completed Content Fragment Model

  1. Press Save button to compelete creation of Article Content Fragment Model.

Exercise 1.3

Now that we have a content fragment model, we will use it to create a content fragment.

  1. Go to AEM > Assets > Files > We.Retail > English

  2. Create a folder by pressing Create btton and provide title as CF.

  3. Open CF folder

  4. Press Create Button > Content Fragment . You should see a list of available content fragments.

    Figure 1: Content Fragment Model List

  5. Click on Article template or content fragment model and Press Next button.

  6. Provide title for the content fragment as North Slope Adventures.

  7. Press Create Button and you should get Success Message. Press Open button in success message modal-window.

Now you should see a form with all data types we provided in article content fragment model. In this exercise we will be adding content to the content fragment Model

  1. Add following content to this article.
    • Article Title : North Slope Adventure
    • Article Author : Your Name or Any name
    • Article Body : Text from file

Figure 1: Content Fragment

  1. Press Save button to save this article

Exercise 1.4

As content owner , we also want to create content fragment variations for other channels and requirements.

  1. Select recently created content fragment
  2. Select Edit or Press E on your keyboard to Edit Content Fragment.
  3. Press Create Variation to create new variation of the content fragment.
  4. Provide Title as Summary and Press Add

Figure 1: Summary Variation

We will be using OOTB summarization feature for content fragments to summarize the article.

  1. Click in Article Body box and select maximize icon Figure 1: Maximize

  2. In maximize window, Press Summarize Text Button Figure 1: Maximize

  3. Provide Target words as 200

  4. Review the summarized results and Press Summarize Button to confirm final Summarization.

  5. Select the text area and press minimize icon.

  6. Press Save button to save summary.

Exercise 1.5 Downloading Content Fragments

  1. Navigate to the content fragements in AEM Assets

  2. Click Download to download the content fragments and choose elements Figure 1: Maximize

  3. Open the zip file and examine the content

Exercise 1.6 Editoral Capabilities and using in web pages of Content Fragments

  1. Click into a content fragment and choose a multi line text field.

  2. Select the annotate field in order to set up collaboration with other authors Figure 1: Maximize

  3. Add a annotation

  4. Open a content fragment and choose timeline to compare. Figure 1: Maximize

Exercise 1.7 Exporting content fragments as JSON

  1. Go to the North Slope Adventures Content Fragment.

  2. Change the URL to look something like http://localhost:4502/api/assets/we-retail/en/north-slope-adventures.json

    Hint: Replace /content/dam in the CF URL with /api/assets and add .json as the extension. /api/assets/.json invokes the AEM Assets HTTP API

  3. You should get CF as json on the page

Figure 1: Maximize

Lesson 2 - Using Experience Fragments in AEM

Objective

  1. Determine usage of Experience Fragments.
  2. Differentiate between Experience Fragments & Content Fragments.

Lesson Context

Experience Fragments allows content authors to reuse content across channels including sites pages and 3rd party systems.

Exercise 1.1

  1. Go to AEM Navigation > Experience Fragments.

  2. Create two language folders with following titles

    • en
    • de

  3. Select en folder and Press Create > Experience Fragments. This will list OOTB templates for Experience Fragment Creation.

    Experience Fragment templates are like Page Templates.

  4. Select ** We.Retail Experience Fragment Web Variation** template.

  5. Press Next button and provide Title of experience fragment as Adventure in North Slope

  6. Press Create button and Press Open in success message.

    You should see a Experience Fragment Page Editor, it is quite similar to AEM Page Editor.

  7. Add following components to the Layout Container :

    • Title Component
    • Image Component
    • Content Fragment Component

  8. Resize Image Component and Content fragment to get them in same row.

Figure 1: Experience Fragment

  1. Now add an image to image component

  2. In Asset browser , filter the list by Content Fragment

    Figure 1: Experience Fragement

  3. Now drag the content fragment on content fragment Component on Page.

  4. Double click to open dialog box of content fragment.

  5. Configure Content Fragment Dialog box

    • Display Mode : Single Text Element
    • Element : Article Body

Figure 1: Content Fragment Models

  1. In Paragraph Tab, Select Range Radio Button and provide input as 2-3. This determines to show only second to third paragraph.

Figure 1: Content Fragment Models

  1. Press check or done button to save changes.

Figure 1: Content Fragment Models

Exercise 1.2

  1. Setup Target cloud configuration in Cloud Services
  2. Configure cloud configuration on folder

Figure 1: Cloud Services

  1. Open the Experience Fragment you created and publish it to Target by clicking Export to Target and Publish

Figure 1: Publish Services

  1. Open in Adobe Target and note the HTML and JSON version of the experience fragment.

Figure 1: Export to Target

  1. Return to AEM and use the Delete from Target Button to delete the offer from Adobe Target.

Figure 1: Delete from Target

Lesson 3 - Connected DAM

Objective

Integrate a local instance of AEM Sites with a different instance of AEM Assets

Lesson Context

AEM now provides the capability to use assets from a DAM repository in websites created on separate AEM instances. While editing pages in Page Editor, authors can seamlessly search, browse, and embed assets from a different AEM Assets instance.

You can also integrate your local instances of AEM Sites with a different (remote) instance of AEM Assets. Your authors can browse, search for, and use assets just as they do for a local instance of Assets. AEM Administrators create an integration between the two instances once and then users can continue to use it seamlessly thereafter. This article details the prerequisites required for this task and lists a few of the limitations you should be aware of.

For the Sites authors, the remote assets continue to be available and behave as read-only local assets.

Exercise 3.1: Set Up an Assets Instance

  1. Start AEM 6.5 Assets Instance on port 4504.

  2. Log on to the Assets Instance using Admin credentials.

  3. Go to Tools > Operations > Web Console.

  4. Look for the Adobe Granite Cross-Origin Resource Sharing Policy configuration. (HINT: You can use Ctrl+F to search for and find it.)

  5. Set the Allowed Origins property to http://localhost:4502 (Sites Instance) image1

  6. Click Save.

  7. Click the Adobe Experience Manager logo in the upper-left corner to display the navigation screen and go to Assets > Files > We.Retail.

  8. Create a new folder and upload a few images.

image upload

Exercise 3.2: Set up an AEM Sites Instance
  1. Start the AEM 6.5 Sites Instance on port 4502.
  2. Log onto the Sites Instance using Admin credentials.
  3. Go to Tools > Assets > Remote DAM Configuration.
  4. Create a new configuration with the following information:
    • Title: Remote DAM
    • Remote DAM URL (must include protocol): http://localhost:4504
    • Username: ksaner
    • Password: password
    • Mount Point (relative to Assets' root): remoteassets
    • Original Binary transfer optimization Threshold: 100 Kilobytes
  5. Click Test.
  6. Click Save.

remoteDamConfig

Exercise 3.3: Use the Connected DAM
  1. Log on to Sites Instance using the ksaner credentials:
    • Username: ksaner
    • Password: password
This user has authoring permissions on both of the AEM instances.
  1. Open a We.Retail website page at Sites > We.Retail > Language Masters > us > en. Edit the page.
  2. Alternatively, access http://localhost:4502/editor.html/content/we-retail/language-masters/en/men.html in a browser to edit a page.
  3. Click the Toggle Side Panel icon in the upper-left corner.
  4. Click the Remote Assets tab and click the Remote DAM button to log in.

remote-dam-icon-login

  1. Provide the credentials -- ksaner as user name and password as password.
  2. Search for the asset (of your choice) that you added to the DAM. Drag-and-drop the asset in an Image component.

remote-dam-search

While the fetched assets are read-only, you can modify the options allowed by your Sites components to edit the asset used in the Sites component. Assets that are used on the Page will be stored im the remoteassets folder on the Sites Instance.

remoteAssets

Lesson 4 - Integrate AEM Assets with Adobe Stock

Objective

  1. Search and Preview AEM Stock Assets directly from AEM
  2. License and save assets directly to the AEM Digital Assets Manager

Lesson Context

AEM 6.5 provides users the ability to search, preview, save and license Adobe Stock assets directly from AEM. Organizations can now integrate their Adobe Stock Enterprise plan with AEM Assets to make sure that licensed assets are now broadly available for their creative and marketing projects, with the powerful asset management capabilities of AEM.

Exercise 4.1

  1. From the main screen of AEM, choose Assets and select Search Adobe Stock.

  2. Search for hiking in Adobe Stock and select an unlicensed asset.

  3. Examine the options in the toolbar and then select View Similiar from Adobe Stock

Figure 1: Overview

  1. Select an image and choose View in Adobe Stock

  2. Examine the image and explore the options available in Adobe Stock.

  3. Navigate back to AEM and save the asset by selecting save and choose the folder you wish to save it in.

Figure 1: Overview

Exercise 4.2

In this exercise, you will use Smart Tagging to automatically tag images

  1. Use AEM's Omnisearch to search for a few terms that are relevant to We.Retail activity images:
  • Nature
  • Outdoor
  • Sky

and notice the lack of results

  1. Navigate to AEM > Assets > Files > We.Retail > English. Select the Activities folder and open it's properties.

Figure 1: Overview

  1. Check the box Enable Smart Tags and save the changes

  2. Create a new workflow on the Activities folder and choose the DAM Smart Tag Assets workflow and click Start.

Figure 2: Overview

  1. Open the properties > Basic Tab for a few of the Smart Tagged assets and review the applied smart tags.

Figure 3: Overview

Additional Resources

AEM Fluid Experiences for headless usecases

AEM Content Fragments Editorial Capabilities

Downloading Content Fragments

Smart Tagging

Appendix

Experience Fragments

Content Fragment Enhancements

Setup Adobe Stock with AEM

Setup Smart Tags with AEM Assets