Connettere Tableau Server a Salesforce Data Cloud

Applicabile a: Data Cloud

Nota: Data Cloud era precedentemente noto con il nome di Customer Data Platform.

Tableau Server (versione 2023.3 e successive)

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 Customer Data Platform, il connettore Salesforce Data Cloud è più semplice da configurare, riconosce gli spazi dati, presenta etichette degli oggetti più chiare ed è basato su query accelerate. Vedi le fasi di seguito.

Nota: il connettore Customer Data Platform è stato deprecato in Tableau Server 2023.3 e non può essere utilizzato per nuove connessioni a partire da Tableau Server 2024.2. Le cartelle di lavoro, le origini dati e le altre risorse esistenti che utilizzano il connettore Customer Data Platform continueranno a funzionare fino alla completa rimozione del connettore, in genere 1-2 versioni dopo essere stato dichiarato deprecato. Per garantire che le risorse esistenti continuino a funzionare, Tableau consiglia ai clienti di modificare le risorse esistenti in modo da utilizzare il connettore Salesforce Data Cloud.

Fase 1. Creare un’app connessa Salesforce

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.

  1. Accedi all’account sviluppatore di Salesforce.com, fai clic sul nome utente in alto a destra, quindi seleziona Configurazione.
  2. Nella colonna di spostamento a sinistra, in App, seleziona App Manager.
  3. Nella sezione App connesse 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

    Impostazioni OAuth

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)

Avviso: Customer Data Platform è stato deprecato a ottobre 2023 e non è disponibile in Tableau Server 2024.2 e versioni successive. Per garantire che le risorse continuino a funzionare, Tableau consiglia ai clienti di modificare le risorse esistenti in modo da utilizzare 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/
  1. 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

Dopo aver creato gli ambiti dell’API, utilizza la procedura seguente per creare un’app connessa Salesforce 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 sinistro, in App, seleziona App Manager.

  3. Nella sezione App connesse 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
Torna in alto
Grazie per il tuo feedback.Il tuo feedback è stato inviato. Grazie!