---
title: "外部データソースからデータ項目を割り当てる"
slug: "assign-a-data-item-from-an-external-data-source"
abstract: "コンポーネントには、外部データソースにリンクしたい未割り当てのデータ項目が含まれます。これにはURL、GraphQL、またはJSONファイルから取得されるデータが含まれます。"
---
# 外部データソースからデータ項目を割り当てる

ページビルダーでは、Sitecoreのコンポーネントには、URLやGraphQLから取得したデータ、またはJSONに含まれるデータなど、外部データソースにリンクする必要がある未割り当てのデータ項目が含まれています。右側の設定オプションから、コンポーネントのデータアイテムとして外部データソースを設定する手順を案内できます。

コンポーネントはコンポーネントビルダーでデータの [配列を受け入れ](https://doc.sitecore.com/sai/ja/users/sitecoreai/design-components/components/adding-dynamic-content-to-a-component/set-a-repeater-for-an-array.html "Set a repeater for an array") るように設定できます。この構成により、特定のデータを選択したり、データソースから取得するアイテム数を制限したりできます。

![Additional options are available when the component has been configured to accept an array of data as data source](https://doc.sitecore.com/api/markdown-image/sai/ja/users/sitecoreai/images/limitandspecify.jpg)

## 登録データソースからデータ項目を割り当てます

コンポーネントでは、**データソース**タブを使って[外部データソースをプロジェクトに追加](https://doc.sitecore.com/sai/ja/users/sitecoreai/design-components/components/adding-dynamic-content-to-a-component/get-your-content-from-external-data-sources.html "Get your content from external data sources")するか、データソースを登録することで可能です。これらのデータソースは、ページビルダーでコンポーネントにデータ項目を割り当てる際に利用できます。

コンポーネントビルダーに登録されたデータソースからデータ項目を割り当てるには:

1.  Pagesの該当ウェブページで、データソースを割り当てたいコンポーネントをクリックし、その後:mdiTextSearch:をクリックしてください。
    
2.  右側のペインで「 **データ項目**」をクリックします。設定パネル上部のインジケーターは、ソースを選択し、次にアイテムを選択する2ステップのプロセスを示しています。
    
3.  希望するデータソースをクリックし、**次にクリック**します。
    
4.  アイテムをクリックして使用してください。
    
    > !注配列を使う際は、配列のすべてのアイテムを使うか、選択を特定の数に制限するか、配列内のランクに応じて使用するアイテムを指定することができます。
    
5.  **完了**をクリックします。
    

## JSONオブジェクトからデータ項目を取得する

JSONオブジェクトを外部データソースとして使用するには:

1.  ページビルダーで、データソースを割り当てるコンポーネントがあるウェブページを開きます。
2.  コンポーネントをクリックしてから:mdiTextSearch:をクリックします。
3.  右側のパネルでは、 **データソース** の概要で現在選択されているデータが表示されます。
4.  データを変更するには、 **カスタマイズ** :mdiCloudRefreshOutline: をクリックしてください。
5.  **データ**ドロップダウンメニューで「**JSONを貼り付け**る」をクリックします。
6.  使いたいデータを含むJSONを貼り付けます。

## URLからデータを取得します

URLに保存された外部データソースを利用するには:

1.  ページビルダーで、データソースを割り当てる必要があるコンポーネントがあるウェブページを開きます
2.  コンポーネントをクリックしてから:mdiTextSearch:をクリックします。
3.  右側のパネルでは、 **データソース** の概要で現在選択されているデータが表示されます。
4.  データを変更するには、 **カスタマイズ** :mdiCloudRefreshOutline: をクリックしてください。
5.  **データ**ドロップダウンメニューで**「URLから取得**」をクリックします。
6.  **メソッド**で**GET**をクリックします。
7.  データ **取得** フィールドでデータソースのURLを入力し、 **Fetch**をクリックします。
8.  **Params**、**Headers**、**Body**のタブでは、必要なデータ項目がキーペアと値ペアとして含まれているか確認できます。不要なデータを削除したり、欠けている場合はキーと値の組み合わせを追加できます。
9.  読み終わったら、「 **保存**」をクリックします。

## GraphQLからデータを取得

GraphQLクエリを外部データソースとして使用するには:

1.  ページビルダーで、データソースを割り当てる必要があるコンポーネントがあるウェブページを開きます
2.  コンポーネントをクリックしてから:mdiTextSearch:をクリックします。
3.  右側のパネルでは、 **データソース** の概要で現在選択されているデータが表示されます。
4.  データを変更するには、 **カスタマイズ** :mdiCloudRefreshOutline: をクリックしてください。
5.  **データ**ドロップダウンメニューで、**GraphQLからFetch**をクリックします。
6.  **メソッド**で**POST**をクリックします。
7.  データ **取得** フィールドでデータソースのURLを入力し、 **Fetch**をクリックします。
8.  **Params**と**Headers**タブでは、必要なデータ項目がキーと値のペアとして含まれているか確認できます。不要なデータを削除したり、欠けている場合はキーと値の組み合わせを追加できます。
9.  **Body**タブで、必要なデータ項目がクエリと変数として含まれているか確認してください。
10.  読み終わったら、「 **保存**」をクリックします。