> 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/tutorial/components/data-table/displaying-salesforce-cms-files-in-a-data-table.md).

# Visualizzazione dei file di Salesforce CMS in una Data Table

## Panoramica

Questo tutorial ti guida nell'uso di [Avonni **Tabella dati**](/experience-cloud/experience-cloud-it/tutorial/components/data-table.md) componente per visualizzare un elenco di file da una **Salesforce Content Management System (CMS) Collection**. Imparerai come configurare la tabella e aggiungere un pulsante "Scarica" per ogni file, offrendo un'esperienza fluida per gli utenti, soprattutto all'interno di un sito Experience Cloud.

**Cosa imparerai:**

* Come collegare la Avonni Data Table a una Salesforce CMS Collection.
* Come configurare le colonne per visualizzare dettagli dei contenuti come Titolo e Data di creazione.
* Come aggiungere una colonna di azione personalizzata con un pulsante "Scarica".
* Come usare l' **Download CMS** interazione per rendere i file scaricabili dagli utenti.

**Prerequisiti:**

* Devi avere una **Salesforce CMS Collection** attiva con uno o più elementi di contenuto pubblicati (ad es. PDF, immagini).
* Avrai bisogno dell' **ID di 18 caratteri** di questa CMS Collection.

***

## Passaggi guidati

{% stepper %}
{% step %}

### Aggiungi il componente Data Table

Per prima cosa, impostiamo la Data Table che visualizzerà il nostro elenco di file CMS.

1. Dalla **Libreria dei componenti** (pannello a sinistra), individua il **Avonni Data Table** componente e trascinalo sulla canvas.

<figure><img src="/files/343e2da175c0fffdfb995f04158c17921ba5d8ce" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Configura l'origine dati

Successivamente, dobbiamo collegare la Data Table alla tua specifica Salesforce CMS Collection.

1. Con la Data Table selezionata, individua la **Origine dati** proprietà nel Pannello Proprietà.
2. Seleziona **CMS Collection** dall'elenco dei tipi di origine dati.
3. Nel **ID della raccolta** campo che appare, inserisci l' **ID di 18 caratteri** della tua Salesforce CMS Collection o Content Key.

La Data Table è ora collegata e riconosce gli elementi di contenuto all'interno della tua raccolta.

<figure><img src="/files/1e80b886eee67d4e43f750cf29488f3c55fa727b" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Aggiungi colonne per visualizzare le informazioni sul contenuto

Ora definiamo quali dettagli sui file saranno visibili nella tabella.

1. Nelle proprietà della Data Table, vai alla **Colonne** sezione.
2. Clic **"Aggiungi colonna"** per creare una nuova colonna.
3. **Campo origine:** Seleziona un campo dai dati del contenuto CMS (ad es. `Titolo`).
4. **Etichetta colonna:** Assegnale un'etichetta chiara per l'utente (ad es. "Titolo documento").
5. Ripeti questo processo per aggiungere altre colonne rilevanti, come `CreatedDate` oppure `LastModifiedDate`.

<figure><img src="/files/35d1d232179252f283631357657539cb1338e3bd" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Aggiungi e configura l'azione di download

Questo è il passaggio più essenziale per rendere i file accessibili agli utenti. Poiché non possiamo collegarci direttamente al nome di un file, creeremo un pulsante di azione dedicato.

1. **Aggiungi una colonna di azione:** Nel **Colonne** sezione delle proprietà della Data Table, fai clic su **"Aggiungi colonna"** ancora una volta. Nelle impostazioni della colonna, imposta il suo **Tipo** su **Pulsante**.
2. **Configura l'elemento pulsante:**
   * All'interno delle proprietà della colonna Pulsante, aggiungi un nuovo elemento pulsante.
   * Assegnagli un **Etichetta** come "Scarica" o "Visualizza file".
   * Imposta un **Nome icona** (ad es. `utility:download`) per un'indicazione visiva migliore.
3. **Crea l'interazione "Download CMS":**
   * Seleziona l'elemento di azione "Scarica" che hai appena configurato.
   * Vai alla sua **Interactions** sezione e aggiungi un' **Al clic** interazione.
   * Per il **Tipo**, seleziona **Download CMS**.
   * Questa interazione specifica è progettata per generare in modo sicuro e avviare un download del file CMS associato a quella specifica riga nella tabella. Per questa interazione non sono necessarie altre proprietà.

<figure><img src="/files/f3a265b220157ae051589a9fa90a4ef9cdbd0a18" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Salva e distribuisci

Ora che la tua Avonni Data Table è completamente configurata direttamente nella pagina Experience Cloud, il passaggio finale è renderla disponibile per i visitatori del tuo sito. In Experience Builder, le modifiche alla configurazione vengono in genere salvate mentre lavori; tuttavia, devi **pubblicare** il sito affinché diventino visibili al tuo pubblico.
{% endstep %}
{% endstepper %}

## Perché usare un'interazione dedicata "Download CMS"?

Quando i contenuti sono gestiti tramite Salesforce CMS e visualizzati in un sito Experience Cloud, i file non hanno una normale "pagina dei dettagli del record" a cui un semplice link possa navigare. Il nome del file nella tabella è solo testo. L' **Download CMS** interazione funge da collegamento sicuro, identificando correttamente la versione del file associata alla riga e avviando un download per l'utente. Ciò garantisce un'esperienza utente affidabile e senza interruzioni.

## **Risultato**

Ora hai una tabella dinamica e facile da usare che elenca i contenuti della tua Salesforce CMS. Quando un utente fa clic sul pulsante "Scarica" in una qualsiasi riga, il file corrispondente verrà scaricato direttamente sul suo dispositivo.


---

# 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/tutorial/components/data-table/displaying-salesforce-cms-files-in-a-data-table.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.
