Guida di Tableau Server su Windows

A partire dal 14 ottobre 2025, Data Cloud è stato ribattezzato Data 360. Durante la transizione potresti riscontrare ancora riferimenti a Data Cloud nell’applicazione e nella documentazione. Anche se il nome è cambiato, la funzionalità e i contenuti rimangono invariati.

Il connettore Salesforce Data Cloud è stato rilasciato per Tableau Desktop e Tableau Prep nella versione 2023.2, per Tableau Cloud nel giugno 2023 e per Tableau Server nella versione 2023.3. Questo connettore collega in modo semplice e rapido Tableau a Data Cloud ed è disponibile per Tableau Desktop, Tableau Cloud, Tableau Server e Tableau Prep. Rispetto al precedente connettore CDP, il connettore Salesforce Data Cloud è più facile da usare, mostra le etichette degli oggetti anziché i nomi API ed è basato su query accelerate.

Nota: Data Cloud era precedentemente denominato Customer Data Platform (CDP). Il connettore CDP è stato deprecato Tableau Server 2023.3, non è più disponibile a partire da Tableau Server 2024.2 ed è stato rimosso completamente da Tableau Server 2025.1 e versioni successive. Le risorse esistenti che utilizzano il connettore CDP devono essere ricreate utilizzando il connettore Salesforce Data Cloud.

Se utilizzi Tableau Server 2023.1 o versioni precedenti, consulta Tableau Server (versione 2023.1 e precedenti).

Tableau Server (versione 2023.3 e successive)

Fase 1. Abilitare l’integrazione app in Salesforce

Per abilitare l’integrazione di Tableau con Salesforce, devi prima configurare l’integrazione delle applicazioni in Salesforce. È consigliabile utilizzare app client esterne. Se disponibili, puoi utilizzare le app connesse Salesforce.

Creare un’app client esterna (scelta consigliata)

Creare un’app connessa Salesforce (opzione deprecata)

Importante: A partire dal rilascio Spring ‘26 di Salesforce, la creazione di app connesse è limitata. Puoi continuare a utilizzare le app connesse esistenti durante e dopo Spring ‘26, ma l’utilizzo di app client esterne è fortemente consigliato. Per maggiori informazioni, consulta i seguenti argomenti nella Guida di Salesforce: Non è più possibile creare nuove app connesse in Spring ‘26 (in inglese)(Il collegamento viene aperto in una nuova finestra), Creare un’app client esterna (in inglese)(Il collegamento viene aperto in una nuova finestra) e Migrazione da app connessa ad app client esterna (in inglese)(Il collegamento viene aperto in una nuova finestra).

Il connettore Salesforce Data Cloud richiede la creazione di un’app connessa in Salesforce.

Sia il connettore Salesforce che il connettore Salesforce Data Cloud possono utilizzare la stessa app connessa. Se quindi utilizzi già il connettore Salesforce, devi solo aggiungere i tre ambiti di Customer Data Platform elencati nella fase 7 all’app connessa esistente.

Per la procedura generale, consulta Configurare le impostazioni di base dell’applicazione app connessa(Il collegamento viene aperto in una nuova finestra) nella Guida di Salesforce. In alternativa, segui la procedura descritta di seguito.

1. Accedi all’account sviluppatore di Salesforce.com, fai clic sul nome utente in alto a destra, quindi seleziona Configurazione.
   
2. Nel riquadro di navigazione a sinistra, in App, cerca “App client esterne” e quindi seleziona Impostazioni app client esterne.
   
3. Fai clic su Nuova app connessa.
   
4. In Informazioni di base assegna un nome all’app, premi TAB nel campo API in modo che venga popolato automaticamente nel formato corretto e immetti un indirizzo e-mail di contatto per l’app.
5. Nella sezione API [Abilita impostazioni OAuth] seleziona Abilita impostazioni OAuth.
6. Nelle nuove impostazioni OAuth visualizzate, per l’URL di richiamata digita il nome di dominio completo del server, utilizza il protocollo https e aggiungi il testo seguente all’URL: auth/add_oauth_token.
   Ad esempio:
   https://www.your_tableau_server.com/auth/add_oauth_token
7. Sposta gli elementi seguenti dagli ambiti OAuth disponibili agli ambiti OAuth selezionati:
   • Accedi al servizio URL di identità (id, profile, email, address, phone)
   • Gestisci i dati utente tramite API (api)
   • Esegui richieste in qualsiasi momento (refresh_token, offline access)
   • Esegui query ANSI SQL sui dati di Customer Data Cloud (cdp_query_api)
   • Gestisci i dati del profilo di Customer Data Platform (cdp_profile_api)
   • Gestisci i dati dell’API di inserimento di Customer Data Platform (cdp_ingest_api)
8. Fai clic su Salva.

Dopo aver salvato l’app, Salesforce compila la sezione API con i seguenti ID che utilizzerai per configurare Tableau Server:

• Chiave consumatore
• Segreto consumatore
• URL di richiamata

Fase 2. Configurare Tableau Server per OAuth di Salesforce.com

Una volta che hai creato l’app connessa in Salesforce e che disponi della chiave client, del segreto client e dell’URL di richiamata, puoi configurare Tableau Server per gli output e le connessioni dati di Salesforce e Einstein Discovery.

1. Al prompt dei comandi del computer Tableau Server esegui questi comandi:
   tsm configuration set -k oauth.salesforce.client_id -v <your_customer_key>
tsm configuration set -k oauth.salesforce.client_secret -v <your_customer_secret>
tsm configuration set -k oauth.salesforce.redirect_uri -v <your_redirect_URL>
2. (Facoltativo) Per modificare il server di accesso predefinito, digita il comando seguente:
   tsm configuration set -k oauth.salesforce.server_base_url -v <URL>
3. Immetti il seguente comando applicare le modifiche:
   tsm pending-changes apply
   Se le modifiche in sospeso richiedono il riavvio del server, il comando pending-changes apply visualizzerà un messaggio per segnalare che verrà eseguito un riavvio. Questo messaggio viene visualizzato anche se il server è stato arrestato, ma in questo caso il riavvio non viene eseguito. Puoi eliminare la richiesta usando l’opzione --ignore-prompt, ma questo non modifica il comportamento del riavvio. Se le modifiche non richiedono un riavvio, vengono applicate senza visualizzare alcun messaggio. Per maggiori informazioni, consulta tsm pending-changes apply.

Configurare OAuth personalizzato per un sito

Per le istruzioni di configurazione, consulta l’argomento Connessioni OAuth.

Tableau Server (versione 2023.1 e precedenti)

Importante: il connettore Customer Data Platform è stato deprecato nell’ottobre 2023, non è più disponibile a partire da Tableau Server 2024.2 ed è stato rimosso completamente da Tableau Server 2025.1 e versioni successive. Per le risorse che utilizzano il connettore CDP, Tableau consiglia vivamente di eseguire l’aggiornamento e di utilizzare invece il connettore Salesforce Data Cloud.

In questa sezione viene descritto come connettersi da Tableau Server a Salesforce Customer Data Platform tramite l’autenticazione OAuth.

La procedura descritta in questa sezione è necessaria per utilizzare i dati di Salesforce Customer Data Platform in Tableau Server.

Fase 1. Impostare il connettore

1. Scarica il connettore di Salesforce Customer Data Platform più recente (file Salesforce_CDP.taco) dal sito dei connettori di Tableau Exchange.
2. Sposta il file .taco nella cartella dei connettori di Tableau:

• Windows: C:\Users[Windows User]\Documents\My Tableau Repository\Connectors
• Linux: /opt/tableau/connectors OPPURE /var/opt/tableau_server/data/tabsvc/vizqlserver/Connectors/

3. Riavvia Tableau Server.

Fase 2. Installare il driver JDBC di Customer Data Platform

Nota: Tableau versione 2023.1 per Server è compatibile solo con il driver JDBC versione 18 e successive.

1. Scarica il driver JDBC più recente (file Salesforce-CDP-jdbc-[versione].jar) dal sito GitHub di Salesforce CDP: https://github.com/forcedotcom/Salesforce-CDP-jdbc/releases
2. Sposta il file Salesforce-CDP-jdbc-[versione].jar scaricato nel percorso seguente:

• Windows: C:\Program Files\Tableau\Drivers
• Linux: /opt/tableau/tableau_driver/jdbc

Fase 3. Creare un’app connessa Salesforce

Importante: A partire dal rilascio Spring ‘26 di Salesforce, la creazione di app connesse è limitata. Puoi continuare a utilizzare le app connesse esistenti durante e dopo Spring ‘26, ma l’utilizzo di app client esterne è fortemente consigliato. Per maggiori informazioni, consulta i seguenti argomenti nella Guida di Salesforce: Non è più possibile creare nuove app connesse in Spring ‘26 (in inglese)(Il collegamento viene aperto in una nuova finestra), Creare un’app client esterna (in inglese)(Il collegamento viene aperto in una nuova finestra) e Migrazione da app connessa ad app client esterna (in inglese)(Il collegamento viene aperto in una nuova finestra).

Dopo aver creato gli ambiti dell’API, crea un’app connessa. Per la procedura generale, consulta Configurare le impostazioni di base dell’applicazione app connessa(Il collegamento viene aperto in una nuova finestra) nella Guida di Salesforce. In alternativa, segui la procedura descritta di seguito per gestire la delega Oauth da Tableau Server.

1. Accedi all’account Salesforce Customer Data Platform come amministratore, fai clic sul nome utente in alto a destra, quindi seleziona Configurazione.

2. Nel riquadro di navigazione a sinistra, in App, cerca “App client esterne” e quindi seleziona Impostazioni app client esterne.

3. Fai clic su Nuova app connessa.

4. In Informazioni di base assegna un nome all’app connessa (ad esempio, Example.com), premi TAB nel campo API in modo che venga popolato automaticamente nel formato corretto e immetti un indirizzo e-mail di contatto per l’app.

5. Nella sezione API [Abilita impostazioni OAuth] seleziona Abilita impostazioni OAuth, quindi procedi come segue:

   1. Nelle nuove impostazioni OAuth visualizzate, per l’URL di richiamata, digita il nome di dominio completo (FQDN) di Tableau Server, utilizzando il protocollo https, e aggiungi il testo seguente all’URL: /auth/add_oauth_token.

      Ad esempio: https://example.com/auth/add_oauth_token

   2. Sposta gli elementi seguenti dagli ambiti OAuth disponibili agli ambiti OAuth selezionati:

      • Gestisci i dati utente tramite API (api)
      • Esegui richieste per tuo conto in qualsiasi momento (refresh_token, offline_access)
      • Gestisci i dati del profilo di Customer Data Cloud (cdp_profile_api)
      • Esegui query ANSI SQL sui dati di Customer Data Cloud (cdp_query_api)

6. Al termine, fai clic su Salva.

7. Vai all’elenco App Manager, passa all’app connessa, fai clic sulla freccia a discesa e seleziona Gestisci.

Dopo aver salvato l’app, la sezione API (Abilita impostazioni OAuth) viene compilata con i seguenti ID che utilizzerai per configurare Tableau Server:

• Chiave consumatore
• Segreto consumatore
• URL di richiamata

  Nota: salva la chiave consumatore, il segreto consumatore e l’URL di richiamata per utilizzarli successivamente.

  
  
  

Utilizzare OAuth con Customer Data Platform

Valuta la possibilità di configurare un client OAuth personalizzato per 1) sostituire un client OAuth configurato per il server o 2) abilitare il supporto per la connessione sicura ai dati che richiedono client OAuth univoci.

Una volta che hai creato l’app connessa in Salesforce e che disponi della chiave consumatore, del segreto consumatore e dell’URL di richiamata, puoi configurare Tableau Server per le connessioni OAuth di Customer Data Platform. Per iniziare, raccogli le seguenti informazioni.

• Chiave consumatore: la chiave consumatore, anche denominata ID client in Tableau, viene generata dalla procedura alla fine della fase 4. Utilizza questo valore per [your_consumer_key] nel seguente comando tsm.
• Segreto consumatore: il segreto consumatore, anche denominato segreto client in Tableau, viene generato dalla procedura alla fine della fase 4. Utilizza questo valore per [your_consumer_secret] nel seguente comando tsm.
• URL di richiamata: l’URL di richiamata, anche denominato URL di reindirizzamento in Tableau, è l’URL di Tableau Server https://example.com con l’aggiunta di "/auth/add_oauth_token". Utilizza questo valore per [your_callback_url] nel seguente comando tsm.
• ID configurazione: il valore per il parametro oauth.config.id da utilizzare nel comando tsm riportato di seguito: customer_360_audience

Utilizzare i comandi TSM per la configurazione di OAuth

Esegui questi comandi tsm per configurare OAuth.

tsm configuration set -k oauth.config.clients -v "[{\"oauth.config.id\":\"customer_360_audience\", \"oauth.config.client_id\":\"[your_consumer_key]\", \"oauth.config.client_secret\":\"[your_consumer_secret]\", \"oauth.config.redirect_uri\":\"[your_callback_url]\"}]" --force-keys

tsm pending-changes apply

Impostazione di più connettori

Se è necessario impostare più connettori, devi includerli tutti in un unico comando. Ad esempio: 

tsm configuration set -k oauth.config.clients -v "[{\"oauth.config.id\":\"custom_360_audience\", \"oauth.config.client_id\":\"[your_consumer_key]\", \"oauth.config.client_secret\":\"[your_consumer_secret]\", \"oauth.config.redirect_uri\":\"[your_callback_url]\"}, {\"oauth.config.id\":\"dremio\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}, {\"oauth.config.id\":\"azure_sql_dw\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}, {\"oauth.config.id\":\"azure_sqldb\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}]" --force-keys

tsm pending-changes apply

Fase 1. Registrare l’ID client OAuth e il segreto client

Completa la seguente procedura per registrare il client OAuth personalizzato nel sito.

1. Accedi a Tableau Server utilizzando le credenziali di amministratore del sito e passa alla pagina Impostazioni.
2. In Registro client OAuth seleziona il pulsante Aggiungi client OAuth.
3. Per Tipo di connessione seleziona Customer Data Platform.
4. Per Provider OAuth seleziona IDP personalizzato.
5. Immetti l’ID client.
6. Immetti il segreto client.
7. Immetti l’URL di reindirizzamento.
8. Per Scegli il file di configurazione OAuth seleziona il pulsante Scegli un file per caricare il file di configurazione.
9. Seleziona il pulsante Aggiungi client OAuth per completare il processo di registrazione.
10. Seleziona il pulsante Salva nella parte inferiore o superiore della pagina Impostazioni per salvare le modifiche.

Fase 2. Convalidare e aggiornare le credenziali salvate

Per garantire un accesso senza interruzioni ai dati, tu (e gli utenti del sito) dovete eliminare eventuali credenziali salvate in precedenza e aggiungerle di nuovo.

1. Passa alla pagina Impostazioni account.
2. In Credenziali salvate per le origini dati seleziona Elimina accanto alle credenziali salvate esistenti.
3. Accanto allo stesso connettore, seleziona Aggiungi.
4. Segui le istruzioni per connettere il connettore Customer Data Platform.
5. Seleziona Salva.

Fase 3. Richiedere agli utenti di aggiornare le credenziali salvate

Assicurati di avvisare gli utenti del sito di aggiornare le loro credenziali salvate per il connettore Customer Data Platform. Gli utenti del sito possono utilizzare la procedura descritta in Gestire le credenziali salvate per le connessioni dati per aggiornare le credenziali salvate.

Vedi anche

• Guida di Salesforce: Connessione di Tableau in Data Cloud
• Guida di Salesforce: Abilitazione di Data Cloud in Tableau
• Guida di Salesforce: Utilizzo dei dati di Data Cloud in Tableau