# Collection CMS

## Aperçu

Cette page explique comment **Collections CMS** peuvent être utilisées comme **source de données** pour les composants Avonni dans **Salesforce Experience Cloud**.

Lorsqu'elle est prise en charge, une collection CMS permet aux composants Avonni **pilotés par les données**—comme le [**Liste**](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-fr/experience-components/ax-liste) ou [**Tableau de données**](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-fr/experience-components/ax-tableau-de-donnees)—d'être remplis dynamiquement avec du contenu géré dans Salesforce CMS (articles, images, documents et autres éléments CMS), sans dépendre des enregistrements Salesforce ou d'objets personnalisés.

Parce que Salesforce propose plusieurs architectures CMS, cette page clarifie également la **distinction critique entre le CMS amélioré et le CMS hérité (non amélioré)**. Seules les collections CMS créées avec **CMS amélioré** sont compatibles avec les composants Avonni qui utilisent le CMS comme source de données.

Comprendre cette distinction est essentiel pour éviter les problèmes de configuration et pour garantir que les sources de données basées sur le CMS fonctionnent comme prévu dans les sites Experience Cloud.

***

## Qu'est-ce qu'une collection CMS ?

Une collection CMS est un regroupement de contenu CMS (articles, images, documents, etc.) qui peut être interrogé et affiché dynamiquement dans un site Experience Cloud.

Les composants Avonni qui prennent en charge le CMS comme source de données s'appuient sur **les API Content Services de Salesforce**, qui sont compatibles uniquement avec **CMS amélioré**.

***

## CMS amélioré vs CMS hérité

Salesforce prend actuellement en charge **deux architectures CMS** qui coexistent sur la plateforme :

### <mark style="color:par défaut;background-color:green;">CMS amélioré (Pris en charge)</mark>

Le CMS amélioré est l'architecture CMS moderne introduite par Salesforce et est le **seul type de CMS pris en charge par les composants Avonni**.

Caractéristiques clés :

* Créé depuis **Configuration → Espaces de travail CMS**
* Utilise **les API Content Services**
* Les collections CMS ont des ID d'enregistrement commençant par **`20V`**
* Le contenu est également adressable via une **clé de contenu** (commençant par `MC`)
* Conçu pour les fonctionnalités modernes d'Experience Cloud et la diffusion headless

Ceci est le modèle CMS attendu par les composants Avonni qui prennent en charge les collections CMS.

***

### <mark style="color:par défaut;background-color:orange;">CMS hérité / non amélioré (Non pris en charge)</mark>

Le CMS hérité est l'ancien système CMS historiquement utilisé par les sites Experience Cloud basés sur Aura et géré depuis :

Espaces de travail Experience → Gestion de contenu

Caractéristiques clés :

* Pris en charge par des objets CMS hérités (par exemple `ManagedContent` et `ManagedContentCollection`)
* Les collections avaient historiquement des ID d'enregistrement commençant par **`0V5`**
* Le contenu et les conteneurs peuvent utiliser **`0Zu`** ID d'enregistrement
* **Non exposé via les API Content Services**

Même si le contenu du CMS hérité peut encore sembler utilisable dans l'interface Salesforce, il **ne peut pas être accédé de manière programmatique** par des composants modernes qui s'appuient sur Content Services.

En conséquence, les collections CMS héritées **ne peuvent pas être utilisées comme source de données** pour les composants Avonni.

***

## Pourquoi les collections CMS héritées ne sont pas prises en charge

Les composants Avonni qui prennent en charge les collections CMS s'appuient sur Salesforce **les API Content Services** pour interroger et rendre le contenu.

Salesforce n'expose que **le contenu du CMS amélioré** via ces API.

Les collections CMS héritées :

* Ne sont pas disponibles via Content Services
* Ne fournissent pas de clés de contenu
* Ne peuvent pas être résolues par des composants qui attendent `20V` ou `MC` des identifiants

Il s'agit d'une limitation de la plateforme Salesforce, pas d'un problème de configuration.

***

## Sites Aura

Même si votre site Experience Cloud est basé sur Aura :

* CMS amélioré **peuvent toujours être utilisés** comme source de contenu
* Les collections CMS héritées créées dans la gestion de contenu **ne sont pas compatibles** avec les sources de données Avonni basées sur le CMS

Pour utiliser des collections CMS avec les composants Avonni sur des sites Aura, vous devez créer les collections dans un **espace de travail CMS amélioré**.

***

## Comment créer une collection CMS compatible

Pour utiliser une collection CMS comme source de données dans les composants Avonni :

1. Allez à **Configuration → Espaces de travail CMS**
2. Créez un nouveau **espace de travail CMS amélioré**
3. Créez un **Collection de contenu** à l'intérieur de cet espace de travail
4. Publiez du contenu dans la collection
5. Utilisez l'un des deux :
   * le **ID de la collection de contenu** (commence par `20V`), ou
   * le **clé de contenu** (`MC…`)

Seuls ces identifiants sont pris en charge par les composants Avonni.

***

## Résumé

| Type de CMS      | Emplacement de l'espace de travail                 | Préfixe d'ID | Pris en charge par la source de données CMS d'Avonni |
| ---------------- | -------------------------------------------------- | ------------ | ---------------------------------------------------- |
| **CMS amélioré** | Configuration → Espaces de travail CMS             | `20V`, `MC`  | ✅ Oui                                                |
| **CMS hérité**   | Espaces de travail Experience → Gestion de contenu | `0V5`, `0Zu` | ❌ Non                                                |