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

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瀏覽時檢視、搜尋和擷取已到期資產。 這麼做可確保這些作業期間不會存取過期的資產。 此設定適用於所有使用者,無論管理員許可權為何。

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