Show Menu
THEMEN×

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

Das Adobe Experience Manager-Desktop-Programm (AEM) stellt eine Verbindung zum Digital Asset Management-Repository (DAM) einer Remote-Bereitstellung von Experience Manager her. Das Programm 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 Benutzeroberfläche von AEM Assets.
Lesen Sie weiter, um Fehler im Programm zu beheben, lernen Sie die Best Practices kennen und erfahren Sie mehr über Einschränkungen.

Best Practices

Befolgen Sie die folgenden Best Practices, um einige häufige Probleme und die Fehlerbehebung zu vermeiden.
  • 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 Verknüpfung zwischen der Web-Oberfläche von Experience Manager und dem Desktop-Programm, Repository-Zuordnung, Asset-Zwischenspeicherung, lokales Speichern und 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 Experience Manager Assets . In einigen Adobe Experience Manager-Anwendungsfällen können durch nicht unterstützte Zeichen im Ordnernamen Probleme auftreten.
  • Best Practices zur Vermeidung von Konflikten : Um mögliche Konflikte bei der Zusammenarbeit mit mehreren Assets zu vermeiden, lesen Sie Vermeiden von Bearbeitungskonflikten .
  • Verwenden Sie den Ordner-Upload für große, hierarchische Ordner : Verwenden Sie anstelle der Assets-Web-Oberfläche oder anderer Methoden das Experience Manager-Desktop-Programm, um große Ordner hochzuladen. Das Programm lädt die Assets mit Protokollierung und Überwachung im Hintergrund hoch. Siehe Massen-Upload von Assets .
  • Verwenden Sie die neueste Version : Verwenden Sie die neueste Programmversion und prüfen Sie immer, ob die Kompatibilität gewährleistet ist, bevor Sie eine neue Programmversion installieren oder bevor Sie auf eine neuere Adobe Experience Manager-Version aktualisieren. Siehe Versionshinweise .
  • Verwenden Sie denselben Laufwerksbuchstaben : Verwenden Sie in der gesamten Organisation denselben Laufwerksbuchstaben für Adobe 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.
  • Beachten Sie das Netzwerk : Die Netzwerkleistung ist von entscheidender Bedeutung für die Leistung des Experience Manager-Desktop-Programms. Wenn die Reaktion auf Dateiübertragungen oder Massenvorgänge verlangsamt ist, deaktivieren Sie die Funktionen oder Applikationen, die zu viel Netzwerkverkehr führen können.
  • Vom Desktop-Programm nicht unterstützte Anwendungsfälle : Verwenden Sie das Programm nicht für die Asset-Migration (diese muss gründlich geplant werden und erfordert andere Tools), anspruchsvolle DAM-Operationen (z. B. Verschieben großer Ordner, Uploads großer Dateien, Suchen von Dateien anhand erweiterter Metadaten-Suchen) oder als Synchronisierungs-Client (Design- und Nutzungsmuster unterscheiden sich von In-Sync-Clients wie Microsoft OneDrive oder Adobe Creative Cloud-Desktop-Synchronisierung).
  • Timeout : Das Desktop-Programm weist derzeit keinen konfigurierbaren Timeout-Wert auf, um die Verbindung zwischen dem Experience Manager-Server und dem Programm nach einem bestimmten Zeitintervall zu trennen. 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

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

Speicherort der Protokolldateien

Experience Manager Die Desktop-App speichert ihre Protokolldateien je nach Betriebssystem an den folgenden Speicherorten:
Unter Windows: %LocalAppData%\Adobe\AssetsCompanion\Logs
Unter Mac OS: ~/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.
Wenn Sie bei einer Supportanfrage oder einem Ticket mit der Kundenunterstützung der Adobe arbeiten, können Sie gebeten werden, die Protokolldateien freizugeben, damit das Kundendienstteam das Problem besser verstehen kann. Archivieren Sie den gesamten Ordner Logs und geben Sie ihn für Ihre Kontaktperson bei der Kundenunterstützung frei.

Detailstufe in Protokolldateien ändern

So ändern Sie die Detailebene in Protokolldateien:
  1. Vergewissern Sie sich, dass die Anwendung nicht ausgeführt wird.
  2. Windows-System:
    1. Öffnen Sie ein Befehlsfenster.
    2. Starten Sie die Adobe Experience Manager Desktop-App, indem Sie den Befehl ausführen:
    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 die Adobe Experience Manager Desktop-App, indem Sie den Befehl ausführen:
    AEM_DESKTOP_LOG_LEVEL=DEBUG open /Applications/Adobe\ Experience\ Manager\ Desktop.app
    
    
Die gültigen Protokollebenen sind DEBUG, INFO, WARN oder FEHLER. Die Ausführlichkeit der Protokolle ist im DEBUG am höchsten und im FEHLER am niedrigsten.

Aktivieren des Debugging-Modus

Zur Fehlerbehebung können Sie den Debug-Modus aktivieren und weitere Informationen in den Protokollen abrufen.
Gültige Protokollebenen sind DEBUG, INFO, WARN oder FEHLER. Die Ausführlichkeit der Protokolle ist im DEBUG am höchsten und im FEHLER am niedrigsten.
So verwenden Sie die App im Debug-Modus unter Mac:
  1. Öffnen Sie ein Terminalfenster oder eine Eingabeaufforderung.
  2. Starten Sie die Experience Manager Desktop-App, 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 die Experience Manager Desktop-App, indem Sie den folgenden Befehl ausführen:
AEM_DESKTOP_LOG_LEVEL=DEBUG&"C:\Program Files\Adobe\Adobe Experience Manager Desktop.exe .

Löschen des Cache

Führen Sie die folgenden Schritte durch:
  1. Beginn der Anwendung und Verbinden Sie eine AEM Instanz.
  2. Öffnen Sie die Voreinstellungen der Anwendung, indem Sie auf die Auslassungspunkte in der oberen rechten Ecke klicken und Preferencesdie Option auswählen.
  3. Suchen Sie den Eintrag, der die Current Cache Size. Klicken Sie auf das Papierkorbsymbol neben diesem Element.
Gehen Sie wie folgt vor, um den Cache manuell zu leeren.
Dies ist ein potenziell destruktiver Vorgang. Wenn lokale Dateiänderungen vorliegen, die nicht in hochgeladen werden, gehen diese Änderungen verloren, indem Sie fortfahren. Adobe Experience Manager
Der Cache wird gelöscht, indem der Cache-Ordner der Anwendung gelöscht wird, der in den Voreinstellungen der Anwendung enthalten ist.
  1. Starten Sie die Anwendung.
  2. Öffnen Sie die Voreinstellungen der Anwendung, indem Sie die Ellipsen in der oberen rechten Ecke auswählen und dann Preferencesauswählen.
  3. Notieren Sie den Cache Directory Wert.
    In diesem Verzeichnis befinden sich Unterordner, die nach den kodierten Adobe Experience Manager Endpunkten benannt sind. The names is an encoded version of the targeted Adobe Experience Manager URL. For example, if the application is targeting localhost:4502 then the directory name will be localhost_4502 .
To clear the cache, delete the desired Encoded Adobe Experience Manager Endpoint directory. Wenn Sie stattdessen den gesamten in den Voreinstellungen angegebenen Ordner löschen, wird der Cache für alle von der Anwendung verwendeten Instanzen gelöscht.
Clearing Adobe Experience Manager desktop app's cache is a preliminary troubleshooting task that can resolve several issues. Löschen Sie den Cache in den Programm-Voreinstellungen. Siehe Festlegen von Voreinstellungen . Der Standardspeicherort des Cache-Ordners ist:

Know the Adobe Experience Manager desktop app version

So sehen Sie die Versionsnummer:
  1. Starten Sie die Anwendung.
  2. Klicken Sie auf die Ellipsen in der oberen rechten Ecke, halten Sie den Mauszeiger über Helpund klicken Sie auf About.
    Die Versionsnummer wird auf diesem Bildschirm angezeigt.

Platzierte Assets werden nicht angezeigt

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 AEM DAM einem anderen Laufwerksbuchstaben zugeordnet wurde, werden die platzierten Assets nicht angezeigt
  • Berechtigungen. Wenden Sie sich an Ihren AEM-Administrator, um zu prüfen, ob Sie berechtigt sind, die platzierten Assets abzurufen.

Änderungen an Dateien in der Benutzeroberfläche der Desktop-App werden nicht Adobe Experience Manager sofort übernommen

Adobe Experience Manager Die Desktop-App ü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, die neue Version einer Datei wieder in Adobe Experience Managerzu übertragen. Das Design der Anwendung erfordert eine Minimierung der Anzahl der Übermittlungen einer Datei vor und zurück, anstatt zu vermuten, wann die Dateibearbeitungen abgeschlossen sind und automatisch hochgeladen werden. Es wird empfohlen, dass der Benutzer die Übertragung der Datei wieder auf einleitet, Adobe Experience Manager indem er die Änderungen einer Datei hochlädt.

Probleme beim Aktualisieren unter macOS

Gelegentlich können bei einem Upgrade des AEM-Desktop-Programms unter macOS Probleme auftreten. Die Ursache liegt darin, dass der alte Systemordner des AEM-Desktop-Programms verhindert, dass neue Versionen des AEM-Desktop-Programms korrekt geladen werden. Zur Behebung dieses Problems können die folgenden Ordner und Dateien manuell entfernt werden.
Ziehen Sie das Adobe Experience Manager Desktop -Programm vor dem Ausführen der folgenden Schritte aus dem Ordner „macOS-Applikationen“ in den Papierkorb. Öffnen Sie dann Terminal, führen Sie den folgenden Befehl aus und geben Sie Ihr Kennwort ein, wenn Sie dazu aufgefordert werden.
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

Wenn Sie das Desktop-Programm mit AEM 6.5.1 oder höher verwenden, aktualisieren Sie den S3- oder Azure-Connector auf Version 1.10.4 oder höher. Dadurch wird das Problem mit dem Hochladen von Dateien im Zusammenhang mit OAK-8599 behoben. Siehe Installationsanweisungen .

Experience Manager Verbindungsprobleme mit Desktop-Apps

Wenn allgemeine Verbindungsprobleme auftreten, finden Sie hier einige Möglichkeiten, um weitere Informationen darüber zu erhalten, was mit der Experience Manager Desktop-App geschieht.
Überprüfen des Anforderungsprotokolls
Experience Manager Die Desktop-App protokolliert alle gesendeten Anforderungen zusammen mit dem Antwortcode jeder Anforderung in einer dedizierten Protokolldatei.
  1. Öffnen Sie request.log im Protokollverzeichnis der Anwendung, um diese Anforderungen anzuzeigen.
  2. Jede Zeile im Protokoll stellt entweder eine Anforderung oder eine Antwort dar. Anforderungen haben ein > Zeichen gefolgt von der angeforderten URL. Antworten haben ein < Zeichen gefolgt vom Antwortcode und der angeforderten URL. Anforderungen und Antworten können mit der GUID jeder Zeile abgeglichen werden.
Überprüfen von Anforderungen, die vom eingebetteten Browser der Anwendung geladen wurden
Die meisten Anforderungen der Anwendung finden Sie im Anforderungsprotokoll. Wenn es dort keine hilfreichen Informationen gibt, können Sie sich die vom eingebetteten Browser der Anwendung gesendeten Anforderungen ansehen. Anweisungen zur Ansicht dieser Anforderungen finden Sie im Abschnitt SAML-Anmeldeauthentifizierung funktioniert nicht SAML.

SAML-Anmeldeauthentifizierung funktioniert nicht

Wenn die Experience Manager Desktop-App keine Verbindung zu Ihrer SSO-aktivierten Adobe Experience Manager Instanz (SAML) herstellt, lesen Sie diesen Abschnitt, um eine Fehlerbehebung durchzuführen. SSO-Prozesse sind vielfältig, manchmal komplex, und das Design der Anwendung bietet das Beste, um diese Arten von Verbindungen aufzunehmen. Einige Setups erfordern jedoch eine zusätzliche Fehlerbehebung.
Manchmal leitet der SAML-Prozess nicht zum ursprünglich angeforderten Pfad zurück, oder die endgültige Umleitung erfolgt zu einem Host, der sich von dem unterscheidet, was in der Adobe Experience Manager Desktop-App konfiguriert wurde. So überprüfen Sie, ob dies nicht der Fall ist:
  1. Öffnen Sie einen Webbrowser.
  2. Geben Sie die URL <AEM host>/content/dam.json in die Adressleiste ein.
    Ersetzen Sie <AEM host> dies beispielsweise durch die Zielgruppe- Adobe Experience Manager Instanz http://localhost:4502/content/dam.json .
  3. Log in to the Adobe Experience Manager instance.
  4. Wenn die Anmeldung abgeschlossen ist, sehen Sie sich die aktuelle Adresse des Browsers in der Adressleiste an. Er sollte exakt mit der URL übereinstimmen, die ursprünglich eingegeben wurde.
  5. Überprüfen Sie außerdem, ob alle zuvor /content/dam.json festgelegten Werte mit dem in den Einstellungen der Adobe Experience Manager Desktop-App konfigurierten Adobe Experience Manager Wert für die Zielgruppe übereinstimmen.
Der SAML-Anmeldeprozess funktioniert gemäß den oben genannten Schritten korrekt, aber die Benutzer können sich trotzdem nicht anmelden
Das Fenster innerhalb der Adobe Experience Manager Desktop-App, in dem der Anmeldevorgang angezeigt wird, ist lediglich ein Webbrowser, in dem die Webbenutzeroberfläche Adobe Experience Manager der Instanz der Zielgruppe angezeigt wird:
  • 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, Ansicht werden. So sehen Sie diese Informationen:
  1. Befolgen Sie die Anweisungen zum Starten der Anwendung im Debug-Modus .
  2. Reproduzieren Sie den Anmeldeversuch.
  3. Navigieren Sie zum Protokollverzeichnis der Anwendung
  4. Für Windows:
    1. Öffnen Sie "aembegleitonlog.txt".
    2. Suchen Sie nach Meldungen, die mit "Login-Browser-Adresse geändert zu"beginnen. Diese Einträge enthalten auch die URL, die die Anwendung geladen hat.
    Mac:
    1. com.adobe.aem.desktop-nnnnnnnn-nnnnnn.log , wobei das n durch die Nummern ersetzt wird, die im neuesten Dateinamen stehen.
    2. Suchen Sie nach Meldungen, die mit "loaded frame"beginnen. Diese Einträge enthalten auch die URL, die die Anwendung 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 SSL-Konfiguration

Die Bibliotheken, die das AEM-Desktop-Programm zur HTTP-Kommunikation nutzt, setzen auf strikte SSL-Durchsetzung. Mitunter kann zwar über einen Browser eine Verbindung erfolgreich hergestellt werden, aber nicht über das AEM-Desktop-Programm. 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 AEM Desktop für die HTTP-Kommunikation verwendet, verwenden eine strikte SSL-Durchsetzung. Es kann also Fälle geben, in denen SSL-Verbindungen, die über einen Browser erfolgreich sind, mit der Adobe Experience Manager Desktop-App fehlschlagen. Dies ist gut, da es die korrekte Konfiguration von SSL fördert und die Sicherheit erhöht, aber frustrierend sein kann, 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 beim Bereitstellen seiner URL überprüfen.
Als vorübergehende Maßnahme ist es möglich, die strikte SSL-Durchsetzung in Adobe Experience Manager Desktop-Apps zu deaktivieren. Dies ist keine empfohlene langfristige Lösung, da dadurch die Sicherheit verringert wird, indem die Ursache für falsch konfigurierte SSL ausgeblendet wird. So deaktivieren Sie die strikte Durchsetzung:
  1. Verwenden Sie den Editor Ihrer Wahl, um die JavaScript-Konfigurationsdatei der Anwendung zu bearbeiten, die (standardmäßig) an den folgenden Speicherorten (je nach Betriebssystem) zu finden ist:
    Unter Mac OS: /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:
    ...
    "assetRepository": {
        "options": {
    ...
    
    
  3. Ändern Sie den Abschnitt, indem Sie "strictSSL": false wie folgt hinzufügen:
    ...
    "assetRepository": {
        "options": {
            "strictSSL": false,
    ...
    
    
  4. Speichern Sie die Datei und starten Sie die Adobe Experience Manager Desktop-App neu.

Das Programm reagiert nicht

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.

Benötigen Sie zusätzliche Hilfe mit der Experience Manager Desktop-App

Erstellen Sie ein Jira-Ticket mit den folgenden Informationen:
  • Verwenden Sie DAM - Companion App als Component.
  • Ausführliche Schritte zum Reproduzieren des Problems in Description.
  • Protokolle auf DEBUG-Ebene, die beim Reproduzieren des Problems erfasst wurden.
  • Target AEM-Version.
  • Betriebssystemversion.
  • Adobe Experience Manager Desktop-App-Version. Informationen zur App-Version finden Sie unter Suchen der Desktop-App-Version .