# Visualizzazione dei file Salesforce CMS in una tabella dati

## Panoramica

Questo tutorial ti guida nell'utilizzo del [Avonni **Data Table**](/experience-cloud/experience-cloud-it/tutorial/componenti/tabella-dati.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 "Download" per ogni file, offrendo un'esperienza fluida per gli utenti, specialmente all'interno di un sito Experience Cloud.

**Cosa imparerai:**

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

**Prerequisiti:**

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

***

## Passaggi guidati

{% stepper %}
{% step %}

### Aggiungi il componente Data Table

Per prima cosa, configuriamo il Data Table che mostrerà il nostro elenco di file CMS.

1. Dal **Component Library** (pannello sinistro), trova il **Avonni Data Table** componente e trascinalo sulla tela.

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

{% step %}

### Configura la sorgente dati

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

1. Con il Data Table selezionato, trova il **Data Source** proprietà nel Pannello Proprietà.
2. Seleziona **CMS Collection** dall'elenco dei tipi di sorgente dati.
3. Nel **Collection ID** campo che appare, inserisci il **ID a 18 caratteri** della tua Salesforce CMS Collection o Content Key.

Il Data Table è ora connesso e riconosce gli elementi di contenuto all'interno della tua collection.

<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à del Data Table, vai alla sezione **Columns** del.
2. Fai clic su **"Add Column"** per creare una nuova colonna.
3. **Campo origine:** Seleziona un campo dai dati del contenuto CMS (ad es., `Title`).
4. **Etichetta colonna:** Assegna un'etichetta di facile lettura (ad es., "Titolo Documento").
5. Ripeti questo processo per aggiungere altre colonne rilevanti, come `CreatedDate` o `LastModifiedDate`.

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

{% step %}

### Aggiungi e configura l'azione di download

Questo è il passaggio più importante 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 Azione:** Nel **Columns** sezione delle proprietà del Data Table, fai clic **"Add Column"** ancora una volta. Nelle impostazioni della colonna, imposta il suo **Tipo** su **Button**.
2. **Configura l'elemento Pulsante:**
   * All'interno delle proprietà della colonna Button, aggiungi un nuovo elemento pulsante.
   * Assegna una **Etichetta** come "Download" o "Visualizza file".
   * Imposta un **Nome icona** (ad es., `utility:download`) per un migliore segnale visivo.
3. **Crea l'interazione "Download CMS":**
   * Seleziona l'elemento di azione "Download" che hai appena configurato.
   * Vai alla sua **Interactions** sezione e aggiungi un **On Click** interazione.
   * Per il **Tipo**seleziona **Download CMS**.
   * Questa specifica interazione è progettata per generare in modo sicuro e avviare il download del file CMS associato a quella particolare riga nella tabella. Non sono necessarie altre proprietà per questa interazione.

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

{% step %}

### Salva e Distribuisci

Ora che il tuo Avonni Data Table è completamente configurato direttamente sulla pagina Experience Cloud, il passaggio finale è renderlo disponibile ai visitatori del tuo sito. In Experience Builder, le modifiche di configurazione vengono generalmente salvate automaticamente durante il lavoro; tuttavia, devi **pubblicare** il sito affinché diventino visibili al tuo pubblico.
{% endstep %}
{% endstepper %}

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

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

## **Risultato**

Ora hai una tabella dinamica e facile da usare che elenca i contenuti del tuo Salesforce CMS. Quando un utente clicca il pulsante "Download" su qualsiasi riga, il file corrispondente verrà scaricato direttamente sul suo dispositivo.


---

# Agent Instructions: 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:

```
GET https://docs.avonnicomponents.com/experience-cloud/experience-cloud-it/tutorial/componenti/tabella-dati/visualizzazione-dei-file-salesforce-cms-in-una-tabella-dati.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
