You're viewing help content for version:
- 6.3
- 6.2
- Older Versions
Adobe Experience Manager Desktop App lets you map the AEM Assets repository to a network directory so assets within AEM are available at your local system.
Depending upon the operating system, you can view and browse assets in AEM from Mac OS X Finder/Windows Explorer. In addition, you can quickly switch between Finder/Explorer and AEM Assets using convenient links.
You can create, edit, or delete files from Finder/Explorer. The changes are automatically synchronized with AEM Assets and vice-versa. In other words, any changes that you make to the assets from Finder/Explorer are reflected in AEM Assets. Similarly, any changes you make within AEM Assets are visible from Finder/Explorer.
You can download AEM Desktop App from the AEM Desktop App download page. Ensure your AEM server has all the required packages installed before using the application.
Note:
Adobe Experience Manager Desktop App is a new name for AEM Assets Companion App, introduced in AEM 6.1 release.
To use AEM Desktop App, ensure that your AEM server version is supported by AEM Desktop App, download the appropriate installation file (binary) for your operating system (Mac or Windows) from AEM Assets and install the app.
Note:
On Windows, the default Win7 setting prevents AEM Desktop App from handling assets that are larger than 50MB.
Adobe recommends that you use an HTTPS connection to connect to the author node to ensure that you securely transfer assets to/from AEM. Moreover, intermediate firewalls, proxies, and load balancers don't support WebDAV well and interfere with the AEM Desktop App. Using SSL ensures that the traffic reaches the AEM author unmodified.
Caution:
The version of AEM Destkop App you are planning to install on your local machine might require a specific AEM server version/additional server-side components (service packs, hot fixes or feature packs). Ensure that the AEM server is properly configured before you connect to it for the first time. If you require help, contact your AEM administrator.
Prerequisites for AEM 6.2
AEM Desktop App 1.3 is compatible with AEM 6.2.
Install the following packages on AEM 6.2:
Prerequisites for AEM 6.1
AEM Desktop App 1.3 is compatible with AEM 6.1 Service Pack 2.
Install the following packages on AEM 6.1:
Caution:
As of now, AEM Desktop App is tested to be compatible with Mac OS X 10.10 or later, with latest bug fixes.
-
Go to the AEM Desktop App download page, and click the appropriate link to download the AEM Desktop App binary for your Mac OS X.
-
In the Adobe Marketing Cloud Sign-in page, specify the user name and password for your instance to sign in to Marketing Cloud.
Note:
If you have configured Proxy Server settings for MAC OS (System Preferences > Network), AEM Desktop App will go through the preconfigured proxy server when attempting to connect to the AEM instance that you specify.
AEM Desktop App lets you check out files to prevent other users from modifying files you’re working on.
-
Note:
The local path to the assets mounted with Desktop App 1.3 is different than the local path mounted with Desktop App 1.2. For example, when you open the More File Info dialog on the same AEM asset, the following server locations are displayed:
- Desktop App 1.3: smb://localhost/DAM/geometrixx-outdoors/logo.png
- Desktop App 1.2: http://localhost/content/dam//geometrixx-outdoors/logo.png
This change may impact assets that have other assets placed through the Place Link command (in Illustrator, Photoshop, InDesign). You may have to relink assets in the Adobe Creative Cloud applications. Alternatively, mount AEM as a WebDAV drive (works even without the Destkop App), and use it along the new Desktop App mounting point before all assets are relinked.
If you use AEM Desktop App 1.3 on Mac OS, files are saved to a network drive location mounted via Desktop App in two phases. In the first phase, a file is saved locally. This way, a user need not wait for the file to be fully transferred to AEM after saving the file. Instead, the user can resume work as soon as the file is saved locally. In the second phase, Desktop App uploads the updated file to AEM server after a predefined delay (for example, 30s). This operation occurs in the background. Use the Show Background File Sync Status option to view the status of the upload operation.
The Copy and Move methods in the Assets API require the following additional headers to be passed to AEM:
- X-Destination
- X-Depth
- X-Overwrite
For additional information on configuring the dispatcher to pass through these additional headers, see Specifying the HTTP Headers.
Caution:
As of now, AEM Desktop App is tested to be compatible with the following:
Windows
- Windows 7, with latest service packs and bug fixes
-
Go to the AEM Desktop App download page, and click the appropriate link to download the AEM Desktop App binary for your Windows operating system.
-
To map your AEM instance with AEM Desktop App, specify the name of the host machine that runs your AEM instance and the port number (http:<aem-url>:port).
Note:
If you have configured Proxy Server settings for Windows (Internet Options > LAN Settings), AEM Desktop App will go through the preconfigured proxy server when attempting to connect to the AEM instance that you specify.
You can customize the Asset Info dialog by overlaying one or both of these components:
- The Granite UI page located at /libs/dam/gui/content/assets/moreinfo
- The HTL /css/javascript component located at /libs/dam/gui/components/admin/moreinfo
Which component is overlaid, depends on the nature of the customization. To change which components are displayed as part of the Asset Info dialog, overlay the Granite UI page. To change the HTML/CSS/Javascript content of the dialog, overlay the HTL component.
After you map the AEM Assets repository to your local drive, you can enable additional icons to appear for the mapped assets and folders.
To link the version history for the assets edited through WebDAV, configure the DAM WebDAV version linking job from Configuration Manager.
If you encounter any issues while working with Desktop App, see Troubleshooting AEM Desktop App.