Skip to content
Blackbird docs

Adobe Experience Manager

View on Github

AEM (Adobe Experience Manager) is a Content Management System (CMS) that allows users and companies to easily build websites, apps, and manage web pages and content. AEM is used by developers and marketers to organize and distribute content across digital channels.

Before setting up

Before you connect to AEM, you need to have the following:

  • AEM instance running and accessible from the Blackbird platform.
  • You have a technical account and created a private key for it so you can obtain a certificate to connect to AEM. Below in the Steps to create technical account section, you can find the steps to create a technical account and a private key and how to obtain a certificate.
  • You know your base URL for AEM environment. The base URL is the URL of your AEM instance, e.g. https://author-xxxx-xxxxx.adobeaemcloud.com.

Steps to create technical account and get a certificate

  1. Open Cloud Manager.
  2. Select needed program. image auth step 2
  3. Open Developer Console for needed Author environment. image auth step 3
  4. Switch to Integrations tab and Create new technical account. image auth step 4
  5. Unfold created private key and View the data. image auth step 5
  6. Use the Download button to obtain the raw data and store it in a file or another location from which it will be used for integration. image auth step 6

Connecting

  1. Navigate to apps and search for AEM
  2. Click Add Connection
  3. Name your connection for future reference e.g., ‘My AEM’
  4. Fill in the following fields:
    • Base URL: Your AEM base URL (e.g., https://author-xxxx-xxxxx.adobeaemcloud.com)
    • Integration JSON certificate: Integration certificate in JSON format. Can be found in the Developer Console. Example: [ “ok”: true, “integration”: [ “imsEndpoint”: “ims-na1.adobelogin.com”, … ] “statusCode”: 200]
  5. Click Connect
  6. Confirm that the connection has appeared and the status is Connected

connection

Actions

  • Search content: Search for content based on provided criteria.
  • Download content: Download content as HTML. Requires a content ID.
  • Upload content: Upload content from HTML. Requires a HTML file and target path as input.

Events

  • On content created or updated: Polling event that periodically checks for new or updated content. If the any content are found, the event is triggered.

Example

Here’s an example of how to set up a translation workflow with AEM and DeepL apps that will automatically translate content in AEM and send it to DeepL for translation.

AEM example

Here’s a notes on how the example works:

  • The On content created or updated event is triggered every hour and checks for new or updated content in AEM. If any content is found, the event is triggered.
  • In the loop, the Download content action downloads the content from AEM in HTML format.
  • The Translate document action of DeepL app sends the downloaded content to DeepL for translation.
  • The Replace using Regex action of Blackbird Utilities app replaces the original path to the target one in the translated content.

Utilitiy example

  • The Upload content action uploads the translated content back to AEM.

Feedback

Do you want to use this app or do you have feedback on our implementation? Reach out to us using the established channels or create an issue.