Workiva kundestøttesenter

Med Tableau®-koblingen kan du bruke kommandoer i en kjede for å samhandle med Tableau. Med denne kontakten kan du for eksempel:

• Legg til brukere i Tableau-grupper eller -nettsteder
• Bygg Tableau-data og hyperuttrekk
• Massesletting eller oppdatering av tillatelser i Tableau
• Opprett og administrer Tableau-prosjekter, -grupper og -nettsteder
• Administrer Tableau-datakilder og -visninger

Merknad: Denne koblingen er bygget av Workiva og kobles til et tredjepartssystem. Selv om supportteamet vårt kan hjelpe deg med å konfigurere denne koblingen i arbeidsområdet ditt, kan vi ikke feilsøke eller på annen måte hjelpe med problemer som oppstår utenfor Workiva-plattformen.

Forutsetninger

For å aktivere tilkoblingen bruker koblingen Tableau REST API, sikret med grunnleggende brukernavn- og passordautentisering. For å sette opp koblingen trenger du:

• En angitt integrasjonsbruker satt opp i Tableau for koblingen
• Integrasjonsbrukerens autentiseringslegitimasjon
• URL-en til Tableau-forekomsten som skal kobles til, for eksempel https://[region].online.tableau.com for Tableau Online
• Nettstedet som skal kobles til i Tableau-forekomsten

• API-versjonen Tableau-forekomsten bruker, eller versjonen av Tableau som skal kobles til

  Tips: For informasjon om hvordan du finner din Tableau-versjon, se Tableaus kunnskapsbase.

For å bruke koblingens kommando Build Hyper Extract eller Build TDE Extract med en GroundRunner, installer Tableau Extract API på serveren og flytt DLL-filene (dynamic link library) til en mappe som brukes av registeret, for eksempel C:\Windows\System32. Hvis du vil ha informasjon om hvordan du installerer Tableau Extract API, kan du se dokumentasjonen for Tableau Extract API.

Støttede versjoner

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

Merk: Med Tableaus kvartalsvise oppdateringer kan det hende at nyere API-versjoner ikke vises som alternativer for koblingen, men de støttes fortsatt gjennom bakoverkompatibilitet.

Bestem URL-navnet til nettstedsinnholdet

Hver forekomst av Tableau distribueres med et standardnettsted, men organisasjonen din kan distribuere flere nettsteder. Koblingens egenskap Nettstedsinnholds-URL-navn angir hvilket nettsted den kobler til. For å bestemme verdien for URL-navn for nettstedsinnhold, sjekk URL-en til Tableau-innholdet du skal koble til:

• Standardnettstedets URL følger formatet https://our.tableau.online.hostname/#/workbooks. For å koble til standardnettstedet, skriv inn Standard i URL-navn for nettstedsinnhold.
• URL-ene til andre nettsteder følger formatet https://our.tableau.online.hostname/#site/[site ID]/workbooks. For å koble til et ekstra nettsted, skriv inn verdien i [nettsteds-ID] -delen av URL-adressen i Nettstedsinnholds-URL-navn.

Merk: Egenskapen Nettstedsinnholds-URL-navn skiller mellom store og små bokstaver.

Konfigurer Tableau-koblingen

Merk: For å gjøre koblingen tilgjengelig for bruk i organisasjonens kjeder, må en sikkerhetsadministrator i organisasjonen først aktivere den fra Konfigurasjon.

1. Fra Kjedebyggerklikker du på Tilkoblingercompare_arrowsog deretter på Opprett øverst til høyre.
2. Under Koblingstilkoblingvelger du Tableauog standard CloudRunner.
   
3. Under Grunnleggende informasjonskriver du inn et unikt navn og en beskrivelse for å identifisere forbindelsen.

4. Under Egenskaperskriver du inn detaljene for koblingen:
   

   Egenskap	Detaljer
   Brukernavn	Skriv inn brukernavnet til koblingens Tableau-integrasjonsbruker.
   Passord	Skriv inn passordet for egenskapen Brukernavn.
   Tableau-URL	Skriv inn basis-URL-en for Tableau-forekomsten som skal kobles til, for eksempel https://us-east-1.online.tableau.comfor Tableau Online.
   URL-navn for nettstedsinnhold	Skriv inn ID-en til nettstedet du vil koble til i Tableau-forekomsten: For å koble til organisasjonens standard Tableau-nettsted, skriv inn Standard. For å koble til et ekstra nettsted som organisasjonen din har distribuert, skriver du inn ID-en som vises etter /#site/ i innholdets URL. Merk: Nettstedinnholds-URL-navn skiller mellom store og små bokstaver.
   Versjon	Velg API-versjonen Tableau-instansen skal bruke, basert på Tableau-versjonen. Merk: Hvis versjonen din ikke er et alternativ, velg den nyeste API-versjonen.
   HTTP-lesetidsavbrudd	Tidsperiode før HTTP-lesekommandoen tidsavbrytes. Denne verdien må være et heltall (1, 2, 3,…) større enn 0, og standardverdien er 180. Maksimumsverdien er 2 147 483 647, eller omtrent 68 år.

   Merk: All sensitiv påloggingsinformasjon krypteres automatisk og lagres med Advanced Encryption Standard (AES)-256-kryptering.

5. Velg miljøene som skal brukes med tilkoblingen, og klikk på Lagre.
6. For å teste tilkoblingen, opprett og kjør en kjede med -koblingens Get Sites-kommando, og bekreft at den returnerer en gyldig utdata.

Feilsøking

Hvis tilkoblingen til Tableau mislykkes:

• Bekreft integrasjonsbrukerens autentiseringslegitimasjon.
• Sjekk basis-URL-en og nettsteds-ID-en til Tableau-forekomsten og nettstedet du skal koble til.
• Bekreft at API-versjonen som er valgt for koblingen samsvarer med versjonen av Tableau-forekomsten din.

Hvis en kommando returnerer en avslutningskode på Suksess, men ikke har noen utdata, må du bekrefte nettsteds-ID-en som er angitt for koblingens URL-navn for nettstedsinnhold:

• For å koble til organisasjonens standard Tableau-nettsted, skriv inn Standard.
• For å koble til et ekstra nettsted som organisasjonen din har distribuert, skriver du inn ID-en som vises etter /#site/ i innholdets URL.