> ## Documentation Index
> Fetch the complete documentation index at: https://developers.hubspot.fr/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Objets CRM dans les pages CMS
> Les objets CRM peuvent être demandés et rendus sur le contenu hébergé par HubSpot, ce qui permet de partager les données entre vos opérations commerciales, votre site Web et vos e-mails.
'Les objets CRM peuvent être demandés et rendus sur le contenu hébergé par HubSpot, ce qui permet de partager les données entre vos opérations commerciales, votre site Web et vos e-mails.';
Vous pouvez interroger les objets CRM pour utiliser les données des enregistrements de l'objet sur le contenu hébergé par HubSpot, ce qui permet de partager les données entre vos opérations commerciales, votre site Web et vos e-mails. En utilisant les fonction HubL [`crm_object`](/docs/cms/reference/hubl/functions#crm-object), [`crm_objects`](/docs/cms/reference/hubl/functions#crm-objects) et [`crm_associations`](/docs/cms/reference/hubl/functions#crm-associations), vous pouvez afficher et contrôler la logique basée sur les données de vos objets CRM.
L'utilisation des données CRM sur votre site web signifie que vos données sur les ventes, marketing et le site web se trouvent toutes au même endroit et reflètent toujours les mêmes informations. En outre, comme vous pouvez associer des enregistrements CRM les uns aux autres, vous pouvez également intégrer les données associées dans les pages de votre site web.
De même, vous pouvez [créer des ensembles de pages dynamiques qui se génèrent automatiquement à l'aide d'objets CRM ou de données HubDB](https://developers.hubspot.com/docs).
Découvrez-en davantage sur la création de pages CMS basées sur les données dans le cours [CMS Data-Driven Content](https://app.hubspot.com/academy/tracks/1148948/intro) de HubSpot Academy.
### Exemple de cas d'utilisation
Un exemple d'utilisation des données d'un objet CRM dans des pages est celui d'une page d'annonces immobilières. Avec un objet personnalisé appelé *propriété*, des enregistrements d'objets individuels peuvent être créés pour chaque maison qui doit être répertoriée. Les agents immobiliers peuvent ensuite ajouter des informations aux propriétés des objets afin de stocker des détails, tels que l'emplacement, le nombre de chambres et les prix demandés.
Les pages du site web peuvent alors extraire les données de l'enregistrement pour chaque propriété afin de créer une page d'inscription et des pages de détails pour chaque propriété.
[Consultez le répertoire GitHub](https://github.com/HubSpot/cms-custom-objects-example) pour voir l'exemple complet.
Pour avoir une vue d'ensemble de cet exemple, consultez l'[enregistrement de la Journée des développeurs HubSpot 2020](https://developers.hubspot.com/community/developer-day-2020).
## Types d'objets CRM pris en charge
Vous trouverez ci-dessous les types d'objets CRM dont vous pouvez tirer des données pour les pages de votre CMS. Le fait que vous puissiez utiliser les données sur toutes les pages ou uniquement sur les pages privées dépend du type d'objet.
Dans les tableaux ci-dessous, découvrez les types d'objets disponibles pour le contenu du CMS ainsi que leurs noms et noms entièrement qualifiés.
### Données des objets CRM disponibles pour toutes les pages
Les données des objets CRM suivants peuvent être utilisées sur n'importe quelle page du CMS.
| Type d'objet | Nom de l'objet | Nom entièrement qualifié |
| -------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------ |
| [Produits](/docs/api-reference/crm-products-v3/guide) | `product` | `PRODUCT` |
| [Événements marketing](/docs/api-reference/marketing-marketing-events-v3/guide) | `marketing_event` | `MARKETING_EVENT` |
| [Objets personnalisés](/docs/api-reference/crm-custom-objects-v3/guide) | ***Content Hub** Entreprise* uniquement. Vous pouvez utiliser le [nom entièrement qualifié](/docs/cms/start-building/features/data-driven-content/crm-objects#getting-a-custom-object-type-s-details) de l'objet ou le nom saisi au moment de la création. Par exemple, si vous créez un objet nommé `Cars`, vous ne pouvez pas le référencer avec `cars` ou `Car`. Vous devez utiliser le [nom entièrement qualifié](/docs/cms/start-building/features/data-driven-content/crm-objects#getting-a-custom-object-type-s-details) si l'objet personnalisé partage un nom avec un objet standard. Il est également fortement recommandé d'utiliser le nom entièrement qualifié si le nom de l'objet est entièrement en majuscules afin d'éviter tout conflit potentiel avec les objets standard de HubSpot. | |
### Données des objets CRM disponibles pour les pages privées
Les données des objets de CRM suivants ne peuvent être utilisées que sur les pages nécessitant un [mot de passe](https://knowledge.hubspot.com/fr/website-pages/password-protect-a-page) ou une [connexion de membre.](https://knowledge.hubspot.com/fr/website-pages/require-member-registration-to-access-private-content)
| Type d'objet | Nom de l'objet | Nom entièrement qualifié |
| ----------------------------------------------------------- | -------------- | ------------------------ |
| [Contacts](/docs/api-reference/crm-contacts-v3/guide) | `contact` | `CONTACT` |
| [Entreprises](/docs/api-reference/crm-companies-v3/guide) | `company` | `COMPANY` |
| [Transactions](/docs/api-reference/crm-deals-v3/guide) | `deal` | `DEAL` |
| [Tickets](/docs/api-reference/crm-tickets-v3/guide) | `ticket` | `TICKET` |
| [Devis](/docs/api-reference/crm-quotes-v3/guide) | `quote` | `QUOTE` |
| [Lignes de produit](/docs/api-reference/crm-line-items-v3/guide) | `line_item` | `LINE_ITEM` |
## Afficher les données d'un seul enregistrement CRM avec la fonction crm\_object
Utilisez la fonction [`crm_object`](/docs/cms/reference/hubl/functions#crm-object) pour obtenir un enregistrement unique de la fonctionnalité CRM de HubSpot par requête ou par ID d'enregistrement CRM.
Les enregistrements d'objets sont renvoyés sous la forme d'un dictionnaire de propriétés et de valeurs.
```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 }}
```
```html theme={null}
Defensive Health
Defensive Health
```
Si une requête renvoie une collection d'enregistrements, la fonction renvoie le premier enregistrement de la collection.
## Afficher les données de plusieurs enregistrements CRM avec la fonction crm\_objects
Utilisez la fonction [`crm_objects()`](/docs/cms/reference/hubl/functions#crm-objects) pour obtenir des enregistrements CRM par type d'objet à partir de la fonctionnalité CRM de HubSpot par requête ou par ID d'enregistrement. Les enregistrements sont renvoyés sous la forme d'un dictionnaire de propriétés et de valeurs.
L'enregistrement renvoyé contient une propriété `results` qui peut être mise en boucle pour afficher les informations dans les éléments de l'enregistrement.
```hubl theme={null}
{# Render custom objects by query #}
{% set events = crm_objects("event", "limit=3&type=virtual") %}
{{events.total}} New Events:
{% for event in events.results %}
- Name: {{ event.name }}
{% endfor %}
{# Render custom objects by ids #}
{% set events = crm_objects("event", [289236,289237,289238]) %}
{{events.total}} New Events:
{% for event in events.results %}
- Name: {{ event.name }}
{% endfor %}
```html theme={null}
3 New Events:
- Name: Defensive Health
- Name: Body Balance
- Name: Happy Heart
3 New Events:
- Name: Defensive Health
- Name: Body Balance
- Name: Happy Heart
```
## Affichage des enregistrements associés
Utilisez la fonction [`crm_associations`](/docs/cms/reference/hubl/functions#crm-associations) de HubL pour obtenir une liste d'informations associées à partir de la fonctionnalité CRM de HubSpot en fonction de l'ID d'enregistrement, de la catégorie d'association et de l'ID de définition de l'association.[](#getting-a-custom-object-s-details)
Les enregistrements sont renvoyés sous la forme d'un dictionnaire de propriétés et de valeurs.
```hubl theme={null}
{% set associated_objects = crm_associations(289236, "USER_DEFINED", 3) %}
Contacts Associated With Event
{% for contact in associated_objects.results %}
- Name: {{ contact.firstname }} {{ contact.lastname }}
{% endfor %}
```
```html theme={null}
Contacts Associated With Event
- Name: Brian Halligan
- Name: Dharmesh Shah
- Name: Yamini Rangan
```
## Obtenir les détails d'un type d'objet personnalisé
Pour obtenir les éléments `name`, `id`, `fullyQualifiedName`, les ID d'association et d'autres détails d'un type d'objet personnalisé, vous pouvez effectuer une requête `GET` sur l'[API schéma d'objets CRM](https://developers.hubspot.com/docs).
`fullyQualifiedName` pour les types d'objets spécifiques au compte inclut l'ID du compte HubSpot, il est donc recommandé d'éviter de l'utiliser lorsque vous développez votre code pour plusieurs comptes HubSpot.
## Champ Module d'objet CRM
Pour permettre aux créateurs de contenu de sélectionner les enregistrements CRM à afficher ou d'exécuter une logique, vous pouvez construire des modules qui incluent le [champ d'objet CRM](https://developers.hubspot.fr/docs/cms/reference/fields/module-theme-fields#crm-object).
Par exemple, si vous souhaitez afficher les informations d'un produit, d'un contact, d'une entreprise, d'une transaction, d'un devis, d'un ticket ou d'un objet personnalisé.
## Tutoriels et ressources concernant les objets CRM
* [Premiers pas avec les objets personnalisés](https://developers.hubspot.com/blog/essentials-for-getting-started-with-custom-objects)
* [Penser comme un architecte : créer des objets personnalisés évolutifs](https://developers.hubspot.com/blog/how-to-think-like-an-architect-by-building-scalable-custom-objects)
* [Créer des pages dynamiques avec des objets de CRM](https://developers.hubspot.com/docs)