カタログ画像のソースの設定

概要

ストアフロントの画像を Sitecore DAM とメディア ライブラリのどちらから取得するかを設定します。

画像などのメディアは、ストアフロント サイトのインパクトと使いやすさを大幅に向上させることができます。以前は、メディア アイテムはメディア ライブラリに保存されていました。Sitecore Digital Asset Management (DAM) システムの導入に伴い、メディア ライブラリまたは DAM のいずれかから画像を取得できるようになりました。

注記

Sitecore DAM とのカスタム統合を作成する場合にのみ、カタログ画像のソースとして DAM を使用できます。

デフォルトの画像ソースはメディア ライブラリですが、プライマリ画像ソースを DAM となるように設定できます。これはサイト レベルで行うことも、ページ アイテム、ページ、またはパーシャル デザインに挿入するときに個々のレンダリングを設定することもできます。サイト設定とレンダリングレベル設定は、実行時に (OR 演算子を使用して) マージされます。いずれかを選択すると、画像は DAM から取得されます。

次の図は、画像の URL を取得するときに、レンダリング、レンダリング モデル、およびプロバイダーとクラスがどのように通信するかを示しています。

商品画像の通信のシーケンス図

シーケンス図は次のことを示しています。

  • CatalogProductImageOptions クラス - CatalogProductImage オブジェクトを作成するため、または画像リンクを取得するためにプロバイダーに渡される引数の 1 つ。

  • CatalogProductInfoProvider - 製品情報を取得するためにリポジトリが使用。

  • CatalogProductImagesProvider - CatalogProductInfoProvider が使用。これには、メディア ライブラリまたは DAM から画像を取得するためのロジックが含まれています。また、フォールバック ロジックも含まれています。

    注記

    DAM 画像は SXA Storefront では拡大縮小されません。

CatalogProductInfoProviderCatalogProductImagesProvider は、CatalogProductImage クラスと一緒に Sitecore.Commerce.XA.Foundation.Common.config ファイルに登録されています。

注記

デフォルトでは、商品画像が DAM で使用できない場合の画像のフォールバックは、メディア ライブラリから取得することです。CatalogProductImage プロバイダーをカスタマイズすることで、この動作を変更できます。

サイト レベルでカタログ画像ソースを設定するには:

  1. コンテンツ エディターで、sitecore/<テナント>/<サイト>/Settings/Commerce/Catalog Configuration に移動します。

  2. [コンテンツ] タブの [Commerce] セクションで、[Sitecore Digital Asset Management システムの画像を使用する] 画像チェック ボックスをクリックします。

    DAM から画像を使用するためのサイト レベルのチェック ボックス

    警告

    サイト レベルの設定とレンダリング レベルの設定は、実行時に (OR 演算子を使用して) マージされます。いずれかを選択すると、画像は DAM から取得されます。

  3. リボン メニューの [保存] をクリックして、変更を保存します。

レンダリング用にカタログ画像ソースを設定するには:

  1. エクスペリエンス エディターで、ページ上のレンダリングをクリックし、選択します。

  2. <rendering> ツールバーで、[詳細]、[コンポーネント プロパティを編集する] の順に選択します。

  3. [コントロール プロパティ] ダイアログ ボックスの [カタログ画像] セクションで、[Sitecore Digital Asset Management システムの画像を使用する] チェック ボックスをクリックします。

    [Sitecore Digital Asset Management システムの画像を使用する] チェック ボックス

    警告

    サイト レベルの設定とレンダリング レベルの設定は、実行時に (OR 演算子を使用して) マージされます。いずれかを選択すると、画像は DAM から取得されます。

  4. リボン メニューの [保存] をクリックして、変更を保存します。