Ansluta Tableau Server till Salesforce Data Cloud
Obs! Data Cloud hette tidigare Customer Data Platform.
Tableau Server (version 2023.3 och senare)
Salesforce Data Cloud-kopplingen släpptes för Tableau Desktop och Tableau Prep 2023.2, för Tableau Cloud i juni 2023 och för Tableau Server 2023.3. Denna koppling kopplar Tableau till Data Cloud på ett smidigt sätt och finns för Tableau Desktop, Tableau Cloud, Tableau Server och Tableau Prep. Jämfört med den tidigare Customer Data Platform-kopplingen är Salesforce Data Cloud-kopplingen enklare att konfigurera, den kan identifiera datautrymmen, har tydligare objektetiketter och drivs av accelererade frågor. Följ stegen nedan.
Obs! Customer Data Platform-kopplingen blev inaktuell från och med Tableau Server 2023.3 och kan från och med Tableau Server 2024.2 inte längre användas för nya kopplingar. Befintliga arbetsböcker, datakällor och andra resurser som använder Customer Data Platform-kopplingen fortsätter att fungera tills kopplingen tagits bort helt, vanligtvis 1–2 versioner efter det att den blivit inaktuell. För att säkerställa att befintliga resurser fortsätter att fungera rekommenderar Tableau på det bestämdaste att kunder modifierar befintliga resurser så att de använder Salesforce Data Cloud-kopplingen.
Steg 1: Skapa ett Salesforce-anslutet program
Salesforce Data Cloud-kopplingen kräver att du skapar ett anslutet program i Salesforce.
Både Salesforce Data Cloud-kopplingen och Salesforce-kopplingen kan använda samma anslutna program. Så om du redan använder Salesforce-kopplingen behöver du bara lägga till de tre Customer Data Platform-omfattningar som anges i steg 7 i det befintliga anslutna programmet.
- Logga in på ditt utvecklarkonto för Salesforce.com, klicka på ditt användarnamn i det övre högra hörnet och välj Installation.
- Välj Apphanterare under Appar i den vänstra navigeringskolumnen.
- Klicka på Nytt anslutet program i sektionen Anslutna program.
- Ge programmet ett namn i Grundläggande information, tabba igenom API-fältet så att det fylls i automatiskt i korrekt format och ange en kontaktadress (mejl) för programmet.
- Välj Aktivera OAuth-inställningar i avsnittet API [Aktivera OAuth-inställningar].
- Skriv serverns fullständiga domännamn med
https
-protokollet som URL för återanrop i de nya OAuth-inställningar som visas och lägg till följande text i URL:en:auth/add_oauth_token
.
Exempel:https://www.your_tableau_server.com/auth/add_oauth_token
- Flytta följande objekt från Tillgängliga OAuth-omfång till Valda OAuth-omfång:
- Få åtkomst till identitets-URL-tjänsten (id, profil, e-post, adress, telefon)
- Hantera användardata via API:er (api)
- Utför förfrågningar när som helst (refresh_token, offlineåtkomst)
- Utför ANSI SQL-frågor på Customer Data Platform-data (cdp_query_api)
- Hantera profildata för Customer Data Platform (cdp_profile_api)
- Hantera data för inhämtnings-API:et för Customer Data Platform (cdp_ingest_api)
- Klicka på Spara.
När du har sparat appen fyller Salesforce i API-avsnittet med följande ID:n som du sedan kommer att använda när du konfigurerar Tableau Server:
- Konsumentnyckel
- Konsumenthemlighet
- URL för återanrop
Steg 2: Konfigurera Tableau Server för Salesforce.com OAuth
När det anslutna programmet har skapats i Salesforce och du har tillgång till kundnyckeln, kundhemligheten och URL:en för återanrop kan du konfigurera Tableau Server för Salesforce-dataanslutningar och -utdata samt Einstein Discovery.
- Kör följande kommandon i kommandotolken på Tableau Server-datorn:
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>
- (Valfritt) Skriv följande kommando om du vill ändra standardinloggningsserver:
tsm configuration set -k oauth.salesforce.server_base_url -v <URL>
- Ange följande kommando för att använda ändringarna:
tsm pending-changes apply
Om de väntande ändringarna kräver att servern startas om visar kommandot pending-changes apply en kommandotolk så att du vet att en omstart kommer att ske. Kommandotolken visas även om servern stoppas, men i så fall sker ingen omstart. Du kan utelämna tolken med alternativet--ignore-prompt
, men det påverkar inte omstartsbeteendet. Om ändringarna inte kräver omstart används de utan någon kommandotolk. Du hittar mer information i tsm pending-changes apply.
Konfigurera anpassad OAuth för en plats
Du hittar konfigurationsanvisningar i avsnittet OAuth-anslutningar.
Tableau Server (version 2023.1 och tidigare)
Varning: Customer Data Platform blev inaktuell i oktober 2023 och är inte tillgänglig i Tableau Server 2024.2 och senare. För att säkerställa att resurser fortsätter att fungera rekommenderar Tableau att kunder modifierar befintliga resurser så att de använder Salesforce Data Cloud-kopplingen.
I det här avsnittet beskrivs hur du ansluter från Tableau Server till Salesforce Customer Data Platform via OAuth-autentisering.
Stegen som beskrivs i det här avsnittet krävs för att använda Salesforce Customer Data Platform-data i Tableau Server.
Steg 1: Konfigurera kopplingen
- Ladda ner den senaste Salesforce Customer Data Platform-kopplingen (filen Salesforce_CDP.taco) från Tableau Exchange Connectors-platsen.
- Flytta .taco-filen till Tableau-kopplingsmappen:
- Windows:
C:\Users[Windows User]\Documents\My Tableau Repository\Connectors
- Linux:
/opt/tableau/connectors
ELLER/var/opt/tableau_server/data/tabsvc/vizqlserver/Connectors/
- Starta om Tableau Server.
Steg 2: Installera JDBC-drivrutinen för Kunddataplattform
Obs! Tableau version 2023.1 för Server är endast kompatibel med JDBC-drivrutinen version 18 och högre.
- Ladda ner den senaste JDBC-drivrutinen (Salesforce-CDP-jdbc-[version].jar-fil) från Salesforce CDP GitHub-webbplatsen: https://github.com/forcedotcom/Salesforce-CDP-jdbc/releases
- Flytta den nedladdade Salesforce-CDP-jdbc-[version].jar-filen till följande plats:
- Windows:
C:\Program Files\Tableau\Drivers
- Linux:
/opt/tableau/tableau_driver/jdbc
Steg 3: Skapa ett Salesforce-anslutet program
När API-omfattningen har skapats kan du använda följande procedur för att skapa ett anslutet Salesforce-program för att hantera OAuth-delegering från Tableau Server.
Logga in på ditt Salesforce Customer Data Platform-konto som administratör, klicka på användarnamnet i det övre högra hörnet och välj Setup (Konfiguration).
I den vänstra rutan under Apps (Appar) väljer du App Manager (Apphanterare).
Klicka på Nytt anslutet program i sektionen Anslutna program.
I Basic Information (Grundläggande information) ger du det anslutna programmet ett namn (till exempel Exempel.com). Tabba sedan igenom API-fältet så att det fyller i sig självt i rätt format och ange en e-postadress för programmet.
I delen API [Enable OAuth Settings] (API [Aktivera OAuth-inställningar]) väljer du Enable OAuth Settings och gör sedan följande:
I de nya OAuth-inställningarna som visas för Callback URL (URL för återanrop) skriver du in det fullständiga domännamnet (FQDN) för din Tableau Server med hjälp av
https
-protokollet och lägger till följande text i URL:en:/auth/add_oauth_token
.Till exempel:
https://example.com/auth/add_oauth_token
Flytta följande objekt från Tillgängliga OAuth-omfång till Valda OAuth-omfång:
- Hantera användardata via API:er (api)
- Perform requests on your behalf at any time (refresh_token, offline_access) (Utför förfrågningar på dina vägnar när som helst)
- Hantera Customer Data Cloud-profildata (cdp_profile_api)
- Utför ANSI SQL-frågor på Customer Data Platform-data (cdp_query_api)
Klicka på Spara när du är klar.
Gå till listan App Manager (Programhanterare), navigera till det anslutna programmet, klicka på listrutepilen och välj sedan Manage (Hantera).
När appen har sparats fylls sektionen API (Aktivera OAuth-inställningar) i med följande ID:n som kan användas för att konfigurera Tableau Server:
- Konsumentnyckel
- Konsumenthemlighet
- URL för återanrop
Obs! Spara konsumentnyckeln, hemligheten och återanrops-URL:en för att användas senare.
Använd OAuth med Customer Data Platform
Överväg att konfigurera en anpassad OAuth-klient för att 1) åsidosätta en OAuth-klient om den är konfigurerad för servern eller 2) aktivera stöd för säker anslutning till data som kräver unika OAuth-klienter.
När det anslutna programmet har skapats i Salesforce och du har konsumentnyckeln, konsumenthemligheten och återanrops-URL:en kan du konfigurera Tableau Server för Customer Data Platform OAuth-anslutningarna. Samla in följande information för att komma igång.
- Konsumentnyckel: Konsumentnyckeln, även känd som klient-ID i Tableau, genereras genom proceduren i slutet av steg 4. Använd det här värdet för
[your_consumer_key]
i följande tsm-kommando. - Konsumenthemlighet: Konsumenthemligheten, även känd som klienthemlighet i Tableau, genereras genom proceduren i slutet av steg 4. Använd det här värdet för
[your_consumer_secret]
i följande tsm-kommando. - URL för återanrop: URL:en för återanrop, även känd som omdirigerings-URL i Tableau, är URL:en för din Tableau Server
https://example.com
med tillägget ”/auth/add_oauth_token
”. Använd det här värdet för[your_callback_url]
i följande tsm-kommando. - Konfigurations-ID: Värdet för parametern
oauth.config.id
som du använder i följande tsm:customer_360_audience
Använd TSM-kommandon för OAuth-konfiguration
Kör följande tsm-kommando för att konfigurera 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
Ange flera kopplingar
Om du har angett flera kopplingar måste du inkludera alla i ett enda kommando. Till exempel:
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
Steg 1: Registrera klient-ID:t och klienthemligheten för OAuth
Slutför följande procedur för att registrera den anpassade OAuth-klienten på din plats.
- Logga in på Tableau Server med dina inloggningsuppgifter som platsadministratör och gå till sidan Inställningar:
- Klicka på knappen Lägg till OAuth-klient under Register för OAuth-klienter.
- Välj Customer Data Platform som kopplingstyp.
- Välj Anpassad IDP som OAuth-leverantör.
- Ange Klient-ID.
- Ange Klienthemlighet.
- Ange Återanrops-URL.
- För Välj OAuth-konfigurationsfil kan du använda knappen Välj en fil för att ladda upp konfigurationsfilen.
- Använd knappen Lägg till OAuth-klient för att slutföra registreringsprocessen.
- Använd knappen Spara längst ned eller högst upp på sidan Inställningar för att spara ändringarna.
Steg 2: Validera och uppdatera sparade inloggningsuppgifter
För att säkerställa oavbruten dataåtkomst måste du (och dina platsanvändare) ta bort de tidigare sparade autentiseringsuppgifterna och lägga till dem igen.
- Gå till sidan Mina kontoinställningar.
- Öppna Sparade inloggningsuppgifter för datakällor och välj Radera bredvid befintliga sparade autentiseringsuppgifterna.
- Välj Lägg till bredvid samma koppling.
- Följ anvisningarna för att ansluta till Customer Data Platform-kopplingen.
- Välj Spara.
Steg 3: meddela användarna att de ska uppdatera sina sparade autentiseringsuppgifter
Se till att du meddelar alla platsanvändare att de ska uppdatera sina sparade inloggningsuppgifter för Customer Data Platform-kopplingen. Platsanvändare kan uppdatera sina sparade inloggningsuppgifter genom att följa stegen som beskrivs i Hantera sparade inloggningsuppgifter för dataanslutningar.
Se även
- Salesforce-hjälpen: Set Up Tableau in Customer Data Platform (Konfigurera Tableau i Kunddataplattform)
- Salesforce-hjälpen: Enable Customer Data Platform in Tableau (Aktivera Kunddataplattform i Tableau)
- Salesforce-hjälpen: Using Customer Data Platform Data in Tableau (Använda data från Kunddataplattform i Tableau)