Use Experience Manager desktop app v1.10 use-aem-desktop-app-v1x
Using the App, the assets within Experience Manager are easily accessible on your local desktop and can be used in any desktop applications. Assets can be easily revealed in Mac Finder or Windows Explorer, opened in desktop applications, and changed locally - the changes are saved back to Experience Manager with a new version created in the repository.
This integration enables centralized asset management and access across Creative Cloud and other applications, ensuring compliance with branding and other standards.
The key tasks that you do using the Experience Manager desktop app v1 include:
For the various recommended dos and don’ts, see the best practices for using the desktop app. If you face issues using the App, see how to troubleshoot Experience Manager desktop app.
Experience Manager desktop app touch-points in the creative workflow aem-desktop-app-touch-points-in-the-creative-workflow
Experience Manager desktop app, along with Assets, integrates in your creative workflow and offers the following touch-points.
Experience Manager desktop app touch-points the creative workflow
Install and connect the app to the Experience Manager server installandconnect
Before you can begin creating or editing the creative assets, connect the desktop application with the Assets server to download and upload assets in the repository. Perform the following tasks:
- Install the app.
- Set your preferences and connection details.
- Connect to an Experience Manager server and mount assets repository as local drive.
- Enable desktop actions on the Experience Manager server.
The Experience Manager desktop app uses an HTTPS connection to connect to the Experience Manager server to transfer your assets robustly and securely.
Install the application installapp
Ensure that the app supports your version of the Experience Manager server to use the Experience Manager desktop app. Download the appropriate installation file (binary) for your operating system (Mac or Windows) and install the app.
Detailed configuration can be necessary depending on your network and system preferences. See Install and configure Experience Manager desktop app for more details.
-
Go to the Experience Manager desktop app v1.10 download page and download the appropriate binary for your operating system.
-
Launch the downloaded installation file and follow the on-screen instructions to install the app.
note note NOTE Only one instance of the Experience Manager desktop app can be installed and be active at a time.
Understand the in-app options and preferences inapppref
The application allows for settings to connect and disconnect from Experience Manager servers, view the status of uploads, manage local cache, and so on. The default settings work for a typical user of the application. You can tweak the settings to get more out of the application. And, get more out of the integration with the Experience Manager server. The following are the various settings:
Explore Assets Open the local drive in which the Assets repository is mounted. In other words, explore the assets that are now made available on your local machine.
View asset status When changed assets are uploaded or new assets are added to the Assets repository, the application uploads the assets in the background. The background upload allows for smooth operations, without you having to wait for the upload to finish, especially for large-sized assets. You can save your changes locally and forget it. The application takes some time to send these assets to the server, depending on the available bandwidth. You can check the status of the upload, along with some more basic information.
Options Click options in the desktop app tray to set the app to launch at startup, connect to the Experience Manager server on launch, and change the local drive letter for Assets after mounting.
Advanced > Manage cache You can control the amount of disk space made available for local caching purposes. The artifacts from the Assets server are cached locally for a smoother experience. You can change the defaults to suit your requirements. Also, you can clear the cache to fetch all assets afresh. When you clear the cache, it preserves your unsaved changes. Any assets not checked into the Experience Manager server are retained and not deleted.
Connect to an Experience Manager server connect
The app supports proxy configuration on Mac and Windows. The configuration is read when the app starts. If you modify proxy settings, restart the app for the changes to take effect.
-
Launch the Experience Manager desktop app. To map your Experience Manager instance with the app, specify your Experience Manager server in the format
https://[aem-server-url]:[port].
-
In the login screen, specify the user name and password for your instance. To specify an alternate Experience Manager instance, select the Alternate Login URL option.
Enable desktop actions in Experience Manager web interface desktopactions
From within the Assets user interface, you can explore the asset locations or check-out and open the asset for editing in your desktop application. These options are called desktop actions and are not enabled by default. Follow these steps to enable it.
-
In the Assets interface, click/tap the User icon in the upper right corner of the toolbar.
-
Click My Preferences to display the Preferences dialog.
-
In the User Preferences dialog, select Show Desktop Actions For Assets, then click Accept.
Figure: Check Show Desktop Actions For Assets to enable the desktop actions.
Access and open assets on your desktop openondesktop
When you click Open to open an asset on your local computer, the app downloads the asset to its internal cache. The app launches the native desktop application that is associated with the file type of the downloaded asset.
On Mac, select Open from the context menu to open an asset through the Experience Manager desktop app. On Windows, select Open on Web from the context menu to open the asset. From the Asset Status window, click/tap
For Adobe InDesign (INDD) files, select Open from the context menu. When you click this option, the App downloads the linked assets to your local file system and then opens the INDD file in Adobe InDesign. This method ensures that the necessary assets are locally available when editing the INDD file.
Figure: Context menu options to access and open assets using the Experience Manager desktop app.
Additional options in Experience Manager interface additional-options-in-aem-assets
After you map the Assets repository to your local drive, you can enable additional icons and the Folder Upload feature to appear for the mapped assets and folders.
-
Open the Assets interface and hover the pointer over a folder or an asset, to display the desktop actions as quick actions in the Card view.
Figure: In Assets UI, open the quick actions menu to see desktop actions.
These desktop actions are also available when you click the Desktop Actions option in the toolbar after selecting the asset or from the toolbar in the asset page.
-
To open the asset in the desktop application that is associated with the specific file extension, click the Open on desktop quick action
Alternatively, choose Open from the Desktop Actions menu in the toolbar.
To locate the particular asset on your local file system, click Reveal quick action
Understand the asset statuses understand-the-asset-statuses
Work on your assets workonassets
Check out assets from the Experience Manager web interface check-out-assets-from-the-aem-web-interface
Experience Manager Assets lets you check out assets for editing and check them back in after you complete making the changes. After you check out an asset, only you can edit, annotate, publish, move, or delete the asset. Checking out an asset locks the asset and prevents other users from performing any of these operations. To be able to check out/in assets, you require Write access on them.
There are two ways of checking out assets from the Experience Manager web interface. For detailed information on the first method, see the check-in and checkout files from Assets UI. Follow these steps for the second methods to check out and open the asset when the Experience Manager desktop app is installed.
-
Open the Assets interface and hover the pointer over a folder or an asset, to display the desktop actions as quick actions in the Card view.
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.
-
To open the asset, click/tap the Open on desktop quick action
Alternatively, choose Open from the Desktop Actions menu in the toolbar.
note note NOTE When you edit an opened but unchecked-out file, other users do not know that you are updating the asset. -
To open an asset for editing in an Adobe Creative Cloud application, click
Alternatively, choose Edit from the Desktop Actions menu in the toolbar.
-
Select the Open menu option. The selected assets are opened in preview mode.
-
To edit the assets, select the Edit option. The assets are opened in edit mode.
Check out assets from Finder on macOS check-out-assets-on-mac
The app lets you check out asset files to prevent other users from modifying the files that you’re working on.
-
From the Mac context menu, select the Open AEM Assets Folder option to open the Finder.
Figure: Context menu options to access and open assets using the Experience Manager desktop app.
-
Navigate to the asset that you want to check out.
-
Right-click the asset, and select More Assets Info from the context menu.
-
In the Asset Info dialog, click/tap the Checkout icon to check out the asset. The Checkout icon toggles to the check-in icon after you click/tap it.
-
To check in the asset so it is available to other users, click/tap the check-in icon in the Asset Info dialog.
Check out assets on Windows check-out-assets-on-windows
The app lets you check out asset files to prevent other users from modifying the files that you’re working on.
-
From the Context menu, select the Explore Assets to open Explorer.
-
In Explorer, navigate to the location of the asset you want to check out.
-
Right-click the asset and select Open on Web from the context menu.
-
In the Asset Info dialog, click the Checkout icon. The Checkout icon toggles to the check-in icon.
-
Review the asset in Explorer. The lock icon on the asset
note note NOTE The lock icon may appear after some delay. The Experience Manager desktop app caches the assets for quick access so it may take a few moments to update the locked status. -
To check in the asset so it is available to other users, click/tap the check-in icon in the Asset Info dialog.
Check in an asset using Finder or Explorer and using web interface check-in-an-asset-using-finder-or-explorer-and-using-web-interface
When you’ve finished editing the assets, save the assets in your desktop application. From the context menu, select More Assets Info and click check-in.
The assets are uploaded to the Experience Manager server. Optionally, you can check the status of the upload by selecting View Asset Status from the system tray icon. Alternatively, you can check in an asset from the Experience Manager web interface. Click the checked out assets or select it. From the toolbar, click the check-in icon
An asset is uploaded to Experience Manager automatically after any changes are saved locally. The check-in makes the asset available to other Experience Manager users for editing.
Bulk upload assets and folders to Experience Manager server bulkupload
Using the Experience Manager desktop app, you can upload an entire folder containing assets from your local file directory to Assets. This way, all assets within the folder are uploaded in bulk instead of having to upload them one at a time.
-
From the Assets UI, click/tap Create from the toolbar, and then from the menu, select Upload Folder.
-
Browse to the folder that you want to upload and select it.
-
Click/tap OK. The Assets Status dialog displays the status of the upload.
See the status of the upload in the Asset Status window
note note NOTE You can manually pause or cancel the upload by clicking/tapping the appropriate icon. -
After the folder uploads, close the dialog and navigate to the Assets UI. The uploaded folder is displayed in the web interface.
Adobe does not recommend copy-pasting or dragging a larger number of files or nested folders, from the local file system, into the network share area. The app cannot control the upload process due to technical limitations and the performance is poor.
Alternatively, select files/folders in Finder or Explorer, copy them, navigate to the target folder in the network share area, and choose Paste Assets from the Experience Manager desktop app context menu. This way, the Experience Manager desktop app starts uploading the pasted assets similar to the Upload Folder option available in the Experience Manager web interface.