Hilfe zu Tableau Desktop und zur Webdokumenterstellung

Tabellenerweiterungen ermöglichen es Ihnen, mit einem Analytics-Erweiterungen-Skript Datentabellen zu erstellen. Sie können ein benutzerdefiniertes TabPy- oder Rserve-Skript schreiben und optional ein oder mehrere Eingabetabellen hinzufügen.

Hinweis: Eine Tabellenerweiterung wird jedes Mal aktualisiert, wenn Sie eine Arbeitsmappe öffnen oder eine Datenquelle aktualisieren.

Vorteile

Tabellenerweiterungen bieten neuen und erfahrenen Benutzern die folgenden Vorteile.

• Skripte oder erweiterte Funktionen können einfach in Tableau integriert werden
• Daten aus Tableau-Datenverbindungen können einfach als Eingabe in Skripte gezogen werden
• Ein Low-Code-Editor erleichtert das Hinzufügen von Code zu Datenquellen.
• Ermöglicht die Integration mit Datenhandbuch und Erklär die Daten
• Ermöglicht die Integration mit TabPy, Rserve und anderen Analytics-Erweiterungen
• Ergebnisse können zur Erstellung von Dashboards oder Visualisierungen verwendet werden

Voraussetzungen

Bevor Sie Tabellenerweiterungen verwenden können, müssen Sie die folgende Liste durchgehen.

• Öffnen Sie eine Datenquelle in Desktop oder der Webdokumenterstellung.
• Konfigurieren einer Analytics-Erweiterung
  • Schritte zum Konfigurieren von Verbindungen zu Analytics-Erweiterungen finden Sie unter Übergeben von Ausdrücken mit Analytics-Erweiterungen.

Erstellen einer Tabellenerweiterung

Führen Sie die folgenden Schritte aus, um eine Tabellenerweiterung zu erstellen.

1. Öffnen Sie eine Arbeitsmappe.
2. Öffnen Sie eine Datenquelle oder erstellen Sie eine.
3. Wählen Sie unter Verbindungen die Option Neue Tabellenerweiterung aus.
4. Ziehen Sie das Blatt in das Datenmodell.
5. (Optional) Ziehen Sie Tabellen aus der Datenverbindung in den Tabellenerweiterungsbereich, um sie als Eingabe in Ihrem Analytics-Erweiterungen-Skript oder -Funktion zu verwenden.

   Standardmäßig werden Daten von Tableau an die Analytics-Erweiterung übergeben und als variable _arg1 definiert, eine wörterbuchähnliche Struktur, wie zum Beispiel: {‘column_name’: [1,2,3], ‘column_name_2’: [3,4,5].

   • Python-Eingabedaten: Die Eingabedaten können wie folgt in einen Pandas-Datenrahmen konvertiert werden: import pandas as pddf = (pd.DataFrame(_arg1))
   • Rserve-Eingabedaten: Bei Verwendung von Rserve werden die Eingabedaten als variable.arg1 definiert, und der Datentyp ist eine benannte Liste von Listen.
   • Benutzerdefinierte SQL-Eingabedaten: Für unterstützte relationale Datenquellen können Sie benutzerdefinierte SQL als Eingabe in eine Tabellenerweiterung verwenden. Wenn Parameter in der benutzerdefinierten SQL-Abfrage verwendet werden, bewirkt eine Änderung des Parameters, dass die Abfrage erneut ausgeführt und das Skript neu berechnet wird. Dadurch wird ein Pfad erstellt, durch den Parameter in einem Dashboard dynamisch aktualisiert und Werte gefiltert oder andernfalls an das Tabellenerweiterungsskript übergeben werden.

     Hinweis: Wenn ein Parameter in einer Tabellenerweiterung verwendet wird, kann dieser Parameter erst gelöscht werden, wenn er aus der Erweiterung entfernt wurde. Das Löschen eines Parameters, der in der Tabellenerweiterung aufgerufen wird, kann einen schwerwiegenden Fehler auslösen.

     

6. Geben Sie unter Skript Ihr Skript oder Ihren Funktionsaufruf ein. Das Skript muss ein Wörterbuch oder eine Liste von Listen zurückgeben, z. B. ein JSON-Objekt. Ein Skript für RServe muss einen data.frame oder eine Liste benannter Listen zurückgeben. Ein Skript für Python muss ein Wörterbuch zurückgeben.
   • Python-Beispiel: Verwenden Sie den folgenden expliziten Rückgabebefehl: return df.to_dict(orient='list')

   Hinweis: Tabellenerweiterungen unterstützen das direkte Aufrufen von TabPy-Endpunkten nicht, wenn TABPY_EVALUATE_ENABLE in TabPy deaktiviert ist.

7. Wählen Sie Übernehmen, um das Skript auszuführen.

   

8. (Optional) Wenn Sie die Tabellenerweiterung mit einer anderen Tabelle im Datenmodell verknüpfen, definieren Sie die Beziehung zwischen mindestens einem Feld in jeder Tabelle.
9. Wählen Sie im Datenraster unter Ausgabetabelle die Option Jetzt aktualisieren aus. Die Ergebnisse werden auf der Registerkarte "Ausgabetabelle" angezeigt.

   

Hinweis: Wenn Sie keine Beziehung zu einer Tabelle im Datenmodell definieren, ist die Registerkarte "Eingabetabelle" leer, und die Meldung "Datenvorschau nicht verfügbar" wird angezeigt.

10. (Optional) Geben Sie im Feld Name einen eindeutigen Namen für Ihre neue Tabellenerweiterung ein.
11. Wechseln Sie zur Registerkarte Blatt, um mit der Untersuchung und Visualisierung der Daten zu beginnen.
12. Veröffentlichen Sie die Arbeitsmappe, um sie freizugeben. Für das Veröffentlichungsziel muss eine Analytics-Erweiterung vom entsprechenden Typ aktiviert und konfiguriert sein.

Tipp für die Fehlerbehebung: Wenn Ihre Tabellenerweiterung einen Fehler auslöst, stellen Sie zunächst sicher, dass der gesamte Code und die Formatierung korrekt sind. Versuchen Sie es dann mit der kreisförmigen Schaltfläche „Datenquelle aktualisieren“ in der Symbolleiste oder klicken Sie erneut auf „Übernehmen“.

Vergleichen von Erweiterungstypen

Auch wenn nicht alle folgenden Produkte miteinander zusammenhängen, haben Tabellenerweiterungen und Analytics-Erweiterungen einige gemeinsame Merkmale. Das Feature "Tabellenerweiterungen" benötigt eine Verbindung zu einer Analytics-Erweiterung, um funktionieren zu können. Schauen wir uns beide Features genauer an.

Dashboarderweiterungen

Dashboard-Erweiterungen ermöglichen das Hinzufügen benutzerdefinierter Webanwendungen zu Dashboards mithilfe des Dashboard Extension SDK.

Tabellenerweiterungen

Tabellenerweiterungen ermöglichen es Ihnen, eine Tabelle in einer Datenquelle zu erstellen, die Daten und ein Skript an Ihre Analytics-Erweiterung senden kann und als Ergebnis eine vollständige Tabelle beliebiger Form zurück gibt. Die zurückgegebenen Ergebnisse werden im Datenmodell als Tabelle und in einer Arbeitsmappe als Kennzahlen und Dimensionen angezeigt.

Analytics-Erweiterungen

Mithilfe des Features Analytics-Erweiterungen können Sie Tableau-Berechnungen um Programmiersprachen (wie Python), externe Tools und externe Plattformen erweitern.

Nachdem Sie eine Verbindung zu einer Analytics-Erweiterung hergestellt haben, können Sie mit Ihrem externen Server über berechnete Felder mit der Bezeichnung SCRIPT_X oder MODEL_EXTERNAL_X kommunizieren, wobei X der Datentyp der erwarteten Rückgabewerte ist. Weitere Informationen finden Sie unter Übergeben von Ausdrücken mit Analytics-Erweiterungen.