Show Menu
主题×

Troubleshoot Adobe Experience Manager desktop app

Adobe Experience Manager(AEM)桌面应用程序连接到远程Experience Manager部署的数字资产管理(DAM)存储库。 应用程序将在您的计算机上获取存储库信息和搜索结果,下载并上传文件和文件夹,并包含管理与AEM资产用户界面冲突的功能。
继续阅读以排除应用程序故障,了解最佳实践并找出限制。

Best practices

遵循以下最佳实践,以防止一些常见问题和疑难解答。
  • 了解桌面应用程序的工作方式 :在开始使用应用程序之前,请花一些时间了解应用程序的工作方式。 了解Experience Manager Web界面与桌面、存储库映射、资产缓存、本地保存和后台上传之间的链接。 了 解工作方式
  • 避免文件夹名称中不支持的字符 :创建或上传文件夹时,请勿使用空格和无效字符。 请参阅Experience Manager资产中创 建文件夹的列表字符 。 某些Adobe Experience Manager用例可能会受到文件夹名称中不支持的字符的影响。
  • 避免冲突的最佳实践 :要避免在协作处理多个资产时出现潜在冲突,请参阅 避免编辑冲突
  • 对大型、分层文件夹使用文件夹上传 :使用Experience Manager桌面应用程序上传大型文件夹,而不是使用资产Web界面或其他方法。 应用程序通过记录和监视在后台上传资产。 请参阅 批量上传资产
  • 使用最新版本 :使用最新的应用程序版本,在安装新的应用程序版本或升级到较新的Adobe Experience Manager版本之前,始终检查兼容性。 See release notes .
  • 使用相同的驱动器号 :使用组织内的同一驱动器号映射到Adobe Experience Manager DAM。 要查看其他用户放置的资产,路径必须相同。 使用相同的驱动器盘符可确保DAM资产的路径一致。 即使不同用户使用不同的驱动器号,资源仍会保留在放置位置且不会被删除。
  • 注意网络 :网络性能对Experience Manager桌面应用程序的性能至关重要。 如果对文件传输或批量操作的响应速度较慢,请关闭可能导致大量网络流量的功能或应用程序。
  • 桌面应用程序不支持的用例 :请勿将应用程序用于资产迁移(它需要规划和其他工具);对于执行繁重的DAM操作(如移动大文件夹、大型上传、使用高级元数据搜索查找文件);作为同步客户端(设计原则和使用模式与同步客户端(如Microsoft OneDrive或Adobe Creative Cloud桌面同步)不同)。
  • 超时 :目前,桌面应用程序没有可配置的超时值,该值在固定时间间隔后会断开Experience Manager服务器与桌面应用程序之间的连接。 上传大型资产时,如果连接在一段时间后超时,应用程序会重试通过增加上传超时来多次上传资产。 不推荐更改默认超时设置。

如何进行疑难解答

要解决桌面应用程序问题,请注意以下信息。 此外,如果您选择寻求支持,它还会帮助您更好地向Adobe客户服务中心传达问题。

启用调试模式

要进行疑难解答,您可以启用调试模式并在日志中获取更多信息。 要在Mac上的调试模式下使用应用程序,请在终端中或在命令提示符下使用以下命令行选项: AEM_DESKTOP_LOG_LEVEL=DEBUG open /Applications/Adobe\ Experience\ Manager\ Desktop.app .
要在Windows上启用调试模式,请执行以下步骤:
  1. 在桌 Adobe Experience Manager Desktop.exe.config 面应用程序安装文件夹中找到文件。 默认情况下,文件夹为 C:\Program Files\Adobe\Adobe Experience Manager Desktop 。 保存并关闭文件。
  2. <level value="INFO"/> 到文件末尾。 将值更 DEBUG 改为,即 <level value="DEBUG"/>
  3. 在桌 logging.json 面应用程序安装文件夹中找到文件。 默认情况下,文件夹为 C:\Program Files\Adobe\Adobe Experience Manager Desktop\javascript\
  4. 在文 logging.json 件中,找到该参数的所有实 level 例。 将值从更改 info debug 。 保存并关闭文件。
  5. 清除在应用程序首选项中设置的位置处缓存的目录。
  6. 重新启动桌面应用程序。

日志文件的位置

您可以在以下位置找到AEM桌面应用程序的日志文件。 在上传许多资产时,如果某些文件无法上传,请参阅 backend.log 文件以识别上传失败的情况。
  • Windows上的路径: %LocalAppData%\Adobe\AssetsCompanion\Logs
  • Mac上的路径: ~/Library/Logs/Adobe\ Experience\ Manager\ Desktop
与Adobe客户关怀团队合作处理支持请求/票证时,可能会要求您共享日志文件,以帮助客户关怀团队了解问题。 存档整个文 Logs 件夹,并与您的客户关怀联系人共享它。

清除缓存

清除AEM桌面应用程序缓存是一个初步的疑难解答任务,可解决多个问题。 从应用程序首选项中清除缓存。 请参阅 设置首选项 。 缓存文件夹的默认位置是:
  • 在 Windows 中: %LocalAppData%\Adobe\AssetsCompanion\Cache\
  • 在Mac上: ~/Library/Group/Containers/group.com.adobe.aem.desktop/cache/
但是,位置可能会因AEM桌面配置的AEM端点而异。 该值是目标URL的编码版本。 例如,如果应用程序是定位的, http://localhost:4502 则目录名称为 http%3A%2F%2Flocalhost%3A4502%2F 。 要清除缓存,请删除相应的文件夹。 清除缓存的另一个原因是当磁盘空间不足时释放磁盘空间。
如果清除AEM桌面缓存,则不同步到AEM服务器的本地资产修改将不可撤消地丢失。

了解AEM桌面应用程序版本

单击 ,打开应用程序菜单,然后单击 Help > About

无法查看已放置的资产

如果看不到您或其他创意专业人士放入支持文件(例如,INDD文件)中的资源,请检查以下各项:
  • 与服务器连接。 不稳定的网络连接可能会阻止资源下载。
  • 文件大小。 下载和显示大型资源需要更长时间。
  • 提高字母一致性。 如果您或其他协作者在将AEM DAM映射到其他驱动器盘符时放置了资产,则不会显示置入的资产。
  • 权限. 要检查您是否有权获取已放置的资产,请与AEM管理员联系。

在macOS上升级时的问题

在macOS上升级AEM桌面应用程序时,偶尔会出现问题。 这是由于AEM桌面应用程序的旧版系统文件夹阻止正确加载新版本的AEM桌面应用程序而导致的。 要解决此问题,可以手动删除以下文件夹和文件。
在执行以下步骤之前,将应用程 Adobe Experience Manager Desktop 序从macOS Applications文件夹拖到垃圾桶。 然后打开终端,执行以下命令,并在出现提示时提供密码。
sudo rm -rf ~/Library/Application\ Support/com.adobe.aem.desktop
sudo rm -rf ~/Library/Preferences/com.adobe.aem.desktop.plist
sudo rm -rf ~/Library/Logs/Adobe\ Experience\ Manager\ Desktop

sudo find /var/folders -type d -name "com.adobe.aem.desktop" | xargs rm -rf
sudo find /var/folders -type d -name "com.adobe.aem.desktop.finderintegration-plugin" | xargs rm -rf

无法上传文件

如果您正在将桌面应用程序与AEM 6.5.1或更高版本结合使用,请将S3或Azure连接器升级到版本1.10.4或更高版本。 它解决了与 OAK-8599相关的文件上传失败问题 。 请参阅 安装说明

SSL配置问题

AEM桌面应用程序用于HTTP通信的库采用严格的SSL强制。 有时,连接可能使用浏览器成功,但使用AEM桌面应用程序失败。 要正确配置SSL,请在Apache中安装缺少的中间证书。 请参 阅如何在Apache中安装Intermediate CA证书

应用程序无响应

应用程序很少会无响应、只显示白屏或在界面底部显示错误,而界面上没有任何选项。 请按顺序尝试以下操作:
  • 右键单击应用程序界面,然后单击 Refresh
  • 退出应用程序,然后再次打开它。
在这两种方法中,应用程序都开始在根DAM文件夹中。