AEM Desktop App Release Notes

You are reading the AEM 6.2 version of AEM Desktop App Release Notes.
This documentation is also available for the following versions: 

Release Information

Products Adobe Experience Manager (AEM) Desktop App
Version

1.4 (1.4.0.1 on Mac OS X; 1.4.0.3 on Windows)

Type Minor Release
Date February 28, 2017
Download URL https://helpx.adobe.com/experience-manager/kb/download-companion-app.html
Compatibility (*)

AEM 6.3 Beta

AEM 6.2 SP1 (with Hot Fix 11099 applied)

AEM 6.1 SP2 (with Feature Pack 6658 and Hot Fix 8723 applied)

Adobe Experience Manager (AEM) Desktop App 1.4 adds the ability to upload hierarchical folders in the background with the ability to monitor progress. 

This release extends and replaces the previous version of the Experience Manager Desktop App, version 1.3, which provided performance enhancements and stability of accessing files and saving changes to AEM, especially from Creative Cloud desktop applications, such as InDesign, Illustrator, or Photoshop. It aimed to provide users with a more local desktop-like experience when working with files, while simultaneously handling network data transfer operations in the background.

Note

Compatibitlity (*) - Availabilty of buttons in Touch UI for new Desktop App 1.4 features - Folder Upload, Edit action - is as follows as of February 28, 2017:

  • AEM 6.3 Beta: available in beta builds
  • AEM 6.2 SP1, AEM 6.1 SP2 with respective packages: updated packages expected to be available soon

When new buttons will become available for AEM 6.1 and 6.2 as packages, this note will be removed.

Note

Want to start quickly?

  • Install the required server-side components on your AEM server (see Installation for details)
  • Download the AEM Desktop App binary from download page and install on your local machine

 

What's included in AEM Desktop App 1.4

This release of AEM Desktop App provides the following benefits:

  • Simplified upload of hierarchical folders through the new Create > Upload Folder action in Touch UI
    • Action initiates a folder upload operation carried out by the Desktop App
    • Desktop app traverses the given folder hierarchy on desktop in the background and uploads the files to AEM Assets
    • User can monitor progress in the new Upload Queue Status window with progress bar for ongoing operations
    • The Upload Queue Status also provides better troubleshooting information (e.g., no connection to  server)
  • New Edit action in Touch UI, that combines Check out and Open operations into one
  • Optimized grouping of desktop-related actions in Touch UI (AEM 6.3 Beta only)
  • Improved compatibility with the latest OS releases
  • Customer reported fixes

Enhancements Available Since AEM Desktop App 1.3

  • Increased efficiency. Users spend less time waiting for network operations to complete.
  • Improved Finder integration, which provides more stability and access to features, such as thumbnails.
  • Caching and performance improvements.
  • Better support for saving directly from desktop apps (PS, ID, AI, and so on).
  • Improved integration with Mac OS (local network drive protocol changed from WebDAV to more stable SMB1)
  • Desktop app connects with the AEM server using AEM native HTTP RESTful protocol
  • Files are saved locally first and then uploaded back to AEM in background after a predefined time (30 sec). This reduces the time to save files.
  • Better handling of desktop applications that use intermediate file operations to save a file (partial saves and temporary files), which enables the AEM Asset timeline to display correct version and asset upload information.
  • Dialog provided to track the status of background upload tasks.

List of changes

Different Mount Point on Mac (Since 1.4)

Since MacOS 10.12 (Sierra), Apple has changed the permissions on the /Volumes folder used to mount network drives and devices to more restrictive. Creating a new mount point there requires administrative rights now.
 
As AEM Desktop App should run for users who do not have admin rights to the local machine, the mount point for AEM Assets repository changed to a DAM subfolder in user's local folder on MacOS (CQ-104183). 
 
The mount point now is: ˜/DAM

Protocol change (Since 1.3)

  • Mac OS X
    • The local network drive protocol for OS X desktop integration changed to SMB1 from WebDAV.
    • The AEM repository mounted with Desktop App will be visible as an “smb” network drive in Finder, instead of a WebDAV drive.
  • Windows
    • The local network drive protocol for Windows dekstop integrations stays; AEM will be mounted as a WebDAV share
  • For both platforms (Windows and Mac)
    • The protocol to access/download assets and to upload changes to AEM has been changed to the native AEM protocol, which is a HTTP-based RESTful protocol. It provides greater control over network operations and is more compatible with the network infrastructure.

Note

On Mac OS X: The change of local network drive protocol from WebDAV to SMB1 results in a different local path to the same asset in the repository. This might impact links to files placed in CC applications via "Place" command. See documentation for more information.

File handling (since 1.3)

  • Folders are updated automatically after a predefined delay (currently 30s). 
  • Files checked out by other users are marked as read-only. 
  • 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, the user saving the file need not wait until the file is fully transferred to AEM, and can resume work as soon as the file is saved.
  • In the second phase, Desktop App uploads an updated file to AEM server after a predefined delay ( for example, 30s). This operations occurs in the background. Use the Show Background File Sync Status option to view the status of the upload operation. 

Important Notices

It is recommended to use the new Folder Upload capability to upload larger, hierarchical folders into AEM as opposed to using a copy / drag and drop into a mounted AEM repository from Finder / Explorer level. When using the folder upload feature, Destkop App communicates with AEM directly and thus has much better control over the overall process.

Please note that AEM Desktop App doesn't support a self-signed SSL certificates when connecting to AEM via a HTTPS secure connection. A CA-signed certificate is required on the server for such connections. (CQ-87941)

Known issues

  • After unmounting AEM, Mount AEM Assets might not actually mount the repository. (CQ-4200793)

Workaround: The workaround is to quit Desktop Application and start again, then mount should work again.

  • An asset checked out by one user is not possible to open for another user, either by Open action from Touch UI, or directly on desktop. Some applications might report it as locked, but also corrupted or even hang while trying to open. (CQ-4199234)

Workaround: When the asset is checked in again, it's available to other users.

  • Desktop Actions might not work in the Touch UI on assets with localized names on Windows. (CQ-4199446)

Workaround: Use "Reveal on desktop" on the folder containing the asset, and open directly from Explorer.

  • Server URLs are required to point to the server without a path (e.g. http://server, https://server, http://server:port, or https://server:port). Context paths and sub-folders other than /content/dam are not supported. CQ-97388, CQ-89343, CQ-87272, CQ-87272
  • File and folder names with reserved characters are not properly handled. Make sure to use file and folder names that fit AEM requirements. CQ-93361, CQ-93308, CQ-89276
  • Checkin/Checkout
    • Changing files simultaniously by multiple users may cause some modifications to get lost. The workaround is to use the checkin/checkout functionality to prevent multiple users from changing the same file. CQ-97035
    • Certain applications don't support the read-only flag properly which allows a user to save a file that's checked out by another user. The modified file is not transferred until the other user checks in the file. Both modifications are available in AEM as different versions of the asset. CQ-89551, CQ-87572, CQ-89615
    • The checked-out and readonly status are reported independently in Finder. This results in 2 lock icons when a user checks out an asset. CQ-89507
  • Finder integration
    • Manual folder reload does not always work. The workaround is to wait 30s for the folder to be automatically updated. CQ-97389
    • More Asset Info... is limited to single file selections. CQ-89542, CQ-87656
    • Open in AEM Assets... is limited to single file and folder selections. CQ-83382
  • Windows
    • Files with Alternate Data Streams (ADS) are only fully supported on NTFS. Copying such files to the WebDAV share provided by the Desktop App will result in a caution dialog warning the user that the file has properties that can't be copied to the new location. This is usually fine since the properties are only relevant to a particular application on the user's desktop and have nothing to do with the actual file contents. CQ-103770
    • Folders show up empty intermittently during folder browsing. CQ-103276.

Installation instructions

Prerequisites

AEM Desktop App 1.4 is compatible with AEM 6.1 Service Pack 2 and AEM 6.2 Service Pack 1. If you are running AEM 6.1 or 6.2, ensure that you have installed the respective Service Pack before installing AEM Desktop App 1.4.

Installing server-side components

Depending upon the AEM version, install the appropriate server-side components. 

AEM 6.1:

Install the following:

AEM 6.2:

Install the following:

AEM 6.3 Beta:

When testing with AEM 6.3 Beta as a part of the AEM Beta Program, no additional server-side components are required.

Installing AEM Desktop App 1.4 on local machine

For instructions, see Adobe Experience Manager Desktop App.

Helpful resources

Release Information for the Previous Release (AEM Desktop App 1.3)

Products Adobe Experience Manager (AEM) Desktop App
Version

1.3 (1.3.1.17 on Mac OS X; 1.3.12 on Windows)

Superseded by AEM Desktop App Version 1.4

Type Minor Release
Date

September 16, 2016 (Mac OS X)

November 14, 2016 (Windows)

Download URL https://helpx.adobe.com/experience-manager/kb/download-companion-app.html
Compatibility

AEM 6.2 (with Hot Fix 11099 applied)

AEM 6.1 SP2 (with Feature Pack 6658 and Hot Fix 8723 applied)

Any questions?

Have a question about this or any other AEM topic? Ask our Community.
Learn more about AEM topics on our help hub.
Was this helpful?

By submitting your feedback, you accept the Adobe Terms of Use.

Thank you for submitting your feedback.