---
title: "データソースのコンテキストを設定するために接頭辞を使いましょう"
slug: "use-a-prefix-to-set-the-data-source-context"
abstract: "プレフィックスを使ってデータソースからコンポーネントデータを取得します。"
---
# データソースのコンテキストを設定するために接頭辞を使いましょう

ほとんどの[SitecoreAI](https://doc.sitecore.com/sai/en/users/sitecoreai/sitecoreai.html)コンポーネントは再利用性を重視し、データソースからデータを取得する設計です。つまり、表示されるコンテンツは表示されるページに縛られず、データソースの項目に保存されます。コンポーネントデータソースとは、そのコンポーネント上で設定して、そのコンポーネントのコンテンツがどこから取得されるかを定義する項目です。

SitecoreAIは、コンポーネントにデータソースを割り当てるいくつかの方法を提供しています。 [ソースフィールドレポートを実行し](https://doc.sitecore.com/sai/ja/developers/sitecoreai/content-modeling-and-presentation/data-sources/run-a-source-field-report-to-set-the-data-source-context.html "Run a source field report to set the data source context") てデータソースのコンテキストを設定することもできますが、プレフィックスを使ってデータソースコンテキストを決定することもできます。

## フィールドからデータソースを引き出す

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

-   以下の接頭辞を使用してください:
    
    接頭辞
    
    フィールド:
    
    例
    
    フィールド:タイトル
    

コンテキストアイテムのフィールド名をデータソースとして使用した場合、SitecoreAIは以下の動作を行います。

-   フィールドタイプがリンクフィールドの場合、SitecoreAIはターゲットアイテムIDをデータソースとして使用します。
-   フィールドタイプがリンクフィールドでなく、フィールド値が空でない場合、SitecoreAIはフィールドの生値をデータソースとして使用します。

例えば、部分的なデザインを使う製品詳細ページがあり、その部分的なデザインのコンポーネントで商品項目欄からコンテンツを選択する必要がある場合に便利です。

## ページに対してデータソースを指定します

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

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

ページに対するデータソースを指定するには、ページとローカルプレフィックスを使用します。

接頭辞

ページ:ローカル:

例

page:/blog1local:/data/text1 ダッシュ付きの項目はハッシュタグを使いましょう。例えば:page:/#my-test-blog#

SitecoreAIページデータフォルダ内のページの下に格納されたコンポーネントに対してpage: 記法を使用しています。多くの場合、page: とlocal: の表記は同じ結果をもたらします。部分設計で使われる場合、local: 表記法はその部分設計の下から項目を取得させますが、page: はSitecoreAI常にページ下のデータソースを探すことを強制します。