> ## Documentation Index
> Fetch the complete documentation index at: https://developers.hubspot.jp/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# CMSページでのCRMオブジェクト

> CRMオブジェクトのクエリーを実行し、HubSpot上にホスティングされたコンテンツにレンダリングできます。これにより、業務、ウェブサイト、Eメールでのデータ共有が可能になります。

'CRMオブジェクトのクエリーを実行し、HubSpot上にホスティングされたコンテンツにレンダリングできます。これにより、業務、ウェブサイト、Eメールでのデータ共有が可能になります。';

CRMオブジェクトのクエリーを実行して、HubSpotでホスティングされるコンテンツ上にオブジェクトのレコードからのデータを表示させることができます。これにより、業務、ウェブサイト、Eメールの間でデータを共有できます。[`crm_object`](/cms/reference/hubl/functions#crm-object)、[`crm_objects`](/cms/reference/hubl/functions#crm-objects)、[`crm_associations`](/cms/reference/hubl/functions#crm-associations)のHubL関数を使用すると、CRMオブジェクトデータに基づいてロジックを表示および制御できます。

ウェブサイト上でCRMデータを使用することで、営業、マーケティング、ウェブサイトのデータが全て同じ場所に存在し、常に同じ情報が反映されることになります。さらに、CRMレコードを相互に関連付けることができるので、関連付けられたデータをウェブサイトページに取り込むこともできます。

同様に、[CRMオブジェクトまたはHubDBデータを使用して自動生成される動的ページのセットを作成](https://developers.hubspot.com/docs)できます。

<Alert type="info">
  データに基づくCMSページの構築について詳しくは、HubSpotアカデミーの[CMSデータ駆動コンテンツのコース](https://app.hubspot.com/academy/tracks/1148948/intro)を参照してください。
</Alert>

### 使用例

ページでCRMオブジェクトデータを使用する例の1つとして、不動産リストページがあります。「物件」と呼ばれるカスタムオブジェクトを使用すると、リストに掲載する必要のある家屋ごとにオブジェクトレコードを作成できます。\_ \_次に、不動産業者は物件オブジェクトに情報を追加して、場所、寝室の数、希望価格などの詳細を保存することができます。

その後、ウェブサイトページで各物件のレコードデータを取り込んで、リスティングページと各物件の詳細ページを作成できます。

この例全体を確認するには、[GitHubリポジトリー](https://github.com/HubSpot/cms-custom-objects-example)をご参照ください。

この例の概要については、[HubSpot Developer Day 2020の録画](https://developers.hubspot.com/community/developer-day-2020)をご参照ください。

## サポートされるCRMオブジェクトタイプ

CMSページのデータの取得元として可能なCRMオブジェクトの種類を以下に示します。全てのページでデータを使用できるか、それとも非公開ページでのみデータを使用できるかは、オブジェクトタイプによって異なります。

以下の表は、CMSコンテンツで使用可能なオブジェクトタイプと、そのオブジェクトタイプ名および完全修飾名を示しています。

### 全てのページで使用できるCRMオブジェクトデータ

次のCRMオブジェクトからのデータは、任意のCMSページで使用可能です。

| オブジェクトタイプ                                                         | object\_type\_name                                                                                                                                                                                                                                                                                                                                                                                                                                                | 完全修飾名             |
| ----------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- |
| [製品](/api-reference/crm-products-v3/guide)                        | `product`                                                                                                                                                                                                                                                                                                                                                                                                                                                         | `PRODUCT`         |
| [マーケティングイベント](/api-reference/marketing-marketing-events-v3/guide) | `marketing_event`                                                                                                                                                                                                                                                                                                                                                                                                                                                 | `MARKETING_EVENT` |
| [カスタムオブジェクト](/api-reference/crm-custom-objects-v3/guide)          | **Content Hub** Enterpriseのみ。\_ \_オブジェクトの[完全修飾名](/cms/start-building/features/data-driven-content/crm-objects#getting-a-custom-object-type-s-details)または作成時に入力した名前を使用できます。例えば、`Cars`という名前のオブジェクトを作成した場合、`cars`や`Car`で参照することはできません。カスタムオブジェクトの名前が標準オブジェクトと同じ場合は、[完全修飾名](/cms/start-building/features/data-driven-content/crm-objects#getting-a-custom-object-type-s-details)を使用する必要があります。また、オブジェクト名が全て大文字で表記される場合は、HubSpotの標準オブジェクトとの競合を避けるためにFQNを使用することを強くお勧めします。 |                   |

### 非公開ページで使用できるCRMオブジェクトデータ

以下のCRMオブジェクトからのデータは、[パスワード](https://knowledge.hubspot.com/ja/website-pages/password-protect-a-page)または[メンバーシップログイン](https://knowledge.hubspot.com/ja/website-pages/require-member-registration-to-access-private-content)のいずれかを必要とするページでのみ使用可能です。

| オブジェクトタイプ                                      | object\_type\_name | 完全修飾名       |
| ---------------------------------------------- | ------------------ | ----------- |
| [コンタクト](/api-reference/crm-contacts-v3/guide)  | `contact`          | `CONTACT`   |
| [会社](/api-reference/crm-companies-v3/guide)    | `company`          | `COMPANY`   |
| [取引](/api-reference/crm-deals-v3/guide)        | `deal`             | `DEAL`      |
| [チケット](/api-reference/crm-tickets-v3/guide)    | `ticket`           | `TICKET`    |
| [見積もり](/api-reference/crm-quotes-v3/guide)     | `quote`            | `QUOTE`     |
| [商品項目](/api-reference/crm-line-items-v3/guide) | `line_item`        | `LINE_ITEM` |

## crm\_object関数を使用して単一のCRMレコードからのデータを表示する

[`crm_object`](/cms/reference/hubl/functions#crm-object)関数を使用し、クエリーまたはCRMレコードIDを使ってHubSpotのCRMから単一のレコードを取得します。

オブジェクトレコードは、プロパティーと値から成るディクショナリーとして返されます。

<Tabs defaultSelected="0">
  <Tab tabId="0" title="入力">
    ```hubl theme={null}
    {# Render custom object by query #}
    {% set event = crm_object("event", "name=Defensive Health") %}
    {{ event.name }}

    {# Render custom objects specifying the id of the object #}
    {% set event = crm_object("event", 289236) %}
    {{ event.name }}
    ```
  </Tab>

  <Tab tabId="1" title="出力">
    ```html theme={null}
    <p>Defensive Health</p>

    <p>Defensive Health</p>
    ```
  </Tab>
</Tabs>

<Alert type="info">
  クエリー結果としてレコードのコレクションが返された場合、この関数はコレクション内の最初のレコードを返します。
</Alert>

## crm\_objects関数を使用して複数のCRMレコードからのデータを表示する

[`crm_objects()`](/cms/reference/hubl/functions#crm-objects)関数を使用し、クエリーまたはレコードIDを使ってHubSpotのCRMからオブジェクトタイプ別にCRMレコードを取得します。レコードは、プロパティーと値から成るディクショナリーとして返されます。

返されるオブジェクトには`results`プロパティーが含まれ、これをループ処理することでレコード内の項目の情報を表示できます。

<Tabs defaultSelected="0">
  <Tab tabId="0" title="入力">
    ```hubl theme={null}
    {# Render custom objects by query #}
    {% set events = crm_objects("event", "limit=3&type=virtual") %}
    <h3>{{events.total}} New Events:<h3>
    <ul>
    {% for event in events.results %}
    	<li>Name: {{ event.name }}</li>
    {% endfor %}
    <ul>

    {# Render custom objects by ids #}
    {% set events = crm_objects("event", [289236,289237,289238]) %}
    <h3>{{events.total}} New Events:<h3>
    <ul>
    {% for event in events.results %}
    	<li>Name: {{ event.name }}</li>
    {% endfor %}
    <ul>
    ```
  </Tab>

  <Tab tabId="1" title="出力">
    ```html theme={null}
    <h3>
      3 New Events:
      <h3>
        <ul>
          <li>Name: Defensive Health</li>
          <li>Name: Body Balance</li>
          <li>Name: Happy Heart</li>
          <ul>
            <h3>
              3 New Events:
              <h3>
                <ul>
                  <li>Name: Defensive Health</li>
                  <li>Name: Body Balance</li>
                  <li>Name: Happy Heart</li>
                  <ul></ul>
                </ul>
              </h3>
            </h3>
          </ul>
        </ul>
      </h3>
    </h3>
    ```
  </Tab>
</Tabs>

## 関連付けられたレコードの表示

[`crm_associations`](/cms/reference/hubl/functions#crm-associations)のHubL関数を使用すると、特定のレコードID、関連付けカテゴリー、関連付け定義IDに基づき、関連付けられているレコードのリストをHubSpotのCRMから取得できます。[](#getting-a-custom-object-s-details)

レコードは、プロパティーと値から成るディクショナリーとして返されます。

<Tabs defaultSelected="0">
  <Tab tabId="0" title="入力">
    ```hubl theme={null}
    {% set associated_objects = crm_associations(289236, "USER_DEFINED", 3) %}
    <h3>Contacts Associated With Event</h3>
    <ul>
    {% for contact in associated_objects.results %}
    	<li>Name: {{ contact.firstname }} {{ contact.lastname }}</li>
    {% endfor %}
    </ul>
    ```
  </Tab>

  <Tab tabId="1" title="出力">
    ```html theme={null}
    <h3>
      Contacts Associated With Event
      <h3>
        <ul>
          <li>Name: Brian Halligan</li>

          <li>Name: Dharmesh Shah</li>

          <li>Name: Yamini Rangan</li>
        </ul>
      </h3>
    </h3>
    ```
  </Tab>
</Tabs>

## カスタムオブジェクトタイプの詳細を取得する

カスタムオブジェクトタイプの`name`、`id`、`fullyQualifiedName`、関連付けID、その他の詳細を取得するには、[CRMオブジェクトスキーマAPI](https://developers.hubspot.com/docs)に`GET`リクエストを送信します。

<Alert type="warning" titleText="注：">
  アカウント固有のオブジェクトタイプの`fullyQualifiedName`にはHubSpotアカウントIDが含まれているので、複数のHubSpotアカウント用のコードを開発するときにはこれを使用しないことをお勧めします。
</Alert>

## CRMオブジェクトモジュールのフィールド

[CRMオブジェクトフィールド](https://developers.hubspot.jp/docs/cms/reference/fields/module-theme-fields#crm-object)を含むモジュールを構築すると、コンテンツ作成者は表示またはロジックを実行する対象のCRMレコードを選択できるようになります。

例えば、特定の製品、コンタクト、会社、取引、見積もり、チケット、またはカスタムオブジェクトからの情報を表示できます。

![CRMオブジェクトフィールド](https://f.hubspotusercontent00.net/hubfs/53/CRM%20Object%20Field.png)

## CRMオブジェクトのチュートリアルと資料

* [カスタムオブジェクトの基本](https://developers.hubspot.com/blog/essentials-for-getting-started-with-custom-objects)
* [建築家のように考える：スケーラブルなカスタムオブジェクトを構築する](https://developers.hubspot.com/blog/how-to-think-like-an-architect-by-building-scalable-custom-objects)
* [CRMオブジェクトを使用した動的ページの作成方法](https://developers.hubspot.com/docs)