Use Connected Assets to share DAM assets in Experience Manager Sites use-connected-assets-to-share-dam-assets-in-aem-sites
In large enterprises the infrastructure required to create websites may be distributed. At times the website creation capabilities and digital assets used to create these websites may reside in different deployments. One reason can be geographically distributed existing deployments that are required to work together. Another reason can be acquisitions leading to heterogenous infrastructure, including different Experience Manager versions, that the parent company wants to use together.
Connected Assets functionality supports the above use cases by integrating Experience Manager Sites and Experience Manager Assets. Users can create web pages in Sites that use the digital assets from a separate Assets deployments.
Overview of Connected Assets overview-of-connected-assets
When editing pages in Page Editor as target destination, the authors can seamlessly search, browse, and embed assets from a different Assets deployment that acts as a source of assets. The administrators create a one-time integration of a deployment of Experience Manager with Sites capability with another deployment of Experience Manager with Assets capability. Site authors can also use Dynamic Media images in their site’s web pages through Connected Assets and use the Dynamic Media functionalities, such as smart crop and image presets.
For the Sites authors, the remote assets are available as read-only local assets. The functionality supports seamless search and access to remote assets on the Site Editor. For any other use cases that may require the complete asset-corpus to be available on Sites, consider migrating the assets in bulk instead of using Connected Assets. See Experience Manager Assets migration guide.
Prerequisites and supported deployments prerequisites
Before you use or configure this capability, ensure the following:
-
The users are part of the appropriate user groups on each deployment.
-
For Adobe Experience Manager deployment types, one of the supported criteria is met. Experience Manager 6.5 Assets works with Experience Manager as a Cloud Service. For more information about how this functionality works in Experience Manager as a Cloud Service, see Connected Assets in Experience Manager as a Cloud Service.
table 0-row-4 1-row-4 2-row-4 3-row-4 Sites as a Cloud Service Experience Manager 6.5 Sites on AMS Experience Manager 6.5 Sites on-premise Experience Manager Assets as a Cloud Service Supported Supported Supported Experience Manager 6.5 Assets on AMS Supported Supported Supported Experience Manager 6.5 Assets on-premise Not Supported Not Supported Not Supported
Supported file formats mimetypes
Authors search for images and the following types of documents in Content Finder and drag the searched assets in Page Editor. Documents are added to the Download component and images to the Image component. Authors may also add the remote assets in any custom Experience Manager component that extends the default Download or Image components. The supported formats are:
- Image formats: The formats that the Image component supports.
- Document formats: See the supported document formats.
Users and groups involved users-and-groups-involved
The various roles that are involved to configure and use the capability and their corresponding user groups are described below. Local scope is used for the use case where an author creates a web page. Remote scope is used for the DAM deployment hosting the required assets. The Sites author fetches these remote assets.
administratorsadminAuthorsksaner/content/DAM/connectedassets/.Authors(with read access on the remote DAM and author access on local Sites)dam-userson local Sites
ksanerksaner DAM user are used.administratorsadmin on remote Experience ManagerAuthorsksaner on remote Experience ManagerAuthorsksaner on remote Experience Managerksaner roles and belongs to a different user group.Connected Assets architecture connected-assets-architecture
Experience Manager lets you connect a remote DAM deployment as a source to multiple Experience Manager Sites deployments. However, you can connect a Sites deployment with only one remote DAM deployment.
Evaluate the optimal number of Sites instances to connect to a remote DAM deployment. Adobe recommends to incrementally connect Sites instances to the deployment and test that there is no performance impact at the remote DAM, as each connected Sites instance contributes to the data traffic on the remote DAM.
The following diagrams illustrate the supported scenarios:
The following diagram illustrates an unsupported scenario:
Configure a connection between Sites and Assets deployments configure-a-connection-between-sites-and-assets-deployments
An Experience Manager administrator can create this integration. Once created, the permissions that are required to use it are established via user groups. The user groups are defined on the Sites deployment and on the DAM deployment.
To configure Connected Assets and local Sites connectivity, follow these steps:
-
Access an existing Sites deployment or create a deployment using the following command:
-
In the folder of the JAR file, execute the following command on a terminal to create each Experience Manager server.
java -Xmx4096m -jar <quickstart jar filepath> -r samplecontent -p 4502 -nofork -gui -nointeractive & -
After a few minutes, the Experience Manager server starts successfully. Consider this Sites deployment as the local machine for web page authoring, say at
https://[local_sites]:4502.
-
-
Ensure that the users and roles with the appropriate scope exist on the Sites deployment and on the Assets deployment on AMS. Create a technical user on Assets deployment and add to the user group mentioned in users and groups involved.
-
Access the local Sites deployment at
https://[local_sites]:4502. Click Tools > Assets > Connected Assets Configuration and provide the following values:- A Title of the configuration.
- Remote DAM URL is the URL of the Assets location in the format
https://[assets_servername]:[port]. - Credentials of a DAM distributor (technical user).
- In the Mount Point field, enter the local Experience Manager path where Experience Manager fetches the assets. For example,
remoteassetsfolder. The assets that are fetched from DAM are stored in this folder on the Sites deployment. - Local Sites URL is the location of the Sites deployment. Assets deployment uses this value to maintain references to the digital assets fetched by this Sites deployment.
- Credentials of Sites technical user.
- The value of Original Binary transfer optimization Threshold field specifies if the original assets (including the renditions) are transferred synchronously or not. Assets with smaller file size can be fetched readily while assets with relatively larger file size are best synchronized asynchronously. The value depends on your network capabilities.
- Select Datastore Shared with Connected Assets, if you use a datastore to store your assets and the Datastore is shared between both deployments. In this case, the threshold limit does not matter as actual asset binaries are available on the datastore and are not transferred.
Figure: A typical configuration for Connected Assets functionality.
-
The existing digital assets on Assets deployment are already processed and the renditions are generated. These renditions are fetched using this functionality so there is no need to regenerate the renditions. Disable the workflow launchers to prevent regeneration of renditions. Adjust the launcher configurations on the (Sites) deployment to exclude the
connectedassetsfolder (the assets are fetched in this folder).-
On Sites deployment, click Tools > Workflow > Launchers.
-
Search for Launchers with workflows as DAM Update Asset and DAM Metadata Writeback.
-
Select the workflow launcher and click Properties on the action bar.
-
In the Properties wizard, change the Path fields as the following mappings to update their regular expressions to exclude the mount point connectedassets.
table 0-row-2 1-row-2 2-row-2 3-row-2 Before After /content/dam(/((?!/subassets).)*/)renditions/original/content/dam(/((?!/subassets)(?!connectedassets).)*/)renditions/original/content/dam(/.*/)renditions/original/content/dam(/((?!connectedassets).)*/)renditions/original/content/dam(/.*)/jcr:content/metadata/content/dam(/((?!connectedassets).)*/)jcr:content/metadatanote note NOTE All renditions that are available on the remote deployment are fetched, when authors fetch an asset. If you want to create more renditions of a fetched asset, skip this configuration step. The DAM Update Asset workflow gets triggered and creates more renditions. These renditions are available only on the local Sites deployment and not on the remote DAM deployment. -
-
Add the Sites deployment as an allowed origin in the CORS configuration on the Assets deployment. For more information, see understand CORS.
-
Configure same site cookie support.
You can check the connectivity between configured Sites deployments and Assets deployment.
Figure: Connection test of Connected Assets configured Sites.
Use Dynamic Media assets dynamic-media-assets
With Connected Assets, you can use image assets processed by Dynamic Media from remote DAM deployment on Sites pages, and use Dynamic Media functionalities, such as smart crop and image presets.
To use Dynamic Media with Connected Assets:
- Configure Dynamic Media on remote DAM deployment with Sync mode enabled.
- Configure Connected Assets.
- Configure Dynamic Media on the Sites instance with the same company name as configured on the remote DAM. The Sites deployment must have read-only access to the Dynamic Media account to work with connected assets. Therefore, ensure to disable the Sync mode in Dynamic Media configuration on Sites instance.
Configure Dynamic Media configure-dynamic-media
To configure Dynamic Media on Assets and Sites deployments:
-
Enable and configure Dynamic Media as global configuration on remote Assets author deployment. To configure Dynamic Media, see Configure Dynamic Media.
On remote Assets deployment, in Dynamic Media sync mode, select Enabled by default. -
Create Connected Assets configuration as described in Configure connection between sites and assets deployments. Also, select Fetch Original Rendition for Dynamic Media Connected Assets option.
-
Configure Dynamic Media on local Sites and remote Assets deployments. Follow the instructions to configure Dynamic Media.
- Use the same company name in all configurations.
- On local Sites, in Dynamic Media sync mode, select Disabled by default. The Sites deployment must have read-only access to the Dynamic Media account.
- On local Sites, in the Publish Assets option, select Selective Publish. Do not select Sync All Content.
-
Enable Dynamic Media support in Image Core Component. This feature enables the default Image component to display Dynamic Media images when Dynamic Media images are used by authors in webpages on local Sites deployment.
Use remote assets use-remote-assets
The website authors use Content Finder to connect to the DAM deployment. The authors can browse, search for, and drag the remote assets in a component. To authenticate to the remote DAM, keep the credentials provided by your administrator (if any) handy.
Authors can use the assets available on the local DAM and the remote DAM deployment, in a single web page. Use the Content Finder to switch between searching the local DAM or searching the remote DAM.
Only those tags of remote assets are fetched that have an exact corresponding tag along with the same taxonomy hierarchy, available on the local Sites deployment. Any other tags are discarded. Authors can search for remote assets using all the tags present on the remote Experience Manager deployment, as it offers a full-text search.
Walk-through of usage walk-through-of-usage
Use the above setup to try the authoring experience to understand how the functionality works. Use documents or images of your choice on the remote DAM deployment.
-
Navigate to the Assets interface on the remote deployment by accessing Assets > Files from Experience Manager workspace. Alternatively, access
https://[assets_servername_ams]:[port]/assets.html/content/damin a browser. Upload the assets of your choice. -
On the Sites deployment, in the profile activator in the upper-right corner, click Impersonate as. Provide
ksaneras user name, select the option provided, and click OK. -
Open a We.Retail website page at Sites > We.Retail > us > en. Edit the page. Alternatively, access
https://[aem_server]:[port]/editor.html/content/we-retail/us/en/men.htmlin a browser to edit a page.Click Toggle Side Panel on upper-left corner of the page.
-
Open the Assets tab (Remote Content Finder) and click Log in to Connected Assets.
-
Provide the credentials –
ksaneras user name andpasswordas password. This user has authoring permissions on both the Experience Manager deployments. -
Search for the asset that you added to DAM. The remote assets are displayed in the left panel. Filter for images or documents and further filter for types of supported documents. Drag the images on an
Imagecomponent and documents on aDownloadcomponent.The fetched assets are read-only on the local Sites deployment. You can still use the options provided by your Sites components to edit the fetched asset. The editing by components is non-destructive.
Figure: Options to filter document types and images when searching assets on remote DAM.
-
A site author is notified if an asset’s original is fetched asynchronously and if any fetch task fails. While authoring or even after authoring, the authors can see detailed information about fetch tasks and errors in the asynchronous jobs user interface.
Figure: Notification about asynchronous fetching of assets that happens in the background.
-
When publishing a page, Experience Manager displays a complete list of assets that are used on the page. Ensure that the remote assets are fetched successfully at the time of publishing. To check the status of each fetched asset, see asynchronous jobs user interface.
note note NOTE Even if one or more remote assets are not fetched completely, the page is published. The Experience Manager notification area displays a notification for errors that show in asynchronous jobs page.
connectedassets in the above walk-through). The assets are also searchable and visible in the local repository via Content Finder.The fetched assets can be used as any other local asset, except that the associated metadata cannot be edited.
Check use of an asset across webpages asset-usage-references
Experience Manager lets DAM users check all the references to an asset. It helps understand and manage the usage of an asset in remote Sites and in compound assets. Many authors of webpages on Experience Manager Sites deployment can use an asset on a remote Assets in different webpages. To simplify asset management and not lead to broken references, it is important for the DAM users to check use of an asset across local and remote webpages. The References tab in an asset’s Properties page lists the local and remote references of the asset.
To view and manage references on the Assets deployment, follow these steps:
-
Select an asset in Assets Console and click Properties from the toolbar.
-
Click References tab. See Local References for use of the asset on the Assets deployment. See **Remote References for use of the asset on Sites deployment where the asset was fetched using Connected Assets functionality.
-
The references for Sites pages displays total count of references for each local Sites. It may take some time to find all the references and display the total number of references.
-
The list of references is interactive and DAM users can click a reference to open the referencing page. If remote references cannot be fetched for some reason, a notification is displayed informing the user of the failure.
-
Users can move or delete the asset. When moving or deleting an asset, the total number of references of all the selected assets/folders are displayed in a warning dialog. When deleting an asset for which the references are not yet retrieved, a warning dialog is displayed.
Manage updates to assets in remote DAM manage-updates-in-remote-dam
After configuring a connection between remote DAM and Sites deployments, the assets on remote DAM are made available on the Sites deployment. You can then perform the update, delete, rename, and move operations on the remote DAM assets or folders. The updates, with some delay, are available automatically on the Sites deployment. In addition, if an asset on remote DAM is used on a local Experience Manager Sites page, the updates to the asset on remote DAM are displayed on the Sites page.
While moving an asset from one location to another, ensure that you adjust references so that the asset displays on the Sites page. If you move an asset to a location that is not accessible from the local Sites deployment, the asset fails to display on the Sites deployment.
You can also update the metadata properties for an asset on remote DAM and the changes are available on the local Sites deployment.
Sites authors can preview the available updates on the Sites deployment and then republish the changes to make them available on the Experience Manager publish instance.
Experience Manager displays an expired status visual indicator on assets in Remote Assets Content Finder to stop site authors from using the asset on a Sites page. If you use an asset with an expired status on a Sites page, the asset fails to display on the Experience Manager publish instance.
Frequently Asked Questions frequently-asked-questions
Limitations and best practices tip-and-limitations
-
To get insights about asset usage, configure the Assets Insight functionality on the Sites instance.
-
You cannot drag the remote asset onto the Image Component Configure dialog. However, you can drag the remote asset directly to the image component on the Sites page without clicking Configure.
Permissions and asset management permissions-and-managing-assets
- Local assets are read-only copies. Experience Manager components do non-destructive edits to assets. No other edits are allowed.
- Locally fetched assets are available for authoring purposes only. Asset update workflows cannot be applied and metadata cannot be edited.
- Only images and the listed document formats are supported. Content Fragments and Experience Fragments are not supported.
- Experience Manager does not fetch the metadata schemas. It means that all the fetched metadata may not be displayed. If the schema are separately updated on the Sites deployment then all the metadata properties are displayed.
- All Sites authors have read permissions on the fetched copies, even if authors cannot access the remote DAM deployment.
- No API support to customize the integration.
- The functionality supports seamless search and use of remote assets. To make many remote assets available on local deployment in one-go, consider migrating the assets. See Assets migration guide.
- It is not possible to use a remote asset as a page thumbnail on Page Properties user interface. You can set a thumbnail of a web page in Page Properties user interface from the Thumbnail by clicking Select Image.
Set up and licensing setup-licensing
- Assets deployment on Adobe Managed Services is supported.
- Sites can connect to a single Assets deployment at a time.
- A license of Assets working as remote repository is required.
- One or more licenses of Sites working as local authoring deployment is required.
Usage usage
- Users can search for remote assets and drag those on local page when authoring. No other functionality is supported.
- Fetch operation times out after 5 seconds. Authors can have issues fetching assets, say if there are network issues. Authors can reattempt by dragging the remote asset from Content Finder to Page Editor.
- Simple edits that are non-destructive and the edit supported via the
Imagecomponent, can be done on fetched assets. Assets are read-only. - The only method to re-fetch the asset is to drag it on a page. There is no API support or other methods to re-fetch an asset to update it.
- If assets are decommissioned from the DAM, those continue to be in use on Sites pages.
- The remote reference entries of an asset are fetched asynchronously. The references and the total count is not real-time and there may be some difference if a Sites author uses the asset while a DAM user is viewing the reference. DAM users can refresh the page and try again in a few minutes to get the total count.
Troubleshoot issues troubleshoot
To troubleshoot common errors, follow these steps:
-
If you are unable to search for remote assets from the Content Finder, then ensure that the required roles and permissions are in place.
-
An asset fetched from the remote DAM may not be published on a web page for one or more reasons. It does not exist on remote server, lack of appropriate permissions to fetch it, or network failure can be the reasons. Ensure that the asset is not removed from the remote DAM. Ensure that appropriate permissions are in place and the prerequisites are met. Retry adding the asset to the page and republish. Check the list of asynchronous jobs for errors in asset fetching.
-
If you are unable to access the remote DAM deployment from the local Sites deployment, ensure that cross-site cookies are allowed and same site cookie support is configured. If cross-site cookies are blocked the deployments of Experience Manager may not authenticate. For example, Google Chrome in Incognito mode may block third-party cookies. To allow cookies in Chrome browser, click the ‘eye’ icon in the address bar, navigate to Site Not Working > Blocked, select the Remote DAM URL, and allow login-token cookie. Alternately, see how to enable third-party cookies.
-
If you are unable to access the Adobe Managed Services remote DAM deployment from Experience Manager Sites as a Cloud Service Sites deployment, update the
aem_author.vhostfile, available at"/etc/httpd/conf.d/available_vhosts, for remote DAM to include the following headers in the Dispatcher configuration:code language-xml Header Set Access-Control-Allow-Origin <Local Sites instance host> Header Set Access-Control-Allow-Credentials true -
If remote references are not retrieved and results in an error message, check if Sites deployment is available and check for network connectivity issues. Retry later to check. Assets deployment attempts twice to establish connection with Sites deployment and then reports a failure.
-
If the cookies are not sent from the Sites server to the Assets server in Google Chrome, this is because the Assets connection is not over HTTPS. If you do not use HTTPS on the Assets instance then the
SameSite=Noneheader cannot be added to the response after you authenticate with the Assets server.