Fehlerbehebung in Dynamic Media – Scene7-Modus

Das folgende Dokument beschreibt das Beheben von Fehlern mit Dynamic Media im Ausführungsmodus dynamicmedia_scene7.

Setup und Konfiguration

Stellen Sie sicher, dass Dynamic Media korrekt eingerichtet wurde, indem Sie folgende Schritte ausführen:

Beginn-up-Befehl enthält das Argument -r dynamicmedia_scene7 runmode.
Alle Cumulative Fix Packs für AEM 6.4 wurden vor den verfügbaren Feature Packs für Dynamic Media installiert.
Das optionale Feature Pack 18912 wurde installiert.

Dieses optionale Feature Pack dient zum FTP-Support oder wenn Sie Assets von Dynamic Media Classic nach Dynamic Media migrieren.
Navigieren Sie zur Cloud Services-Benutzeroberfläche und vergewissern Sie sich, dass das angegebene Konto unter Verfügbare Konfigurationen aufgeführt wird.
Stellen Sie sicher, dass der Replizierungsagenten Dynamic Media Asset Aktivierung (scene7) aktiviert ist.

Dieser Replizierungsagenten befindet sich unter Agenten im Autor.

Allgemein (alle Assets)

Die folgenden allgemeinen Tipps und Tricks gelten für alle Assets.

Eigenschaften des Synchronisierungsstatus von Elementen

Anhand der folgenden Asset-Eigenschaften können Sie in CRXDE Lite prüfen, ob Assets erfolgreich zwischen AEM und Dynamic Media synchronisiert wurden:

Eigenschaft	Beispiel	Beschreibung
`<object_node>/jcr:content/metadata/dam:scene7ID`	`a\|364266`	Allgemeiner Indikator dafür, dass der Knoten mit Dynamic Media verknüpft ist.
`<object_node>/jcr:content/metadata/dam:scene7FileStatus`	PublishComplete oder Fehlertext	Status des Hochladens der Assets in Dynamic Media.
`<object_node>/jcr:content/metadata/dam:scene7File`	`myCompany/myAssetID`	Muss angegeben werden, um URLs zu Remote-Assets von Dynamic Media zu generieren.
`<object_node>/jcr:content/dam:lastSyncStatus`	`success` oder `failed:<error text>`	Synchronisierungsstatus für Sets (Rotationssets, Bildsets usw.), Bildvorgaben, Viewer-Vorgaben oder Imagemap-Updates für ein Asset oder Bilder, die bearbeitet wurden.

Protokollierung der Synchronisierung

Synchronisierungsfehler und -probleme werden in der Datei error.log (AEM-Server-Verzeichnis/crx-quickstart/logs/) protokolliert. Es ist eine ausreichende Protokollierung verfügbar, um die Hauptursache der meisten Probleme zu ermitteln. Sie können jedoch die Protokollierung für DEBUG im com.adobe.cq.dam.ips-Paket über die Sling-Konsole (http://localhost:4502/system/console/slinglog) erhöhen, um weitere Informationen zu erfassen.

Verschieben, Kopieren oder Löschen

Führen Sie folgende Schritte aus, bevor Sie einen Verschiebe-, Kopier- oder Löschvorgang ausführen:

Prüfen Sie für Bilder und Videos, ob der Wert <object_node>/jcr:content/metadata/dam:scene7ID vorhanden ist, bevor Sie Verschiebe-, Kopier- oder Löschvorgänge ausführen.
Prüfen Sie für Bild- und Viewer-Vorgaben, ob der Wert https://<server>/crx/de/index.jsp#/etc/dam/presets/viewer/testpreset/jcr%3Acontent/metadata vorhanden ist, bevor Sie Verschiebe-, Kopier- oder Löschvorgänge ausführen.
Wenn der obige Metadatenwert fehlt, müssen Sie Assets erneut hochladen, bevor Sie Verschiebe-, Kopier- oder Löschvorgänge ausführen.

Versionskontrolle

Beim Ersetzen eines vorhandenen Dynamic Media-Assets (gleicher Name und Speicherort) haben Sie die Möglichkeit, beide Assets beizubehalten oder eine Version zu ersetzen oder zu erstellen:

Durch Beibehalten beider Werte wird ein neues Asset mit einem eindeutigen Namen für die URL des veröffentlichten Assets erstellt. Beispiel: image.jpg ist das ursprüngliche Asset und image1.jpg ist das neu hochgeladene Asset.
Das Erstellen einer Version wird im Scene7-Modus von Dynamic Media nicht unterstützt. Die neue Version ersetzt das vorhandene Asset in Versand.

Bilder und Sets

Falls Sie Probleme mit Bildern und Sets haben, sehen Sie sich die folgende Anleitung zur Fehlerbehebung an.

Problem	Debugging	Lösung
Kein Zugriff auf Schaltfläche „URL kopieren“/„Code einbetten“ in der Asset-Detailansicht	Öffnen Sie CRX/DE: Überprüfen Sie, ob die Vorgabe im JCR `/etc/dam/presets/viewer/<preset> has lastReplicationAction` definiert ist. Achtung: Dieser Pfad trifft zu, wenn Sie ein Upgrade von AEM 6.x auf 6.4 durchgeführt und sich gegen die Migration entschieden haben. Andernfalls ist der Ort `/conf/global/settings/dam/dm/presets/viewer`. Überprüfen Sie, ob das Asset im JCR unter „Metadaten“ für `dam:scene7FileStatus` den Wert `PublishComplete` aufweist.	Aktualisieren Sie die Seite/navigieren Sie zu einer anderen Seite und kehren Sie dann zurück (Seitenleisten-JSPs müssen neu kompiliert werden). Wenn dies das Problem nicht behebt: Veröffentlichen Sie das Asset. Laden Sie das Asset erneut hoch und veröffentlichen Sie es.
Asset-Wähler im Set-Editor hängt sich beim Laden auf	Bekanntes Problem, das in 6.4 behoben wird	Schließen Sie den Wähler und öffnen Sie ihn erneut.
Schaltfläche Auswählen ist nicht aktiv, nachdem ein Asset beim Bearbeiten eines Sets ausgewählt wurde	Bekanntes Problem, das in 6.4 behoben wird	Klicken Sie im Asset-Wähler zuerst auf einen anderen Ordner und kehren Sie dann zurück, um das Asset auszuwählen.
Karussell-Hotspot verschiebt sich nach dem Wechsel zwischen Folien	Prüfen Sie, ob alle Folien dieselbe Größe haben.	Verwenden Sie für das Karussell nur Bilder derselben Größe.
Bild wird im Viewer für Dynamic Media nicht als Vorschau angezeigt	Überprüfen Sie, ob das Asset `dam:scene7File` in den Metadateneigenschaften (CRXDE Lite) enthält.	Überprüfen Sie, ob alle Elemente verarbeitet wurden.
Hochgeladenes Asset wird nicht in der Asset-Auswahl angezeigt	Überprüfen Sie, ob das Asset die Eigenschaft `jcr:content` > `dam:assetState` = `processed` (CRXDE Lite) aufweist.	Überprüfen Sie, ob alle Elemente verarbeitet wurden.
Banner wird in der Kartenansicht als Neu angezeigt, wenn das Asset noch nicht gestartet wurde	Überprüfen Sie `jcr:content` > `dam:assetState` für das Asset. Wenn `unprocessed`, dann wurde es nicht vom Workflow abgeholt	Warten Sie, bis das Asset vom Workflow abgeholt wurde.
Bilder oder Sets zeigen weder Viewer-URL noch eingebetteten Code an	Prüfen Sie, ob die Viewer-Vorgabe veröffentlicht wurde.	Wechseln Sie zu Tools > Assets > Viewer-Vorgaben und veröffentlichen Sie die Viewer-Vorgabe.

Video

Falls Sie Probleme mit Videos haben, sehen Sie sich die folgende Anleitung zur Fehlerbehebung an.

Problem	Debugging	Lösung
Video kann nicht als Vorschau angezeigt werden	Prüfen Sie, ob dem Ordner ein Videoprofil zugewiesen ist (falls nicht unterstütztes Dateiformat). Falls nicht unterstützt, wird nur ein Bild angezeigt. Das Videoprofil muss mehr als eine Kodierungsvorgabe enthalten, damit ein AVS-Set generiert werden kann (einzelne Kodierungen werden als Videoinhalt für MP4-Dateien behandelt; nicht unterstützte Dateien werden wie nicht verarbeitete Dateien behandelt). Überprüfen Sie anhand von `dam:scene7FileAvs` von `dam:scene7File` in den Metadaten, ob die Verarbeitung des Videos abgeschlossen wurde.	Weisen Sie dem Ordner ein Videoprofil zu. Bearbeiten Sie das Videoprofil, damit es mehr als eine Kodierungsvorgabe enthält. Warten Sie, bis die Verarbeitung des Videos abgeschlossen ist. Stellen Sie sicher, dass der Workflow für die Dynamic Media-Videokodierung nicht ausgeführt wird, bevor Sie das Video erneut laden. Laden Sie das Video erneut hoch.
Video ist nicht kodiert	Prüfen Sie, ob der Ausführungsmodus dynamicmedia_scene7 lautet. Prüfen Sie, ob der Dynamic Media-Cloud-Service konfiguriert ist. Prüfen Sie, ob dem Upload-Ordner ein Videoprofil zugeordnet ist.	Überprüfen Sie Ihre AEM-Instanz mit -r dynamicmedia_scene7 Prüfen Sie, ob die Dynamic Media-Konfiguration unter Cloud Services ordnungsgemäß eingerichtet ist. Überprüfen Sie, ob der Ordner ein Videoprofil hat. Überprüfen Sie außerdem das Videoprofil.
Die Videoverarbeitung dauert zu lang	So prüfen Sie, ob die Videokodierung noch läuft oder ob ein Fehler aufgetreten ist: Überprüfen Sie den Videostatus `http://localhost:4502/crx/de/index.jsp#/content/dam/folder/videomp4/jcr%3Acontent` > dam:assetState Überwachen Sie das Video in der Workflow-Konsole `http://localhost:4502/libs/cq/workflow/content/console.html` > Registerkarten „Instanzen“, „Archiv“, „Fehler“.
Videoausgabedarstellung fehlt	Wenn das Video hochgeladen wurde, aber keine kodierten Ausgabedarstellungen vorhanden sind: Prüfen Sie, ob dem Ordner ein Videoprofil zugewiesen ist. Prüfen Sie anhand von `dam:scene7FileAvs` in den Metadaten, ob die Verarbeitung des Videos abgeschlossen wurde.	Weisen Sie dem Ordner ein Videoprofil zu. Warten Sie, bis die Verarbeitung des Videos abgeschlossen ist.

Viewer

Falls Sie Probleme mit einem Viewer haben, sehen Sie sich die folgende Anleitung zur Fehlerbehebung an.

Problem Debugging Lösung

Viewer-Vorgaben werden nicht veröffentlicht

Wechseln Sie zur Diagnoseseite des Beispiel-Managers: http://localhost:4502/libs/dam/gui/content/s7dam/samplemanager/samplemanager.html

Überwachen Sie die berechneten Werte. Bei einem ordnungsmäßigen Betrieb wird Folgendes angezeigt:

_DMSAMPLE status: 0 unsyced assets - activation not necessary _OOTB status: 0 unsyced assets - 0 unactivated assets

Hinweis: Nach der Konfiguration der Dynamic Media-Cloud-Einstellungen kann es bis zu 10 Minuten dauern, bis die Assets im Viewer synchronisiert werden.

Falls weiterhin nicht aktivierte Assets vorhanden sind, klicken Sie auf eine der Schaltflächen Alle nicht aktivierten Assets auflisten, um die Details anzuzeigen.

Navigieren Sie in den Admin Tools zur Viewer-Vorgabeliste: http://localhost:4502/libs/dam/gui/content/s7dam/samplemanager/samplemanager.html
Wählen Sie alle Viewer-Vorgaben aus und klicken Sie auf Veröffentlichen.
Navigieren Sie zurück zum Beispiel-Manager und prüfen Sie, ob die Anzahl der nicht aktivierten Assets jetzt mit null angegeben wird.

Für das Bildmaterial der Viewer-Vorgabe wird für eine Vorschau in den Asset-Details oder für „URL kopieren“/„Code einbetten“ der Code 404 zurückgegeben

Gehen Sie in CRXDE Lite wie folgt vor:

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, ist für dam:scene7FileStatus der Wert PublishComplete angegeben.
Versuchen Sie, das Bildmaterial direkt aus Dynamic Media anzufordern, indem Sie die Werte der folgenden Eigenschaften und Zeichenketten verketten.
- dam:scene7Domain
- "is/content"
- dam:scene7Folder
- <asset-name>
- Beispiel: https://<server>/is/content/myfolder/_CSS/_OOTB/CarouselDotsLeftButton_dark_sprite.png

Wenn die Beispiel-Assets oder das Bildmaterial der Viewer-Vorgabe nicht synchronisiert oder veröffentlicht wurden, starten Sie den gesamten Kopier-/Synchronisierungsvorgang neu:

Navigieren Sie zu CRXDE Lite.
- Löschen Sie <sync-folder>/_CSS/_OOTB.
Navigieren Sie zum CRX Package Manager: http://localhost:4502/crx/packmgr/
1. Suchen Sie das Viewer-Paket in der Liste (es beginnt mit cq-dam-scene7-viewers-content)
2. Klicken Sie auf Neu installieren.
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 auf Speichern. Dadurch wird die Logik zum Erstellen und Synchronisieren von Beispiel-Assets, Viewer-Vorgabe-CSS und Bildmaterial erneut ausgelöst.