プレフィックスを使用してデータソースのコンテキストを設定する

コンポーネントデータソースをフィールドからプルするには:

コンテキスト アイテムのフィールド名をデータ ソースとして使用する場合、SXAは次のことを行います。

これは、たとえば、パーシャル デザインを使用する製品詳細ページがあり、パーシャル デザインのコンポーネントで製品アイテム フィールド自体からコンテンツを選択する場合に便利です。

項目のフルパスを指定する代わりに、特別な表記を使用して、そのパスをコンテキスト項目に対して相対的にすることができます。SXAは、ページがレンダリングされるときに、相対パスを完全なアイテム パスに変換します。

これは、再利用可能なページ要素、たとえばパーシャル デザインで、データをグローバルな場所から取得するのではなく、各ページの下に保存したい場合に便利です。

ページに対する相対的なデータソースを指定するには、pageプレフィックスとlocalプレフィックスを使用します。

SXAは、ページ データ フォルダー内のページの下に保存されるコンポーネントにpage: 表記を使用します。多くの場合、page: 表記とlocal: 表記は同じ結果になります。パーシャル デザインで使用すると、local: 表記ではそのパーシャル デザインの下からアイテムが取得されますが、page: では、SXAは常にページの下のデータ ソースを検索するように強制されます。

コードを使用してデータソースを解決するには:

このメソッドを使用すると、データ ソースに使用する項目の配列を取得できます。Sitecoreに渡されるアイテムは、コードが返すアイテムになります。これを使用してコンポーネントのデータソースを設定している場合、これがそのContext.Itemになります。コードはresolveRenderingDatasourceパイプライン プロセッサで呼び出されます。

これは、たとえば、時刻やその他のビジネス固有の基準に基づいて、さまざまなアイテムを返品する場合に便利です。

コンテンツ検索クエリを使用して、Sitecoreアイテムを取得します。コンポーネントが取得する項目を制限するには、検索クエリの絞り込み条件を指定します。

これは、SXA動的クエリ トークンを使用する場合や、ファセットの1つに基づいてデータ ソース アイテムを選択する場合に便利です。

Sitecoreクエリを使用してSitecoreアイテムを取得できます。フィルタリングを含む標準のSitecoreクエリ表記を使用できます。

これは、アイテムツリーの場所に基づいてデータソースにアイテムを動的に入力する場合に便利です。