Connectoren, die mit dem Web Data Connector 3.0-SDK erstellt wurden

Der Web Data Connector 3.0 ist die neueste Version des Webdaten-Connectors, Tableaus Lösung zum Herstellen einer Verbindung zu Daten in Webanwendungen und -diensten, die über APIs anstatt über ODBC/JDBC-Treiber zugänglich sind.

Das Web Data Connector 3.0-SDK stellt die Tools bereit, die Sie zum Erstellen Ihres eigenen benutzerdefinierten Connectors für Webdaten benötigen. Darüber hinaus können Connectoren verwendet werden, die von Partnern erstellt wurden und in Tableau Exchange verfügbar sind.

Hinweis: Der Web Data Connector 3.0 war Bestandteil der Tableau-Version 2022.3.

Über den Web Data Connector 3.0

Ausgehend von früheren Verbesserungen des Webdaten-Connectors und analog zum Tableau Connector-SDK ermöglicht es Ihnen der Web Data Connector 3.0, einen benutzerdefinierten Connector für Webdaten zu erstellen und als .taco-Datei zu packen. WDC 3.0-Connectoren können wie beliebige treiberbasierte Connectoren verwendet werden, die mit dem Tableau Connector-SDK erstellt wurden, und erfordern nicht, dass Sie den Connector auf Ihrem eigenen Webserver hosten.

WDC 3.0-Connectoren sind wie andere .taco-Connectoren verpackte und signierte .jar-Dateien, die eine Reihe von XML- und Javascript-/TypeScript-Dateien enthalten. Diese Dateien definieren das Aussehen und Verhalten des Connectors. Dazu gehören die folgenden Punkte:

  • Eine webbasierte Benutzeroberfläche für den Connector
  • API-Aufrufe zum Abrufen von Daten aus Ihrer Anwendung oder Ihrem Dienstendpunkt
  • Anweisungen zum Zuordnen der abgerufenen Daten in Tableau-Extrakte

Hinweis: Web Data Connector 3.0 ist weiterhin nur zum Extrahieren in der Lage, ermöglicht Ihnen aber ansonsten, Ihre Daten zu visualisieren und Ihre Analysen wie jede andere Datenquelle zu veröffentlichen.

Wichtig: Es gibt ein bekanntes Problem mit WDC 3.0-basierten Connectoren in Tableau Server. Mehr dazu erfahren Sie weiter unten unter Bekannte Probleme (nur Tableau Server).

Erstellen Ihres eigenen Connectors

Informationen zum Erstellen Ihres eigenen benutzerdefinierten Connectors finden Sie in der offiziellen Dokumentation zum Web Data Connector 3.0.

Verwenden eines Connectors, der mit dem Web Data Connector 3.0-SDK erstellt wurde

Nachdem Sie einen Connector mit dem Web Data Connector 3.0-SDK erstellt haben, führen Sie die folgenden Schritte aus, um ihn mit Tableau zu verwenden:

  1. Laden Sie die Connector-Datei "[Name des Connectors].taco" herunter.
  2. Platzieren Sie die .taco-Datei im folgenden Verzeichnis (Standardspeicherort):
    • Für 2021.2 und neuer:
      Für Tableau DesktopFür Tableau Prep BuilderFür Tableau Server
      • Windows: C:\Benutzer\[Windows-Benutzer]\Dokumente\Eigenes Tableau-Repository\Connectors
      • macOS: C:\Benutzer\[Benutzer]\Dokumente\Eigenes Tableau-Repository\Connectors
      • Windows: C:\Benutzer\[Windows-Benutzer]\Dokumente\Eigenes Tableau Prep-Repository\Connectors
      • macOS: /Benutzer/Dokumente/Eigenes Tableau Prep-Repository/Connectors
      • Windows: C:\Programme\Tableau\Connectors

      • Linux: /opt/tableau/connectors

    • Für 2021.1 und älter:
      Für Tableau DesktopFür Tableau Prep BuilderFür Tableau Server, Tableau Prep Conductor, Tableau Prep Flow Authoring
      • Windows: C:\Benutzer\[Windows-Benutzer]\Dokumente\Eigenes Tableau-Repository\Connectors
      • macOS: C:\Benutzer\[Benutzer]\Dokumente\Eigenes Tableau-Repository\Connectors
      • Windows: C:\Benutzer\[Windows-Benutzer]\Dokumente\Eigenes Tableau Prep-Repository\Connectors
      • macOS: /Benutzer/Dokumente/Eigenes Tableau Prep-Repository/Connectors
      • Tableau Server: [Installationsverzeichnis_von_Tableau_Server]/data/tabsvc/vizqlserver/Connectors

      Um Ihren Connector für Prep zu aktivieren, müssen Sie Ihre .taco-Datei auch an den folgenden Speicherorten hinzufügen:

      • Tableau Prep Conductor: [Installationsverzeichnis_von_Tableau_Server]/data/tabsvc/flowprocessor/Connectors
      • Tableau Prep Flow Authoring: [Installationsverzeichnis_von_Tableau_Server]/data/tabsvc/flowqueryservice/Connectors

Hinweis: Nachdem Sie den Connector installiert haben, wird er in der Liste der Connectoren in Tableau angezeigt.

Wenn Sie ein Problem mit der WDC-Bibliothek, dem Simulator oder einem der Entwicklerbeispiele feststellen, melden Sie das Problem auf Github(Link wird in neuem Fenster geöffnet).

Verbinden von Tableau mit den Daten

  1. Starten Sie Tableau und wählen Sie unter Verbinden den Namen des Connectors aus, den Sie gerade installiert haben. Für eine vollständige Liste der Connectoren wählen Sie Mehr unter Mit einem Server aus.
  2. Geben Sie die angeforderten Informationen ein und wählen Sie dann Anmelden aus.
  3. Warten Sie, bis der Connector Ihre Daten in Tableau abgerufen hat.
  4. Wählen Sie die Blattregisterkarte aus, um Ihre Analyse zu starten.

Ladereihenfolge für Connectoren

Wenn ein Connector dieselbe Klasse wie ein bereits registrierter Connector hat, wird der neue Connector abgelehnt. Zuerst geladene Connectoren haben Vorrang, wenn zwei Connectoren denselben Klassennamen verwenden.

Tableau lädt Connectoren nach Verzeichnis in der folgenden Reihenfolge:

  1. Integrierte Tableau-Connectoren
  2. Connectoren, die sich in C:\Program Files\Tableau\Connectors (Windows) bzw. /opt/tableau/connectors (Linux) befinden
  3. Connectoren, die sich in My Tableau Repository/Connectors befinden
  4. (Optional) Connectoren, die sich in dem per -DConnectPluginsPath angegebenen dev-Pfad befinden

Bekannte Probleme (nur Tableau Server)

Bei dem Versuch, eine Verbindung mit einem WDC 3.0-basierten Connector in Tableau Server herzustellen, wird den Benutzern möglicherweise die Fehlermeldung „Beim Arbeiten mit diesem Arbeitsblatt ist in Tableau Server (Version <Versionsnummer>) ein Fehler aufgetreten“ angezeigt.

Dieser Fehler tritt auf, weil der auf Tableau-Webdaten-Connector 3.0 basierende Connector, mit dem die Arbeitsmappe erstellt wurde, nicht mit Tableau Server mit mehreren Knoten kompatibel ist. Derzeit gibt es keine Problemumgehung oder Lösung. Weitere Informationen finden Sie in dem Knowledge-Artikel When web authoring using WDC 3.0-based Connectors, receiving HTTP 503 along with error „encountered an error“(Link wird in neuem Fenster geöffnet) (Beim Erstellen von Webinhalten mit WDC 3.0-basierten Connectoren wird ein HTTP 503-Fehler zusammen mit der Fehlermeldung „Es ist ein Fehler aufgetreten“ angezeigt.).

Siehe auch

Vielen Dank für Ihr Feedback!Ihr Feedback wurde erfolgreich übermittelt. Vielen Dank.