DokumentationAEMHandbuch für das Desktop-Programm

Fehlerbehebung für das Adobe Experience Manager-Desktop-Programm troubleshoot-v2

Last update: Thu Jul 31 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Benutzende
  • Admin

Adobe Experience Manager Desktop-Programm stellt eine Verbindung zum DAM-Repository (Digital Asset Management) einer Experience Manager-Bereitstellung her. Die App ruft Repository-Informationen und Suchergebnisse auf Ihrem Computer ab, lädt Dateien und Ordner herunter und lädt sie hoch und bietet Funktionen zum Verwalten von Konflikten mit der Assets-Benutzeroberfläche.

Lesen Sie weiter, um Fehler im Programm zu beheben, lernen Sie die Best Practices kennen und erfahren Sie mehr über Einschränkungen.

Best Practices best-practices-to-prevent-troubles

Befolgen Sie die folgenden Best Practices, um einige häufige Probleme zu vermeiden, und für die Fehlerbehebung.

  • So funktioniert das Desktop-Programm: Bevor Sie mit der Verwendung des Programms beginnen, sollten Sie sich kurz mit ihrer Funktionsweise vertraut machen. Erfahren Sie mehr über die Verknüpfung zwischen der Experience Manager-Web-Oberfläche und dem Desktop, die Repository-Zuordnung, das Zwischenspeichern von Assets, das lokale Speichern und das Hochladen im Hintergrund. Machen Sie sich mit der Funktionsweise vertraut.

  • Vermeiden Sie nicht unterstützte Zeichen in Ordnernamen: Verwenden Sie beim Erstellen oder Hochladen von Ordnern keine Leerzeichen und ungültige Zeichen. Eine Liste der Zeichen finden Sie unter Erstellen von Ordnern in Adobe Experience Manager Assets. Nicht unterstützte Zeichen im Ordnernamen können sich auf einige Experience Manager Anwendungsfälle auswirken.

  • Best Practices zur Vermeidung von: Um potenzielle Konflikte bei der Zusammenarbeit an mehreren Assets zu vermeiden, gehen Sie zu Bearbeitungskonflikte vermeiden.

  • Verwenden des Ordner-Uploads für große, hierarchische Ordner: Verwenden Sie anstelle der Assets-Web-Oberfläche oder anderer Methoden das Experience Manager-Desktop-Programm zum Hochladen großer Ordner. Die App lädt die Assets im Hintergrund mit Protokollierung und Überwachung hoch. Siehe Massen-Upload von Assets.

  • Die neueste Version verwenden: Verwenden Sie die neueste App-Version. Führen Sie eine Kompatibilitätsprüfung durch, bevor Sie entweder eine neue Anwendungsversion installieren oder auf eine neuere Experience Manager aktualisieren. Siehe Versionshinweise.

  • Verwenden Sie denselben Laufwerksbuchstaben: Verwenden Sie in der gesamten Organisation denselben Laufwerksbuchstaben für das Experience Manager-DAM. Damit von anderen Benutzern platzierte Assets angezeigt werden können, müssen die Pfade identisch sein. Mit demselben Laufwerksbuchstaben wird ein konstanter Pfad zu DAM-Assets sichergestellt. Die Assets bleiben platziert und werden auch dann nicht entfernt, wenn verschiedene Laufwerksbuchstaben von verschiedenen Benutzern verwendet werden.

  • Denken Sie an das Netzwerk: Die Netzwerkleistung ist von entscheidender Bedeutung für die Leistung des Experience Manager-Desktop-Programms. Wenn Sie auf Dateiübertragungen oder Massenvorgänge nur langsam reagieren, sollten Sie die Funktionen oder Apps deaktivieren, die möglicherweise zu viel Netzwerk-Traffic führen.

  • Nicht unterstützte Anwendungsfälle für das Desktop-Programm: Verwenden Sie das Programm nicht für die Asset-Migration, da dies Planung und zusätzliche Tools erfordert. Sie ist auch nicht für gängige DAM-Vorgänge wie das Verschieben großer Ordner, große Uploads oder erweiterte Metadatensuchen geeignet. Verwenden Sie ihn außerdem nicht als Synchronisierungs-Client, da sich seine Design-Prinzipien und Nutzungsmuster von Synchronisierungs-Clients wie Microsoft OneDrive oder Adobe Creative Cloud Desktop Sync unterscheiden.

  • Zeitüberschreitung: Derzeit verfügt das Desktop-Programm über keinen konfigurierbaren Zeitüberschreitungswert, der die Verbindung zwischen Experience Manager Server und dem Desktop-Programm nach einem festen Zeitintervall trennt. Wenn beim Hochladen großer Assets nach einiger Zeit ein Verbindungs-Timeout eintritt, versucht das Programm, das Asset einige Male hochzuladen, indem es den Timeout-Wert für den Upload erhöht. Es gibt keine empfohlene Vorgehensweise, um die Standardeinstellungen für den Timeout zu ändern.

Fehlerbehebung troubleshooting-prep

Um Probleme mit dem Desktop-Programm zu beheben, beachten Sie die folgenden Informationen. Außerdem werden Sie darauf vorbereitet, die Probleme besser an den Adobe-Kunden-Support zu übermitteln, wenn Sie sich für den Support entscheiden.

Speicherort der Protokolldateien check-log-files-v2

Die Experience Manager Desktop-App speichert ihre Protokolldateien je nach Betriebssystem an den folgenden Speicherorten:

Unter Windows: %LocalAppData%\Adobe\AssetsCompanion\Logs

Unter macOS: ~/Library/Logs/Adobe\ Experience\ Manager\ Desktop

Wenn beim Hochladen vieler Assets einige Dateien nicht hochgeladen werden können, finden Sie in der Datei backend.log Informationen zu den fehlgeschlagenen Uploads.

NOTE
Wenn Sie mit dem Adobe-Support an einer Support-Anfrage/einem Ticket arbeiten, werden Sie möglicherweise aufgefordert, die Protokolldateien zu teilen, damit das Support-Team das Problem verstehen kann. Archivieren Sie den gesamten Ordner Logs und geben Sie ihn für Ihre Kontaktperson beim Support frei.

Ändern der Detailebene in Protokolldateien level-of-details-in-log

So ändern Sie die Detailebene in Protokolldateien:

  1. Stellen Sie sicher, dass die Anwendung nicht ausgeführt wird.

  2. Windows-System:

    1. Öffnen Sie ein Befehlsfenster.

    2. Starten Sie das Adobe Experience Manager-Desktop-Programm, indem Sie den Befehl ausführen:

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

    Mac-System:

    1. Öffnen Sie ein Terminal-Fenster.

    2. Starten Sie das Adobe Experience Manager-Desktop-Programm, indem Sie den Befehl ausführen:

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

Die gültigen Protokollebenen sind DEBUG, INFO, WARN oder ERROR. Die Ausführlichkeit der Protokolle ist in DEBUG am höchsten und in ERROR am niedrigsten.

Aktivieren des Debug-Modus enable-debug-mode

Zur Fehlerbehebung können Sie den Debug-Modus aktivieren und weitere Informationen in den Protokollen abrufen.

NOTE
Gültige Protokollebenen sind DEBUG, INFO, WARN oder ERROR. Die Ausführlichkeit der Protokolle ist in DEBUG am höchsten und in ERROR am niedrigsten.

So verwenden Sie das Programm im Debug-Modus auf einem Mac:

  1. Öffnen Sie ein Terminal-Fenster oder eine Eingabeaufforderung.

  2. Starten Sie das Experience Manager-Desktop-Programm, indem Sie den folgenden Befehl ausführen:

    AEM_DESKTOP_LOG_LEVEL=DEBUG open /Applications/Adobe\ Experience\ Manager\ Desktop.app.

So aktivieren Sie den Debug-Modus unter Windows:

  1. Öffnen Sie ein Befehlsfenster.

  2. Starten Sie das Experience Manager-Desktop-Programm, indem Sie den folgenden Befehl ausführen:

AEM_DESKTOP_LOG_LEVEL=DEBUG&"C:\Program Files\Adobe\Adobe Experience Manager Desktop.exe.

Ermitteln der Adobe Experience Manager-Desktop-Programm-Version know-app-version-v2

So zeigen Sie die Versionsnummer an:

  1. Starten Sie das Programm.

  2. Klicken Sie auf die Auslassungszeichen in der oberen rechten Ecke, halten Sie den Mauszeiger über Help und klicken Sie auf About.

    Daraufhin wird die Versionsnummer auf dem Bildschirm angezeigt.

Löschen des Cache clear-cache-v2

Führen Sie die folgenden Schritte durch:

  1. Starten Sie die Anwendung und verbinden Sie sich mit einer Instanz von Experience Manager.

  2. Öffnen Sie die Voreinstellungen des Programms, indem Sie auf die Auslassungspunkte in der oberen rechten Ecke klicken und die Option Preferences auswählen.

  3. Gehen Sie zum Eintrag, der die Current Cache Size anzeigt. Klicken Sie auf das Papierkorbsymbol neben diesem Element.

Gehen Sie wie folgt vor, um den Cache manuell zu löschen:

CAUTION
Diese Schritte sind potenziell zerstörerisch. Wenn es lokale Dateiänderungen gibt, die nicht in Adobe Experience Manager hochgeladen werden, gehen diese Änderungen verloren.

Der Cache wird gelöscht, indem das Cache-Verzeichnis des Programms gelöscht wird. Zu finden ist es in den Voreinstellungen des Programms.

  1. Starten Sie das Programm.

  2. Öffnen Sie die Voreinstellungen des Programms, indem Sie die Auslassungspunkte in der oberen rechten Ecke auswählen und dann Preferences auswählen.

  3. Notieren Sie den Wert für Cache Directory.

    In diesem Verzeichnis gibt es Unterverzeichnisse, die nach den Endpunkten des Typs Encoded Adobe Experience Manager benannt sind. Die Namen sind eine kodierte Version der Zielgruppen-Adobe Experience Manager. Wenn die Anwendung beispielsweise auf localhost:4502 abzielt, wird der Verzeichnisname localhost_4502.

Wenn Sie den Cache löschen möchten, löschen Sie das Verzeichnis „Codierter Adobe Experience Manager-Endpunkt“. Alternativ wird durch Löschen des in den Voreinstellungen angegebenen gesamten Ordners der Cache für alle Instanzen gelöscht, die von der Anwendung verwendet wurden.

Beim Löschen des Caches des Adobe Experience Manager-Desktop-Programms handelt es sich um eine vorläufige Aufgabe zur Fehlerbehebung, durch die verschiedene Probleme gelöst werden können. Löschen Sie den Cache in den Programm-Voreinstellungen. Siehe Festlegen von Voreinstellungen. Der Standardspeicherort des Cache-Ordners ist:

Platzierte Assets werden nicht angezeigt placed-assets-missing

Wenn Sie die Assets, die Sie oder andere Kreativprofis in den Support-Dateien gespeichert haben (z. B. INDD-Dateien), nicht sehen können, überprüfen Sie Folgendes:

  • Verbindung zum Server. Instabile Netzwerkverbindungen können das Herunterladen von Assets verzögern.

  • Dateigröße. Das Herunterladen und Anzeigen großer Assets dauert länger.

  • Konsistenz der Laufwerksbuchstaben. Wenn Sie oder ein anderer Mitarbeiter die Assets platziert haben, während das Experience Manager-DAM einem anderen Laufwerksbuchstaben zugeordnet war, werden die platzierten Assets nicht angezeigt.

  • Berechtigungen. Um zu prüfen, ob Sie berechtigt sind, die platzierten Assets abzurufen, wenden Sie sich an Ihren Experience Manager-Administrator.

Änderungen an Dateien in der Benutzeroberfläche des Desktop-Programms werden in Adobe Experience Manager nicht sofort übernommen changes-on-da-not-visible-on-aem

Das Adobe Experience Manager-Desktop-Programm überlässt es dem Benutzer, zu entscheiden, wann alle Änderungen an einer Datei abgeschlossen sind. Je nach Größe und Komplexität einer Datei dauert es sehr lange, bis die neue Version einer Datei wieder auf Adobe Experience Manager übertragen wird. Die Anwendung ist so konzipiert, dass die Anzahl der Dateiübertragungen minimiert wird, anstatt Dateien basierend auf dem vermuteten Abschluss der Bearbeitungen automatisch hochzuladen. Es wird empfohlen, dass der Benutzer die Übertragung der Datei zurück in Adobe Experience Manager einleitet, indem er die Änderungen einer Datei hochlädt.

Probleme beim Aktualisieren unter macOS issues-when-upgrading-on-macos

Gelegentlich können beim Aktualisieren des Experience Manager-Desktop-Programms auf macOS Probleme auftreten. Diese Probleme werden durch ältere Systemordner für das Experience Manager Desktop-Programm verursacht. Die Ordner verhindern, dass neue Versionen des Experience Manager-Desktop-Programms korrekt geladen werden. Zur Behebung dieses Problems können die folgenden Ordner und Dateien manuell entfernt werden.

Ziehen Sie die Adobe Experience Manager Desktop Anwendung vor dem Ausführen der folgenden Schritte aus dem Ordner "macOS Applications“ in den Papierkorb. Öffnen Sie dann das Terminal, führen Sie den folgenden Befehl aus und geben Sie bei Aufforderung Ihr Kennwort ein.

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

Dateien können nicht hochgeladen werden upload-fails

Wenn Sie das -Desktop-Programm mit Experience Manager 6.5.1 oder höher verwenden, aktualisieren Sie den S3- oder Azure-Connector auf Version 1.10.4 oder höher. Das Problem mit dem Fehler beim Datei-Upload im Zusammenhang mit OAK-8599 wird behoben. Siehe Installationsanweisungen.

Verbindungsprobleme mit dem Experience Manager-Desktop-Programm connection-issues

Wenn allgemeine Konnektivitätsprobleme auftreten, gibt es hier einige Möglichkeiten, weitere Informationen darüber zu erhalten, was das Experience Manager-Desktop-Programm tut.

Überprüfen des Anfrageprotokolls

Die Experience Manager Desktop-App protokolliert alle gesendeten Anfragen zusammen mit dem Antwort-Code jeder Anfrage in einer dedizierten Protokolldatei.

  1. Öffnen Sie request.log im Protokollverzeichnis des Programms, um diese Anfragen anzuzeigen.

  2. Jede Zeile im Protokoll stellt entweder eine Anfrage oder eine Antwort dar. Anfragen weisen ein > Zeichen auf, gefolgt von der angeforderten URL. Antworten haben ein < Zeichen, gefolgt vom Antwort-Code und der angeforderten URL. Anfragen und Antworten können mit der GUID jeder Zeile abgeglichen werden.

Überprüfen von Anfragen, die vom eingebetteten Browser des Programms geladen wurden

Die meisten Anfragen des Programms finden Sie im Anfrageprotokoll. Wenn es dort keine hilfreichen Informationen gibt, können Sie sich die vom eingebetteten Browser des Programms gesendeten Anfragen ansehen.
Anweisungen zur Ansicht dieser Anfragen finden Sie im Abschnitt zu SAML.

SAML-Anmeldeauthentifizierung funktioniert nicht da-connection-issue-with-saml-aem

Das Experience Manager-Desktop-Programm stellt möglicherweise keine Verbindung zu Ihrer SSO-fähigen (SAML) Adobe Experience Manager-Bereitstellung her. Das Programm-Design versucht, die Variationen und Komplexitäten von SSO-Verbindungen und -Prozessen zu berücksichtigen. Eine Konfiguration kann jedoch eine zusätzliche Fehlerbehebung erfordern.

Manchmal wird der SAML-Prozess nicht zum ursprünglich angeforderten Pfad zurückgeleitet. Oder die endgültige Umleitung erfolgt an einen Host, der sich von dem unterscheidet, der in der Adobe Experience Manager Desktop-App konfiguriert ist. Um sicherzustellen, dass dies nicht der Fall ist, führen Sie die folgenden Schritte aus:

  1. Öffnen Sie einen Webbrowser. Rufen Sie die https://[aem_server]:[port]/content/dam.json-URL auf.

  2. Melden Sie sich bei der Adobe Experience Manager-Bereitstellung an.

  3. Wenn die Anmeldung abgeschlossen ist, sehen Sie sich die aktuelle Adresse des Browsers in der Adressleiste an. Sie sollte genau mit der ursprünglich von Ihnen eingegeben URL übereinstimmen.

  4. Überprüfen Sie außerdem, ob alles vor /content/dam.json mit dem Zielwert von Adobe Experience Manager, der in den Einstellungen des Adobe Experience Manager-Desktop-Programms konfiguriert ist, übereinstimmt.

Der SAML-Anmeldevorgang funktioniert ordnungsgemäß, aber die Benutzer können sich weiterhin nicht anmelden

Das Fenster innerhalb des Adobe Experience Manager-Desktop-Programms, das den Anmeldeprozess anzeigt, ist einfach ein Webbrowser, der die Web-Benutzeroberfläche der Adobe Experience Manager-Zielinstanz anzeigt:

  • Die Mac-Version verwendet eine WebView.

  • Die Windows-Version verwendet Chromium-basiertes CefSharp.

Stellen Sie sicher, dass der SAML-Prozess diese Browser unterstützt.

Zur weiteren Fehlerbehebung können die exakten URLs, die der Browser zu laden versucht, angezeigt werden. So sehen Sie diese Informationen:

  1. Befolgen Sie die Anweisungen zum Starten des Programms im Debug-Modus.

  2. Reproduzieren Sie den Anmeldeversuch.

  3. Navigieren Sie zum Protokollverzeichnis der Anwendung.

  4. Für Windows:

    1. Öffnen Sie „aemcompanonlog.txt“.

    2. Suchen Sie nach Nachrichten, die mit „Adresse des Anmelde-Browsers geändert in“ beginnen. Diese Einträge enthalten auch die URL, die das Programm geladen hat.

    Für Mac:

    1. Ersetzen Sie in com.adobe.aem.desktop-nnnnnnnn-nnnnnn.log durch die Zahlen im neuesten Dateinamen n.

    2. Suchen Sie nach Nachrichten, die mit „Geladener Rahmen“ beginnen. Diese Einträge enthalten auch die URL, die das Programm geladen hat.

Wenn Sie sich die URL-Sequenz ansehen, die geladen wird, können Sie die Fehlerbehebung am SAML-Ende durchführen, um festzustellen, was falsch ist.

Problem bei der SSL-Konfiguration ssl-config-v2

Die Bibliotheken, die die Experience Manager-Desktop-App für die HTTP-Kommunikation verwendet, verwenden eine strikte SSL-Durchsetzung. Manchmal kann eine Verbindung über einen Browser erfolgreich sein, aber sie schlägt fehl, wenn das Experience Manager-Desktop-Programm verwendet wird. Installieren Sie für eine ordnungsgemäße SSL-Konfiguration das fehlende Zwischenzertifikat in Apache. Siehe How to install an Intermediate CA cert in Apache (nur auf Englisch verfügbar).

Die Bibliotheken, die die Experience Manager-Desktop-App für die HTTP-Kommunikation verwendet, verwenden eine strikte SSL-Durchsetzung. Es kann also vorkommen, dass SSL-Verbindungen, die über einen Browser erfolgreich sind, bei der Adobe Experience Manager Desktop-App fehlschlagen. Dieses Ergebnis ist gut, da es die korrekte Konfiguration von SSL fördert und die Sicherheit erhöht, kann aber frustrierend sein, wenn die Anwendung keine Verbindung herstellen kann.

Der empfohlene Ansatz in diesem Fall besteht darin, ein Tool zu verwenden, um das SSL-Zertifikat eines Servers zu analysieren und Probleme zu identifizieren, damit diese korrigiert werden können. Es gibt Websites, die das Zertifikat eines Servers überprüfen, indem sie dessen URL angeben.

Als temporäre Maßnahme ist es möglich, die strikte SSL-Durchsetzung in der Adobe Experience Manager Desktop-App zu deaktivieren. Dieser Ansatz ist keine empfohlene langfristige Lösung, da er die Sicherheit reduziert, indem er die Grundursache von falsch konfiguriertem SSL verbirgt. So deaktivieren Sie die strikte Durchsetzung:

  1. Verwenden Sie den Editor Ihrer Wahl, um die JavaScript-Konfigurationsdatei des Programms zu bearbeiten, die sich (standardmäßig) an den folgenden Speicherorten befindet (je nach Betriebssystem):

    Unter macOS: /Applications/Adobe Experience Manager Desktop.app/Contents/Resources/javascript/lib-smb/config.json

    Unter Windows: C:\Program Files (x86)\Adobe\Adobe Experience Manager Desktop\javascript\config.json

  2. Suchen Sie den folgenden Abschnitt in der Datei:

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

  3. Ändern Sie den Abschnitt, indem Sie "strictSSL": false wie folgt hinzufügen:

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

  4. Speichern Sie die Datei und starten Sie das Adobe Experience Manager-Desktop-Programm neu.

Probleme bei der Anmeldung beim Wechsel zu einem anderen Server cannot-login-cookies-issue

Wenn Sie nach der Verwendung eines Experience Manager-Servers versuchen, die Verbindung zu einem anderen Server zu ändern, treten möglicherweise Anmeldeprobleme auf. Der Grund hierfür sind alte Cookies, die die neue Authentifizierung beeinträchtigen. Die Option Clear Cookies im Hauptmenü hilft hierbei. Melden Sie sich bei der aktuellen Programmsitzung ab und wählen Sie Clear Cookies, bevor Sie mit der Herstellung der Verbindung fortfahren.

Löschen von Cookies beim Server-Wechsel

Das Programm reagiert nicht unresponsive

In seltenen Fällen reagiert das Programm möglicherweise nicht mehr, zeigt nur einen weißen Bildschirm an oder zeigt einen Fehler am unteren Rand der Benutzeroberfläche an, ohne dass Optionen auf der Benutzeroberfläche vorhanden sind. Versuchen Sie Folgendes in genannter Reihenfolge:

  • Klicken Sie mit der rechten Maustaste auf die Programmoberfläche und klicken Sie auf Refresh.
  • Beenden Sie das Programm und starten Sie es erneut.

Bei beiden Methoden startet das Programm im Stammordner des DAM.

Ausblenden abgelaufener Assets hide-expired-assets

Beim Durchsuchen von Assets über die Experience Manager-Benutzeroberfläche werden die abgelaufenen Assets nicht angezeigt. Admins können Einstellungen konfigurieren, um das Anzeigen, Suchen und Abrufen abgelaufener Assets beim Durchsuchen über das Desktop-Programm und Asset Link zu verhindern. Dadurch wird sichergestellt, dass bei diesen Vorgängen nicht auf abgelaufene Assets zugegriffen werden kann. Die Konfiguration funktioniert für alle Benutzer, unabhängig von den Administratorberechtigungen.

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