DokumentationExperience Cloud KCS

AEM: DAM-Asset-Vorschau und Bearbeitungsfehler nach DITA-Upgrade in DEV/STAGE/PROD

Letzte Aktualisierung: 17. Juli 2026

In diesem Artikel werden Probleme mit der DAM-Asset-Vorschau und -Bearbeitungsfunktion in Adobe Experience Manager-Umgebungen behandelt.

Beschreibung description

Umgebung


Adobe Experience Manager (AEM) (alle Versionen)

Problem/Symptome


In der Admin-Benutzeroberfläche von AEM Assets kann die Vorschau einiger Bilder (z. B.: Klicken auf das Asset) das Asset kurz anzeigen, und dann wird die Vorschau leer. Das Problem ist in der Regel auf bestimmte Assets beschränkt, während andere Assets in derselben Umgebung möglicherweise weiterhin normal in der Vorschau angezeigt werden.

Browser-Netzwerkspuren für betroffene Assets zeigen eine fehlgeschlagene Dynamic Media-Viewer-Anfrage ähnlich der folgenden an:

GET /is/image/content/dam/<asset-path>?req=set,json,UTF-8&handler=s7viewerss7sdkJSONResponse

Die Anfrage gibt zurück:

HTTP 404
No preview server defined for root ID referenced in net path

Verwandte AEM-Protokolle können Folgendes enthalten:

Unable to forward request for root [ content] , no preview servlet defined for [ content]

Lösung resolution

Führen Sie zur Behebung des Problems folgende Schritte aus:

  1. Überprüfen Sie die Dynamic Media-Metadaten des betroffenen Assets Öffnen Sie den Asset-Metadatenknoten und überprüfen Sie die folgenden Eigenschaften unter:

    code language-none 
    /content/dam/<asset-path>/jcr:content/metadata

    Aktivieren Sie diese Felder gezielt:

    • dam:scene7FileStatus
    • dam:scene7File
    • dam:scene7ID
    • dam:scene7Domain
    • dam:scene7CloudConfigPath
    • dam:scene7APIServer
    • dam:scene7Type

    Ein gesundes Asset sollte normalerweise über Folgendes verfügen:

    • dam:scene7FileStatus = PublishComplete
    • dam:scene7File befüllt
    • dam:scene7ID befüllt

  2. Mit einem funktionierenden Asset vergleichen Wenn möglich, vergleichen Sie das fehlerhafte Asset mit einem anderen Bild in derselben Umgebung, die die Vorschau korrekt anzeigt. In den meisten Fällen fehlt dem fehlerhaften Asset eine oder mehrere erforderliche dam:scene7*-Eigenschaften oder dam:scene7FileStatus wird auf einen nicht fehlerfreien Wert gesetzt, z. B.:

    • NeedsReupload
    • PublishIncomplete
    • UploadFailed
    • UploadStart
    • ReprocessStart

  3. Das betroffene Asset erneut hochladen oder verarbeiten Das erneute Hochladen oder Verarbeiten des Assets zwingt AEM/Dynamic Media, die fehlenden Scene7-Verknüpfungsmetadaten neu zu generieren. Im validierten Fall wurde das Asset durch erneutes Hochladen von wie folgt geändert:

    • dam:scene7FileStatus = NeedsReupload
    • Fehlende dam:scene7File
    • Fehlende dam:scene7ID

    in einen gesunden Zustand mit:

    • dam:scene7FileStatus = PublishComplete
    • Befüllte dam:scene7File
    • Befüllte dam:scene7ID

  4. Wenn das Asset durch Inhaltskopie, Paketinstallation oder Migration eingeführt wurde, verarbeiten Sie die betroffenen Assets in der Zielumgebung erneut Assets, das aus einer anderen Umgebung kopiert wurde, kann veraltete oder unvollständige Dynamic Media-Metadaten beibehalten oder die normale Dynamic Media-Aufnahme in der Zielumgebung umgehen. Beim erneuten Hochladen oder Verarbeiten in der Zielumgebung werden die richtigen lokalen dam:scene7*-Metadaten neu generiert.

  5. Validieren der Vorschau Wiederherstellung nach erneutem Hochladen oder Neuverarbeitung:

    • Bestätigen Sie, dass die Asset-Vorschau in Asset-Details funktioniert.
    • Bestätigen, dass das Asset keine fehlgeschlagene Vorschauanfrage mehr ausgibt an:
    code language-none 
    /is/image/content/dam/<asset-path>?req=set,json,UTF-8&handler=s7viewerss7sdkJSONResponse
    • Bestätigen, dass das Asset jetzt mit einem gültigen Scene7-Handle in dam:scene7File aufgelöst wird.

  6. Identifizieren Sie für die Massenauswirkung ähnliche Assets nach Status Wenn mehrere Assets betroffen sind, fragen Sie nach Assets mit fehlerhaften dam:scene7FileStatus-Werten und verarbeiten Sie diese Teilmenge neu, anstatt die gesamte DAM-Baumstruktur.

Ursache

Das Problem wird dadurch verursacht, dass sich das betroffene Asset in einem unvollständigen oder veralteten Synchronisierungsstatus für Dynamic Media befindet. In diesem Zustand ist das Asset in AEM vorhanden, es fehlen jedoch die gültigen Scene7-Verknüpfungsmetadaten, die für die Vorschauauflösung der Asset-Details erforderlich sind, z. B. dam:scene7File, dam:scene7ID oder eine fehlerfreie dam:scene7FileStatus.

Daher versucht Asset Details, die Dynamic Media-Vorschau mithilfe eines Repository-Pfads unter /content/dam/... anstelle eines gültigen Scene7-Asset-Handles zu laden, und die Vorschau-Anfrage schlägt fehl, was dazu führt, dass der Vorschaubereich leer bleibt.

Dieser Status wird häufig eingeführt, wenn:

  • Die Synchronisierung/der Upload von Dynamic Media wurde nicht ordnungsgemäß abgeschlossen.
  • Das Asset wurde aus einer anderen Umgebung kopiert oder migriert.
  • Veraltete dam:scene7*-Metadaten wurden von einer anderen Umgebung übernommen.
  • Das Asset wurde in der Zielumgebung nach der Migration oder Inhaltskopie nicht vollständig neu verarbeitet.
recommendation-more-help
experience-cloud-kcs-help-kbarticles