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 桌面應用程式中的 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 和適用於 XD 的 Adobe Asset Link 升級到最新版本。Adobe Asset Link 在 Rosetta 模擬模式下支援 M1 裝置上的 Adobe Photoshop。若要了解如何在 Rosetta 中執行 Photoshop,請參閱適用於 Apple Silicon 的 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 面板。

錯誤

使用 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 伺服器無法使用時網路連線中斷,則會出現此錯誤。

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

  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使用者頁面,搜尋使用者帳戶。

    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 的內部部署執行個體。

InDesign 中的使用者有時會看不見 Experience Manager 上連結資產所做的變更,除非他們刪除本機 InDesign 快取。該問題可能是由於對連結資產中繼資料的權限不足。

若要解決此問題,請確使用者在 CRxDe 的 /content/dam/dam:batch 節點中具有「修改」存取權。

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

若要解決此問題,請依照以下步驟進行:

  1. 以管理員身分登入 AEM Author 執行個體,並刪除有簽入問題的 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 層級記錄,請將值變更成,如下所示:

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 或更新版本。

使用 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 > 擴充功能檔案夾。

  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 檔案在適用於 XD 的 Adobe Asset Link 中新增 Experience Manager 環境

若要在適用於 XD 的 Adobe Asset Link 中新增 Experience Manager 環境,請使用特定環境的 URL 更新 assetlink-settings.json

設定 assetlink-settings.json檔案以指向新的 Experience Manager 執行個體。啟動 Adobe XD,然後從以下位置開啟 storage.json 檔案:

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

該檔案包含項目

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

                "activeAemEnvironmentRoot": url,

                "viewMode": "grid}

取代「網址」和您的 Experience Manager 執行個體的網址。將該網址包含在引號中。儲存並關閉檔案。退出並重新啟動 Adobe XD,使其連接到 Experience Manager Assets。

註解:

如果 assetlink-settings.json 檔案不同,適用於 XD 的 Adobe Asset Link 會重新導向到發現服務工作流程。

在 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。

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

更快、更輕鬆地獲得協助

新的使用者?