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.

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).

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.

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.