データソースのコンテキストを設定するために接頭辞を使いましょう
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
ほとんどの /xmc/en/users/xm-cloud/en/sitecoreai.htmlコンポーネントは再利用性を重視し、データソースの項目からデータを引き出します。つまり、表示されるコンテンツは表示されるページに縛られず、データソースの項目に保存されます。コンポーネントデータソースとは、そのコンポーネントのコンテンツがどこから取得されるかを定義するために設定した項目のことです。
コンポーネントにデータソースを割り当てるいくつかの方法を提供しています。 ソースフィールドレポートを実行し てデータソースのコンテキストを設定することもできますが、プレフィックスを使ってデータソースコンテキストを決定することもできます。
フィールドからデータソースを引き出す
フィールドからコンポーネントデータソースを取得するには:
-
以下の接頭辞を使用してください:
接頭辞
field:
例
field
コンテキストアイテムのフィールド名をデータソースとして使う場合、以下のことをします。
- フィールドタイプがリンクフィールドの場合、ターゲットアイテムIDをデータソースとして使用します。
- フィールドタイプがリンクフィールドでなく、フィールド値が空でない場合、フィールドの生値がデータソースとして使用されます。
例えば、部分的なデザインを使う製品詳細ページがあり、その部分的なデザインのコンポーネントで商品項目欄からコンテンツを選択する必要がある場合に便利です。
ページに対してデータソースを指定します
アイテムの全パスを指定する代わりに、特別な表記を使ってそのパスをコンテキストアイテムに対して相対的に設定できます。ページがレンダリングされる際に、相対パスを完全なアイテムパスに変換します。
これは、例えば部分的なデザインで、グローバルな場所からデータを取るのではなく、各ページの下にデータを保存したい場合など、再利用可能なページ要素に便利です。
ページに対するデータソースを指定するには、ページとローカルプレフィックスを使用します。
接頭辞
page:
local:
例
page:/blog1
local:/data/text1
ダッシュ付きのアイテムはハッシュタグを使ってください。例えば:
page:/#my-test-blog#
ページデータフォルダのページの下に格納されたコンポーネントに対してpage: 記法を使用します。多くの場合、page: とlocal: 表記は同じ結果をもたらします。部分的なデザインで使われる場合、local: 記法はその部分的な設計下からアイテムを取り出しますが、page: は常にページ下のデータソースを探す必要があります。