[AEM Assets]{class="badge positive" title="AEM Assetsに適用)。"}

Dynamic Media のトラブルシューティング troubleshooting-dynamic-media-scene-mode

このトピックでは、Dynamic Media​に関するトラブルシューティングのガイダンスを提供します。一般的な問題、その原因、および一般的な解決方法について説明します。 Dynamic Mediaは、画像、動画、インタラクティブなエクスペリエンスなどのリッチメディアアセットを大規模に作成、管理、配信し、様々なデバイス、画面サイズ、視聴条件にコンテンツを適応させるために使用される機能です。 多くの環境をまたいでアセットの処理、配信、レンダリングに及ぶため、トラブルシューティングでは通常、アセットの取り込み、アクティベーション、配信中に問題が発生したかどうかを特定する必要があります。

Dynamic Mediaの一般的な問題カテゴリ

ほとんどのDynamic Mediaの問題は、認識できる少数のカテゴリに分類されます。 カテゴリを特定すると、まず調査が絞られ、解決が速くなります。

  • アセットのアップロードと処理エラー – 読み込まない、レンディションを生成できない、または処理状態のままのアセット。
  • アクティベーションと公開に関する問題 – 処理に成功したが、配信レイヤーで使用できないアセット。
  • 配信とレンダリングの問題 – 読み込みに失敗する、正しく表示されない、またはサイズや画質が正しくない画像やビデオ。
  • ビューアと埋め込みの問題 — インタラクティブなビューア、ビデオプレーヤー、または埋め込みエクスペリエンスが、初期化または動作が期待どおりにありません。
  • 設定と接続の問題 — オーサリング環境と配信サービス間の通信を中断するサービス設定、資格情報、またはネットワーク条件が正しくありません。

一般的なトラブルシューティングのアプローチ

構造化されたアプローチは、ほとんどのDynamic Mediaの問題を試行錯誤よりも確実に解決します。 次の手順を順番に実行します。

  1. アセットが正しく処理されていることを確認します。 配信とレンダリングのエラーは多くの場合、不完全な処理に遡るため、ソースアセットが完全にアップロードされ、期待されるレンディションが生成されたことを確認します。
  2. アクティベーションの状態を確認します。 オーサリングで正しく表示されるアセットは、アクティベーションが完了しなかった場合でもエンドユーザーが利用できない可能性があるため、アセットが公開されるか、配信サービスにアクティベートされていることを確認します。
  3. 配信URLとレンダリングパラメーターを確認します。 配信URLが正しく、サイズ、形式、品質のパラメーターが意図した出力と一致することを確認します。
  4. 環境を分離します。 オーサリング、配信サービス、またはクライアントブラウザーのいずれで問題が発生するか、エラーが発生した場所を特定します。
  5. 設定と接続性を確認します。 オーサリング環境とDynamic Media配信サービス間のサービス設定、資格情報、ネットワーク接続を検証します。

一般的に問題が発生するケース

失敗の典型的なポイントを理解することは、調査をターゲットにするのに役立ちます。

  • 取り込み中​に、サポートされていないファイル形式、破損したソースファイル、または中断されたアップロードは、一般的に正常な処理を妨げます。
  • アクティブ化中​に、不完全または遅延した公開中に、オーサリング環境にアセットが存在する場合でも、配信レイヤーにアセットが見つからなくなります。
  • 配信中​に、キャッシュ、不正なURL、または誤った設定のパラメーターが原因で、アセットの読み込みが遅くなったり、読み込みが正しくなくなったり、まったく読み込まれなくなったりします。

処理、アクティベーション、配信などの各段階を順番に確認することで、Dynamic Mediaの問題の根本原因を効率的に特定し、適切な解決策を適用できます。

新しい Dynamic Media 設定 new-dm-config

新しいDynamic Media (DM)設定​は、Adobe Experience Manager AssetsをDynamic Mediaに接続して、画像、ビデオ、その他のリッチメディアを大規模に処理、最適化、配信できるようにします。 ダイナミックメディアを使用すると、単一のマスターアセットからレンディション、レスポンシブ画像配信、インタラクティブビューア、ストリーミングビデオを動的に生成できるため、複数の事前レンダリング済みバリエーションを保存して管理する必要性を減らすことができます。

目的とトラブルシューティングの範囲

新しいDynamic Media設定を設定すると、AEM Assets環境とDynamic Media サービス間のリンクが確立されるため、AEMにアップロードされたアセットが同期され、処理され、最適化された配信に利用できるようになります。 スマートイメージング、ダイナミックレンディション、ビューアの埋め込みなどのダイナミックメディア機能が期待どおりに機能するには、正しく完了した設定が必要です。

設定の問題は通常、アセットが同期しない、レンディションが生成できない、配信URLが解決しない場合に発生します。 これらの問題は一般的に、不完全または誤って適用された設定に起因するため、設定を検証することは、それらを診断する際に推奨される最初の手順です。

これらの問題の診断と解決に関する手順ごとのガイダンスについては、新しいDynamic Media設定のトラブルシューティング ​を参照してください。

一般(すべてのアセット) general-all-assets

次のベストプラクティスは、あらゆるアセットタイプに適用されます。 これらのガイドラインを適用することで、どのようなアセットを扱っているかにかかわらず、整理、見つけやすさ、長期的なメンテナンス性を一貫して向上できます。

命名と整理

一貫性のある命名と構造は、管理可能なアセットの基盤です。 主要な実践は次の通りです。

  • わかりやすい名前を使用します。 一般的なラベルを使用するのではなく、目的やコンテンツに応じて各アセットに名前を付けます。 これにより、プロジェクトが成長しても、アセットを一目で特定でき、後で検索できるようになります。
  • 一貫した命名規則を採用します。 すべてのアセットに同じケーシング、セパレータ、およびプレフィックスを適用すると、混乱が軽減され、自動処理と並べ替えの信頼性が高まります。
  • 関連アセットを一緒にグループ化します。 アセットを論理フォルダーやカテゴリーごとに整理することで、大規模なコレクションをスムーズに移動でき、チームメンバーは必要なアセットをすばやく見つけることができます。

再利用と効率化

既存のアセットを再利用することは、再制作よりも効率的で、視覚的および機能的な一貫性を維持するのに役立ちます。 推奨されるアプローチは次のとおりです。

  • 新しいアセットを作成する前に、既存のアセットを確認します。 これにより、重複を回避し、時間を節約し、冗長なファイルの蓄積を防ぐことができます。
  • 同じ要素が複数の場所に表示される、共有または再利用可能なアセット​を好む。 単一のソースを一元管理することで、アセットが使用されるあらゆる場所に、更新を反映できます。

メンテナンスと品質

よく管理されたアセットは、長期的に利用でき、技術的負債を減らすことができます。 実践的なステップは次のとおりです。

  • 未使用のアセットを定期的に削除します。 参照されなくなったアセットを削除することで、コレクションをリーンで管理しやすくなります。
  • アセットを最適化しておきます。 適切なサイズと形式のアセットを使用することで、パフォーマンスが向上し、不要なオーバーヘッドを削減できます。
  • 重要な詳細を文書化します。 アセットの目的、ソース、使用状況に関するメモを記録することで、現在および将来のチームメンバーが、各アセットをどのように、どこで使用すべきかを把握できます。

:一般的な慣行に従うことで、信頼性の高いベースラインを確立し、特定のアセットタイプごとに継承できるため、個々のアセットの制作、更新、保守を容易におこなうことができます

アセット同期ステータスプロパティ asset-synchronization-status-properties

4つのアセットプロパティにより、Adobe Experience Manager(AEM)​から​ Dynamic Media ​までのアセットの同期が成功したことが確認されます:dam:scene7ID、dam:scene7FileStatus、dam:scene7File、およびdam:lastSyncStatus。 AEM コンテンツリポジトリ (JCR) ノード構造の調査に使用されるブラウザベースの開発環境である​ CRXDE Lite ​で、これらのプロパティを直接確認します。 各プロパティは、アセットのDynamic Mediaへのリンクの状態に関する特定のシグナルを提供します。

CRXDE Liteで同期を検証する方法

次のアセットプロパティは、CRXDE Liteで確認され、Adobe Experience ManagerからDynamic Mediaへのアセットの同期が正常に行われたことを確認します。

プロパティ
例
説明
<object_node>/jcr:content/metadata/dam:scene7ID
a|364266
ノードがDynamic Mediaにリンクされていることを示す一般的なインジケーター。 この値が存在すると、AEMがアセットノードとそのDynamic Media (Scene7)の対応物との間に関連付けを確立したことを確認します。
<object_node>/jcr:content/metadata/dam:scene7FileStatus
PublishComplete またはエラーテキスト
Dynamic Mediaへのアセットのアップロードのステータス。 値​ PublishComplete ​は、アップロードが正常に完了したことを示します。このフィールドのエラーテキストは、アップロードが完了しなかったことを示します。
<object_node>/jcr:content/metadata/dam:scene7File
myCompany/myAssetID
Dynamic MediaのリモートアセットへのURLを生成するには、入力する必要があります。 配信URLはこの値から構築されるので、空のdam:scene7File プロパティは、アセットに対してDynamic Media URLを生成できないことを意味します。
<object_node>/jcr:content/dam:lastSyncStatus
success または failed:<error text>
セット(スピンセット、画像セットなど)、画像プリセット、ビューアプリセット、アセットの画像マップの更新、編集された画像などの同期ステータス。 値​ success ​は、最後の同期操作が完了したことを確認します。一方、失敗しました:<error text>​は、同期を妨げた特定のエラーを識別します。

プロパティが重要な理由

各プロパティは、アセット配信パイプラインにおける明確なチェックポイントとなるため、4つすべてを同時に確認することで、アセットの同期状態を包括的に把握できます。 dam:scene7ID​および​dam:scene7File プロパティは、リンクとファイル参照が存在することを確認し、dam:scene7FileStatus​はアップロード自体を確認し、dam:lastSyncStatus​はスピンセット、画像セット、画像プリセット、ビューアプリセット、画像マップの更新などの依存アーティファクトが正しく同期されていることを確認します。 Adobe Dynamic Mediaでアセットが期待通りに配信されなかった場合、CRXDE Liteでこれらのプロパティを調べることが、プロセスのどの段階(リンク、アップロード、設定の同期)が完了しなかったかを直接的に判断する方法となります。

同期のログ synchronization-logging

同期エラーと問題は、Experience Manager サーバーディレクトリ /crx-quickstart/logs/​にある​error.log ファイルに記録されます。 このログは、アセットの同期に関する問題を診断するための主要な参照先です。

デフォルトのロギングレベルは、ほとんどの同期の問題の根本原因を特定するのに十分な詳細を提供します。 再現が困難な問題をより詳細に調査するために、管理者は​com.adobe.cq.dam.ips パッケージのログの冗長性を​ DEBUG ​に上げることができます。 DEBUG レベルのログでは、より詳細な診断イベントが表示され、デフォルト レベルで書き込まれていない同期プロセスのコンテキストが追加されます。

DEBUGへの同期ログを増やすには:

  1. https://localhost:4502/system/console/slinglogでSling コンソールを開きます。
  2. com.adobe.cq.dam.ips パッケージのロガー設定を見つけるか、追加します。
  3. ログレベルを​ DEBUG ​に設定します。
  4. 同期の問題を再現してから、/crx-quickstart/logs/​で​ error.log ​に書き込まれた追加の詳細を確認してください。

この方法でログレベルを上げると、同期ワークフローに関するより多くの情報が収集されるため、デフォルトのロギングで十分な詳細が提供されない場合に、基礎となる原因を簡単に特定できます。

バージョン管理 version-control

同じ名前と場所​を共有する既存のDynamic Media アセットを置き換える場合、Adobe Experience Managerには、2つの異なる処理オプションが用意されています。両方のアセットを保持​または​既存のアセットを置き換える。 バージョン管理は、アップロード時にこれらのビヘイビアーが適用されるかを決定します。

  • 両方のアセットを保持:​新しくアップロードされたファイルは、一意の名前​の下に保存され、公開されたアセット URLが明確なままになります。 例えば、image.jpgは元のアセットで、image1.jpgは新しくアップロードされたアセットです。 各ファイルには独自の名前が保持されるため、両方のアセットは個別にアドレス可能かつ成果物のままとなり、新しいアップロードで元のアセットが上書きされるのを防ぎます。

  • バージョンの作成: バージョンの作成は、Dynamic Mediaで​サポートされていません。 その結果、新しいアップロードはバージョン履歴に追加されません。 代わりに、新しいアセットが配信の既存のアセットに置き換わります。つまり、以前に公開されたファイルが置き換えられ、更新されたコンテンツがその場所で提供されます。 以前のバージョンは配信のために保持されないため、配信されたアセットの置き換えは実質的に永続的になります。

画像とセット images-and-sets

以下のトラブルシューティングガイダンスを使用して、画像とセットに関する一般的な問題を解決します。 画像エラーとセットエラーは通常、サポートされていない形式、不完全なアップロード、誤った命名、キャッシュの競合、設定の不一致が原因です。 最初に問題のカテゴリを特定することは、ほとんどの画像およびセットのエラーが少数の繰り返しパターンに分類されるため、クイックフィックスに対する最も信頼できるパスです。

画像とセットの一般的な問題

画像やセットに関して最も頻繁に発生する問題には、次のようなものがあります。

  • 画像が表示されない – 破損、空白、または不足している画像は、多くの場合、無効なファイルパス、サポートされていないファイル形式、またはアップロードに失敗したことを示します。
  • 不正確な画像または古い画像 – 更新後に古いバージョンが表示される場合、通常、原因は更新されていないコンテンツがキャッシュされます。
  • セットが完全に読み込まれていません – 一部または不完全なセットは、通常、メンバー項目の欠落、参照の破損、または同期の中断が原因です。
  • 形式または解像度の問題 – 通常、画像が歪んでいる、引き伸ばされている、または低画質の場合、サイズ、縦横比、または解像度の設定が要件に一致しません。
  • 権限またはアクセス エラー – 読み込みに失敗した画像またはセットは、アクセス権限または期限切れのリンクによって制限される場合があります。

ステップバイステップ形式のトラブルシューティング

次の手順を順を追って実行します。各ステップは、より関与するソリューションに移行する前に共通の原因を除外するためです。

  1. ファイルの形式とサイズを確認します。 画像がサポートされている形式を使用し、許容されるサイズ制限に収まっていることを確認します。 これにより、変換エラーなしでファイルをレンダリングできるようになります。
  2. アップロードが完了したことを確認します。 中断されたアップロードは壊れた画像の主な原因であるため、欠落または破損していると思われる画像を再アップロードします。
  3. キャッシュをクリアして更新します。 ブラウザーまたはアプリケーションキャッシュをクリアすると、最新バージョンが強制的に読み込まれ、古い画像が表示される場合は解決されます。
  4. ファイルのパスと参照を確認します。 壊れたパスでは画像の読み込みが妨げられるため、各画像を確認し、参照ポイントを有効な既存の場所に設定します。
  5. 権限とアクセス設定を確認します。 画像またはセットにアクセス可能であり、共有リンクが期限切れになっていないことを確認します。
  6. 別の環境でテストします。 画像またはセットを別のブラウザー、デバイス、またはセッションに読み込んで、問題がシステム全体ではなくローカルかどうかを判断します。

画像および設定エラーの防止

繰り返し発生する問題を減らすには、次の予防策を適用します。

  • あらゆる画像やセットで、サポートされる一貫したファイル形式と命名規則を使用できます。
  • 各アップロードが完全に終了することを確認してから続行します。これにより、ファイルの一部または破損を防ぐことができます。
  • メンバー項目が欠落したり孤立したりしないように、画像参照とセットメンバーを同期させておきます。
  • 更新を行った後、キャッシュされたコンテンツを更新して、現在のバージョンが常に提供されるようにします。
問題
デバッグの方法
解決策
アセットの詳細表示で URL/埋め込みコードのコピーボタンにアクセスできない
  1. CRX/DE に移動します。

    • JCR 内のプリセット /etc/dam/presets/viewer/<preset> has lastReplicationAction が定義されているかどうかを確認します。 この場所は、Experience Manager 6.x から 6.4 にアップグレードし、移行をオプトアウトした場合に適用されます。 それ以外の場合、場所は /conf/global/settings/dam/dm/presets/viewer になります。
    • JCR のアセットに dam:scene7FileStatus があり、それが「メタデータ」で PublishComplete と表示されていることを確認します。

ページを更新するか、別のページに移動してから戻ります(サイドレール JSP を再コンパイルする必要があります)。

それでも解決しない場合:

  • アセットを公開します。
  • アセットを再度アップロードして公開します。
スライドを切り替えた後、カルーセルホットスポットが移動する
すべてのスライドが同じサイズであることを確認します。
カルーセルには同じサイズの画像のみを使用します。
Dynamic Media ビューアで画像がプレビューされない
アセットのメタデータプロパティに dam:scene7File が含まれていることを確認します(CRXDE Lite)。
すべてのアセットの処理が完了したことを確認します。
アップロードしたアセットがアセットセレクターに表示されない
アセットのプロパティ jcr:content > dam:assetState が processed であることを確認します(CRXDE Lite)。
すべてのアセットの処理が完了したことを確認します。
アセットの処理がまだ開始していないときに、カードビューのバナーに「新規」と表示される
アセットの jcr:content > dam:assetState を確認します。unprocessed の場合は、アセットの処理がワークフローで開始されていません。
ワークフローがアセットの処理を始めるまで待ちます。
画像やセットにビューア URL や埋め込みコードが表示されない
ビューアプリセットが公開されているかどうかを確認します。
ツール/アセット/ビューアプリセットに移動し、ビューアプリセットを公開します。

これらのトラブルシューティング手順を完了した後も問題が解決しない場合は、問題をエスカレーションして、特定の画像またはセットの詳細、既に試みた手順、および発生したエラーメッセージをサポートします。 このような情報を提供することで、より効率的に根本原因を特定することができます。

ビデオ video

ビデオ再生の問題は、最も一般的な技術的な問題の1つであり、ほとんどの問題は、いくつかの標準的なトラブルシューティング手順で解決されます。 ビデオが読み込まれない場合、フリーズしているように見える場合、サウンドなしで再生する場合、黒い画面が表示される場合は、以下のガイダンスを使用して問題を特定し、解決してください。

ビデオの問題の一般的な原因

ほとんどのビデオの問題は、予測可能な少数の原因に起因します。 原因を把握することで、正しい修正を適用することができます。

  • ネットワーク接続が不十分または不安定です — ストリーミング ビデオには一貫した帯域幅が必要です。 接続が脆弱または変動すると、バッファリング、停止、または品質の自動ダウングレードが発生します。
  • 古いブラウザーまたはアプリケーション – 古いソフトウェアでは、現在のビデオ形式または再生標準がサポートされていない場合があり、エラーまたは空白の画面が発生します。
  • 破損したキャッシュまたはCookie – 保存された一時データは、新しいビデオコンテンツと競合し、正しく読み込まれなくなる可能性があります。
  • ブラウザーの拡張機能または広告ブロッカー – 特定の拡張機能は、再生に必要なスクリプトをブロックすることで、ビデオ プレーヤーを妨げます。
  • 古いグラフィックドライバーまたはハードウェアアクセラレーションの競合 – これらは、黒い画面、再生が途切れる、またはクラッシュの原因が頻繁に発生します。
  • オーディオまたはコーデックの互換性がありません – 環境にないコーデックまたはサポートされていないコーデックを使用すると、音声なしでビデオが再生されたり、完全にレンダリングされなくなる場合があります。

ステップバイステップ形式のビデオトラブルシューティング

次の手順に従います。 各ステップでは、最も可能性の高い原因に最初に対処するため、多くの場合、問題は後のステップに進む前に解決されます。

  1. インターネット接続を確認してください。 他のWeb サイトやサービスが正常に読み込まれていることを確認します。 接続の速度が遅い、または切断が、バッファリングと再生エラーの主な原因です。 可能であれば、有線接続に切り替えるか、ワイヤレスルータに近づけます。
  2. ページを更新して再生を再開します。 再読み込みすると、一時的な読み込みエラーがクリアされ、ビデオソースへの接続が再確立されます。
  3. ブラウザーまたはアプリケーションを更新します。 最新バージョンを実行すると、現在のビデオ形式と再生機能との互換性が保証されます。
  4. キャッシュとCookieをクリアします。 保存された一時データを削除すると、ビデオの読み込みを妨げる競合がなくなります。 後でブラウザーを再起動します。
  5. 拡張機能と広告ブロッカーを無効にします。 これらのオプションを一時的にオフにして、いずれかのオプションがビデオプレーヤーをブロックしているかどうかを確認します。 ビデオが機能する場合は、拡張機能を1つずつ再度有効にして、ソースを特定します。
  6. ビデオ画質を下げます。 ビデオが再生されますが、繰り返し停止する場合、低解像度を選択すると、必要な帯域幅が減少し、よりスムーズな再生が可能になります。
  7. グラフィックドライバーを更新するか、ハードウェアアクセラレーションを切り替えます。 古いドライバーは視覚的な不具合や黒い画面を引き起こします。 問題が解決しない場合、ブラウザー設定でハードウェアアクセラレーションを無効にすると、レンダリングの問題が解決されることがよくあります。
  8. 別のブラウザーまたはデバイスを試してください。 ビデオが別の場所で再生される場合、問題はビデオソース自体ではなく、元のブラウザーまたはデバイスに固有です。

さらなるサポートを求めるタイミング

上記のすべての手順を完了した後もビデオの問題が発生する場合は、ビデオソースまたは詳細なシステム設定が原因で問題が発生する可能性があります。 この場合、診断をスピードアップするため、サポートに連絡する前に次の詳細に注意してください。

  • 正確なエラーメッセージまたは画面に表示される内容の説明
  • ブラウザーまたはアプリケーションの名前とバージョン
  • オペレーティングシステムとデバイスの種類
  • すべてのビデオで問題が発生するか、特定のビデオのみで問題が発生するか
問題
デバッグの方法
解決策
ビデオをプレビューできない
  • (サポートされていないファイル形式の場合)フォルダーにビデオプロファイルが割り当てられていることを確認します。 サポートされていない場合は、画像のみが表示されます。
  • AVS セットを生成するには、ビデオプロファイルに複数のエンコーディングプリセットが含まれている必要があります(単一のエンコーディングは MP4 ファイルのビデオコンテンツとして扱われます。サポートされていないファイルの場合は、未処理のファイルと同じように扱われます)。
  • メタデータで dam:scene7File の dam:scene7FileAvs を確認して、ビデオの処理が終了したことを確かめます。
  1. ビデオプロファイルをフォルダーに割り当てます。
  2. エンコーディングプリセットを 2 つ以上含むよう、ビデオプロファイルを編集します。
  3. ビデオの処理が終了するまで待ちます。
  4. ビデオを再度読み込む前に、「Dynamic Media エンコーディングビデオ」ワークフローが実行されていないことを確認します。
  5. ビデオを再度アップロードします。
ビデオがエンコードされていない
  • Dynamic Media Cloud Service が設定されていることを確認します。
  • ビデオプロファイルがアップロードフォルダーに関連付けられていることを確認します。
  1. クラウドサービスページで Dynamic Media 設定が正しくセットアップされていることを確認します。
  2. フォルダーにビデオプロファイルが含まれていることを確認します。 そのビデオプロファイルも確認します。
ビデオの処理に時間がかかりすぎる

ビデオのエンコーディングがまだ進行中か、エラー状態になっているかを判断するには、次の手順を実行します。

  • ビデオのステータスを確認します。https://localhost:4502/crx/de/index.jsp#/content/dam/folder/videomp4/jcr%3Acontent > dam:assetState
ビデオレンディションがありません

ビデオがアップロードされたが、エンコードされたレンディションがない場合。

  • フォルダーにビデオプロファイルが割り当てられていることを確認します。
  • メタデータで dam:scene7FileAvs を確認して、ビデオの処理が終了したことを確かめます。
  1. ビデオプロファイルをフォルダーに割り当てます。
  2. ビデオの処理が終わるまで待ちます。

この情報を提供することで、サポートが問題を再現し、原因がデバイスのローカルであるか、ビデオサービス自体に影響を与えるかどうかを特定できます。

ビューア viewers

視聴者は、再生、読み込み、表示、互換性の問題を経験し、コンテンツが正しくレンダリングされなくなる可能性があります。 以下のトラブルシューティングガイダンスでは、最も一般的なビューアの問題に対処し、それらを解決するためのステップバイステップのパスを提供します。

ビューアの一般的な問題

視聴者の問題は、一般的に、いくつかの認識可能なカテゴリに分類されます。

  • コンテンツの読み込みに失敗しました — ビューアが開きますが、予想されるコンテンツの代わりに、空白の画面、スピナー、またはエラーメッセージが表示されます。
  • 再生またはレンダリングエラー - コンテンツの読み込みが部分的に行われたり、フリーズしたり、表示が正しくありません。
  • 互換性の問題 — ビューアが特定のブラウザー、デバイス、またはオペレーティングシステムで期待どおりに機能しません。
  • パフォーマンスに関する問題 – 読み込みが遅い、読み込みが遅い、または使用中に応答しない。

ビューアの問題の多くは、古いソフトウェア、ブラウザーのキャッシュの競合、ブロックされたスクリプト、不安定なネットワーク接続、サポートされていないファイル形式など、いくつかの原因に起因します。 どのカテゴリが適用されるかを特定することは、迅速な解決に向けた最初のステップです。

トラブルシューティング手順

前の手順で最も頻繁に発生する問題を解決するため、次の手順を順番に実行します。

  1. ビューアーを更新して再読み込みします。 一時的な読み込みエラーは、ページを再読み込みするか、ビューアを再度開くことでクリアされることがよくあります。
  2. ブラウザーのキャッシュとCookieをクリアします。 古いキャッシュされたデータは、空白の画面や古いコンテンツの一般的な原因であるため、クリアすると、ビューアは新しいリソースを再読み込みする必要があります。
  3. ブラウザーまたはアプリケーションを更新します。 最新バージョンを実行すると、ビューアのレンダリング要件との互換性が確保されます。
  4. 別のブラウザーまたはデバイスを試してください。 これにより、問題が1つの環境に固有なものであるか、コンテンツ自体に影響を与えるものであるかが分かります。
  5. ネットワーク接続を確認してください。 不安定または制限された接続では、ビューアがコンテンツを取得できないため、安定した接続を確認すると、多くの読み込みエラーが解決されます。
  6. 競合する拡張機能またはブロッカーを無効にします。 広告ブロッカー、スクリプトブロッカー、プライバシー拡張機能は、ビューアの機能に影響を与える可能性があります。一時的に無効にすると、それらが原因かどうかを確認できます。

これらの手順を完了した後も問題が解決しない場合は、ローカル環境ではなくコンテンツソースまたはビューア設定で問題が発生する可能性があり、さらに診断サポートが必要になる場合があります。

問題:ビューアプリセットが公開されていない viewers-not-published

現象: ビューアのプリセットが公開(アクティブ化)されていないため、配信されたアセットに対してDynamic Media ビューアが正しくレンダリングされません。 これを解決するには、アクティベーションステータスを確認し、アクティベートされていないプリセットを公開する必要があります。

デバッグ方法:ビューアプリセットのアクティベーション状態を確認

ビューアプリセットが公開されない理由を特定するには、次の手順に従います。

  1. サンプルマネージャーの診断ページに進みます:https://localhost:4502/libs/dam/gui/content/s7dam/samplemanager/samplemanager.html。

  2. 診断ページで報告された計算値を確認します。 システムが正しく動作すると、診断ページに次の情報が表示されます:_DMSAMPLE status: 0 unsyced assets - activation not necessary _OOTB status: 0 unsyced assets - 0 unactivated assets。 ここでは、DMSAMPLE​のステータスはDynamic Media サンプルアセットを参照し、OOTB​のステータスは標準のビューアアセットを参照します。 同期されていないアセットが​ 0個 ​個、非アクティブなアセットが​ 0個 ​個の数で、すべて同期され、期待どおりにアクティブ化されていることを確認します。

    note
    NOTE
    ビューアアセットを同期するには、Dynamic Media クラウド設定を設定してから約​ 10分 ​かかることがあります。 カウントがまだゼロでない場合は、この同期ウィンドウが完了するのを待ってから、トラブルシューティングを続行します。
  3. アクティベートされていないアセットが残っている場合は、1つ以上のビューアプリセットが公開されていないことを示します。 「すべての非アクティブなAssetsを一覧表示」ボタンのいずれかを選択して、アクティブ化が必要なアセットの詳細を表示します。

解決策:ビューアプリセットを公開

アクティベートされていないアセットは公開されていないプリセットに起因するため、修正は明示的に公開することです。

  1. 管理ツールのビューアプリセットリストに移動します:https://localhost:4502/libs/dam/gui/content/s7dam/samplemanager/samplemanager.html。
  2. すべてのビューアプリセットを選択したあと、「公開」を選択します。 公開すると、関連するアセットが同期され、配信に利用できるようにプリセットがアクティブ化され、非アクティブ化ステータスがクリアされます。
  3. サンプルマネージャーに戻り、アクティベートされていないアセット数が​ ゼロ ​になったことを確認します。 カウントが0の場合、ビューアプリセットが正常に公開され、問題が解決されていることを確認します。

問題:ビューアプリセットのアートワークが、アセット詳細のプレビューまたは URL をコピー/埋め込みコードで 404 を返す viewer-preset-404

デバッグ方法:同期ステータスを検証し、アートワークを直接要求する

CRXDE Lite(Adobe Experience Manager リポジトリのデベロッパーコンソール)で、次の手順を実行します。

  1. Dynamic Media 同期フォルダー内の <sync-folder>/_CSS/_OOTB フォルダー(例えば /content/dam/_CSS/_OOTB)に移動します。

  2. 問題のあるアセットのメタデータノードを見つけます(例えば <sync-folder>/_CSS/_OOTB/CarouselDotsLeftButton_dark_sprite.png/jcr:content/metadata/)。

  3. dam:scene7* プロパティがあることを確認します。 アセットが同期され、正常に公開された場合、dam:scene7FileStatus プロパティは​ PublishComplete ​に設定され、アセットが同期され、正常に公開されたことを確認します。 これらのdam:scene7* プロパティが存在しない場合、アセットは同期と公開のワークフローを完了しませんでした。これは、404の根本的な原因です。

  4. 次のプロパティと文字列リテラルの値を連結して、Dynamic Mediaからアートワークを直接要求します。 直接リクエストが成功すると、アートワークがDynamic Media サーバーに存在することを確認します。404は、アートワークが公開されていないことを確認します。

    • dam:scene7Domain
    • "is/content"
    • dam:scene7Folder
    • <asset-name>
      例:https://<server>/is/content/myfolder/_CSS/_OOTB/CarouselDotsLeftButton_dark_sprite.png

解決策:コピーと同期プロセスを再開します

直接リクエストが失敗した場合、またはdam:scene7* プロパティが見つからない場合、サンプルアセットまたはビューアプリセットアートワークは同期されていないか、公開されていません。 その結果、コピー/同期プロセス全体を再起動します。

  1. CRXDE Lite に移動します。
  2. <sync-folder>/_CSS/_OOTB を削除します。 これにより、古い未同期のアートワークフォルダーが削除され、クリーンに再生成されます。
  3. CRX パッケージマネージャー(リポジトリパッケージインストールツール)に移動します:https://localhost:4502/crx/packmgr/。
  4. リストでビューアパッケージを検索します。cq-dam-scene7-viewers-contentで始まります。
  5. 「再インストール」を選択します。 このパッケージを再インストールすると、ビューアプリセットコンテンツが復元されます。
  6. クラウドサービスページで、Dynamic Media 設定ページに移動した後、Dynamic Media - Scene7 設定の設定ダイアログボックスを開きます。
  7. 変更を加えずに、保存​を選択します。
    Dynamic Media - S7の設定を再保存すると、Experience Managerがサンプルアセット、ビューアプリセット CSS、アートワークを再作成および再同期し、404 エラーが解決されるため、このsave actionは再び設定ロジックをトリガーします。

問題:「帯域幅とストレージ」タブを開くときにエラー#2046が発生する error-2046-bandwidth-storage

原因:キャッシュされたRSL​の期限切れの署名証明書

Dynamic Media Classicの「Bandwidth & Storage」タブにエラー#2046表示されます

リッチメディアのホスティング、管理、配信に使用されるAdobe Asset-Management ツールである​Dynamic Media Classic(Scene7) デスクトップアプリケーションの​Bandwidth & Storage タブを開くと、Error #2046​が表示されます。 このエラーは、Adobe AIR(Adobe Integrated Runtime) フレームワークで使用されている​RSL (Runtime Shared Library) キャッシュに含まれている​ 期限切れのデジタル署名証明書 ​が原因で発生します。

エラーは、ローカル証明書の再検証​中にトリガーされます。アプリケーションがキャッシュされたRSLを読み込むと、署名証明書の検証が試行されます。キャッシュされた証明書の有効期限が切れているため、検証が失敗し、エラー#2046がスローされます。 問題はアプリケーション自体ではなくローカルに保存されたライブラリにあるため、修正は古いキャッシュされたファイルを削除して、現在の有効に署名されたRSLを取得できるようにすることです。

解決策:ローカル Adobe AIR キャッシュをクリアする

ローカル キャッシュをクリアして、Adobe AIR​に更新された​ RSL (Runtime Shared Library) ​のダウンロードを強制します。 古いキャッシュファイルを削除すると、期限切れの証明書が削除され、次の起動時にAdobe AIRは新たに署名されたRSLをダウンロードして、ローカル証明書の再検証を渡し、エラーを解決します。

macOS

  1. 次の URL に移動します。
    ~/Library/Caches/Adobe/Flash Player/AssetCache/<folder>/
  2. .swzと.heuのすべてのファイルを削除します。

Windows

  1. 次の URL に移動します。
    %APPDATA%\Adobe\Flash Player\AssetCache\<folder>\
  2. フォルダー内のすべてのファイルを削除します。

キャッシュをクリアした後、アプリケーションを再起動します。 再起動時に「帯域幅とストレージ」タブをもう一度開き、更新されたRSLが正常にダウンロードされ、検証されたことを示すエラー#2046が表示されなくなったことを確認します。

問題:ビューアプリセットのオーサリングで画像プレビューが読み込まれない image-preview-not-loading

解決策

古いサンプルコンテンツとキャッシュされたビューアプリセットアーティファクトがプレビューのレンダリングを妨げる場合、ビューアプリセットのオーサリングで​ 画像プレビュー ​を読み込めません。 これらのアーティファクトをクリアし、Dynamic Media設定を再作成してプレビューを復元します。

  1. Experience Manager で、Experience Manager ロゴを選択してグローバルナビゲーションコンソールにアクセスし、ツール/一般/CRXDE Lite に移動します。

  2. 左側のパネルで、次の場所にあるサンプルコンテンツフォルダーに移動します。

    /content/dam/_DMSAMPLE

  3. _DMSAMPLE フォルダーを削除します。 これにより、プレビューが正しくレンダリングされなくなる古いサンプルコンテンツが削除されます。

  4. 左側のパネルで、次の場所にあるプリセットフォルダーに移動します。

    /conf/global/settings/dam/dm/presets/viewer

  5. viewer フォルダーを削除します。 このフォルダーを削除すると、キャッシュされたビューアプリセット設定がクリアされ、クリーンに再生成されます。

  6. CRXDE Lite ページの左上隅付近にある「すべて保存」を選択して、削除をリポジトリに確定します。

  7. CRXDE Lite ページの左上隅にある「ホームに戻る」アイコンを選択します。

  8. Cloud Services の Dynamic Media 設定を再作成します。 この手順では、削除されたサンプルコンテンツとビューアプリセットが再生成され、ビューアプリセットのオーサリングで​ 画像プレビュー ​が復元されます。

recommendation-more-help
experience-manager-cloud-service-help-main-toc