文件AEM桌面應用程式指南

疑難排解Adobe Experience Manager案頭應用程式 troubleshoot-v2

Last update: Fri Jul 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • 使用者
  • 管理員

Adobe Experience Manager案頭應用程式連線至Experience Manager部署的數位資產管理(DAM)存放庫。 應用程式會擷取您電腦上的存放庫資訊和搜尋結果、下載和上傳檔案及資料夾，並包含管理與Assets使用者介面衝突的功能。

請閱讀下文，針對應用程式進行疑難排解，瞭解最佳實務，並找出限制。

最佳做法 best-practices-to-prevent-troubles

請遵循以下最佳實務，以防止一些常見問題和疑難排解。

  • 瞭解案頭應用程式的運作方式：開始使用應用程式之前，請先花點時間瞭解應用程式的運作方式。 瞭解Experience Manager網頁介面與案頭之間的連結、存放庫對應、資產快取、本機儲存和背景上傳。 檢視運作方式。

  • 避免資料夾名稱中有不支援的字元：建立或上傳資料夾時，請勿使用空格和無效的字元。 在在 Adobe Experience Manager Assets中建立資料夾，檢視字元清單。 資料夾名稱中不支援的字元可能會影響某些Experience Manager使用案例。

  • 避免衝突的最佳實務：若要避免在多個資產上共同作業時可能發生的衝突，請移至避免編輯衝突。

  • 針對大型階層資料夾使用資料夾上傳：不使用Assets網頁介面或其他方法，而是使用Experience Manager案頭應用程式來上傳大型資料夾。 應用程式會在背景使用記錄及監控功能上傳資產。 請參閱大量上傳資產。

  • 使用最新版本：使用最新應用程式版本。 在安裝新的應用程式版本或升級到較新的Experience Manager版本之前，請務必檢查相容性。 請參閱發行說明。

  • 使用相同的磁碟機代號：在組織內使用相同的磁碟機代號來對應至Experience Manager DAM。 若要檢視其他使用者置入的資產，路徑必須相同。 使用相同的磁碟機代號可確保到DAM資產的路徑不變。 即使不同的使用者使用不同的磁碟機代號，資產仍會放置且不會移除。

  • 請注意網路：網路效能對於Experience Manager案頭應用程式的效能至關重要。 如果您遇到檔案傳輸或大量作業回應速度變慢的問題，請關閉可能導致大量網路流量的功能或應用程式。

  • 案頭應用程式不支援的使用案例：請避免使用應用程式進行資產移轉，因為它需要規劃和其他工具。 此外，它也不適合執行大量的DAM作業，例如移動大型資料夾、大型上傳或進階中繼資料搜尋。 此外，請勿將其用作同步處理使用者端，因為其設計原則和使用模式與Microsoft OneDrive或Adobe Creative Cloud案頭同步處理等同步處理使用者端不同。

  • 逾時：目前案頭應用程式沒有可設定的逾時值，無法在固定時間間隔後中斷Experience Manager伺服器與案頭應用程式之間的連線。 上傳大型資產時，如果連線一段時間後逾時，應用程式會增加上傳逾時，多次重試上傳資產。 沒有建議的方法可變更預設逾時設定。

疑難排解 troubleshooting-prep

若要疑難排解案頭應用程式問題，請注意下列資訊。 此外，如果您選擇尋求支援，它可讓您更妥善地向Adobe客戶支援傳達問題。

記錄檔的位置 check-log-files-v2

Experience Manager案頭應用程式會根據作業系統將其記錄檔儲存在下列位置：

在Windows上： %LocalAppData%\Adobe\AssetsCompanion\Logs

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

上傳許多資產時，如果部分檔案無法上傳，請參閱backend.log檔案以識別失敗的上傳。

NOTE
處理Adobe客戶支援的支援要求或票證時，系統會要求您共用記錄檔，以協助客戶支援團隊瞭解問題。 封存整個Logs資料夾並與您的客戶支援聯絡人共用。

變更記錄檔中的詳細資訊層級 level-of-details-in-log

若要變更記錄檔中的詳細資訊層級：

  1. 確認應用程式未執行。

  2. 在Windows系統上：

    1. 開啟命令視窗。

    2. 執行命令以啟動Adobe Experience Manager案頭應用程式：

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

    在Mac系統上：

    1. 開啟終端機視窗。

    2. 執行命令以啟動Adobe Experience Manager案頭應用程式：

    code language-shell 
    AEM_DESKTOP_LOG_LEVEL=DEBUG open /Applications/Adobe\ Experience\ Manager\ Desktop.app

有效的記錄層級為DEBUG、INFO、WARN或ERROR。 記錄的詳細程度在DEBUG中是最高的，在ERROR中是最低的。

啟用偵錯模式 enable-debug-mode

若要進行疑難排解，您可以啟用偵錯模式，並在記錄中取得更多資訊。

NOTE
有效的記錄層級為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。

瞭解Adobe Experience Manager案頭應用程式版本 know-app-version-v2

若要檢視版本號碼：

  1. 啟動應用程式。

  2. 按一下右上角的省略符號，將游標暫留在Help上，然後按一下About。

    版本號碼會列在此畫面上。

清除快取 clear-cache-v2

執行下列步驟：

  1. 啟動應用程式並連線到Experience Manager的執行個體。

  2. 按一下右上角的省略符號並選取Preferences，開啟應用程式的偏好設定。

  3. 找到顯示Current Cache Size的專案。 按一下此元素旁的垃圾桶圖示。

若要手動清除快取，請執行下列動作：

CAUTION
這些步驟可能會造成破壞性作業。 如果有未上傳至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案頭應用程式的快取是一項初步的疑難排解工作，可解決數個問題。 從應用程式偏好設定中清除快取。 檢視設定偏好設定。 快取資料夾的預設位置為：

無法看到已放置資產 placed-assets-missing

如果您無法看到您或其他創意專業人士放置在支援檔案（例如INDD檔案）中的資產，請檢查以下內容：

  • 連線到伺服器。 不穩定的網路連線可能會延遲資產下載作業。

  • 檔案大小。 大型資產的下載和顯示時間較長。

  • 磁碟機代號一致性。 如果您或其他共同作業人員在將Experience Manager DAM對應至其他磁碟機代號時放置資產，則放置的資產不會顯示。

  • 權限。若要檢查您是否擁有擷取置入資產的許可權，請連絡您的Experience Manager管理員。

對案頭應用程式使用者介面上檔案的編輯不會立即在Adobe Experience Manager中反映 changes-on-da-not-visible-on-aem

Adobe Experience Manager案頭應用程式留給使用者決定檔案的所有編輯何時完成。 根據檔案的大小和複雜性，將檔案的新版本傳輸回Adobe Experience Manager需要相當長的時間。 應用程式的設計目的是將檔案傳輸的數目降至最低，而不是根據猜測的編輯完成情況自動上傳檔案。 建議使用者選擇上傳檔案的變更，以開始將檔案傳輸回Adobe Experience Manager。

在macOS上升級時發生的問題 issues-when-upgrading-on-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

無法上傳檔案 upload-fails

如果您使用案頭應用程式搭配Experience Manager 6.5.1或更新版本，請將S3或Azure聯結器升級至1.10.4或更新版本。 它解決與OAK-8599相關的檔案上傳失敗問題。 請參閱安裝指示。

Experience Manager案頭應用程式連線問題 connection-issues

如果您遇到一般連線問題，以下提供一些方法，以取得有關Experience Manager案頭應用程式正在做什麼的詳細資訊。

檢查要求記錄

Experience Manager案頭應用程式會將它傳送的所有要求以及每個要求的回應代碼，記錄在專用的記錄檔中。

  1. 在應用程式的記錄檔目錄中開啟request.log以檢視這些要求。

  2. 記錄中的每一行代表要求或回應。 要求有>個字元，後面接著要求的URL。 回應有<個字元，後面接著回應代碼和要求的URL。 可使用每一行的GUID來比對請求和回應。

檢查應用程式內嵌瀏覽器載入的要求

大部分應用程式的要求可在要求記錄中找到。 不過，如果沒有有用的資訊，則檢視應用程式的內嵌瀏覽器所傳送的請求會很有用。
請參閱SAML區段，瞭解如何檢視這些要求的說明。

SAML登入驗證無法運作 da-connection-issue-with-saml-aem

Experience Manager案頭應用程式可能無法連線至已啟用SSO (SAML) Adobe Experience Manager部署。 應用程式的設計會嘗試適應SSO連線和程式的變化與複雜性。 不過，安裝程式可能需要額外的疑難排解。

有時SAML程式不會重新導向回最初請求的路徑。 或者，最終重新導向會導向與Adobe Experience Manager案頭應用程式中已設定的主機不同的主機。 若要確認此問題並非如此情況，請執行下列動作：

  1. 開啟網頁瀏覽器。 存取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使用者介面的網頁瀏覽器：

  • 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中，最新檔案名稱中的數字會取代​ n。

    2. 搜尋以「載入的框架」開頭的訊息。 這些專案也包含應用程式載入的URL。

檢視正在載入的URL序列有助於在SAML端進行疑難排解，以判斷哪裡出了問題。

SSL設定問題 ssl-config-v2

Experience Manager案頭應用程式用於HTTP通訊的資料庫使用嚴格的SSL強制執行。 有時，連線可能會使用瀏覽器成功，但在使用Experience Manager案頭應用程式時失敗。 若要正確設定SSL，請在Apache中安裝缺少的中間憑證。 請參閱如何在Apache中安裝中繼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. 在檔案中找出下列區段：

    code language-shell 
    ...
"assetRepository": {
    "options": {
...

  3. 新增"strictSSL": false以修改區段，如下所示：

    code language-shell 
    ...
"assetRepository": {
    "options": {
        "strictSSL": false,
...

  4. 儲存檔案並重新啟動Adobe Experience Manager案頭應用程式。

切換至其他伺服器時出現登入問題 cannot-login-cookies-issue

使用Experience Manager伺服器後，當您嘗試變更其他伺服器的連線時，可能會遇到登入問題。 這是由於舊的Cookie干擾新的驗證。 主要功能表中的Clear Cookies選項有所幫助。 登出應用程式中的目前工作階段並選取Clear Cookies，再繼續連線。

切換伺服器時 清除Cookie

應用程式無回應 unresponsive

極少數情況下，應用程式可能會變得無回應、只顯示白色熒幕，或在介面底部顯示錯誤（沒有任何介面選項）。 請依順序嘗試下列操作：

  • 在應用程式介面上按一下滑鼠右鍵，然後按一下​ Refresh。
  • 請退出應用程式並再次開啟。

在這兩種方法中，應用程式都會從根DAM資料夾開始。

隱藏過期的資產 hide-expired-assets

從Experience Manager使用者介面瀏覽資產時，不會顯示過期的資產。 管理員可設定設定，以防止在從案頭應用程式和Asset Link瀏覽時檢視、搜尋和擷取已到期資產。 這麼做可確保這些作業期間不會存取過期的資產。 此設定適用於所有使用者，無論管理員許可權為何。

Related Articles
recommendation-more-help
d27c3dc5-a94a-4e63-a6d5-c47555beb65d