Template-Adobe Experience Manager: Assets

Rebekah Garner
Rebekah Garner
  • Updated

 

Adding an AEM Integration to a Template for Asset Data

In order to sync asset metadata from AEM Assets, you will select 'Assets' as the data type when setting up an inbound Experience Manager integration. To learn more about AEM Assets, see their documentation.

 

mceclip1.png Templates connected to Experience Manager can contain a single inbound integration. If you add multiple inbound integrations, a template validation error notification will appear in the warning icon in the top right corner of the page).

Create a Template

  1. Open an existing template or follow the steps to create a new template, creating the necessary Patterns, Pick Lists, and Field Sets (including any custom field mappings) to match your AEM fields. 

  2. Click Step 3 - Connect.

  3. Click  to add a new Inbound integration.
    mceclip1.png

  4. Click Adobe Experience Manager Inbound Integration.
    mceclip0.png
         
    The AEM Inbound configuration section displays.
    mceclip2.png

  5. Input the Integration Name.

  6. Select the connected Adobe Experience Manager Account.

  7. Click the modal for the Assets Data Selection type.

  8. Select the frequency sync period in the Schedule Sync. All Experience Manager inbound integrations sync data every 8 hours, beginning from the time the template is initially saved. This is not currently configurable, but may be in the future.

    ℹ️  Experience Manager syncs are incremental after the initial sync of data, meaning each subsequent sync will only pull in changes made in AEM since the last sync. The integration uses the jcr:lastModified property to detect recent changes.

    Integration Filters

  9. In the Integration Filter section, apply the appropriate File Format, Folder, and Tag filters:
     
    Name Description Notes
    Folder Searchable list of all folders to limit data. Using this filter will sync all contents of this folder and the contents of its sub-folders.

    Claravine support syncing of image, document, video, and audio files. Specifically, you can limit the data synced to specific file formats.
     
    Tag Searchable list of all tags ID to limit data.
    Filter applied to cq:tags
    File Format Searchable list of file types to limit synced data on.
    Filter applied to dc:format
     
    The following file formats are available to filter on:
    Image Document Video Audio
    GIF PDF MP4 MP3
    JPEG DOC MPEG WAV
    BMP DOCX    
    PNG PPT    
    SVG PPTX    
    TIFF XLS    
      XLSX    
      HTML    
     
    To learn more about supported file types in Experience Manager, please visit Adobe’s documentation.
     
    💡 Helpful tips:
    • Sync content fragments by filtering to assets in HTML file formats.
    • Multiple filters applied will behave as an ‘AND’ filter. For example, if you apply a filter on file format and folder, metadata synced from AEM will be limited to data that of the specified file format AND located in the specified folder.

    Field Mapping

    In Experience Manager, an object is uniquely identified using its path which Claravine relies upon in its integration as its key to detect changes. As such, path is a required field mapping when adding an AEM integration to a template.

  10. In the Field Mapping section, use the Map from AEM drop-down list to select the standard and custom inbound AEM field, and select the corresponding Map to Claravine drop-down list of fields in the template. 

    Claravine’s Experience Manager integration allows mapping to many of its standard properties. Depending upon what type of data you choose to sync to a template, the list of properties will change to be relevant to the data you select to sync (e.g. Assets vs. Page).

    Mappable Properties

    Property Display Name
    path path
    dc:date dc:date
    dc:description dc:description
    dc:format dc:format
    dc:identifier dc:identifier
    dc:language dc:language
    dc:publisher dc:publisher
    dc:relation dc:relation
    dc:rights dc:rights
    dc:source dc:source
    dc:subject dc:subject
    dc:title dc:title
    dc:type dc:type
    cq:tags cq:tags
    jcr:uuid jcr:uuid
    jcr:created jcr:created
    jcr:createdBy jcr:createdBy
    jcr:lastModifiedBy jcr:lastModifiedBy
    jcr:lastModified jcr:lastModified
    jcr:createdBy jcr:createdBy
    jcr:created jcr:created
    cq:parentPath cq:parentPath
    jcr:primaryType jcr:primaryType
    cq:name cq:name
    dam:assetID dam:assetID
    dam:assetState dam:assetState
    dam:fileFormat dam:fileFormat
    dam:relativePath dam:relativePath
    To learn more about properties in Experience Manager, see their documentation

  11. Click + Add New Mapping to add additional AEM to Claravine mapping. 

  12. Click Save to save the template.
 
💡 Helpful tip
  • You can use custom field mappings to sync data in custom properties in Experience Manager. It’s common for companies to customize their AEM environment through custom properties. In order to map data from custom properties, you simply add a custom field mapping to the AEM connect account. 

 

Watch a video showing you how to add an AEM Inbound Integration to an AEM Assets template.

 
 
What's Next: Follow the instructions to set up an integration template for AEM Pages.

Comments

0 comments

Article is closed for comments.