Workiva Support Center

Mit dem Tableau® Connector können Sie Befehle in einer Kette verwenden, um mit Tableau zu interagieren. Mit diesem Konnektor können Sie beispielsweise Folgendes tun:

• Hinzufügen von Benutzern zu Tableau-Gruppen oder -Sites
• Erstellen von Tableau-Daten und Hyper-Extrakten
• Berechtigungen in Tableau massenhaft löschen oder aktualisieren
• Erstellen und Verwalten von Tableau-Projekten, -Gruppen und -Sites
• Verwalten von Tableau-Datenquellen und Ansichten

Hinweis: Dieser Konnektor wird von Workiva hergestellt und verbindet sich mit einem System eines Drittanbieters. Unser Support-Team kann Ihnen zwar bei der Konfiguration dieses Konnektors innerhalb Ihres Arbeitsbereichs behilflich sein, aber wir sind nicht in der Lage, Fehler zu beheben oder anderweitig bei Problemen zu helfen, die ihren Ursprung außerhalb der Workiva-Plattform haben.

Voraussetzungen

Um die Verbindung zu aktivieren, verwendet der Connector die Tableau REST API, die durch eine einfache Authentifizierung mit Benutzernamen und Passwort gesichert ist. Zur Einrichtung des Konnektors benötigen Sie Folgendes:

• Ein designierter Integrationsbenutzer, der in Tableau für den Connector eingerichtet ist
• Die Authentifizierungsdaten des Integrationsbenutzers
• Die URL der Tableau-Instanz, mit der eine Verbindung hergestellt werden soll, z. B. https://[region].online.tableau.com für Tableau Online
• Die Site, mit der eine Verbindung innerhalb der Tableau-Instanz hergestellt werden soll

• Die API-Version, die die Tableau-Instanz verwendet, oder die Version von Tableau, mit der eine Verbindung hergestellt werden soll

  Tipp: Informationen darüber, wie Sie Ihre Tableau-Version finden, finden Sie unter in der Wissensdatenbank von Tableau.

Um den Befehl Build Hyper Extract oder Build TDE Extract des Connectors mit einem GroundRunner zu verwenden, installieren Sie die Tableau Extract API auf dem Server und verschieben Sie die DLL-Dateien (Dynamic-Link Library) in einen Ordner, der von der Registrierung verwendet wird, z. B. C:\Windows\System32. Informationen über die Installation der Tableau Extract API finden Sie unter in der Dokumentation Tableau Extract API.

Unterstützte Versionen

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

Hinweis: Bei den vierteljährlichen Updates von Tableau werden neuere API-Versionen möglicherweise nicht als Optionen für den Connector angezeigt, werden aber durch Abwärtskompatibilität weiterhin unterstützt.

Bestimmen Sie den URL-Namen des Website-Inhalts

Jede Instanz von Tableau wird mit einer Standard-Site bereitgestellt, aber Ihr Unternehmen kann weitere Sites bereitstellen. Die Eigenschaft Site content URL name des Connectors gibt an, mit welcher Site er sich verbindet. Um den Wert für Site content URL name zu bestimmen, überprüfen Sie die URL des Tableau-Inhalts, mit dem eine Verbindung hergestellt werden soll:

• Die Standard-URL der Website hat das Format https://our.tableau.online.hostname/#/workbooks. Um eine Verbindung zur Standard-Site herzustellen, geben Sie Default in Site content URL name ein.
• Die URLs weiterer Websites haben das Format https://our.tableau.online.hostname/#site/[site ID]/workbooks. Um eine Verbindung zu einer weiteren Website herzustellen, geben Sie den Wert in den [site ID] Teil der URL in Site content URL name ein.

Hinweis: Bei der Eigenschaft URL-Name der Site-Inhalte wird zwischen Groß- und Kleinschreibung unterschieden.

Einrichten des Tableau-Connectors

Hinweis: Um den Konnektor für die Verwendung in den Ketten Ihrer Organisation verfügbar zu machen, muss ein Sicherheitsadministrator der Organisation ihn zunächst aktivieren unter Konfiguration.

1. Von Chain Builder, klicken Sie auf Verbindungen compare_arrows, und dann Erstellen oben rechts.
2. Wählen Sie unter Connector Verbindung, Tableau und den Standard-CloudRunner.
   
3. Geben Sie unter Basisinformationen einen eindeutigen Namen und eine Beschreibung ein, um die Verbindung zu identifizieren.

4. Geben Sie unter Eigenschaften die Details des Connectors ein:
   

   Eigenschaft	Details
   Benutzername	Geben Sie den Benutzernamen des Tableau-Integrationsbenutzers des Connectors ein.
   Kennwort	Geben Sie das Passwort für die Eigenschaft Benutzername ein.
   Tableau-URL	Geben Sie die Basis-URL für die Tableau-Instanz ein, mit der eine Verbindung hergestellt werden soll, z. B. https://us-east-1.online.tableau.com für Tableau Online.
   Website-Inhalt URL-Name	Geben Sie die ID der Site ein, mit der eine Verbindung innerhalb der Tableau-Instanz hergestellt werden soll: Um eine Verbindung mit der Standard-Tableau-Site Ihres Unternehmens herzustellen, geben Sie Default ein. Um eine Verbindung zu einer weiteren von Ihrer Organisation bereitgestellten Site herzustellen, geben Sie die ID ein, die nach /#site/ in der URL des Inhalts erscheint. Hinweis: Bei dem URL-Namen der Website wird zwischen Groß- und Kleinschreibung unterschieden.
   Version	Wählen Sie die API-Version, die die Tableau-Instanz verwendet, basierend auf der Version von Tableau. Hinweis: Wenn Ihre Version nicht zur Auswahl steht, wählen Sie die neueste API-Version.

   Hinweis: Alle sensiblen Anmeldedaten werden automatisch verschlüsselt und mit Advanced Encryption Standard (AES)-256-Verschlüsselung gespeichert.

5. Wählen Sie die Umgebungen aus, die für die Verbindung verwendet werden sollen, und klicken Sie auf Speichern.
6. Um die Verbindung zu testen, erstellen Sie eine Kette und führen Sie diese mit dem Befehl Websites beziehen des Konnektors aus und prüfen Sie, ob eine gültige Ausgabe zurückgegeben wird.

Fehlersuche

Wenn die Verbindung zu Tableau fehlschlägt:

• Überprüfen Sie die Authentifizierungsdaten des Integrationsbenutzers.
• Überprüfen Sie die Basis-URL und die Site-ID der Tableau-Instanz und der Site, mit der Sie eine Verbindung herstellen möchten.
• Überprüfen Sie, ob die für den Konnektor ausgewählte API-Version mit der Version Ihrer Tableau-Instanz übereinstimmt.

Wenn ein Befehl einen Exit-Code von Success zurückgibt, aber keine Ausgabe hat, überprüfen Sie die Site-ID, die für den Site content URL name des Connectors eingegeben wurde:

• Um eine Verbindung mit der Standard-Tableau-Site Ihres Unternehmens herzustellen, geben Sie Default ein.
• Um eine Verbindung zu einer weiteren von Ihrer Organisation bereitgestellten Site herzustellen, geben Sie die ID ein, die nach /#site/ in der URL des Inhalts erscheint.