Topics

Configuring AEM synchronization

In This Guide

Brightspot integrates with Adobe Experience Manager (AEM) to provide you with the most powerful means to manage your content. This topic provides guidance on synchronizing Brightspot and AEM.

Configuring AEM synchronization overview

To configure AEM synchronization:

  1. In AEM, create the folder you want to synchronize with Brightspot.
  2. To configure synchronization from Brightspot to AEM, do the following:
    1. Click menu > Admin > Sites & Settings > Global. The Edit Global widget appears.
    2. Under Main, expand Adobe AEM.
    3. From the Settings list, select Set.
    4. Using the following table as a reference, enter values to synchronize content from Brightspot to AEM.
    5. Click Save.
  3. To configure synchronization from AEM to Brightspot, do the following:
    1. Go to the AEM tools console at http://<aehmost>/miscadmin.
    2. Under Tools/Replication, select Agents on author.
    3. Click New. A Create Page dialog box appears.
    4. In the Title field, enter the synchronization folder's title.
    5. In the Name field, enter the synchronization folder's name.
    6. Select Replication Agent.
    7. Click Create. You return to the Agents on author list.
    8. Double-click the agent you just created. A widget appears.
    9. Click Edit. An Agent Settings dialog box appears.
    10. Under Transport, in the URI field, enter http://hostname/_api/adobe/aem, where hostname is the Brightspot tool URL, such as http://editors.mybrightspot.com/.
    11. In the User and Password fields, enter an existing Brightspot username and password. Ensure this user has adequate permissions to create content.
    12. Under Triggers, mark On Modification.
    13. Click OK. You return to the previous widget.
    14. Click Test Connection. A web page appears with diagnostic messages. If the last message is Replication test succeeded, the AEM-to-Brightspot synchronization is configured correctly.

Fields for configuring the Brightspot-to-AEM synchronization

The following table describes the fields for configuring the Brightspot-to-AEM synchronization.

Field
Description
AEM Base URLTop-level URL for logging on to AEM, such as http://myaem.myhost.com. Do not include a trailing slash.
AEM Repository URLURL to the AEM repository. This URL is typically the AEM base URL and a path, such as http://myaem.myhost.com/crx/server. Do not include a trailing slash. You can find the path by doing the following:
  1. Go to the URL http://myaem.myhost.com/system/console/components. The Adobe Experience Manager Web Console appears.
  2. Expand the component org.apache.sling.jcr.davex.impl.servlets.SlingDavExServlet.
  3. Under Properties, look at the value for alias.
AEM UsernameUsername for logging in to AEM.
AEM PasswordPassword for logging in to AEM.
Jcr WorkspaceAEM Java Content Repository. You can determine the available repositories by doing the following:
  1. Open the CRX DE by going to the URL http://myaem.myhost.com/crx/de/index.jsp.
  2. Expand /etc/virtual-repositories, and select the required JCR.
  3. Use the value for address.
    JCR workspace
    JCR workspace

The default workspace is typically crx.default.

Aem Dam RootPath to the root folder where AEM stores your assets. You can determine the AEM DAM root by examining the URL of a folder. For example, if a folder’s name is my-images, and URL to the folder is http://myaem.myhost.com/content/dam/geometrixx-outdoors, then the AEM DAM root is content/dam. Do not include a trailing slash.
Aem Image FolderName of existing folder in AEM. You can view a folder’s name and title by doing the following:
  1. Open the CRX DE by going to the URL http://myaem.myhost.com/crx/de/index.jsp.
  2. In the CRX DE search bar, search for the folder’s name or title.
  3. In the Aem Image Folder field, enter one of the folder names, typically under the key /content/dam/.
    AEM Folder Title Name.png
    AEM Image folder
Aem Image Folder Titles Title of existing folder in AEM.
Brightspot CMS Base URLBrightspot tool URL, such as http://editors.mybrightspot.com/.
Disable Import
  • If toggled on, items you create in AEM are not imported into Brightspot.
  • If toggled off, items you create in AEM are imported into Brightspot.
Disable Export
  • If toggled on, items you create in Brightspot are not exported to AEM.
  • If toggled off, items you create in Brightspot are exported to AEM
Aem Node InitializerInitialization setting to use this integration. For most implementations, select Aem Node Default Initializer.

Finding and modifying synchronized items in AEM

If you created a synchronized item in Brightspot, you can open and modify the same item in AEM. The procedure in this section applies to content types and fields configured for synchronization between Brightspot and AEM.

To find and modify a synchronized item in AEM:

  1. In Brightspot, open the item in the content edit form.
  2. Toward the right of the form, select > AEM. A widget appears.
    AEM Tab.png
    Finding AEM items
  3. In AEM, do one of the following:
    • Paste the item's title into the search field.
    • Paste the item's UUID into the search field.
    • Navigate to the item using the AEM path.
  4. Modify the item in AEM, and save the changes. The changes appear in Brightspot.

Finding and modifying synchronized items in Brightspot

If you created a synchronized item in AEM, you can open and modify the same item in Brightspot.

To find and modify a synchronized item in Brightspot:

  1. Open the item in AEM, and observe the item’s UUID and title.

    AEM Item UUID Title.png
    Item opened in AEM

  2. In Brightspot, do one of the following:

    • Paste the item’s title into the search field.
    • Paste the item’s UUID into the search field.
  3. Modify the item in Brightspot, and save the changes. The changes appear in AEM.
In This Guide