[AEM Assets]{class="badge positive" title="Gilt für AEM Assets)."}
Problembehandlung in Dynamic Media troubleshooting-dynamic-media-scene-mode
Dieses Thema enthält Anleitungen zur Fehlerbehebung bei Dynamic Media, einschließlich häufiger Probleme, wahrscheinlicher Ursachen und allgemeiner Ansätze zu ihrer Behebung. Mit Dynamic Media können Sie Rich-Media-Assets, z. B. Bilder, Videos und interaktive Erlebnisse, skaliert erstellen, verwalten und bereitstellen sowie Inhalte an verschiedene Geräte, Bildschirmgrößen und Anzeigebedingungen anpassen. Da sich die Fehlerbehebung auf die Asset-Verarbeitung, -Bereitstellung und das Rendering über viele Umgebungen erstreckt, muss in der Regel isoliert werden, ob ein Problem bei der Erfassung, Aktivierung oder Bereitstellung von Assets auftritt.
Allgemeine Problemkategorien in Dynamic Media
Die meisten Probleme mit Dynamic Media lassen sich in eine kleine Anzahl von Kategorien unterteilen. Die Identifizierung der ersten Kategorie grenzt die Untersuchung ein und beschleunigt die Lösung:
- Fehler beim Hochladen und Verarbeiten von Assets - Assets, die nicht importiert werden, keine Ausgabedarstellungen generieren oder in einem Verarbeitungsstatus hängen bleiben.
- Aktivierungs- und Veröffentlichungsprobleme - Assets, die erfolgreich verarbeitet werden, aber nicht auf der Bereitstellungsebene verfügbar werden.
- Bereitstellungs- und Rendering - Bilder oder Videos, die nicht geladen, falsch angezeigt oder in den falschen Abmessungen oder der falschen Qualität bereitgestellt werden.
- Viewer- und Einbettungsprobleme - Interaktive Viewer, Video-Player oder eingebettete Erlebnisse, die nicht wie erwartet initialisiert werden oder sich nicht wie erwartet verhalten.
- Konfigurations- und Verbindungsprobleme - falsche Service-Einstellungen, Anmeldeinformationen oder Netzwerkbedingungen, die die Kommunikation zwischen der Authoring-Umgebung und dem Versand-Service unterbrechen.
Allgemeiner Ansatz zur Fehlerbehebung
Ein strukturierter Ansatz löst die meisten Dynamic Media-Probleme zuverlässiger als „Trial and Error“. Führen Sie die folgenden Schritte in der richtigen Reihenfolge aus:
- Bestätigen Sie, dass das Asset ordnungsgemäß verarbeitet wurde. Stellen Sie sicher, dass das hochgeladene Quell-Asset die erwarteten Ausgabedarstellungen generiert hat, da Fehler bei Bereitstellung und Rendering oft auf eine unvollständige Verarbeitung zurückgehen.
- Überprüfen des Aktivierungsstatus. Stellen Sie sicher, dass das Asset für den Bereitstellungs-Service veröffentlicht oder aktiviert wurde, da Assets, die beim Authoring korrekt angezeigt werden, für Endbenutzer möglicherweise weiterhin nicht verfügbar sind, wenn die Aktivierung nicht abgeschlossen wurde.
- Versand-URLs und Rendering-Parameter überprüfen. Vergewissern Sie sich, dass die Versand-URLs korrekt sind und dass alle Größen-, Format- oder Qualitätsparameter der gewünschten Ausgabe entsprechen.
- Isolieren Sie die Umgebung. Stellen Sie fest, ob das Problem beim Authoring, beim Bereitstellungs-Service oder im Client-Browser auftritt, da dies die Ursache des Fehlers ist.
- Überprüfen Sie die Konfiguration und Konnektivität. Validieren Sie Service-Einstellungen, Anmeldeinformationen und die Netzwerkverbindung zwischen der Authoring-Umgebung und dem Dynamic Media-Bereitstellungs-Service.
Wo typische Probleme auftreten
Wenn Sie die typischen Fehlerursachen verstehen, können Sie die Untersuchung zielgerichtet durchführen:
- Während der Aufnahme verhindern nicht unterstützte Dateiformate, beschädigte Quelldateien oder unterbrochene Uploads in der Regel eine erfolgreiche Verarbeitung.
- Bei Aktivierung führt eine unvollständige oder verzögerte Veröffentlichung dazu, dass Assets in der Bereitstellungsebene fehlen, selbst wenn sie in der Autorenumgebung vorhanden sind.
- Während des Versands führen Zwischenspeicherung, falsche URLs oder falsch konfigurierte Parameter dazu, dass Assets langsam, falsch oder gar nicht geladen werden.
Durch die Bestätigung der einzelnen Phasen nacheinander - Verarbeitung, Aktivierung und Versand - können Sie die Grundursache eines Dynamic Media-Problems effizient isolieren und die entsprechende Lösung anwenden.
Neue Konfiguration für Dynamic Media new-dm-config
Eine neue Dynamic Media (DM)- verbindet Adobe Experience Manager Assets mit Dynamic Media, sodass Bilder, Videos und andere Rich-Media-Inhalte in großem Umfang verarbeitet, optimiert und bereitgestellt werden können. Dynamic Media ermöglicht die dynamische Generierung von Ausgabedarstellungen, die responsive Bildbereitstellung, interaktive Viewer und das Streaming von Videos aus einem einzigen primären Asset, wodurch die Notwendigkeit verringert wird, mehrere vorgerenderte Varianten zu speichern und zu verwalten.
Zweck und Umfang der Fehlerbehebung
Durch das Einrichten einer neuen Dynamic Media-Konfiguration wird die Verbindung zwischen Ihrer AEM Assets-Umgebung und dem Dynamic Media-Service hergestellt, sodass in AEM hochgeladene Assets synchronisiert, verarbeitet und für eine optimierte Bereitstellung verfügbar gemacht werden. Eine korrekt abgeschlossene Konfiguration ist erforderlich, bevor Dynamic Media-Funktionen wie intelligente Bildbearbeitung, dynamische Ausgabedarstellungen und Viewer-Einbettungen erwartungsgemäß funktionieren.
Konfigurationsprobleme treten in der Regel auf, wenn Assets nicht synchronisiert werden, Ausgabedarstellungen nicht generiert werden oder Bereitstellungs-URLs nicht aufgelöst werden. Da diese Probleme in der Regel von unvollständigen oder falsch angewendeten Konfigurationseinstellungen herrühren, ist die Überprüfung der Konfiguration der empfohlene erste Schritt zur Diagnose.
Eine schrittweise Anleitung zur Diagnose und Lösung dieser Probleme finden Sie unter Fehlerbehebung bei einer neuen Dynamic Media-Konfiguration.
Allgemein (alle Assets) general-all-assets
Die folgenden Best Practices gelten für alle Asset-Typen. Die Anwendung dieser Richtlinien verbessert konsistent die Organisation, Auffindbarkeit und langfristige Wartbarkeit, unabhängig von der spezifischen Art des Assets, mit dem Sie arbeiten.
Benennung und Organisation
Konsistente Benennung und Struktur bilden die Grundlage für verwaltbare Assets. Zu den wichtigsten Best Practices gehören:
- Verwenden Sie klare, beschreibende Namen. Benennen Sie die einzelnen Assets nach ihrem Zweck oder Inhalt, anstatt generische Kennzeichnungen zu verwenden. Dadurch wird sichergestellt, dass Assets auch bei einem Wachstum eines Projekts auf einen Blick identifizierbar bleiben und später durchsucht werden können.
- Nehmen Sie eine konsistente Namenskonvention an. Die Anwendung derselben Groß- und Kleinschreibung, Trennzeichen und Präfixe auf alle Assets verringert die Verwirrung und macht die automatisierte Verarbeitung und Sortierung zuverlässiger.
- Gruppieren Sie verwandte Assets. Wenn Sie Assets in logischen Ordnern oder Kategorien organisieren, können Sie große Sammlungen navigieren und die Team-Mitglieder schnell finden, was sie benötigen.
Wiederverwendung und Effizienz
Die Wiederverwendung vorhandener Assets ist effizienter als ihre Neuerstellung und hilft, die visuelle und funktionale Konsistenz zu wahren. Zu den empfohlenen Ansätzen gehören:
- Prüfen Sie auf vorhandene Assets, bevor Sie neue erstellen. Dies vermeidet Duplizierungen, spart Zeit und verhindert die Anhäufung redundanter Dateien.
- Bevorzugen Sie freigegebene oder wiederverwendbare Assets bei denen dasselbe Element an mehreren Stellen auftritt. Durch die Zentralisierung einer einzigen Quelle werden Aktualisierungen überall dort eingesetzt, wo das Asset verwendet wird, anstatt dass Änderungen an vielen Stellen erforderlich sind.
Wartung und Qualität
Gut gepflegte Anlagen bleiben langfristig nutzbar und reduzieren technische Schulden. Die praktischen Schritte umfassen:
- Entfernen Sie nicht verwendete Assets regelmäßig. Durch das Löschen von Assets, die nicht mehr referenziert werden, bleibt die Sammlung schlank und leichter zu verwalten.
- Assets optimiert halten. Die Verwendung von Assets mit angemessener Größe und Formatierung verbessert die Leistung und reduziert unnötigen Overhead.
- Dokument mit wichtigen Details. Durch die Aufzeichnung des Zwecks, der Quelle oder etwaiger Nutzungshinweise eines Assets können aktuelle und zukünftige Team-Mitglieder verstehen, wie und wo jedes Asset verwendet werden soll.
Durch Befolgen dieser allgemeinen Best Practices wird eine zuverlässige Grundlage geschaffen, die auf jeden bestimmten Asset-Typ übertragen wird. So wird das Erstellen, Aktualisieren und Verwalten einzelner Assets erleichtert.
Asset-Synchronisierungsstatus-Eigenschaften asset-synchronization-status-properties
Vier Asset-Eigenschaften bestätigen die erfolgreiche Synchronisierung eines Assets von Adobe Experience Manager (AEM mit Dynamic Media: dam:scene7ID, dam:scene7FileStatus, dam:scene7File und dam:lastSyncStatus. Überprüfen Sie diese Eigenschaften direkt in CRXDE Lite, der browserbasierten Entwicklungsumgebung, die zum Überprüfen der Knotenstruktur des AEM Content Repository (JCR) verwendet wird. Jede Eigenschaft liefert ein spezifisches Signal zum Status der Verknüpfung des Assets mit Dynamic Media.
Überprüfen der Synchronisierung in CRXDE Lite
Die folgenden Asset-Eigenschaften werden in CRXDE Lite überprüft, um zu bestätigen, dass das Asset erfolgreich von Adobe Experience Manager mit Dynamic Media synchronisiert wurde:
<object_node>/jcr:content/metadata/dam:scene7IDa|364266<object_node>/jcr:content/metadata/dam:scene7FileStatus<object_node>/jcr:content/metadata/dam:scene7Filedam:scene7File-Eigenschaft, dass keine Dynamic Media-URL für das Asset generiert werden kann.<object_node>/jcr:content/dam:lastSyncStatus<error text><error text> identifiziert den spezifischen Fehler, der die Synchronisierung verhindert hat.Warum diese Eigenschaften wichtig sind
Jede Eigenschaft dient als separater Checkpoint in der Asset-Bereitstellungs-Pipeline. Wenn Sie also alle vier Eigenschaften zusammen überprüfen, erhalten Sie einen vollständigen Überblick über den Synchronisierungsstatus eines Assets. Die dam:scene7ID- und dam:scene7File-Eigenschaften bestätigen, dass der Link und der Dateiverweis vorhanden sind, dam:scene7FileStatus bestätigen den Upload selbst, und dam:lastSyncStatus bestätigen, dass abhängige Artefakte - wie Rotationssets, Bildsets, Bildvorgaben, Viewer-Vorgaben und Imagemap-Aktualisierungen - korrekt synchronisiert wurden. Wenn ein Asset nicht wie erwartet in Dynamic Media bereitgestellt werden kann, können Sie direkt durch Überprüfen dieser Eigenschaften in CRXDE Lite isolieren, welche Phase des Prozesses (Verknüpfen, Hochladen oder Synchronisieren von Datensätzen) nicht abgeschlossen wurde.
Protokollierung der Synchronisierung synchronization-logging
Synchronisierungsfehler und -probleme werden in der error.log-Datei aufgezeichnet, die sich im /crx-quickstart/logs/ des Experience Manager-Serververzeichnisses befindet. Dieses Protokoll ist der primäre Referenzpunkt für die Diagnose von Problemen bei der Synchronisierung von Assets.
Die standardmäßige Protokollebene bietet genügend Details, um die Grundursache der meisten Synchronisierungsprobleme zu ermitteln. Für eine tiefere Untersuchung von schwieriger zu reproduzierenden Problemen können Admins die Protokollierungsintensität erhöhen, um auf das com.adobe.cq.dam.ips-Paket DEBUG. Die Protokollierung auf DEBUG-Ebene liefert detailliertere Diagnoseereignisse und erfasst zusätzlichen Kontext rund um den Synchronisierungsprozess, der nicht auf der Standardebene geschrieben wird.
So erhöhen Sie die Synchronisierungsprotokollierung nach DEBUG:
- Öffnen Sie die Sling-Konsole unter https://localhost:4502/system/console/slinglog.
- Suchen Sie eine Logger-Konfiguration für das
com.adobe.cq.dam.ips-Paket oder fügen Sie sie hinzu. - Setzen Sie die Protokollebene auf
DEBUG. - Synchronisierungsprobleme reproduzieren und dann die zusätzlichen Details überprüfen, die in
/crx-quickstart/logs/inerror.loggeschrieben wurden.
Durch diese Erhöhung der Protokollebene werden weitere Informationen zum Synchronisierungs-Workflow erfasst, sodass die zugrunde liegende Ursache leichter isoliert werden kann, wenn die standardmäßige Protokollierung nicht genügend Details bereitstellt.
Versionskontrolle version-control
Beim Ersetzen eines bestehenden Dynamic Media-Assets, das denselben und hat, bietet Adobe Experience Manager zwei verschiedene Bearbeitungsoptionen: Beibehalten oder Ersetzen des vorhandenen Assets. Die Versionskontrolle bestimmt, welches dieser Verhaltensweisen beim Hochladen zutrifft.
-
Beibehalten beider Assets: Die neu hochgeladene Datei wird unter einem eindeutigen Namen“ gespeichert sodass die veröffentlichte Asset-URL eindeutig bleibt. Beispiel:
image.jpgist das ursprüngliche Asset undimage1.jpgist das neu hochgeladene Asset. Da jede Datei einen eigenen Namen behält, bleiben beide Assets unabhängig voneinander adressierbar und lieferbar, sodass der neue Upload das Original nicht überschreiben kann. -
Erstellen einer Version: Erstellen einer Version wird Dynamic nicht unterstützt. Daher hängt der neue Upload nicht an einen Versionsverlauf an. Stattdessen das neue Asset ersetzt das vorhandene Asset im Versand d. h. die zuvor veröffentlichte Datei wird ersetzt und der aktualisierte Inhalt wird an seiner Stelle bereitgestellt. Da keine frühere Version für die Bereitstellung beibehalten wird, ist die Ersetzung für das bereitgestellte Asset effektiv dauerhaft.
Bilder und Sets images-and-sets
Beheben Sie häufige Probleme mit Bildern und Sets mithilfe der unten stehenden Anleitungen zur Fehlerbehebung. Bild- und Set-Fehler rühren in der Regel von nicht unterstützten Formaten, unvollständigen Uploads, falschen Namen, Cache-Konflikten oder Konfigurationskonflikten her. Das Ermitteln der Kategorie des Problems ist der zuverlässigste Weg zu einer schnellen Lösung, da die meisten Bild- und Set-Fehler in eine geringe Anzahl wiederkehrender Muster fallen.
Häufige Probleme mit Bildern und Sets
Zu den am häufigsten aufgetretenen Problemen mit Bildern und Sets gehören:
- Bilder werden nicht angezeigt - Ein fehlerhaftes, leeres oder fehlendes Bild weist häufig auf einen ungültigen Dateipfad, ein nicht unterstütztes Dateiformat oder einen fehlgeschlagenen Upload hin.
- Falsche oder veraltete Bilder - Wenn eine alte Version nach einer Aktualisierung angezeigt wird, ist die Ursache normalerweise zwischengespeicherte Inhalte, die nicht aktualisiert wurden.
- Sets werden nicht vollständig geladen - Ein partieller oder unvollständiger Satz resultiert normalerweise aus fehlenden Elementelementen, einer fehlerhaften Referenz oder einer unterbrochenen Synchronisierung.
- Formatierungs- oder Auflösungsprobleme - Verzerrte, gestreckte oder qualitativ minderwertige Bilder zeigen in der Regel auf Größe, Seitenverhältnis oder Auflösungseinstellungen, die nicht den Anforderungen entsprechen.
- Berechtigungs- oder Zugriffsfehler - Ein Bild oder Set, das nicht geladen werden kann, kann durch Zugriffsberechtigungen oder einen abgelaufenen Link eingeschränkt werden.
Schrittweise Fehlerbehebung
Führen Sie die folgenden Schritte der Reihe nach durch, da bei jedem Schritt eine gemeinsame Ursache ausgeschlossen wird, bevor Sie zu einer komplexeren Lösung übergehen:
- Überprüfen des Dateiformats und der Dateigröße. Bestätigen Sie, dass das Bild ein unterstütztes Format verwendet und innerhalb der zulässigen Größenbeschränkungen liegt. Dadurch wird sichergestellt, dass das System die Datei ohne Konvertierungsfehler rendern kann.
- Bestätigen Sie, dass der Upload abgeschlossen ist. Laden Sie alle fehlenden oder beschädigten Bilder erneut hoch, da unterbrochene Uploads eine der Hauptursachen für fehlerhafte Bilder sind.
- Löschen Sie den Cache und aktualisieren Sie. Das Löschen des Browser- oder Anwendungs-Caches erzwingt das Laden der neuesten Version und behebt Fälle, in denen ein veraltetes Bild angezeigt wird.
- Überprüfen Sie den Dateipfad und die Verweise. Stellen Sie sicher, dass alle Bilder vorhanden sind, und legen Sie Referenzpunkte auf einen gültigen vorhandenen Speicherort fest, da ein fehlerhafter Pfad das Laden des Bildes verhindert.
- Überprüfen Sie die Berechtigungen und Zugriffseinstellungen. Vergewissern Sie sich, dass auf das Bild oder Set zugegriffen werden kann und dass kein freigegebener Link abgelaufen ist.
- Testen in einer alternativen Umgebung. Laden Sie das Bild oder legen Sie es in einem anderen Browser, Gerät oder einer anderen Sitzung fest, um festzustellen, ob das Problem lokal und nicht systemisch auftritt.
Vermeiden von Bild- und Set-Fehlern
Um wiederkehrende Probleme zu reduzieren, wenden Sie diese vorbeugenden Maßnahmen an:
- Verwenden Sie konsistente, unterstützte Dateiformate und Benennungskonventionen für alle Bilder und Sets.
- Vergewissern Sie sich, dass jeder Upload vollständig abgeschlossen ist, bevor Sie fortfahren. Dadurch werden partielle oder beschädigte Dateien verhindert.
- Halten Sie Bildverweise und Set-Member synchron, sodass kein Member-Element fehlt oder verwaist ist.
- Aktualisieren Sie zwischengespeicherte Inhalte, nachdem Sie Aktualisierungen vorgenommen haben, um sicherzustellen, dass immer die aktuelle Version bereitgestellt wird.
Wenn das Problem nach Abschluss dieser Schritte zur Fehlerbehebung weiterhin besteht, eskalieren Sie das Problem an den Support mit Details zum jeweiligen Bild oder Set, zu den bereits versuchten Schritten und zu allen festgestellten Fehlermeldungen. Diese Informationen helfen, die Grundursache effizienter zu identifizieren.
Video video
Probleme mit der Videowiedergabe gehören zu den häufigsten technischen Problemen. Die meisten Probleme werden mit einigen standardmäßigen Fehlerbehebungsschritten behoben. Wenn das Video nicht geladen wird, eingefroren erscheint, ohne Ton abgespielt wird oder einen schwarzen Bildschirm anzeigt, verwenden Sie die unten stehenden Anweisungen, um das Problem zu identifizieren und zu beheben.
Häufige Ursachen für Bildprobleme
Die meisten Videoprobleme rühren von einer kleinen Anzahl vorhersehbarer Ursachen her. Wenn Sie die Ursache verstehen, können Sie die richtige Lösung anwenden:
- Unzureichende oder instabile Netzwerkverbindung - Streaming-Video erfordert konsistente Bandbreite. Eine schwache oder schwankende Verbindung führt zu Pufferung, Verzögerungen oder automatischen Qualitätsminderungen.
- Veralteter Browser oder Anwendung - Ältere Software unterstützt möglicherweise nicht aktuelle Videoformate oder Wiedergabestandards, was zu Fehlern oder leeren Bildschirmen führt.
- Beschädigter Cache oder Cookies - Gespeicherte temporäre Daten können mit neuen Videoinhalten in Konflikt stehen und das korrekte Laden verhindern.
- Browser-Erweiterungen oder Anzeigenblocker - Bestimmte Erweiterungen stören Video-Player, indem sie Skripte blockieren, die für die Wiedergabe erforderlich sind.
- Veraltete Grafiktreiber oder Hardware-Beschleunigungskonflikte - Dies sind häufige Ursachen für schwarze Bildschirme, unregelmäßige Wiedergabe oder Abstürze.
- Audio- oder Codec-Inkompatibilität - Fehlende oder nicht unterstützte Codecs können dazu führen, dass Videos ohne Ton wiedergegeben werden oder nicht vollständig gerendert werden können.
Schrittweise Videofehlerbehebung
Führen Sie diese Schritte in der richtigen Reihenfolge aus. Jeder Schritt behandelt zunächst die wahrscheinlichste Ursache, sodass das Problem oft behoben wird, bevor die späteren Schritte erreicht werden:
- Überprüfen Sie Ihre Internetverbindung. Vergewissern Sie sich, dass andere Websites und Dienste normal geladen werden. Eine langsame oder abbrechende Verbindung ist die Hauptursache für Pufferung und Wiedergabefehler. Wechseln Sie nach Möglichkeit zu einer Kabelverbindung oder nähern Sie sich Ihrem Wireless-Router an.
- Aktualisieren Sie die Seite und starten Sie die Wiedergabe neu. Beim erneuten Laden wird ein vorübergehender Ladefehler behoben und die Verbindung zur Videoquelle wieder hergestellt.
- Aktualisieren des Browsers oder der Anwendung. Die Ausführung der neuesten Version gewährleistet die Kompatibilität mit aktuellen Videoformaten und Wiedergabefunktionen.
- Löschen Sie den Cache und die Cookies. Durch Entfernen gespeicherter temporärer Daten werden Konflikte vermieden, die das Laden von Videos verhindern. Starten Sie den Browser anschließend neu.
- Deaktivieren von Erweiterungen und Anzeigenblockern. Schalten Sie diese vorübergehend aus, um festzustellen, ob einer von ihnen den Video-Player blockiert. Wenn das Video funktioniert, aktivieren Sie Erweiterungen einzeln wieder, um die Quelle zu identifizieren.
- Verringern Sie die Videoqualität. Wenn das Video wiederholt abgespielt wird, es jedoch zum Anhalten kommt, verringert die Auswahl einer niedrigeren Auflösung die erforderliche Bandbreite und sorgt für eine weichere Wiedergabe.
- Grafiktreiber aktualisieren oder Hardwarebeschleunigung umschalten. Veraltete Treiber verursachen visuelle Störungen und schwarze Bildschirme. Wenn die Probleme weiterhin bestehen, können Rendering-Probleme häufig durch Deaktivieren der Hardwarebeschleunigung in den Browser-Einstellungen behoben werden.
- Verwenden Sie einen anderen Browser oder ein anderes Gerät. Wenn das Video an einer anderen Stelle abgespielt wird, hängt das Problem vom ursprünglichen Browser oder Gerät ab und nicht von der Videoquelle selbst.
Wann weitere Unterstützung angefordert werden sollte
Wenn die Videoprobleme nach Abschluss der oben genannten Schritte weiterhin bestehen, kann das Problem von der Videoquelle oder einer tieferen Systemkonfiguration herrühren. Beachten Sie in diesem Fall die folgenden Details, bevor Sie sich an den Support wenden, da sie die Diagnose beschleunigen:
- Die genaue Fehlermeldung oder eine Beschreibung dessen, was auf dem Bildschirm angezeigt wird
- Der Name und die Version des Browsers oder des Programms
- Betriebssystem und Gerätetyp
- Ob das Problem bei allen oder nur bei bestimmten Videos auftritt
Die Bereitstellung dieser Informationen ermöglicht es dem Support, das Problem zu reproduzieren und festzustellen, ob die Ursache lokal auf Ihrem Gerät liegt oder den Videodienst selbst betrifft.
Viewer viewers
Bei Betrachtern können Probleme mit der Wiedergabe, dem Laden, der Anzeige und der Kompatibilität auftreten, die dazu führen, dass Inhalte nicht korrekt wiedergegeben werden. Die folgende Anleitung zur Fehlerbehebung behandelt die häufigsten Viewer-Probleme und bietet eine schrittweise Anleitung zu ihrer Behebung.
Häufige Probleme mit dem Viewer
Viewer-Probleme lassen sich in der Regel in einige wenige Kategorien einteilen:
- Inhalt kann nicht geladen werden - Der Viewer wird geöffnet, zeigt aber anstelle des erwarteten Inhalts einen leeren Bildschirm, ein Rotationswerkzeug oder eine Fehlermeldung an.
- Wiedergabe- oder Renderfehler - Der Inhalt wird teilweise geladen, eingefroren oder falsch angezeigt.
- Kompatibilitätsprobleme - Der Viewer funktioniert in einem bestimmten Browser, Gerät oder Betriebssystem nicht wie erwartet.
- Leistungsprobleme - langsames Laden, Verzögerung oder Nichtreagieren während der Verwendung.
Die meisten Viewer-Probleme rühren von einer kleinen Anzahl zugrunde liegender Ursachen her, einschließlich veralteter Software, Browser-Cache-Konflikten, blockierten Skripten, instabilen Netzwerkverbindungen oder nicht unterstützten Dateiformaten. Die Bestimmung der anzuwendenden Kategorie ist der erste Schritt zu einer schnellen Lösung.
Schritte zur Fehlerbehebung
Führen Sie die folgenden Schritte der Reihe nach aus, da die früheren Schritte die häufigsten Probleme lösen:
- Aktualisieren Sie den Viewer und laden Sie ihn neu. Ein vorübergehender Ladefehler wird oft behoben, indem die Seite neu geladen oder der Viewer erneut geöffnet wird.
- Löschen Sie den Browser-Cache und die Cookies. Veraltete zwischengespeicherte Daten sind eine häufige Ursache für leere Bildschirme und veraltete Inhalte, sodass das Löschen den Viewer zwingt, neue Ressourcen neu zu laden.
- Aktualisieren des Browsers oder der Anwendung. Die Ausführung der neuesten Version stellt die Kompatibilität mit den Rendering-Anforderungen des Viewers sicher.
- Verwenden Sie einen anderen Browser oder ein anderes Gerät. Dadurch wird isoliert, ob das Problem spezifisch für eine Umgebung ist oder sich auf den Inhalt selbst auswirkt.
- Überprüfen Sie die Netzwerkverbindung. Eine instabile oder eingeschränkte Verbindung verhindert, dass der Viewer Inhalte abruft, sodass durch die Bestätigung einer stabilen Verbindung viele Ladefehler behoben werden können.
- Konfliktende Erweiterungen oder Blocker deaktivieren. Anzeigenblocker, Skriptblockierer und Datenschutzerweiterungen können die Viewer-Funktionalität beeinträchtigen. Durch die vorübergehende Deaktivierung dieser Blocker lässt sich feststellen, ob sie die Ursache sind.
Wenn das Problem nach Abschluss dieser Schritte weiterhin besteht, kann das Problem von der Inhaltsquelle oder der Viewer-Konfiguration und nicht von der lokalen Umgebung ausgehen. Möglicherweise ist weitere Unterstützung für die Diagnose erforderlich.
Problem: Viewer-Vorgaben werden nicht veröffentlicht viewers-not-published
Problem: Viewer-Vorgaben wurden nicht veröffentlicht (aktiviert), was verhindert, dass Dynamic Media-Viewer für bereitgestellte Assets korrekt dargestellt werden. Um dies zu beheben, müssen Sie den Aktivierungsstatus bestätigen und nicht aktivierte Vorgaben veröffentlichen.
Vorgehensweise beim Debuggen: Überprüfen des Aktivierungsstatus der Viewer-Vorgabe
Führen Sie die folgenden Schritte aus, um zu ermitteln, warum Viewer-Vorgaben nicht veröffentlicht werden:
-
Wechseln Sie zur Diagnoseseite des Beispiel-Managers:
https://localhost:4502/libs/dam/gui/content/s7dam/samplemanager/samplemanager.html. -
Beobachten Sie die berechneten Werte, die von der Diagnoseseite gemeldet werden. Wenn das System ordnungsgemäß funktioniert, zeigt die Diagnoseseite Folgendes an:
_DMSAMPLE status: 0 unsyced assets - activation not necessary _OOTB status: 0 unsyced assets - 0 unactivated assets. Hier bezieht sich DMSAMPLE-Status auf Dynamic Media-Beispiel-Assets und OOTB-Status auf die vordefinierten Viewer-Assets. Die Zählung von 0 nicht synchronisierten Assets und 0 nicht aktivierten Assets bestätigt, dass alles erwartungsgemäß synchronisiert und aktiviert wurde.note NOTE Nach der Konfiguration der Dynamic Media Cloud-Einstellungen kann es bis zu 10 Minuten, bis die Assets im Viewer synchronisiert werden. Wenn die Anzahl noch nicht null ist, warten Sie, bis dieses Synchronisierungsfenster abgeschlossen ist, bevor Sie mit der Fehlerbehebung fortfahren. -
Wenn weiterhin nicht aktivierte Assets vorhanden sind, bedeutet dies, dass eine oder mehrere Viewer-Vorgaben nie veröffentlicht wurden. Klicken Sie auf eine der Alle nicht aktivierten Assets auflisten-Schaltflächen, um die Details zu den Assets anzuzeigen, die weiterhin aktiviert werden müssen.
Lösung: Veröffentlichen der Viewer-Vorgaben
Da nicht aktivierte Assets aus Vorgaben resultieren, die nicht veröffentlicht wurden, besteht die Lösung darin, sie explizit zu veröffentlichen:
- Navigieren Sie in den Admin Tools zur Viewer-Vorgabeliste:
https://localhost:4502/libs/dam/gui/content/s7dam/samplemanager/samplemanager.html. - Wählen Sie alle Viewer-Vorgaben aus und klicken Sie auf Veröffentlichen. Bei der Veröffentlichung werden die Voreinstellungen aktiviert, sodass die zugehörigen Assets synchronisiert und für die Bereitstellung verfügbar gemacht werden. Dadurch wird der Status „Nicht aktiviert“ entfernt.
- Navigieren Sie zurück zum Beispiel-Manager und bestätigen Sie, dass die Anzahl der nicht aktivierten Assets jetzt null ist. Eine Nullanzahl stellt sicher, dass die Viewer-Vorgaben erfolgreich veröffentlicht wurden und das Problem behoben wurde.
Problem: Für das Bildmaterial der Viewer-Vorgabe wird für eine Vorschau in den Asset-Details oder für „URL kopieren“/„Code einbetten“ der Fehler 404 zurückgegeben viewer-preset-404
Debugging: Überprüfen des Synchronisierungsstatus und direktes Anfordern von Bildmaterial
Führen Sie in CRXDE Lite (der Entwicklerkonsole für das Adobe Experience Manager-Repository) die folgenden Schritte aus:
-
Navigieren Sie zum
<sync-folder>/_CSS/_OOTB-Ordner im Synchronisierungsordner für Dynamic Media (z. B./content/dam/_CSS/_OOTB). -
Suchen Sie den Metadaten-Knoten des problematischen Assets (z. B.
<sync-folder>/_CSS/_OOTB/CarouselDotsLeftButton_dark_sprite.png/jcr:content/metadata/). -
Prüfen Sie, ob die Eigenschaften
dam:scene7*vorhanden sind. Wenn das Asset erfolgreich synchronisiert und veröffentlicht wurde, wird diedam:scene7FileStatus-Eigenschaft auf "PublishComplete“ festgelegt wodurch bestätigt wird, dass das Asset synchronisiert und erfolgreich veröffentlicht wurde. Wenn diesedam:scene7*nicht vorhanden sind, hat das Asset den Synchronisierungs- und Veröffentlichungs-Workflow nie abgeschlossen. Dies ist die zugrunde liegende Ursache für den 404. -
Versuchen Sie, das Bildmaterial direkt aus Dynamic Media anzufordern, indem Sie die Werte der folgenden Eigenschaften und Zeichenfolgenliterale verketten. Eine erfolgreiche direkte Anfrage bestätigt, dass das Bildmaterial auf dem Dynamic Media-Server vorhanden ist. Eine 404 bestätigt, dass es nie veröffentlicht wurde:
dam:scene7Domain"is/content"dam:scene7Folder<asset-name>
Beispiel:https://<server>/is/content/myfolder/_CSS/_OOTB/CarouselDotsLeftButton_dark_sprite.png
Lösung: Neustarten des Kopier- und Synchronisierungsprozesses
Wenn die direkte Anfrage fehlschlägt oder die dam:scene7* fehlen, wurden die Beispiel-Assets oder das Bildmaterial der Viewer-Vorgabe nicht synchronisiert oder veröffentlicht. Starten Sie daher den gesamten Kopier-/Synchronisierungsvorgang neu:
- Gehen Sie zu CRXDE Lite.
- Löschen Sie
<sync-folder>/_CSS/_OOTB. Dadurch wird der veraltete, nicht synchronisierte Grafikordner entfernt, damit er sauber neu generiert werden kann. - Navigieren Sie zum CRX Package Manager (das Repository Package Installation Tool):
https://localhost:4502/crx/packmgr/. - Suchen Sie das Viewer-Paket in der Liste; es beginnt mit
cq-dam-scene7-viewers-content. - Wählen Sie Neu installieren aus. Bei der Neuinstallation dieses Pakets werden die standardmäßig vorhandenen Inhalte der Viewer-Vorgabe wiederhergestellt.
- Navigieren Sie zur Seite für die Dynamic Media-Konfiguration und klicken Sie auf „Bearbeiten“, um das Konfigurationsdialogfeld für Ihre Dynamic Media S7-Konfiguration zu öffnen.
- Nehmen Sie keine Änderungen vor und klicken Sie dann auf Speichern.
Durch diese Speicheraktion wird die Konfigurationslogik erneut Trigger, da Experience Manager beim erneuten Speichern der Dynamic Media-S7-Konfiguration die Beispiel-Assets, die Viewer-Vorgabe-CSS und das Bildmaterial neu erstellen und synchronisieren muss, um den 404-Fehler zu beheben.
Problem: Fehler #2046 beim Öffnen der Registerkarte „Bandbreite und Speicher“ error-2046-bandwidth-storage
Ursache: Abgelaufenes Signaturzertifikat in einer zwischengespeicherten RSL
Fehler #2046 wird angezeigt, wenn Benutzer die Registerkarte Bandbreite und Speicher im Desktop-Programm Dynamic Media Classic (Scene7) öffnen, einem Asset-Management-Tool von Adobe, das zum Hosten, Verwalten und Bereitstellen von Rich-Media verwendet wird. Der Fehler wird durch ein abgelaufenes digitales Signaturzertifikat verursacht, das in einer zwischengespeicherten RSL (Runtime Shared Library) enthalten ist vom Adobe AIR (Adobe Integrated Runtime)- verwendet wird.
Der Fehler wird während der Erneuten Überprüfung des lokalen Zertifikats ausgelöst: Wenn die Anwendung die zwischengespeicherte RSL lädt, versucht sie, das Signaturzertifikat zu überprüfen. Da dieses zwischengespeicherte Zertifikat abgelaufen ist, schlägt die Überprüfung fehl und die #2046 wird ausgelöst. Da das Problem in der lokal gespeicherten Bibliothek und nicht in der Anwendung selbst liegt, besteht die Lösung darin, die veralteten zwischengespeicherten Dateien zu entfernen, damit eine aktuelle, gültig signierte RSL abgerufen werden kann.
Lösung: Löschen Sie den lokalen Adobe AIR-Cache
Löschen Sie den lokalen Cache, um Adobe AIR zum Herunterladen der aktualisierten RSL (Runtime Shared Library) zu. Durch das Löschen der veralteten zwischengespeicherten Dateien wird das abgelaufene Zertifikat entfernt. Beim nächsten Start lädt Adobe AIR eine neu signierte RSL herunter, die die lokale Zertifikatsüberprüfung erfolgreich durchläuft, wodurch der Fehler behoben wird.
macOS
- Gehen Sie zu:
~/Library/Caches/Adobe/Flash Player/AssetCache/<folder>/ - Löschen Sie alle
.swzund.heuDateien.
Windows
- Gehen Sie zu:
%APPDATA%\Adobe\Flash Player\AssetCache\<folder>\ - Löschen Sie alle Dateien im Ordner .
Starten Sie die Anwendung neu, nachdem Sie den Cache gelöscht haben. Öffnen Sie beim Neustart erneut die Registerkarte Bandbreite und Speicher, um zu bestätigen, dass die #2046 nicht mehr angezeigt wird. Dies bedeutet, dass die aktualisierte RSL erfolgreich heruntergeladen und validiert wurde.
Problem: Die Bildvorschau wird beim Bearbeiten von Viewer-Vorgaben nicht geladen image-preview-not-loading
Lösung
Das Bildvorschau kann beim Erstellen von Viewer-Vorgaben nicht geladen werden, wenn veraltete Beispielinhalte und zwischengespeicherte Viewer-Vorgabenartefakte das Rendern der Vorschau verhindern. Löschen Sie diese Artefakte und erstellen Sie die Dynamic Media-Konfiguration neu, um die Vorschau wiederherzustellen.
-
Klicken Sie in Experience Manager auf das Adobe Experience Manager-Logo, um auf die globale Navigationskonsole zuzugreifen, und dann auf Tools > Allgemein > CRXDE Lite.
-
Navigieren Sie in der linken Leiste zum Ordner mit Beispielinhalten am folgenden Speicherort:
/content/dam/_DMSAMPLE -
Löschen Sie den Ordner
_DMSAMPLE. Dadurch werden veraltete Beispielinhalte entfernt, die das korrekte Rendern der Vorschau blockieren können. -
Navigieren Sie in der linken Leiste zum Ordner „Vorgaben“ am folgenden Speicherort:
/conf/global/settings/dam/dm/presets/viewer -
Löschen Sie den Ordner
viewer. Durch Entfernen dieses Ordners werden zwischengespeicherte Viewer-Vorgabeneinstellungen gelöscht, sodass sie sauber neu generiert werden. -
Wählen Sie oben links auf der CRXDE Lite-Seite die Option Alle speichern aus, um die Löschungen in das Repository zu übertragen.
-
Klicken Sie links oben auf der Seite „CRXDE Lite“ auf das Symbol Zurück zur Startseite.
-
Erstellen Sie erneut eine Dynamic Media-Konfiguration in Cloud Services. In diesem Schritt werden der Beispielinhalt und die entfernten Viewer-Vorgaben regeneriert, wodurch die Bildvorschau) beim Erstellen Viewer-Vorgaben wiederhergestellt wird.