Adobe Asset Link 疑難排解

本文件包含疑難排解資訊,可用於解決使用 Adobe Asset Link 時可能遇到的問題。

關於 Adobe Asset Link 面板

Adobe Asset Link 作為 Adobe Creative Cloud 應用程式 (Photoshop、Illustrator、InDesign 和 XD) 的延伸功能安裝。

安裝和設定後,您可以選擇「 視窗延伸功能 Adobe Asset Link」,來開啟 Adobe Illustrator 和 InDesign 中的 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 管理資產

註解:
  • 如果在瀏覽時看不到資產縮圖,但可以檢視資產預覽,請聯絡管理員以使用最新的 Service Pack 更新 Adobe Experience Manager Managed Services (AMS)。
  • 如果無法存取 Adobe Asset Link 面板,請聯絡管理員,以取得疑難排解步驟的指導。

疑難排解開始之前

如果無法使用 Adobe Asset Link 面板,請在開始疑難排解特定錯誤之前執行這些步驟。

  1. 若要重新整理 Creative Cloud 應用程式中的快取,請在安裝/重新安裝 Adobe Asset Link 前關閉應用程式。

  2. 檢查 Adobe Asset Link 是否安裝於下列位置的檔案夾 com.adobe.assetlink

    • 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 桌面應用程式中的 Business ID、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. 如果您使用具有 Experience Manager 6.5.5 (或更新版本) (以 S3 部署為資料存放區) 的 Adobe Asset Link,請檢查 Platform API 的功能是否正常。

    存取 https://<server>:<port>/platform/content/dam 以檢查是否出現任何連線問題。如果 Platform 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 不支援 M1 裝置上的 Adobe Photoshop。

錯誤案例

以下是在使用 Adobe Asset Link 面板時可能遇到的一些錯誤情況和問題解決步驟。

錯誤

中止補漏:6 錯誤在您使用 Adobe Extension Manager 命令列工具 (ExManCmd) 安裝延伸功能時出現。

原因

Adobe Asset Link 無法在 macOS 上安裝。在 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 面板。

錯誤

使用 Business ID、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 登入,請登出然後再次使用 Business 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 伺服器無法使用時網路連線中斷,則會出現此錯誤。

若要修正錯誤,請確定您已連線到網際網路並執行下列動作:

  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 的值。
註解:

具有 Proxy 環境的客戶遭到封鎖,無法使用 Adobe Asset Link。Adobe Asset Link 尚未支援 Proxy 環境。

如果用戶無權存取 Experience Manager,或其帳戶未新增至 Experience Manager 或與 Experience Manager 中的 IMS 群組不符:

  1. 以管理員身分登入 Admin Console.

  2. 瀏覽至「用戶」頁面並搜尋用戶帳戶。

    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 > extensions 檔案夾在電腦上的以下位置出現。如果檔案夾不存在,請建立該檔案夾。
    • Windows:C:\Users\<username>\AppData\Roaming\Adobe\CEP\extensions
    • macOS:/Users/<username>/Library/Application Support/Adobe/CEP/extensions

錯誤

您正在嘗試連線的 Experience Manager Assets 伺服器未回應。如需詳細資訊,請聯絡 Adobe Experience Manager 管理員。

原因

無法連線到 Experience Manager 伺服器時,則會出現此錯誤。

若要修正此錯誤,請聯絡您的 IT 管理員,查看 Experience Manager 伺服器是否已啟動並執行。

錯誤

無網際網路連線。

原因

未連線到網際網路時,則會出現此錯誤。

若要修正錯誤,確定您的電腦已連線到網際網路。

在 InDesign 2020 或更新版本中,如果從 Adobe Asset Link 快顯選單使用「放置連結」選項,則會遇到以下錯誤。 驗證 InDesign 用戶端 ID InDesignAem2 是否在 Experience Manager 伺服器內核准的清單中新增。

如需如何將用戶端 ID 新增至核准清單的資訊,請參閱「使用設定套件設定 Experience Manager」。

註解:

如果您有一個雲端服務型 Experience Manager Assets 執行個體,則無需進行此動作。它僅適用於 AMS 和 Experience Manager Assets 的內部部署執行個體。

如果 Experience Manager Assets 和 Adobe Asset Link 中的資產搜尋傳回不同的結果,請嘗試進行視覺相似性搜尋,以找出一致的結果。

啟用用戶端記錄

由於您需要使用用戶端和伺服器記錄診斷連線問題,因此啟用用戶端記錄有助於偵錯連線問題。

在 Creative Cloud 應用程式 (Photoshop、InDesign 和 Illustrator) 中,為 Adobe Asset Link 延伸功能啟用 DEBUG 或 TRACE 層級的用戶端記錄。僅需件立單行文字檔 assetlink-override.json

檔案只包含下列 DEBUG 層級記錄的程式碼行:

     {"LOG_LEVEL":"DEBUG"}

若要啟用 TRACE 層級記錄,請將值變更成,如下所示:

6     {"LOG_LEVEL":"TRACE"}

請將檔案放置於與 assetlink-settings.json 檔案相同的位置。

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

在此情況下,username 是您電腦上的登入 ID。

重新啟動您的 Creative Cloud 應用程式 (Photoshop、InDesign、Illustrator)。Adobe Asset Link 重新開啟時,記錄檔便會以合適的記錄層級在暫存目錄中建立。 

視作業系統而定,暫存目錄位於以下位置:

  • macOS:/tmp
  • Windows:%TEMP% (which usually resolves to 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 層級記錄,請將值變更成,如下所示:

6     {"LOG_LEVEL":"TRACE"}

請將檔案放置於與 storage.json 檔案相同的位置。

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

在此情況下,username 是您電腦上的登入 ID。

重新啟動 Adobe XD。Adobe Asset Link 重新開啟時,記錄檔便會以合適的記錄層級在以下位置中建立:

  • macOS: ~/Library/Application/Support/Adobe/UXP/PluginsStorage/SPRK/External/61d229b9/PluginData/logs
  • Windows:C:\Users\<user>\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 或更新版本。

在 Photoshop、InDesign 和 Illustrator 等 Creative Cloud 應用程式中,針對 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、InDesign、Illustrator)。當 Adobe Asset Link 重新開啟時,便會在適當記錄層級的暫存目錄中建立記錄檔。

視作業系統而定,您可於下列位置找到暫存目錄。

  • MacOS: /tmp
  • Windows: %TEMP% (一般會解析至 C:\Users\使用者名稱\AppData\Local\Temp)

記錄檔的名稱是 adobe-assetlink-APPN-99.9.9.log

APPN 是下列任一名稱: PHXS、IDSN 或 ILST,而 99 位數則是 CC 應用程式的版本編號。以下是 Photoshop 的檔案名稱範例。

     adobe-assetlink-PHXS-19.1.2.log

記錄檔的大小只有幾 KB。

用戶端記錄可協助對連線問題偵錯,因為診斷連線問題需要用戶端和伺服器端記錄。

Adobe 標誌

登入您的帳戶