# Integration with Adobe Experience Manager (AEM)

### Overview

The integration allows users to access and utilize media assets stored in AEM directly within MangoApps without copying files. Instead, assets are linked via Adobe’s CDN.

<figure><img src="https://1627138357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKbJ2ssjhlUZRcGOXW%2Fuploads%2F3ql7vmezCPJNsBNyX5e8%2Fadobe-experience-cloud-lockup-rgb-one-line-red-black2.png?alt=media&#x26;token=9d7b4b8d-ccbe-4654-915d-a43525a0b446" alt=""><figcaption></figcaption></figure>

This guide provides step-by-step instructions for setting up and using the AEM integration.

***

### **Key Features**

* Users can retrieve media from AEM wherever the Media Center is used.
* AEM integration is accessible in the "Add Image" and "Add Video" dialogs.
* Assets remain linked to AEM, avoiding duplication in MangoApps.
* Permissions are managed through AEM’s access controls.
* The integration supports automatic updates when an asset is modified in AEM.

***

### **Role Pre-requisites**

#### **For Administrators:**

* Access to **MangoApps Admin Portal** to enable the integration.
* **AEM Administrator privileges** to retrieve the necessary API details and user credentials.

#### **For End Users:**

* Must have access to MangoApps and appropriate permissions to add media.

***

### **Admin Setup**

#### **Enabling AEM Integration**

Navigate to **Admin Portal > Integration > All**.

Locate **Adobe Experience Manager (AEM)**.

<figure><img src="https://1627138357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKbJ2ssjhlUZRcGOXW%2Fuploads%2F7p7e9QYLRDKWD6MElVSv%2F04-02-2025-09-01-18.png?alt=media&#x26;token=2c03f44b-0eec-4985-8c84-6e2be5231519" alt="" width="563"><figcaption></figcaption></figure>

Click **Setup** and configure the following fields:

* **Module Label** (Default: Adobe, but customizable).
* **AEM URL** (Your AEM instance URL).
* **Enable Media Post-Back** (Optional, allows tracking asset usage).

Click **Save** to complete the setup.

<figure><img src="https://1627138357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKbJ2ssjhlUZRcGOXW%2Fuploads%2FuNhBNffakOhDWj8yvPjv%2Fsdfsada.png?alt=media&#x26;token=aecbce28-1b80-40c7-850a-bc8372714f2c" alt="" width="563"><figcaption></figcaption></figure>

#### **User Permissions**

* MangoApps will use a **service user account** in AEM to access assets.
* Permissions are assigned based on AEM’s folder structure and access controls.

***

### **End User Experience**

#### **Adding Images and Videos**

1. Open the **Add Image** or **Add Video** dialog in MangoApps.
2. Click on the **Adobe** tab to browse AEM assets.
3. Navigate folders or use the **search bar** to find media.
4. Select the desired media and confirm selection.

***

#### **Image and Video Display Options**

**Views**: Choose between **Card View** or **List View**.

**Filters**: Filter media by **File Type** or **Tags**.

**Resize Options**: Users can select predefined sizes

**Smart Crops**: Users can choose predefined aspect ratios like:

* 16:9 Widescreen
* Square
* Instagram Story

***

### **Managing AEM Media in MangoApps**

**Replacing or Removing Assets**

* Click **Replace Image/Video** to select a new one from AEM.
* Click **Delete** to remove an asset from MangoApps (this does not delete it from AEM).

**Setting Image Properties**

* Users can add **Alt Text** for accessibility.
* Assets can be linked via:
  * **Simple URL** (Custom external link)
  * **Media URL** (Direct AEM link)
  * **Phone** (Clickable phone number)
  * **Other** (User-defined URL)

***

### **Testing Considerations**

Before rolling out the AEM integration, perform the following tests:

#### **Functionality Testing**

* Verify that AEM media appears correctly in MangoApps' Media Center.
* Ensure media assets are properly linked (not copied) from AEM.
* Test **search filters** and **Smart Crop options** for images.

#### **Permission Testing**

* Confirm users can access only the folders assigned to them in AEM.
* Check whether different user roles (Admin, Contributor, Viewer) function as expected.

#### **Edge Case Testing**

* Test how expired or deleted AEM media displays in MangoApps (should show a broken thumbnail instead of an error).
* Verify media updates in AEM reflect automatically in MangoApps without requiring manual re-upload.

***

### **Rollout Recommendations**

#### **Phase 1: Admin & IT Setup**

* Configure AEM integration in MangoApps.
* Assign appropriate access permissions in AEM.
* Conduct internal testing for functionality and security.

#### **Phase 2: Limited User Testing**

* Roll out integration to a small group of users for feedback.
* Train testers on how to retrieve and manage AEM media in MangoApps.
* Gather feedback and refine permissions if necessary.

#### **Phase 3: Full Deployment**

* Enable AEM integration for all MangoApps users.
* Provide **help documentation** and **support channels** for troubleshooting.
* Monitor asset performance and optimize as needed.

***

### **Asset Expiration and Writeback to AEM**

#### **Handling Expired Media**

* Expired or deleted AEM assets will display a **broken image icon** in MangoApps instead of causing errors.

#### **Usage Tracking (Writeback)**

* MangoApps will send usage data back to AEM, tracking where assets are used.
* The writeback supports **Create** and **Delete** actions.

***

### **Troubleshooting and Support**

#### **Common Issues & Solutions**

| **Issue**                      | **Solution**                                         |
| ------------------------------ | ---------------------------------------------------- |
| AEM tab is not visible         | Ensure AEM integration is enabled in Admin settings. |
| Cannot access AEM media        | Verify user permissions in AEM.                      |
| Selected media does not appear | Check if the asset has expired in AEM.               |
| Writeback is not working       | Ensure the **Media Post-Back** option is enabled.    |

For further support, contact your IT administrator or your MangoApps Account Team.

***

### FAQ

**Q: If we use the Adobe Experience Manager (AEM) Integration, will PDF files be editable similar to how Microsoft Office files are editable via WOPI?**

**A:** No, the AEM integration does not enable PDF editing. AEM allows users to browse and select assets (such as images and videos) for sharing in MangoApps, but it does not provide PDF viewing or editing functionality. Additionally, WOPI only supports the editing of Microsoft Office files (e.g., Word, Excel, PowerPoint) and is not connected to PDF editing.