> For the complete documentation index, see [llms.txt](https://docs.avonnicomponents.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-it/pannello-proprieta/data-sources/cms-collection.md).

# CMS Collection

## Panoramica

Questa pagina spiega come **Raccolte CMS** può essere utilizzato come **origine dati** per i componenti Avonni in **Salesforce Experience Cloud**.

Quando supportata, una Raccolta CMS consente ad Avonni **componenti basati sui dati**—come il [**Elenco**](/experience-cloud/experience-cloud-it/experience-components/ax-list.md) oppure [**Tabella dati**](/experience-cloud/experience-cloud-it/experience-components/ax-data-table.md)—di essere popolati dinamicamente con contenuti gestiti in Salesforce CMS (articoli, immagini, documenti e altri elementi CMS), senza fare affidamento su record Salesforce o oggetti personalizzati.

Poiché Salesforce fornisce più architetture CMS, questa pagina chiarisce anche la **distinzione fondamentale tra Enhanced CMS e CMS legacy (non Enhanced)**. Solo le Raccolte CMS create con **Enhanced CMS** sono compatibili con i componenti Avonni che usano CMS come origine dati.

Comprendere questa distinzione è essenziale per evitare problemi di configurazione e garantire che le origini dati basate su CMS funzionino come previsto nei siti Experience Cloud.

***

## Che cos'è una Raccolta CMS?

Una Raccolta CMS è un raggruppamento di contenuti CMS (articoli, immagini, documenti, ecc.) che può essere interrogato e visualizzato dinamicamente in un sito Experience Cloud.

I componenti Avonni che supportano CMS come origine dati si basano su **API di Salesforce Content Services**, che sono compatibili solo con **Enhanced CMS**.

***

## Enhanced CMS vs CMS legacy

Salesforce attualmente supporta **due architetture CMS** che coesistono nella piattaforma:

### <mark style="background-color:green;">Enhanced CMS (supportato)</mark>

Enhanced CMS è l'architettura CMS moderna introdotta da Salesforce ed è il **solo tipo di CMS supportato dai componenti Avonni**.

Caratteristiche principali:

* Creato da **Setup → CMS Workspaces**
* Utilizza **API di Content Services**
* Le Raccolte CMS hanno ID record che iniziano con **`20V`**
* Il contenuto è inoltre indirizzabile tramite una **Content Key** (che inizia con `MC`)
* Progettato per le funzionalità moderne di Experience Cloud e la distribuzione headless

Questo è il modello CMS previsto dai componenti Avonni che supportano le Raccolte CMS.

***

### <mark style="background-color:orange;">CMS legacy / non Enhanced (non supportato)</mark>

Legacy CMS è il vecchio sistema CMS utilizzato storicamente dai siti Experience Cloud basati su Aura e gestito da:

Experience Workspaces → Gestione contenuti

Caratteristiche principali:

* Basato su oggetti CMS legacy (ad esempio `ManagedContent` e `ManagedContentCollection`)
* Storicamente le raccolte avevano ID record che iniziavano con **`0V5`**
* Il contenuto e i contenitori possono usare **`0Zu`** ID record
* **Non esposto tramite le API di Content Services**

Sebbene il contenuto CMS legacy possa ancora sembrare utilizzabile nell'interfaccia utente di Salesforce, esso **non può essere accessibile programmaticamente** dai componenti moderni che si basano su Content Services.

Di conseguenza, le Raccolte CMS legacy **non possono essere usate come origine dati** per i componenti Avonni.

***

## Perché le Raccolte CMS legacy non sono supportate

I componenti Avonni che supportano le Raccolte CMS si basano su Salesforce **API di Content Services** per interrogare e renderizzare il contenuto.

Salesforce espone solo **contenuti Enhanced CMS** tramite queste API.

Le raccolte CMS legacy:

* Non sono disponibili tramite Content Services
* Non forniscono Content Key
* Non possono essere risolte dai componenti che si aspettano `20V` oppure `MC` identificatori

Si tratta di una limitazione della piattaforma Salesforce, non di un problema di configurazione.

***

## siti Aura

Anche se il tuo sito Experience Cloud è basato su Aura:

* Enhanced CMS **può comunque essere usato** come origine di contenuti
* Le Raccolte CMS legacy create in Content Management **non sono compatibili** con le origini dati Avonni basate su CMS

Per usare le Raccolte CMS con i componenti Avonni sui siti Aura, devi creare le raccolte in un **Workspace Enhanced CMS**.

***

## Come creare una Raccolta CMS compatibile

Per usare una Raccolta CMS come origine dati nei componenti Avonni:

1. Vai a **Setup → CMS Workspaces**
2. Crea un nuovo **Workspace Enhanced CMS**
3. Crea una **Raccolta di contenuti** all'interno di quel workspace
4. Pubblica contenuti nella raccolta
5. Usa uno dei seguenti:
   * il **ID della raccolta di contenuti** (inizia con `20V`), oppure
   * il **Content Key** (`MC…`)

Solo questi identificatori sono supportati dai componenti Avonni.

***

## Riepilogo

| Tipo di CMS      | Posizione del workspace                    | Prefisso ID  | Supportato dall'origine dati CMS di Avonni |
| ---------------- | ------------------------------------------ | ------------ | ------------------------------------------ |
| **Enhanced CMS** | Setup → CMS Workspaces                     | `20V`, `MC`  | ✅ Sì                                       |
| **CMS legacy**   | Experience Workspaces → Gestione contenuti | `0V5`, `0Zu` | ❌ No                                       |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.avonnicomponents.com/experience-cloud/experience-cloud-it/pannello-proprieta/data-sources/cms-collection.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
