若要重新整理 Creative Cloud 應用程式中的快取,請在安裝/重新安裝 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 面板,請在開始疑難排解特定錯誤之前執行這些步驟。
-
-
檢查 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。
-
驗證 assetlink-settings.json 檔案是否存在於以下位置:
- macOS: /Users/<username>/Library/Application Support/Adobe/CEP/extensions
- Windows:C:\Users\<username>\AppData\Roaming\Adobe\CEP\extensions
-
確定您已使用 Creative Cloud 桌面應用程式中的 Enterprise ID 或 Federated ID 登入。
-
確定檔案同步功能已在 Creative Cloud 桌面應用程式中啟用。
-
使用活動監視器 (macOS) 或工作管理員 (Windows) 確定名為 CoreSync 的處理程序正在執行。
-
如果您是管理員,請確定下列項目:
- 所有 IMS 設定皆已正確完成。
- 在 Adobe Admin Console 中,使用者的 Business、Enterprise 或 Federated ID 即新增至使用者群組 (在 Experience Manager 伺服器中設定)。
- 在 Experience Manager 伺服器中設定的 IMS 使用者群組屬於 Experience Manager 中 dam-users 群組的一部分。
-
如果您使用具有 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 或更新版本。
-
為了讓 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,安裝失敗但未出現任何錯誤。
若要修正此問題,請執行下列動作。
-
離開適用於桌上型電腦的 Creative Cloud。
-
從以下位置刪除 ExMan.db:
macOS:/Library/Application Support/Adobe/Extension Manager CC/Configuration/DB。
Windows:C:\ProgramData\Adobe\Extension Manager CC\Configuration\DB。
-
重新啟動適用於桌上型電腦的 Creative Cloud,然後使用您在步驟 1 中使用的相同認證登入。
-
重新安裝包含 Adobe Asset Link 擴充功能的套件。即安裝 Adobe Asset Link 面板。
錯誤
原因
如果您嘗試使用 Adobe ID 登入並存取 Adobe Asset Link,則會出現此錯誤。如果您沒有適用於企業的 Creative Cloud 帳戶,請聯絡您的 IT 管理員。
錯誤
如果您沒有存取此服務的權限,請聯絡您的 IT 管理員以取得存取權限。 |
原因
如果您沒有存取 Experience Manager 伺服器的所需權限,則會出現此錯誤。
若要修正此錯誤,如果 Experience Manager 伺服器已啟動並執行,請聯絡您的 IT 管理員。
錯誤
您正在嘗試連線的 Experience Manager Assets 伺服器無法連線。如需詳細資訊,請聯絡 Adobe Experience Manager 管理員。 |
原因
如果在連線到 Experience Manager 伺服器或 Experience Manager 伺服器無法使用時網路連線中斷,則會出現此錯誤。
若要修正錯誤,請確定您已連線到網際網路並執行下列動作:
-
檢查 Experience Manager 伺服器已啟動並執行。
-
退出並重新啟動正在使用 Creative Cloud 應用程式。
-
啟動 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 群組不符:
-
登入 Admin Console 的使用者頁面,搜尋使用者帳戶。
-
在使用者清單中,按一下相關使用者名稱。
-
在「使用者群組」下,驗證關聯的 IMS 群組是否符合 Experience Manager。
您可以在「aem-instance/system/console/configMgr > Adobe Granite OAuth IMS Provider > 群組對應」下檢查 Experience Manager 群組對應。
註解:使用 Experience Manager 6.4 及以上版本時,如果未明確定義群組對應,確定 IMS 使用者群組屬於 Experience Manager 中 dam-users 群組的一部分。
-
請參閱「設定 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
- Windows:C:\Users\<username>\AppData\Roaming\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 中的資產搜尋傳回不同的結果,請嘗試進行視覺相似性搜尋,以找出一致的結果。
啟用使用者端記錄
由於您需要使用使用者端和伺服器記錄診斷連線問題,因此啟用使用者端記錄有助於偵錯連線問題。
在 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 > 擴充功能檔案夾。
-
下載 assetlink-settings.json 範例檔案,然後使用文字編輯器開啟。
-
修改檔案,加入一個或多個 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。
用戶端記錄可協助對連線問題偵錯,因為診斷連線問題需要用戶端和伺服器端記錄。