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:

  • Der Befehl "Start"enthält -r dynamicmedia_scene7 runmode -Argument.

  • 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 ist für die FTP-Unterstützung oder für die Migration von Assets von Dynamic Media Classic zu Dynamic Media vorgesehen.

  • 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 Dynamic Media Asset Activation (scene7) Replikationsagent ist aktiviert.

    Dieser Replikationsagent befindet sich unter Agenten auf der Autoreninstanz.

Allgemein (alle Assets)

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

Asset-Synchronisierungsstatus-Eigenschaften

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`
<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 die Protokollierung jedoch auf DEBUG auf der com.adobe.cq.dam.ips Paket über die Sling Console (http://localhost:4502/system/console/slinglog), um weitere Informationen zu sammeln.

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:

  • Wenn Sie beide beibehalten, wird ein neues Asset mit einem eindeutigen Namen für die veröffentlichte Asset-URL 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 der Bereitstellung.

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

  1. Ö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.
  1. Weisen Sie dem Ordner ein Videoprofil zu.
  2. Bearbeiten Sie das Videoprofil, damit es mehr als eine Kodierungsvorgabe enthält.
  3. Warten Sie, bis die Verarbeitung des Videos abgeschlossen ist.
  4. Stellen Sie sicher, dass der Workflow für die Dynamic Media-Videokodierung nicht ausgeführt wird, bevor Sie das Video erneut laden.
  5. 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.
  1. Überprüfen Sie Ihre AEM-Instanz mit -r dynamicmedia_scene7
  2. Prüfen Sie, ob die Dynamic Media-Konfiguration unter Cloud Services ordnungsgemäß eingerichtet ist.
  3. Ü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.
  1. Weisen Sie dem Ordner ein Videoprofil zu.
  2. 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.
  1. Navigieren Sie in den Admin Tools zur Viewer-Vorgabeliste: http://localhost:4502/libs/dam/gui/content/s7dam/samplemanager/samplemanager.html
  2. Wählen Sie alle Viewer-Vorgaben aus und klicken Sie auf Veröffentlichen.
  3. 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:

  1. Navigieren Sie zum <sync-folder>/_CSS/_OOTB-Ordner im Synchronisierungsordner für Dynamic Media (z. B. /content/dam/_CSS/_OOTB).
  2. Suchen Sie den Metadaten-Knoten des problematischen Assets (z. B. <sync-folder>/_CSS/_OOTB/CarouselDotsLeftButton_dark_sprite.png/jcr:content/metadata/).
  3. 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.
  4. 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:

  1. Gehen Sie zu CRXDE Lite.
    • Löschen Sie <sync-folder>/_CSS/_OOTB.
  2. 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.
  3. 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.

Auf dieser Seite