Workiva supportcenter

Med Tableau® Connector kan du använda kommandon i en kedja för att interagera med Tableau. Med den här kontakten kan du t.ex:

• Lägga till användare i Tableau-grupper eller -platser
• Skapa data- och hyperextrakt i Tableau
• Ta bort eller uppdatera behörigheter i Tableau i bulk
• Skapa och hantera Tableau-projekt, -grupper och -webbplatser
• Hantera Tableau-datakällor och -vyer

Obs: Denna kontakt är byggd av Workiva och ansluts till ett system från tredje part. Vår support kan hjälpa till att konfigurera den här anslutningen i din arbetsyta, men vi kan inte felsöka eller på annat sätt hjälpa till med problem som uppstår utanför Workiva-plattformen.

Förkunskapskrav

För att aktivera anslutningen använder connectorn Tableau REST API, som är säkrat med grundläggande autentisering med användarnamn och lösenord. För att sätta upp kontakten behöver du:

• En utsedd integrationsanvändare konfigurerad i Tableau för anslutningen
• Autentiseringsuppgifter för integrationsanvändaren
• URL:en för Tableau-instansen att ansluta till, t.ex. https://[region].online.tableau.com för Tableau Online
• Den webbplats som ska anslutas till i Tableau-instansen

• API-versionen som Tableau-instansen använder, eller versionen av Tableau att ansluta till

  Tips: För information om hur du hittar din Tableau-version, se Tableaus kunskapsbas.

För att använda kopplingens kommando Build Hyper Extract eller Build TDE Extract med en GroundRunner, installera Tableau Extract API på dess server och flytta dess DLL-filer (dynamic-link library) till en mapp som används av registret, till exempel C:\Windows\System32. För information om hur du installerar Tableau Extract API, se Tableau Extract API-dokumentationen.

Versioner som stöds

• 8.3
• 9.x
• 10.x
• 2018.x
• 2019.x
• 2020.1 och 2020.2
• Tableau Online

Obs: Med Tableaus kvartalsvisa uppdateringar kan det hända att nyare API-versioner inte visas som alternativ för kontakten, men de har fortfarande support genom bakåtkompatibilitet.

Bestäm namnet på webbplatsens innehåll URL

Varje instans av Tableau distribueras med en standardwebbplats, men din organisation kan distribuera ytterligare webbplatser. Kopplingens egenskap Site content URL name anger vilken webbplats den ansluter till. För att bestämma värdet för URL-namn för webbplatsinnehåll, kontrollera URL:en för Tableau-innehållet som du ska ansluta till:

• Standardwebbplatsens URL följer formatet https://our.tableau.online.hostname/#/workbooks. Om du vill ansluta till standardwebbplatsen anger du Standard i Webbplatsinnehåll URL-namn.
• Ytterligare webbplatsers URL:er följer formatet https://our.tableau.online.hostname/#site/[site ID]/workbooks. Om du vill ansluta till ytterligare en webbplats anger du värdet i [webbplats-ID] delen av URL:en i Webbplatsinnehåll URL-namn.

Obs: Namnet på URL:en för webbplatsinnehåll är skiftlägeskänsligt.

Konfigurera Tableau-anslutningen

Obs: För att göra kontakten tillgänglig för användning i din organisations kedjor, en org säkerhetsadministratör först aktivera den från Konfiguration.

1. Från Kedjebyggareklickar du på Anslutningarcompare_arrowsoch sedan på Skapa längst upp till höger.
2. Under Anslutning för anslutningväljer du Tableauoch standardinställningen för CloudRunner.
   
3. Under Basic Info anger du ett unikt namn och en beskrivning som hjälper dig att identifiera anslutningen.

4. Under Properties anger du kontaktens detaljer:
   

   Egenskap	Information
   Användarnamn	Ange användarnamnet för anslutningens Tableau-integrationsanvändare.
   Lösenord	Ange lösenordet för egenskapen Username.
   Tableau URL	Ange bas-URL:en för Tableau-instansen som du vill ansluta till, t.ex. https://us-east-1.online.tableau.com för Tableau Online.
   Namn på URL för webbplatsens innehåll	Ange ID för den webbplats som du vill ansluta till i Tableau-instansen: För att ansluta till din organisations standard Tableau-webbplats anger du Default. För att ansluta till ytterligare en webbplats som din organisation har distribuerat, ange ID:t som visas efter /#site/ i innehållets URL. Obs: Namnet på URL:en för webbplatsinnehåll är skiftlägeskänsligt.
   Version	Välj den API-version som Tableau-instansen ska använda, baserat på Tableau-versionen. Obs: Om din version inte är ett alternativ väljer du den senaste API-versionen.
   HTTP-läsningstidsgräns	Tidsperiod innan HTTP-läskommandot når tidsgränsen. Detta värde måste vara ett heltal (1,2,3,…) större än 0, och standardvärdet är 180. Det maximala värdet är 2 147 483 647, eller ungefär 68 år.

   Obs: Alla känsliga uppgifter krypteras automatiskt och lagras med Advanced Encryption Standard (AES)-256-kryptering.

5. Välj de miljöer som ska användas med anslutningen och klicka på Save.
6. Testa anslutningen genom att skapa och köra en kedja med -anslutningens Get Sites -kommando och kontrollera att den returnerar en giltig utdata.

Felsökning

Om anslutningen till Tableau misslyckas:

• Verifiera autentiseringsuppgifterna för integrationsanvändaren.
• Kontrollera bas-URL och webbplats-ID för Tableau-instansen och webbplatsen som du ska ansluta till.
• Kontrollera att den API-version som valts för anslutningen överensstämmer med versionen av din Tableau-instans.

Om ett kommando returnerar utgångskoden Success men inte har någon utdata, kontrollera det webbplats-ID som angetts för kontaktdonets Webbplatsinnehåll URL-namn:

• För att ansluta till din organisations standard Tableau-webbplats anger du Default.
• För att ansluta till ytterligare en webbplats som din organisation har distribuerat, ange ID:t som visas efter /#site/ i innehållets URL.