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