You're viewing help content for version:

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. 

Using AEM Desktop App

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

Prerequisites for AEM Server

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.

AEM Desktop App is compatible with AEM 6.3. No additional AEM packages are required.

Download AEM Desktop App on Mac OS

Caution:

As of now, AEM Desktop App is tested to be compatible with Mac OS X 10.10 or later, with latest bug fixes.

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

  2. Double-click the DMG file, and then click/tap Open to install AEM Desktop App. 

    chlimage_1

    Note:

    Only one instance of the AEM Desktop App can be installed and be active at a time.

  3. After the app is installed, an icon appears on the MAC menu bar at the top right of the screen.

    chlimage_1
  4. To configure the URL to AEM Assets, select Preferences from the menu and specify the URL for your AEM instance in the AEM Assets Server URL box. Then, press Enter to save the changes.

    chlimage_1

    Note:

     The default URL is http://localhost:4502/content/dam.

  5. From the AEM Desktop App menu, select Mount AEM Assets to mount the AEM Assets server to your local drive.

    chlimage_1
  6. In the Adobe Marketing Cloud Sign-in page, specify the user name and password for your instance to sign in to Marketing Cloud.

    chlimage_1

Proxy support on Mac

If you configure proxy server settings for MAC OS (System Preferences > Network), AEM Desktop App will go through the preconfigured proxy server when attempting to connect to your AEM instance. If you modify proxy settings, restart AEM Desktop App for the changes to take effect.

Checking out assets on Mac

AEM Desktop App lets you check out files to prevent other users from modifying files you’re working on.

  1. From the Context menu, select the Open AEM Assets Folder to open Finder.

    chlimage_1
  2. Navigate to the location of the asset you want to check out.

    chlimage_1
  3. Right-click the asset, and select More Asset Info from the context menu.

    chlimage_1

    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.

  4. In the Asset Info dialog, click/tap the Checkout icon to check the asset out. The Checkout icon toggles to the Checkin icon after you click/tap it.

    chlimage_1
  5. To check the asset in so it is available to other users, click/tap the Checkin icon in the Asset Info dialog.

File handling

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.

  1. Upload an asset to AEM Assets.

  2. Click/tap the AEM Desktop App icon from the toolbar.

  3. From the menu, select the Show Background File Sync Status option.

    chlimage_1
  4.  From the dialog, review the status of the upload operation.

    chlimage_1

Connecting to AEM Behind a Dispatcher

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

AEM Desktop connects to AEM using a URL that includes the default port. Therefore, the virtualhosts setting in the dispatcher configuration should include the default port number. For more information around virtualhosts configuration, see Identifying Virtual Hosts.

For additional information on configuring the dispatcher to pass through these additional headers, see Specifying the HTTP Headers

Download AEM Desktop App on Windows

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

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

  2. Double-click the downloaded MSI file, and follow the instructions in the installation wizard to install AEM Desktop App.

    chlimage_1

    Note:

    Only one instance of the AEM Desktop App can be installed and be active at a time.

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

    chlimage_1
  4.  In the login screen, specify the user name and password for your instance. Select the Alternate Login URL option to specify an alternate AEM instance.

    chlimage_1

Proxy support on Windows

If you configure 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. If you modify proxy settings, restart AEM Desktop App for the changes to take effect.

Checking out assets on Windows

  1. From the Context menu, select the Explore Assets to open Explorer.

    chlimage_1
  2. In Explorer, navigate to the location of the asset you want to check out. 

    chlimage_1
  3. Right-click the asset and select Open on Web from the context menu.

    chlimage_1
  4. In the Asset Info dialog, click/tap the Checkout icon to check the asset out. The Checkout icon is a toggles to the Checkin icon after you click the Checkout icon to check the asset out.

    chlimage_1
  5. Review the asset in Explorer. A lock appears on the asset that you checked out.

    chlimage_1
  6. To check the asset in so it is available to other users, click/tap the Checkin icon in the Asset Info dialog.

    chlimage_1

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.

Enable Desktop icons for mapped assets

After you map the AEM Assets repository to your local drive, you can enable additional icons and the Folder Upload feature to appear for the mapped assets and folders.

  1. In the Assets console, click the User icon from the toolbar.  

    chlimage_1
  2. Click the My Preferences to display the Preferences dialog.

    chlimage_1
  3. Select Show desktop actions for Assets, and then click Accept

    chlimage_1
  4. Navigate to the Assets UI and hover the mouse pointer over a folder or asset. The following desktop actions are displayed as quick actions in the Card view:

    • Open on desktop
    • Edit desktop 
    • Reveal
    chlimage_1

    These desktop actions are also available when you click/tap the Desktop Actions icon in the toolbar after selecting the asset or from the toolbar in the asset page.  

    chlimage_1
  5. Click/tap the Open on desktop quick action to open the asset in read-only mode.

    chlimage_1

    Alternatively, choose Open from the Desktop Actions menu in the toolbar.

    chlimage_1
  6. Click/tap the Edit desktop quick action to open the asset for editing in an Adobe Creative Cloud application. Opening the asset in edit mode using this quick action checks the asset out. After you finish editing, check the asset in to update the changes in AEM Assets.

    chlimage_1

    Alternatively, choose Edit from the Desktop Actions menu in the toolbar.

    chlimage_1
  7. Click/tap the Reveal quick action to locate the particular asset in your local file system.

    chlimage_1

    Alternatively, choose Reveal from the Desktop Actions menu in the toolbar.

    chlimage_1
  8. (AEM Desktop version 1.6 onwards) With AEM 6.3 Service Pack 1, you can open upto five assets from a folder or collection simultaneously on desktop for preview or editing. Select multiple assets from the UI (maximum 5) and then tap/click the Desktop Actions icon from the toolbar. 

  9. Select the Open menu option. The selected assets are opened in preview mode. 

  10. To edit the assets, select the Edit option. The assets are opened in edit mode.

Note:

If you attempt to open or edit more than five assets simultaneously, a dialog is displayed notifying that the maximum limit has been reached and your request is not processed.

Uploading Folders

Using AEM Desktop, you can upload an entire folder containing assets from your local file directory to AEM Assets. This way, all assets within the folder are uploaded in bulk instead of having to upload them one at a time.

  1. From the Assets UI, click/tap Create from the toolbar, and the choose Upload Folder from the menu.

    chlimage_1
  2. Browse to the folder you want to upload and select it.

    chlimage_1
  3. Click/tap OK. The Background Upload Queue Status dialog displays the status of the upload. 

    chlimage_1
  4. After the folder uploads, close the dialog and navigate to the Assets UI. The uploaded folder id displayed in the UI. 

Linking asset versions edited through WebDAV

To link the version history for the assets edited through WebDAV, configure the DAM WebDAV version linking job from Configuration Manager.

  1. Go to http://<AEM Server>:<Port>4502/system/console/configMgr to open Configuration Manager.

  2. Open the DAM WebDAV version linking job configuration.

  3. Select Enable Version Linking.

    chlimage_1
  4. Specify the time interval for the scheduler to run the job and the staging timeout time, and save the settings.

Troubleshooting AEM Desktop App

If you encounter any issues while working with Desktop App, see:

Additional Resources

Here are some additional resources and knowledgebase articles on Desktop App:

This work is licensed under a Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License  Twitter™ and Facebook posts are not covered under the terms of Creative Commons.

Legal Notices   |   Online Privacy Policy