ドキュメントExperience Cloud KCS

AEM:DEV/STAGE/PRODでのDITA アップグレード後のDAM Asset PreviewとEdit エラー

最終更新日： 2026年7月17日

この記事では、Adobe Experience Manager環境でのDAM アセットのプレビューと編集機能に関する問題を解決します。

説明 description

環境


Adobe Experience Manager（AEM）（すべてのバージョン）

問題/症状


AEM Assets管理UIで、一部の画像をプレビューすると（例：アセットをクリックすると）、アセットが簡単に表示され、プレビューが空白になる場合があります。 通常、この問題は特定のアセットに限定されますが、同じ環境の他のアセットは引き続き正常にプレビューされます。

影響を受けるアセットのブラウザーネットワークトレースで、次のようなDynamic Media ビューアーリクエストが失敗した場合に表示されます。

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

リクエストは次を返します。

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

関連するAEM ログには、次のものが含まれる場合があります。

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

解決策 resolution

問題を解決するには、次の手順に従います。

  1. 影響を受けるアセットのDynamic Media メタデータを調べる アセット メタデータ ノードを開き、以下のプロパティを確認します。

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

    これらのフィールドを具体的にチェックします。

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

    通常、健全なアセットには次のようなものがあります。

    • dam:scene7FileStatus = PublishComplete
    • dam:scene7Fileが入力されました
    • dam:scene7IDが入力されました

  2. 作業中のアセットと比較可能であれば、問題のあるアセットを、正しくプレビューされる同じ環境内の別の画像と比較します。 ほとんどの場合、失敗したアセットには1つ以上の必須プロパティ dam:scene7*が見つからないか、dam:scene7FileStatusは次のような正常でない値に設定されます。

    • NeedsReupload
    • PublishIncomplete
    • UploadFailed
    • UploadStart
    • ReprocessStart

  3. 影響を受けたアセットの再アップロードまたは再処理 アセットの再アップロードまたは再処理を行うと、AEM/Dynamic Mediaは見つからないScene7 リンクメタデータを再生成します。 検証済みの場合、再アップロードすると、アセットが次の場所から変更されました。

    • dam:scene7FileStatus = NeedsReupload
    • dam:scene7Fileがありません
    • dam:scene7IDがありません

    次の機能を備えた健全な状態に移行する：

    • dam:scene7FileStatus = PublishComplete
    • dam:scene7Fileが入力されました
    • dam:scene7IDが入力されました

  4. コンテンツのコピー、パッケージのインストール、または移行によってアセットが導入された場合、対象の環境で影響を受けるアセットを再処理します別の環境からコピーされたAssetsでは、古いDynamic Media メタデータまたは不完全なDynamic Media メタデータが保持されるか、対象の環境で通常のDynamic Media取り込みがバイパスされる可能性があります。 ターゲット環境で再アップロードまたは再処理すると、正しいローカル dam:scene7* メタデータが再生成されます。

  5. 再アップロードまたは再処理後にプレビューの回復を検証:

    • アセットのプレビューが アセットの詳細で機能することを確認します。
    • アセットが失敗したプレビューリクエストを発行しなくなったことを確認します。
    code language-none 
    /is/image/content/dam/<asset-path>?req=set,json,UTF-8&handler=s7viewerss7sdkJSONResponse
    • アセットがdam:scene7Fileで有効なScene7 ハンドルを使用して解決することを確認します。

  6. 一括影響の場合は、ステータス別に類似のアセットを特定複数のアセットが影響を受ける場合は、DAM ツリー全体ではなく、異常なdam:scene7FileStatus値を持つアセットをクエリし、そのサブセットを再処理します。

原因

この問題は、影響を受けるアセットが 不完全または古いDynamic Media同期状態 にあることが原因です。 この条件では、アセットはAEMに存在しますが、dam:scene7File、dam:scene7ID、正常なdam:scene7FileStatusなど、アセットの詳細プレビュー解決に必要な有効なScene7 リンケージ メタデータがありません。

その結果、アセットの詳細では、有効なScene7 アセットハンドルの代わりに/content/dam/...の下のリポジトリパスを使用してDynamic Media プレビューを読み込もうとすると、プレビューリクエストが失敗し、プレビュー領域が空白になります。

この状態は、次の場合に一般的に導入されます。

  • Dynamic Mediaの同期/アップロードが正常に完了しませんでした。
  • アセットがコピーされたか、別の環境から移行されました。
  • 古いdam:scene7* メタデータが別の環境から引き継がれました。
  • 移行後またはコンテンツのコピー後に、ターゲット環境でアセットが完全に再処理されませんでした。
recommendation-more-help
experience-cloud-kcs-help-kbarticles