Workiva-ondersteuningscentrum

Met de Tableau® connector kunt u commando's in een keten gebruiken voor interactie met Tableau. Met deze connector kunt u bijvoorbeeld:

• Gebruikers toevoegen aan Tableau-groepen of -sites
• Tableau-gegevens en hyper-extracten samenstellen
• Machtigingen in bulk verwijderen of bijwerken in Tableau
• Tableau-projecten, -groepen en -sites maken en beheren
• Tableau-gegevensbronnen en weergaven beheren

Opmerking: Deze connector is gebouwd door Workiva en maakt verbinding met een systeem van derden. Hoewel ons Support team kan helpen bij het configureren van deze connector binnen uw workspace, kunnen wij geen problemen oplossen of op een andere manier helpen met problemen die hun oorsprong vinden buiten het Workiva platform.

Vereisten

Om de verbinding mogelijk te maken, gebruikt de connector de Tableau REST API, beveiligd met een basisgebruikersnaam en wachtwoordverificatie. Om de connector in te stellen, hebt u het volgende nodig:

• Een aangewezen integratiegebruiker die in Tableau is ingesteld voor de connector
• De verificatiegegevens van de integratiegebruiker
• De URL van de Tableau-instantie waarmee verbinding moet worden gemaakt, zoals https://[region].online.tableau.com voor Tableau Online
• De site waarmee verbinding moet worden gemaakt binnen de Tableau-instantie

• De API-versie die de Tableau-instantie gebruikt, of de versie van Tableau waarmee verbinding moet worden gemaakt

  Tip: Zie Tableau's kennisbank voor informatie over hoe u uw Tableau-versie kunt vinden.

Om het commando Build Hyper Extract of Build TDE Extract van de connector met een GroundRunner te gebruiken, installeert u de Tableau Extract API op de server en verplaatst u de DLL-bestanden (dynamic-link library) naar een map die door het register wordt gebruikt, zoals C:\WindowsSystem32. Zie de Tableau Extract API documentatie voor informatie over het installeren van de Tableau Extract API.

Ondersteunde versies

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

Opmerking: Door de driemaandelijkse updates van Tableau worden nieuwere API-versies mogelijk niet als opties voor de connector weergegeven, maar ze worden nog steeds ondersteund via achterwaartse compatibiliteit.

Bepaal de URL-naam voor de inhoud van de site

Elke instantie van Tableau wordt geïnstalleerd met een standaardsite, maar uw organisatie kan extra sites implementeren. De eigenschap Site content URL name van de connector geeft aan met welke site deze verbinding maakt. Om de waarde voor Site content URL name te bepalen, controleert u de URL van de Tableau-inhoud waarmee u verbinding wilt maken:

• De standaard URL van de site heeft het formaat https://our.tableau.online.hostname/#/workbooks. Om verbinding te maken met de standaardsite, voert u Standaard in Site-inhoud URL-naam.
• De URL's van extra sites hebben het formaat https://our.tableau.online.hostname/#site/[site-ID]/werkmappen. Als u verbinding wilt maken met een extra site, voert u de waarde in het gedeelte [site-ID] van de URL in Site content URL name.

Opmerking: De eigenschap Site content URL name is hoofdlettergevoelig.

De Tableau-connector instellen

Opmerking: Om de connector beschikbaar te maken voor gebruik in de ketens van uw organisatie, moet een beveiligingsbeheerder van de org deze eerst inschakelen vanuit Configuratie.

1. Ga naar Chain Builder, klik op Connectionscompare_arrows, en vervolgens op Create rechtsboven.
2. Selecteer onder Connector Connection, Tableau en de standaard CloudRunner.
   
3. Voer onder Basisinfo een unieke naam en beschrijving in om de verbinding te helpen identificeren.

4. Voer onder Eigenschappen de gegevens van de connector in:
   

   Eigendom	Details
   Gebruikersnaam	Voer de gebruikersnaam van de Tableau integratiegebruiker van de connector in.
   Wachtwoord	Voer het wachtwoord in voor de eigenschap Username.
   Tableau URL	Voer de basis URL in voor de Tableau-instantie waarmee u verbinding wilt maken, zoals https://us-east-1.online.tableau.com voor Tableau Online.
   Site-inhoud URL-naam	Voer de ID in van de site waarmee u verbinding wilt maken binnen de Tableau-instantie: Om verbinding te maken met de standaard Tableau-site van uw organisatie, voert u Default in. Om verbinding te maken met een extra site die uw organisatie heeft geïmplementeerd, voert u de ID in die achter /#site/ in de URL van de inhoud staat. Opmerking: Site content URL naam is hoofdlettergevoelig.
   Versie	Selecteer de API-versie die de Tableau instance gebruikt, gebaseerd op de versie van Tableau. Opmerking: Als uw versie geen optie is, selecteer dan de meest recente API-versie.

   Opmerking: Alle gevoelige gegevens worden automatisch versleuteld en opgeslagen met Advanced Encryption Standard (AES)-256 codering.

5. Selecteer de omgevingen die u met de verbinding wilt gebruiken en klik op Opslaan.
6. Om de verbinding te testen, maakt een ketting aan en voert deze uit met de opdracht Get Sites van de connector, en controleert of deze een geldige uitvoer oplevert.

Probleemoplossing

Als de verbinding met Tableau mislukt:

• Controleer de verificatiegegevens van de integratiegebruiker.
• Controleer de basis URL en site ID van de Tableau instance en site waarmee u verbinding wilt maken.
• Controleer of de API-versie die is geselecteerd voor de connector overeenkomt met de versie van uw Tableau instance.

Als een opdracht een exitcode Succes retourneert maar geen uitvoer heeft, controleer dan de site-ID die is ingevoerd voor de connector Site content URL name:

• Om verbinding te maken met de standaard Tableau-site van uw organisatie, voert u Default in.
• Om verbinding te maken met een extra site die uw organisatie heeft geïmplementeerd, voert u de ID in die achter /#site/ in de URL van de inhoud staat.