Tableau Server verbinden met de Salesforce Data Cloud
Let op: Data Cloud heette vroeger Customer Data Platform.
Tableau Server (versie 2023.3 en hoger)
De Salesforce Data Cloud-connector werd uitgebracht voor Tableau Desktop en Tableau Prep in 2023.2, voor Tableau Cloud in juni 2023 en voor Tableau Server in 2023.3. Deze connector verbindt Tableau naadloos met Data Cloud en is beschikbaar voor Tableau Desktop, Tableau Cloud, Tableau Server en Tableau Prep. Vergeleken met de eerdere Customer Data Platform-connector is de Salesforce Data Cloud-connector eenvoudiger in te stellen. Daarnaast herkent de connector dataruimten, bevat deze duidelijkere objectlabels en wordt gebruikgemaakt van versnelde query's. Zie de onderstaande stappen.
Opmerking: de Customer Data Platform-connector is verouderd in Tableau Server 2023.3 en kan niet worden gebruikt voor nieuwe verbindingen vanaf Tableau Server 2024.2. Bestaande werkmappen, databronnen en andere assets die gebruikmaken van de Customer Data Platform-connector kunnen nog steeds worden gebruikt totdat de connector volledig is verwijderd, meestal één tot twee releases na de beëindiging. Tableau raadt klanten ten zeerste aan bestaande assets aan te passen zodat deze gebruikmaken van de Salesforce Data Cloud-connector en de assets nog steeds kunnen worden gebruikt.
Stap 1: maak een met Salesforce verbonden app
Voor de Salesforce Data Cloud-connector moet u een verbonden app maken in Salesforce.
Zowel de Salesforce Data Cloud-connector als de Salesforce-connector kunnen dezelfde verbonden app gebruiken. Als u de Salesforce-connector al gebruikt, hoeft u daarom alleen de drie Customer Data Platform-bereiken uit stap 7 toe te voegen aan uw bestaande verbonden app.
- Meld u aan bij uw Salesforce.com-ontwikkelaarsaccount, klik rechtsboven op uw gebruikersnaam en selecteer vervolgens Configuratie.
- Selecteer in de linkernavigatiekolom, onder Apps de optie App-manager.
- Klik in het gedeelte Verbonden apps op Nieuwe verbonden app.
- Geef in Basisinformatie een naam op voor de app, doorloop met de Tab-toets het API-veld, zodat deze automatisch in de juiste indeling wordt ingevuld en voer een e-mailadres voor contact voor de app in.
- Selecteer in het gedeelte API [OAuth-instellingen inschakelen] de optie OAuth-instellingen inschakelen.
- Typ in de nieuwe OAuth-instellingen die worden weergegeven voor Callback-URL de volledig gekwalificeerde domeinnaam van uw server met gebruik van het
https
-protocol en voeg de volgende tekst toe aan de URL:auth/add_oauth_token
.
Bijvoorbeeld:https://www.your_tableau_server.com/auth/add_oauth_token
- Verplaats de volgende items van Beschikbare OAuth-bereiken naar Geselecteerde OAuth-bereiken:
- Toegang tot de service voor identiteits-URL's (ID, profiel, e-mailadres, adres, telefoon)
- Gebruikersdata beheren via API's (api)
- Op elk gewenst moment verzoeken uitvoeren (refresh_token, offline toegang)
- ANSI SQL-query's uitvoeren op Customer Data Platform-data (cdp_query_api)
- Customer Data Platform-profieldata beheren (cdp_profile_api)
- Opname-API-data voor het Customer Data Platform beheren (cdp_ingest_api)
- Klik op Opslaan.
Nadat u de app hebt opgeslagen, wordt door Salesforce de API-sectie ingevuld met de volgende ID's die u gaat gebruiken om Tableau Server te configureren:
- Gebruikerssleutel
- Gebruikersgeheim
- Callback-URL
Stap 2: configureer Tableau Server voor Salesforce.com OAuth
Wanneer uw verbonden app eenmaal is gemaakt in Salesforce en u over de klantsleutel, het klantgeheim en de callback-URL beschikt, kunt u Tableau Server configureren voor Salesforce-dataverbindingen en -uitvoer, en Einstein Discovery.
- Voer op de Tableau Server-computer bij een opdrachtprompt de volgende opdrachten uit:
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>
- Als u de standaard inlogserver wilt wijzigen (optioneel), typt u de volgende opdracht:
tsm configuration set -k oauth.salesforce.server_base_url -v <URL>
- Voer de volgende opdracht in om wijzigingen toe te passen:
tsm pending-changes apply
Als voor de lopende wijzigingen de server opnieuw moet worden opgestart, geeft de opdracht pending-changes apply een prompt weer om u te laten weten dat de server opnieuw wordt gestart. Deze prompt verschijnt ook als de server is gestopt, maar in dat geval vindt er geen herstart plaats. U kunt de prompt onderdrukken met de optie--ignore-prompt
, maar dit verandert niets aan het herstartgedrag. Als opnieuw opstarten niet nodig is voor de wijzigingen, worden de wijzigingen zonder waarschuwing van een prompt toegepast. Zie tsm pending-changes apply voor meer informatie.
Aangepaste OAuth configureren voor een site
Zie het onderwerp OAuth-verbindingen voor instructies voor de configuratie.
Tableau Server (versie 2023.1 en lager)
Waarschuwing: het Customer Data Platform was in oktober 2023 verouderd en is niet meer beschikbaar in Tableau Server 2024.2 en hoger. Tableau raadt klanten aan bestaande assets aan te passen zodat deze gebruikmaken van de Salesforce Data Cloud-connector en de assets nog steeds kunnen worden gebruikt.
In dit gedeelte wordt beschreven hoe u vanuit Tableau Server verbinding maakt met het Salesforce Customer Data Platform via OAuth-verifiicatie.
De stappen die in dit gedeelte worden beschreven, zijn vereist om Salesforce Customer Data Platform-data te gebruiken in Tableau Server.
Stap 1: stel de connector in
- Download de nieuwste Salesforce Customer Data Platform-connector (het bestand Salesforce_CDP.taco) van de site Tableau Exchange-connectors.
- Verplaats het Taco-bestand naar de map met Tableau-connectors:
- Windows:
C:\Users[Windows User]\Documents\My Tableau Repository\Connectors
- Linux:
/opt/tableau/connectors
OR/var/opt/tableau_server/data/tabsvc/vizqlserver/Connectors/
- Start Tableau Server opnieuw.
Stap 2: installeer het JDBC-stuurprogramma voor Customer Data Platform
Opmerking: Tableau versie 2023.1 voor Server is alleen compatibel met versie 18 en hoger van het JDBC-stuurprogramma.
- Download het nieuwste JDBC-stuurprogramma (het bestand Salesforce-CDP-jdbc-[versie].jar) van de GitHub-site voor Salesforce CDP: https://github.com/forcedotcom/Salesforce-CDP-jdbc/releases
- Verplaats het gedownloade bestand Salesforce-CDP-jdbc-[versie].jar naar de volgende locatie:
- Windows:
C:\Program Files\Tableau\Drivers
- Linux:
/opt/tableau/tableau_driver/jdbc
Stap 3: maak een met Salesforce verbonden app
Nadat u de API-bereiken hebt gemaakt, maakt u aan de hand van de volgende procedure een met Salesforce verbonden app voor het afhandelen van OAuth-delegatie vanuit Tableau Server.
Meld u als beheerder aan bij uw Salesforce Customer Data Platform-account. Klik rechtsboven op uw gebruikersnaam en selecteer vervolgens Configuratie.
Selecteer in het linkerdeelvenster, onder Apps, de optie App-manager.
Klik in het gedeelte Verbonden apps op Nieuwe verbonden app.
Geef in Basisinformatie een naam op voor de verbonden app (bijvoorbeeld voorbeeld.com), doorloop met de Tab-toets het API-veld zodat deze automatisch in de juiste indeling wordt ingevuld en voer een e-mailadres voor contact voor de app in.
Selecteer in het gedeelte API [OAuth-instellingen inschakelen] de optie OAuth-instellingen inschakelen en doe het volgende:.
Typ in de nieuwe OAuth-instellingen die worden weergegeven voor Callback-URL de volledig gekwalificeerde domeinnaam (FQDN) van uw Tableau Server met gebruik van het
https
-protocol en voeg de volgende tekst toe aan de URL:/auth/add_oauth_token
.Bijvoorbeeld:
https://example.com/auth/add_oauth_token
Verplaats de volgende items van Beschikbare OAuth-bereiken naar Geselecteerde OAuth-bereiken:
- Gebruikersdata beheren via API's (api)
- Op elk gewenst moment namens u verzoeken uitvoeren (refresh_token, offline_access)
- Customer Data Cloud-profieldata beheren (cdp_profile_api)
- ANSI SQL-query's uitvoeren op Customer Data Platform-data (cdp_query_api)
Wanneer u klaar bent, klikt u op Opslaan.
Ga naar de lijst van App-manager, navigeer naar uw verbonden app, klik op de pijl van de vervolgkeuzelijst en selecteer vervolgens Beheren.
Nadat u de app hebt opgeslagen, wordt het gedeelte API (OAuth-instellingen inschakelen) ingevuld met de volgende ID's die u gaat gebruiken om Tableau Server te configureren:
- Gebruikerssleutel
- Gebruikersgeheim
- Callback-URL
Opmerking: sla uw gebruikerssleutel, gebruikersgeheim en callback-URL op, zodat u deze later kunt gebruiken.
OAuth gebruiken met het Customer Data Platform
U kunt een aangepaste OAuth-client configureren om 1) een OAuth-client te overschrijven, als deze voor de server is geconfigureerd, of 2) ondersteuning te bieden voor een veilige verbinding met data waarvoor unieke OAuth-clients nodig zijn.
Nadat de verbonden app is gemaakt in Salesforce en u over de gebruikerssleutel, het gebruikersgeheim en de callback-URL beschikt, kunt u Tableau Server configureren voor de OAuth-verbindingen van het Customer Data Platform. Voordat u aan de slag gaat, verzamelt u de volgende informatie.
- Gebruikerssleutel: de gebruikerssleutel, in Tableau ook wel de client-ID genoemd, wordt gegenereerd via de procedure aan het einde van stap 4. Gebruik deze waarde voor
[your_consumer_key]
in de volgende tsm-opdracht. - Gebruikersgeheim: het gebruikersgeheim, in Tableau ook wel het clientgeheim genoemd, wordt gegenereerd via de procedure aan het einde van stap 4. Gebruik deze waarde voor
[your_consumer_secret]
in de volgende tsm-opdracht. - Callback-URL: de callback-URL, in Tableau ook wel de omleiding-URL genoemd, is uw Tableau Server-URL
https://example.com
met daaraan '/auth/add_oauth_token
’ toegevoegd. Gebruik deze waarde voor[your_callback_url]
in de volgende tsm-opdracht. - Configuratie-ID: De waarde voor de parameter
oauth.config.id
die u gebruikt in de volgende tsm-opdracht:customer_360_audience
TSM-opdrachten gebruiken voor OAuth-configuratie
Voer de volgende tsm-opdrachten uit om OAuth te configureren.
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
Meerdere connectors instellen
Als u meerdere connectors moet instellen, moet u ze allemaal in één opdracht opnemen. Bijvoorbeeld:
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
Stap 1: registreer de OAuth-client-ID en -clientgeheim
Voer de volgende procedure uit om de aangepaste OAuth-client op uw site te registreren.
- Meld u aan bij Tableau Server met uw sitebeheerdersreferenties en navigeer naar de pagina Instellingen.
- Selecteer onder Register OAuth-clients de knop OAuth-client toevoegen.
- Selecteer voor Verbindingstype, de optie Customer Data Platform.
- Selecteer voor OAuth-aanbieder de optie Aangepaste IDP.
- Voer de Client-ID in.
- Voer het Klantgeheim in.
- Voer de Omleiding-URL in.
- Selecteer voor OAuth-configuratiebestand kiezen de knop Een bestand kiezen om het configuratiebestand te uploaden.
- Selecteer de knop OAuth-client toevoegen om het registratieproces te voltooien.
- Selecteer de knop Opslaan onderaan of bovenaan de pagina Instellingen om de wijzigingen op te slaan.
Stap 2: valideer de opgeslagen referenties en werk deze bij
U (en uw sitegebruikers) moeten alle eerder opgeslagen referenties verwijderen en deze opnieuw toevoegen, zodat u over een ononderbroken datatoegang beschikt.
- Navigeer naar uw pagina Mijn accountinstellingen.
- Selecteer onder Opgeslagen referenties voor databronnen de optie Verwijderen naast de bestaande opgeslagen referenties.
- Selecteer naast dezelfde connector de optie Toevoegen.
- Volg de prompts om verbinding te maken met de Customer Data Platform-connector.
- Selecteer Opslaan.
Stap 3: informeer gebruikers dat ze hun opgeslagen referenties moeten bijwerken
Zorg ervoor dat uw sitegebruikers weten dat ze hun opgeslagen referenties moeten bijwerken voor de Customer Data Platform-connector. Sitegebruikers kunnen hun opgeslagen referenties bijwerken aan de hand van de procedure die wordt beschreven in Opgeslagen referenties voor dataverbindingen beheren.
Zie ook
- Help voor Salesforce: Set Up Tableau in Customer Data Platform (Tableau instellen in Customer Data Platform)
- Help voor Salesforce: Enable Customer Data Platform in Tableau (Customer Data Platform inschakelen in Tableau)
- Help voor Salesforce: Using Customer Data Platform Data in Tableau (Customer Data Platform-data gebruiken in Tableau)