Adobe Asset Link 故障排除

Enterprise

Enterprise

Admin Console

本文档包含故障排除信息，用于解决在使用 Adobe Asset Link 时可能遇到的各种问题。

关于 Adobe Asset Link 面板

Adobe Asset Link 作为扩展安装在 Photoshop、Illustrator、InDesign 和 XD 等 Adobe Creative Cloud 应用程序中。

安装并配置后，即可在 Adobe Illustrator 和 InDesign 中通过选择“窗口”>“扩展”>“Adobe Asset Link”而打开 Adobe Asset Link 面板。

要打开 Photoshop 中的 Adobe Asset Link 面板，请选择窗口 > 扩展（旧版） > Adobe Asset Link。

要打开 Adobe XD 中的 Adobe Asset Link 面板，请选择插件 > Adobe Asset Link。

使用 Adobe Asset Link 访问、使用和编辑存储在 Adobe Experience Manager Assets 中的数字资源。可在 Experience Manager Assets 中上传新资源。详细了解使用 Adobe Asset Link 管理资源。

注意:
  • 如果在浏览时看不到资源缩略图，但可查看资源预览，请与管理员联系，用最新的服务包更新 Adobe Experience Manager Managed Services (AMS)。
  • 如果您无法访问 Adobe Asset Link 面板，请与管理员联系以获取有关故障排除步骤的指导。

开始故障排除之前

如果无法使用 Adobe Asset Link 面板，请在开始对特定错误进行故障排除之前执行以下步骤。

  1. 要刷新 Creative Cloud 应用程序中的缓存，请在安装/重新安装 Adobe Asset Link 之前关闭这些应用程序。

  2. 在以下位置中检查 com.adobe.assetlink 文件夹中是否安装了 Adobe Asset Link：

    • macOS：/Library/Application Support/Adobe/CEP/extensions。
    • Windows：C:\Program Files (x86)\Common Files\Adobe\CEP\extensions。

    如果遇到问题，请尝试删除 Adobe Asset Link 的现有版本，然后再重新安装或安装新版本。要删除现有版本，请删除 com.adobe.assetlink 文件夹。然后，安装 Adobe Asset Link 的最新版本。

  3. 验证以下位置中是否存在 assetlink-settings.json 文件：

    • macOS：/Users/<username>/Library/Application Support/Adobe/CEP/extensions
    • Windows：C:\Users\<username>\AppData\Roaming\Adobe\CEP\extensions

  4. 确保在 Creative Cloud 桌面应用程序中已使用 Enterprise ID 或 Federated ID 登录。

  5. 确保已在 Creative Cloud 桌面应用程序中启用文件同步。

  6. 使用活动监视器（适用于 macOS）或任务管理器（适用于 Windows）确保名为 CoreSync 的进程正在运行。

  7. 如果您是管理员，请确保：

    • 所有 IMS 配置均已正确完成。
    • 在 Adobe Admin Console 中，将用户的 Business、Enterprise 或 Federated ID 添加到在 Experience Manager 服务器中配置的用户组。
    • 在 Experience Manager 服务器中配置的 IMS 用户组是 Experience Manager 中 dam-users 组的一部分。

  8. 如果将 Adobe Asset Link 与以 S3 作为数据存储而部署的 Experience Manager 6.5.5（或更高版本）共用，请检查 Platform API 是否正常运行。

    访问 https://<服务器>:<端口>/platform/content/dam 以检查是否有任何连接问题。如果平台 API 正常运行，则响应为顶级 DAM 对象的 JSON 表示形式。任何 Platform API 故障都会生成响应代码为 500 的错误，并且 Adobe Asset Link 无法与 Experience Manager 连接。要解决该错误，请将 S3 数据存储连接器升级到 1.10.12 版或更高版本。

  9. 为了使 Adobe Asset Link 与 Apple M1 设备上的 Adobe Illustrator、InDesign 和 XD 兼容，请将 Adobe Asset Link 和 Adobe Asset Link for XD 升级到最新版本。Adobe Asset Link 在 Rosetta 仿真模式下支持 M1 设备上的 Adobe Photoshop。要了解如何在 Rosetta 中运行 Photoshop，请参阅 Photoshop for Apple Silicon。

错误情景

以下是使用 Adobe Asset Link 面板时可能会遇到的一些错误情况，以及解决这些错误的步骤。

错误

在使用 Adobe Extension Manager 命令行工具 (ExManCmd) 安装扩展时出现 Abort trap: 6 错误。

原因

在 macOS 上安装 Adobe Asset Link 失败。在 Windows 上安装失败，并且不显示任何错误。

要解决该问题，请执行以下操作。

  1. 退出 Creative Cloud 桌面应用程序。

  2. 从以下位置删除 ExMan.db：

    macOS：/Library/Application Support/Adobe/Extension Manager CC/Configuration/DB。

    Windows：C:\ProgramData\Adobe\Extension Manager CC\Configuration\DB。

  3. 重新启动 Creative Cloud 桌面应用程序，并使用在步骤 1 中使用的相同凭据登录。

  4. 重新安装包含 Adobe Asset Link 扩展的包。此时会安装 Adobe Asset Link 面板。

错误

使用 Enterprise ID 或 Federated ID 登录到 Creative Cloud 帐户以访问此服务。如果您没有 Creative Cloud 企业帐户，请与您的 IT 管理员联系。

原因

当您从 Adobe Creative Cloud 注销或 Adobe Asset Link 面板无法访问您的身份时，出现此错误。

要解决此错误，请执行以下操作：

  1. 确保已登录到 Creative Cloud 应用程序。

  2. 退出并重新启动您正在使用的 Creative Cloud 应用程序。

  3. 检查是否可以打开 Adobe 网站。

错误

Adobe Asset Link 仅支持 Business、Enterprise 或 Federated 用户。如果您使用 Adobe ID 登录，请注销并使用 Enterprise ID 或 Federated ID 再次登录。有关 Adobe 支持的身份类型的信息，请参阅管理身份类型。

原因

如果尝试用 Adobe ID 登录并访问 Adobe Asset Link，则出现此错误。如果您没有 Creative Cloud 企业版帐户，请与您的 IT 管理员联系。

错误

如果您无权访问此服务，请与您的 IT 管理员联系以获准访问。

原因

如果您没有访问 Experience Manager 服务器所需的权限，则出现此错误。

要解决此错误，如果 Experience Manager 服务器正常运行，请与您的 IT 管理员联系。

错误

无法访问您尝试访问的 Experience Manager Assets 服务器。请与您的 Adobe Experience Manager 管理员联系以获取进一步的详细信息。

原因

如果在连接到 Experience Manager 服务器时网络连接中断或 Experience Manager 服务器不可用，则出现此错误。

要解决此错误，请确保您已连接到 Internet 并执行以下操作：

  1. 检查 Experience Manager 服务器是否已启动并正在运行。

  2. 退出并重新启动您正在使用的 Creative Cloud 应用程序。

  3. 启动 Adobe Asset Link 面板。

错误

您的 Creative Cloud 企业版帐户可能无权访问此 Experience Manager Assets 服务器。请与您的 Adobe Experience Manager 管理员联系以获得帮助。

原因

如果您的 Creative Cloud 企业版帐户无权访问 Experience Manager Assets 服务器，则出现此错误。

如果您的本地 assetlink-settings.json 文件内的一个或多个设置不正确，则还可能会发生授权错误（有关详细信息，请参阅文档）。请与您的 Experience Manager 管理员联系以获得帮助。具体而言，在以下情况下会发生此错误：

  • 未授权用户访问 Experience Manager 服务器。
  • 用户帐户未添加到在 Experience Manager 中配置的 IMS 组。
  • 添加到用户帐户的 IMS 组与 Experience Manager IMS 组不匹配。
  • assetlink-settings.json 文件包含错误的 aemPort。
  • assetlink-settings.json 文件中缺少 aemServer 的值。
注意:

具有代理环境的客户被禁止使用 Adobe Asset Link。Adobe Asset Link 尚不支持代理环境。

如果未授权用户访问 Experience Manager、其帐户未添加到 Experience Manager 或与其中的 IMS 组不匹配，请执行以下操作：

  1. 在 Admin Console 的用户页面上，搜索用户帐户。

    1. 从用户列表中，单击相关用户的名称。

    2. 在“用户组”下，确认关联的 IMS 组是否与 Experience Manager 匹配。

      可在“aem-instance/system/console/configMgr”>“Adobe Granite OAuth IMS Provider”>“组映射”下检查 Experience Manager 组映射。

      注意:

      对于 Experience Manager 6.4 和更高版本，如果未定义组映射，请确保 IMS 用户组是 Experience Manager 中 dam-users 组的一部分。

    3. 如果用户未与 Experience Manager 中的 IMS 组关联，请编辑用户组并分配为 Experience Manager 配置的用户组。

      有关更多信息，请参阅创建用户组。

请参阅配置 assetlink-settings.json 文件并添加到所有设备，以确保 assetlink-settings.json文件中的 aemPort 和 aemServer 的值正确。如果仍然出现错误，请与您的 IT 管理员联系以验证以下各项：

  • 您有正确的权限可访问 Experience Manager 服务器。
  • 您被添加到在 Experience Manager 中配置的 IMS 组。

作为新用户，如果您在启动 Adobe Asset Link 时看到“添加新环境”视图（而非“主页”视图），请执行以下操作之一：

  • 更新到 Adobe Asset Link 的最新版本。
  • 确保 CEP > 扩展 文件夹位于计算机上的以下位置，具体取决于操作系统。如果该文件夹尚不存在，请创建它。
    • Windows：C:\Users\<用户名>\AppData\Roaming\Adobe\CEP\extensions
    • macOS：/Users/<用户名>/Library/Application Support/Adobe/CEP/extensions

错误

您尝试访问的 Experience Manager Assets 服务器无响应。请与您的 Adobe Experience Manager 管理员联系以获取进一步的详细信息。

原因

当您无法连接到 Experience Manager 服务器时，出现此错误。

要解决此错误，请与您的 IT 管理员联系以检查 Experience Manager 服务器是否已启动并正在运行。

错误

无 Internet 连接。

原因

当您未连接到 Internet 时，出现此错误。

要解决此错误，请确保计算机已连接到 Internet。

在 InDesign 2020 或更高版本内使用 Adobe Asset Link 上下文菜单中的“放置链接资源”选项时，可能会遇到以下错误。直接在 Experience Manager 服务器中确认 InDesign Client ID InDesignAem2 被添加到已批准的列表。

有关如何将客户端 ID 添加到批准列表的信息，请参见使用配置程序包配置 Experience Manager。

注意:

如果您拥有 Experience Manager Assets as a Cloud Service 实例，则无需此项。它仅适用于 AMS 和本地 Experience Manager Assets 实例。

对 Experience Manager 上的链接资源所做的更改有时对 InDesign 中的用户不可见，除非他们删除本地 InDesign 缓存。该问题可能是由于对链接资源的元数据的权限不足。

要解决此问题，请确保用户在 CRxDe 的 /content/dam/dam:batch 节点中具有“修改”访问权限。

如果在 Experience Manager Assets 和 Adobe Asset Link 中搜索资源所返回的结果不同，请尝试执行视觉相似性搜索以产生一致的结果。

要解决此问题，请执行以下步骤：

  1. 以管理员身份登录到 AEM 作者实例中，然后删除签入有问题的 AEM 用户。

    删除此用户的所有其他条目（如果有）。

  2. 用户需要使用其凭据再次登录到 AEM 作者实例，然后尝试在 Adobe Asset Link 中签入资源。这样将从 IMS 更新最新用户信息。

启用客户端日志

启用客户端日志有助于调试连接问题，因为您需要客户端和服务器日志才能诊断连接错误。

在 Creative Cloud 应用程序（Photoshop、InDesign 和 Illustrator）中为 Adobe Asset Link 扩展启用 DEBUG 或 TRACE 级别的客户端日志记录很容易。只需创建一个单行文本文件 assetlink-override.json 即可。

该文件仅包含 DEBUG 级别日志记录的以下代码行：

     {"LOG_LEVEL":"DEBUG"}

要启用 TRACE 级别日志记录，请将值更改为 trace，如下所示：

     {"LOG_LEVEL":"TRACE"}

将该文件放在 assetlink-settings.json 文件所在的相同位置。

  • macOS：/Users/<用户名>/Library/Application Support/Adobe/CEP/extensions
  • Windows：C:\Users\<用户名>\AppData\Roaming\Adobe\CEP\extensions

在本例中，用户名 是您计算机上的登录 ID。

重新启动 Creative Cloud 应用程序（Photoshop、Illustrator 或 InDesign）。重新打开 Adobe Asset Link 时，它将按照适当的日志记录级别在临时目录中创建日志文件。

临时目录位于以下位置，具体取决于操作系统：

  • macOS：/tmp
  • Windows：%TEMP%（通常解析为 C:\Users\username\AppData\Local\Temp）

日志文件的名称是 adobe-assetlink-APPN-99.9.9.log。

APPN 是 PHXS、IDSN 或 ILST 这些名称之一。数字 99 是 Creative Cloud 应用程序的版本号。以下是 Photoshop 的示例文件名。

     adobe-assetlink-PHXS-19.1.2.log

该日志文件只有几 KB 大小。

客户端日志有助于调试连接问题，因为诊断连接错误需要客户端和服务器日志。

要在 Adobe XD 中为 Adobe Asset Link 启用 DEBUG 或 TRACE 级别的客户端日志记录，请创建一个单行文本文件 assetlink-override.json。

该文件仅包含 DEBUG 级别日志记录的以下代码行：

     {"LOG_LEVEL":"DEBUG"}

要启用 TRACE 级别日志记录，请将值更改为 trace，如下所示：

     {"LOG_LEVEL":"TRACE"}

将该文件与您的 storage.json 文件放在相同位置。

  • macOS：~/Library/Application/Support/Adobe/UXP/PluginsStorage/SPRK/External/61d229b9/PluginData
  • Windows：C:\Users\<用户名>\AppData\Roaming\Adobe\UXP\PluginsStorage\SPRK\External\61d229b9\PluginData

在本例中，用户名 是您计算机上的登录 ID。

重新启动 Adobe XD。当 Adobe Asset Link 重新打开时，它在以下位置创建一个具有适当的日志记录级别的日志文件：

  • macOS：~/Library/Application/Support/Adobe/UXP/PluginsStorage/SPRK/External/61d229b9/PluginData/logs
  • Windows：C:\Users\<用户>\AppData\Roaming\Adobe\UXP\PluginsStorage\SPRK\External\61d229b9\PluginData\logs

该日志文件的名称为 adobe-assetlink-XD-4X.X.XX.XX.xxx.log。

该日志文件只有几 KB 大小。

注意:

X 的值因所使用的 Adobe XD 版本而异。但是，您必须使用 Adobe XD 41.0 或更高版本。

使用 assetlink-settings.json 手动配置端点

对于新用户，可在创建用户帐户之前预配计算机。根据操作系统的不同，将 assetlink-settings.json 文件复制到以下位置之一：

  • macOS：/Library/Application Support/Adobe/CEP/extensions
  • Windows：\Program Files (x86)\Common Files\Adobe\CEP\extensions

新用户启动 Adobe Asset Link 时，后者在系统位置扫描设置文件。然后，根据操作系统的不同，它将该文件复制到以下用户区域之一：

  • macOS：../Library/Application Support/Adobe/CEP/extensions
  • Windows：..\AppData\Adobe\CEP\extensions (Windows)

确保用户对 assetlink-settings.json 文件所在的文件夹具有读取权限。另请确保部署计算机上的未来用户具有对该文件夹的读取访问权限。

注意:

如果设备上没有文件夹路径，请手动创建 CEP > extensions 文件夹。

  1. 下载示例 assetlink-settings.json 文件，并在文本编辑器中打开它。

  2. 修改该文件以包括一个或多个 Experience Manager Assets 端点。

    {"aemServer":"SERVERNAME","aemPort":"SERVERPORT","aemScheme":"PROTOCOL"}

    参数

    描述

    SERVERNAME

    Experience Manager 服务器的名称或 URL

    SERVERPORT

    Experience Manager 服务器的端口号

    PROTOCOL

    Experience Manager 服务器 URL 的协议方案。使用 HTTP 或 HTTPS。

    例如，如果 Experience Manager 服务器 URL 为：http://content.demo.com:4502，则该 .json 文件应包括以下代码：

    • {"aemServer":"content.demo.com","aemPort":"4502","aemScheme":"http"}

    .json 文件的更多示例如下：

    • {"aemServer":"author.customer.com","aemPort":"443","aemScheme":"https"}
    • {"aemServer":"localhost","aemPort":"4502","aemScheme":"http"}
    • {"aemServer":"author-nossl.customer.com","aemPort":"80","aemScheme":"http"}

使用 json 文件在 Adobe Asset Link for XD 中添加 Experience Manager 环境

要在 Adobe Asset Link for XD 中添加 Experience Manager 环境，请使用特定环境的 URL 更新 assetlink-settings.json 文件。

将 assetlink-settings.json 文件配置为指向新的 Experience Manager 实例。启动 Adobe XD，然后从以下位置打开 storage.json 文件：

  • macOS：Users/<用户名>/Library/Application/Support/Adobe/UXP/PluginsStorage/SPRK/External/61d229b9/PluginData
  • Windows：C:\Users\<用户名>\AppData\Roaming\Adobe\UXP\PluginsStorage\SPRK\External\61d229b9\PluginData

该文件包含条目

               {"aemEnvironments": [{  "root": url, "title": title }],

                "activeAemEnvironmentRoot": url,

                "viewMode": "grid}

将“url”替换为您的 Experience Manager Assets 实例的 URL。将 URL 括在引号中。保存并关闭该文件。退出并重新启动 Adobe XD 以使其连接到 Experience Manager Assets。

注意:

如果 assetlink-settings.json 文件不同，Adobe Asset Link for XD 将重定向到发现服务工作流程。

在 Photoshop、InDesign 和 Illustrator 等 Creative Cloud 应用程序中，可轻松为 Adobe Asset Link 扩展（面板）启用 DEBUG 或 TRACE 级别的客户端日志记录。简单来说，就是创建一个单行文本文件 assetlink-override.json。

这个文件包含以下行（用于 DEBUG 级别日志记录）：

     {  "LOG_LEVEL":"debug" }.

对于 TRACE 级别日志记录，按以下所示更改相应的值以便进行跟踪：

     {  "LOG_LEVEL":"trace" }.

将该文件放置在与 assetlink-settings.json 文件相同的位置。 

  • MacOS：/用户/用户名/资源库/Application Support/Adobe/CEP/extensions
  • Windows：C:\用户\用户名\AppData\Roaming\Adobe\CEP\extensions

这里的用户名是您在计算机上的用户登录 ID。

重新启动 Creative Cloud 应用程序（Photoshop、InDesign、Illustrator）。在 Adobe Asset Link 重新打开之后，它将在临时目录中创建相应记录级别的日志文件。

临时目录位于以下位置，具体取决于操作系统。

  • MacOS：/tmp
  • Windows：%TEMP%（这通常解析为 C:\用户\用户名\AppData\Local\Temp)

日志文件的名称是 adobe-assetlink-APPN-99.9.9.log.

APPN 是“PHXS”、“IDSN”或“ILST”之一，99 等数字是 CC 应用程序的版本编号。以下是 Photoshop 的文件名示例。

     adobe-assetlink-PHXS-19.1.2.log

日志文件只有几千字节大小。

客户端日志有助于调试连接问题，因为在诊断连接错误时，既需要服务器日志，也需要客户端日志。

更多此类内容

更快、更轻松地获得帮助

新用户？

快速链接

查看您的所有计划 管理您的计划
查看快速链接
隐藏快速链接

法律声明    |    在线隐私政策

Copyright © 2024 Adobe。保留所有权利。