对Adobe Experience Manager桌面应用程序进行疑难解答

Adobe Experience Manager桌面应用程序连接到远程Experience Manager部署的数字资产管理(DAM)存储库。 应用程序可在您的计算机上获取存储库信息和搜索结果、下载和上传文件和文件夹,并包含管理与资产用户界面冲突的功能。

阅读应用程序疑难解答、了解最佳实践并找出限制。

最佳实践

遵循以下最佳实践,防止一些常见问题和疑难解答。

  • 了解桌面应用程序的工作方式:开始使用应用程序之前,请花些时间了解应用程序的工作方式。了解Experience ManagerWeb界面与桌面之间的链接、存储库映射、资产缓存、本地保存以及后台上传。 请参见其工作方式

  • 避免文件夹名称中不支持的字符:创建或上传文件夹时,请勿使用空格和无效字符。请参阅在Experience Manager资产中创建文件夹中的列表字符。 某些Adobe Experience Manager用例可能受文件夹名称中不支持的字符影响。

  • 避免冲突的最佳实践:要避免在协作处理多个资产时发生潜在冲突,请参阅 避免编辑冲突

  • 将文件夹上传用于大型分层文件夹:使用Experience Manager桌面应用程序上传大型文件夹,而不是使用资产Web界面或其他方法。应用程序通过记录和监视在后台上传资产。 请参阅批量上传资产

  • 使用最新版本:使用最新的应用程序版本,在安装新的应用程序版本或升级到较新的Adobe Experience Manager版本之前,始终检查兼容性。请参阅发行说明

  • 使用相同的驱动器号:在整个组织中使用相同的驱动器号映射到Adobe Experience ManagerDAM。要查看其他用户放置的资产,路径必须相同。 使用相同的驱动器号可确保DAM资产的路径不变。 即使不同用户使用不同的驱动器盘符,资源仍会保持放置状态并且不会被删除。

  • 注意网络:网络性能对Experience Manager桌面应用程序的性能至关重要。如果对文件传输或批量操作的响应速度较慢,请关闭可能导致大量网络流量的功能或应用程序。

  • 桌面应用程序不支持的用例:请勿将应用程序用于资产迁移(它需要规划和其他工具);执行繁重的DAM操作(如移动大文件夹、大型上传、使用高级元数据搜索查找文件);同步客户端(设计原则和使用模式与同步客户端(如Microsoft OneDrive或Adobe Creative Cloud桌面同步)不同。

  • 超时:当前,桌面应用程序没有可配置的超时值,该值在固定时间间隔后会断开Experience Manager服务器与桌面应用程序之间的连接。上传大型资产时,如果连接在一段时间后超时,应用程序会重试通过增加上传超时来上传资产几次。 不推荐更改默认超时设置。

如何对进行疑难解答

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

日志文件的位置

Experience Manager 桌面应用程序根据操作系统将其日志文件存储在以下位置:

在 Windows 中:%LocalAppData%\Adobe\AssetsCompanion\Logs

在Mac上:~/Library/Logs/Adobe\ Experience\ Manager\ Desktop

上传多个资产时,如果某些文件无法上传,请参阅backend.log文件以标识上传失败的内容。

注意

在与Adobe客户关怀团队协作处理支持请求或票证时,可要求您共享日志文件,以帮助客户关怀团队了解问题。 将整个Logs文件夹存档,并与客户关怀联系人共享。

更改日志文件中的详细信息级别

要更改日志文件中的详细信息级别:

  1. 确保应用程序未运行。

  2. 在Windows系统上:

    1. 打开命令窗口。

    2. 通过运行命令启动Adobe Experience Manager桌面应用程序:

    set AEM_DESKTOP_LOG_LEVEL=DEBUG&"C:\Program Files\Adobe\Adobe Experience Manager Desktop.exe
    

    在Mac系统上:

    1. 打开终端窗口。

    2. 通过运行命令启动Adobe Experience Manager桌面应用程序:

    AEM_DESKTOP_LOG_LEVEL=DEBUG open /Applications/Adobe\ Experience\ Manager\ Desktop.app
    

有效日志级别为DEBUG、INFO、WARN或ERROR。 在DEBUG中日志的详细程度最高,在ERROR中最低。

启用调试模式

要进行疑难解答,您可以启用调试模式并在日志中获取更多信息。

注意

有效日志级别为DEBUG、INFO、WARN或ERROR。 在DEBUG中日志的详细程度最高,在ERROR中最低。

要在Mac上的调试模式下使用应用程序,请执行以下操作:

  1. 打开终端窗口或命令提示符。

  2. 运行以下命令启动Experience Manager桌面应用程序:

    AEM_DESKTOP_LOG_LEVEL=DEBUG open /Applications/Adobe\ Experience\ Manager\ Desktop.app

要在Windows上启用调试模式:

  1. 打开命令窗口。

  2. 运行以下命令启动Experience Manager桌面应用程序:

AEM_DESKTOP_LOG_LEVEL=DEBUG&"C:\Program Files\Adobe\Adobe Experience Manager Desktop.exe

清除缓存

执行以下步骤:

  1. 开始应用程序并连接Experience Manager实例。

  2. 单击右上角的省略号并选择Preferences,打开应用程序的首选项。

  3. 找到显示Current Cache Size的条目。 单击此元素旁边的垃圾桶图标。

要手动清除缓存,请继续执行以下步骤。

注意

这可能是破坏性操作。 如果有未上载到Adobe Experience Manager的本地文件更改,则继续操作将丢失这些更改。

通过删除应用程序的缓存目录清除缓存,该目录位于应用程序的首选项中。

  1. 开始应用程序。

  2. 选择右上角的省略号并选择Preferences,打开应用程序的首选项。

  3. 请注意Cache Directory值。

    在此目录中,有以编码Adobe Experience Manager端点命名的子目录。 名称是目标Adobe Experience Manager URL的编码版本。 例如,如果应用程序的目标为localhost:4502,则目录名称将为localhost_4502

要清除缓存,请删除所需的已编码Adobe Experience Manager端点目录。 或者,删除首选项中指定的整个目录将清除应用程序已使用的所有实例的缓存。

清除Adobe Experience Manager桌面应用程序的缓存是可解决多个问题的初步故障诊断任务。 从应用程序首选项中清除缓存。 请参阅设置首选项。 缓存文件夹的默认位置为:

了解Adobe Experience Manager桌面应用程序版本

要查看版本号:

  1. 开始应用程序。

  2. 单击右上角的省略号,将指针悬停在Help上,然后单击About。

    版本号列在此屏幕上。

无法查看已放置的资源

如果您或其他创意专业人士无法在支持文件(例如INDD文件)中看到放置的资源,请检查以下各项:

  • 与服务器连接。 不稳定的网络连接可能会阻止资源下载。

  • 文件大小。 下载和显示大型资源需要更长的时间。

  • 驱动器盘符一致性。 如果您或其他协作者在将Experience ManagerDAM映射到其他驱动器号时放置了资源,则放置的资源不会显示。

  • 权限. 要检查您是否有权获取已放置的资产,请与Experience Manager管理员联系。

对桌面应用程序用户界面上的文件所做的编辑不会立即反映在Adobe Experience Manager中

Adobe Experience Manager 桌面应用程序将由用户决定何时完成对文件的所有编辑。根据文件的大小和复杂性,将新版本的文件传输回Adobe Experience Manager需要大量时间。 应用程序的设计要求最大限度地减少文件来回传输的次数,而不是猜测文件编辑何时完成并自动上传。 建议用户选择上传文件的更改,以启动将文件传回Adobe Experience Manager。

在macOS上升级时的问题

在macOS上升级Experience Manager桌面应用程序时,偶尔会发生问题。 这是由于Experience Manager桌面应用程序的旧系统文件夹阻止正确加载新版本的Experience Manager桌面应用程序而导致的。 要解决此问题,可以手动删除以下文件夹和文件。

在执行以下步骤之前,将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

无法上载文件

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

Experience Manager 桌面应用程序连接问题

如果您遇到一般连接问题,请通过以下方式获取有关Experience Manager桌面应用程序正在执行的操作的更多信息。

检查请求日志

Experience Manager 桌面应用程序将其发送的所有请求以及每个请求的响应代码记录在专用日志文件中。

  1. 打开应用程序日志目录中的request.log以查看这些请求。

  2. 日志中的每一行表示请求或响应。 请求将具有>字符,后跟请求的URL。 响应将具有<字符,后跟响应代码和请求的URL。 可以使用每行的GUID匹配请求和响应。

检查应用程序的嵌入式浏览器加载的请求

大多数应用程序请求都位于请求日志中。 但是,如果那里没有有用的信息,那么查看应用程序的嵌入式浏览器发送的请求可能会很有用。
有关如何视图这些请求的说明,请参阅SAML部分

SAML登录身份验证无法运行

如果Experience Manager桌面应用程序未连接到启用SSO(SAML) Adobe Experience Manager实例,请阅读本节以进行疑难解答。 SSO过程多种多样,有时也很复杂,应用程序的设计尽其所能来适应这些类型的连接。 但是,某些设置需要额外的疑难解答。

有时SAML进程不会重定向回最初请求的路径,或最终重定向到与Adobe Experience Manager桌面应用程序中配置的主机不同的主机。 要验证情况并非如此:

  1. 打开Web浏览器。 访问https://[aem_server]:[port]/content/dam.json URL。

  2. 登录Adobe Experience Manager部署。

  3. 登录完成后,在地址栏中查看浏览器的当前地址。 它应与最初输入的URL完全匹配。

  4. 另外,验证/content/dam.json之前的所有项是否与Adobe Experience Manager桌面应用程序设置中配置的目标Adobe Experience Manager值相匹配。

根据上述步骤,登录SAML进程可以正常工作,但用户仍无法登录

Adobe Experience Manager桌面应用程序中显示登录过程的窗口只是显示目标Adobe Experience Manager实例的Web用户界面的Web浏览器:

  • Mac版本使用WebView

  • Windows版本使用基于Chromium的CefSharp

确保SAML进程支持这些浏览器。

要进一步进行疑难解答,可以视图浏览器正尝试加载的确切URL。 要查看此信息:

  1. 按照调试模式中启动应用程序的指示操作。

  2. 重现登录尝试。

  3. 导航到应用程序的日志目录

  4. 对于Windows:

    1. 打开“aemcompanionlog.txt”。

    2. 搜索以“登录浏览器地址已更改为”开头的消息。 这些条目还包含应用程序加载的URL。

    对于Mac:

    1. com.adobe.aem.desktop-nnnnnnnn-nnnnnn.log,其中, ​nare替换为最新文件名中的任何数字。

    2. 搜索以“已加载帧”开头的消息。 这些条目还包含应用程序加载的URL。

查看正在加载的URL序列有助于在SAML结尾进行疑难解答,以确定错误。

SSL配置问题

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

Experience Manager桌面用于HTTP通信的库采用严格的SSL强制。 因此,在某些情况下,通过浏览器成功的SSL连接在Adobe Experience Manager桌面应用程序中失败。 这很好,因为它鼓励正确配置SSL并提高安全性,但当应用程序无法连接时,这可能会令人沮丧。

在这种情况下,建议使用一种工具来分析服务器的SSL证书并识别问题,以便更正它们。 有一些网站在提供服务器的URL时检查服务器的证书。

作为临时措施,可以在Adobe Experience Manager桌面应用程序中禁用严格的SSL强制。 这不是推荐的长期解决方案,因为它通过隐藏配置不正确的SSL的根本原因来降低安全性。 禁用严格强制:

  1. 使用您选择的编辑器编辑应用程序的JavaScript配置文件,该文件(默认情况下)位于以下位置(取决于操作系统):

    在Mac上:/Applications/Adobe Experience Manager Desktop.app/Contents/Resources/javascript/lib-smb/config.json

    在 Windows 中:C:\Program Files (x86)\Adobe\Adobe Experience Manager Desktop\javascript\config.json

  2. 在文件中找到以下部分:

    ...
    "assetRepository": {
        "options": {
    ...
    
  3. 通过添加"strictSSL": false修改该部分,如下所示:

    ...
    "assetRepository": {
        "options": {
            "strictSSL": false,
    ...
    
  4. 保存文件并重新启动Adobe Experience Manager桌面应用程序。

应用程序无响应

应用程序很少会变得无响应、只显示白屏或在界面底部显示错误,而界面上没有任何选项。 按顺序尝试以下各项:

  • 右键单击应用程序接口,然后单击​Refresh
  • 退出应用程序并再次打开它。

在这两种方法中,应用程序开始在根DAM文件夹。

在此页面上