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
Open the Add Image or Add Video dialog in MangoApps.
Click on the Adobe tab to browse AEM assets.
Navigate folders or use the search bar to find media.
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.
Last updated