Tableau Server-Hilfe

Tableau Server-Handbuch
Version 8.3; Last Updated in 2014
Copyright © 2014 Tableau Software, Incorporated and its licensors. All rights reserved.
This product is Client Software as defined in Tableau Software’s End User Software License
Agreement.
Willkommen – Tableau Server
Tableau Server ist ein Begleitprodukt zu Tableau Desktop Professional Edition. Es ermöglicht
Ihnen und anderen, über eine interaktive und kollaborative Web-Benutzeroberfläche
Entdeckungen weiterzugeben. Mit Tableau Desktop können Daten visuell dargestellt werden,
um die Interpretation einfacher bis komplexer Fragestellungen zu erleichtern. Diese
Darstellungen werden Ansichten genannt. Mit Tableau Server können Autoren dann
Arbeitsmappen mit einer ganzen Reihe von Ansichten veröffentlichen, die von anderen
angezeigt und interaktiv bearbeitet werden können.
So funktioniert die Hilfe
Wenn Sie Hilfe benötigen, klicken Sie oben auf der Seite auf das Menü Hilfe. Daraufhin wird
das Hilfemenü mit Themen geöffnet, die sich auf die geöffnete Seite beziehen.
Version: 8.3 | Aktualisiert am 12/1/2014
-3-
Anmelden
Normalerweise müssen Sie über ein Konto bei Tableau Server verfügen, um Daten
veröffentlichen und darin navigieren zu können. Außerdem muss Ihnen die Lizenzstufe Viewer
oder Interactor zugewiesen sein. Benutzerkonten werden von einem Administrator
eingerichtet. Sie basieren entweder auf Ihrem Windows-Benutzerkonto, auf Active Directory
oder auf dem internen Benutzerverwaltungssystem von Tableau Server. Wenden Sie sich an
Ihren Administrator, falls Sie Ihren Benutzernamen und Ihr Kennwort nicht kennen.
Je nach Konfiguration des Servers kann es sein, dass Sie automatisch angemeldet werden.
Falls Sie automatisch als falscher Benutzer angemeldet werden, können Sie zu Ihrem Konto
wechseln, indem Sie im Servermenü in der Ecke rechts oben auf Abmelden klicken.
Wenn Sie zum Anmelden aufgefordert werden, geben Sie Ihren Benutzernamen und Ihr
Kennwort ein, und klicken Sie auf Anmelden.
Speichern des Benutzernamens
Wenn Sie das Kontrollkästchen Anmeldedaten speichern auf der Anmeldeseite von
Tableau Server aktivieren, wird Ihr Benutzername bei jedem Serverbesuch automatisch
eingetragen. Diese Option erleichtert Ihnen den schnellen Zugang zu Ihrem Konto. Ihr
Kennwort müssen Sie bei jedem Besuch weiterhin eingeben, um sich anzumelden. Wenn Sie
auf der Anmeldeseite die Option Anmeldedaten speichern aktivieren, erstellt Tableau
Server ein Cookie mit Ihrem Benutzernamen, das abgerufen wird, wenn Sie die Seite auf
demselben Computer erneut aufrufen.Sie können die Cookies Ihres Browsers löschen, um
das automatische Einfügen des Benutzernamens zu beenden.
-4-
Tableau Server speichert immer ein Sitzungscookie, wenn Sie sich anmelden, unabhängig
davon, ob die Option Anmeldedaten speichern aktiviert ist. Aus diesem Grund muss Ihr
Browser so konfiguriert sein, dass er Cookies von Erstanbietern zulässt.
Anmelden bei einer Site
Wenn Sie Mitglied einer einzelnen Site auf Tableau Server sind, müssen Sie beim Anmelden
keine Site auswählen, da diese automatisch ausgewählt wird. Der Anfang der Serverseite
ähnelt dem folgenden Bild:
Wenn Sie zu verschiedenen Sites gehören, wird der Name Ihrer aktuellen Site im Site-Menü
angezeigt:
Anmelden mit SAML
Wenn Tableau Server für die SAML-Authentifizierung konfiguriert ist, wird keine Tableau
Server-Anmeldeaufforderung angezeigt.Stattdessen wird eine Aufforderung von einem
externen Identitätsprovider angezeigt. Beispiel:
Nach der Anmeldung mit aktivierter SAML-Authentifizierung wird kein Befehl zum Abmelden
im Tableau Server-Benutzermenü angezeigt. Dies liegt daran, dass Ihre Anmeldung vom
Identitätsprovider und nicht von Tableau Server verarbeitet wurde. Zum Abmelden von
Tableau Server müssen Sie ebenfalls Ihren Identitätsprovider verwenden.
-5-
Suche in Tableau Server
Wenn Sie sich zum ersten Mal bei Tableau Server anmelden, wird eine Liste von Ansichten
angezeigt. Die Ansichten sind alphabetisch oder nach Namen sortiert. Die Seite enthält
verschiedene Tools für die Navigation und zum Suchen nach Ansichten auf dem Server:
Navigieren auf dem Server
Die Navigation in Tableau Server ist entweder über die Navigationslinks auf der linken Seite
oder die Seitensteuerelemente möglich.
Navigationslinks
Der Navigationsbereich auf der linken Seite ist in eine Admin-Registerkarte, die nur von
System- und Site-Administratoren angezeigt werden kann, und eine Inhaltsregisterkarte
unterteilt, die von allen Serverbenutzern angezeigt werden kann:
Admin
Wenn Sie Systemadministrator sind, können Sie mit folgenden Schritten eine Website zu
Tableau Server hinzufügen: Site-Administratoren können dieselben Bereiche wie
Administratoren ansehen, mit Ausnahme der Site- und Lizenzierungsseiten. SiteAdministratoren haben für die für sie sichtbaren Bereiche allgemein weniger Berechtigungen.
Die Berechtigung von Site-Administratoren für das Hinzufügen von Benutzern zu einer Site
zählt zu den Dingen, die Systemadministratoren gewähren oder verweigern können (siehe
Hinzufügen oder Bearbeiten von Sites Auf Seite 222).
-6-
Inhalt
Der Bereich Projekte enthält einen Link zur Liste der Projekte auf dem Server. Ein Projekt ist
eine Sammlung verwandter Arbeitsmappen. Administratoren erstellen und warten Projekte.
Weitere Informationen hierzu finden Sie unter Projekte Auf Seite 203.
Seitensteuerelemente
Wenn mehrere Seiten vorhanden sind, können Sie mit den unten auf der Seite angeordneten
Links Nächste und Vorherige durch die Seiten blättern. Alternativ dazu können Sie direkt auf
eine bestimmte Seite zugreifen, indem Sie die Seitenzahl in das Textfeld eingeben und auf der
Tastatur die Eingabetaste drücken.
Sie können die Anzahl der auf einer Seite angezeigten Elemente erhöhen oder verringern,
indem Sie die Anzahl der gewünschten Elemente eingeben und dann die Eingabetaste
drücken.Beachten Sie, dass die Erhöhung der Anzahl der auf einer Seite angezeigten
Elemente manchmal zu Leistungseinschränkungen für Serverbenutzer führen kann.
-7-
Blattregisterkarten
Arbeitsmappen bestehen oft aus mehreren Blättern, die einzelne Ansichten, Dashboards und
Storys enthalten können. Autoren können diese Arbeitsmappen auch dort veröffentlichen, wo
die Blätter im oberen Seitenbereich als Registerkarten angezeigt werden (mithilfe Tableau
Desktop-Option Blätter als Registerkarten anzeigen). In einer Arbeitsmappe mit
Registerkarten können Sie bequem mittels der Registerkarten zwischen den Blättern
wechseln.
Navigieren durch Seiten
Ansichten können über mehrere Seiten verfügen, auf die die Daten basierend auf den Werten
eines bestimmten Felds aufgeteilt werden. Ein typisches Beispiel ist eine Ansicht, bei der die
Daten für jedes Jahr, jedes Quartal oder jeden Monat jeweils auf einer separaten Seite
-8-
angezeigt werden. Mithilfe dieser Seiten können Sie Daten besser vergleichen und Ausreißer
erkennen. Auf jeder Seite wird der gleiche Achsenbereich verwendet, damit Sie beim
Navigieren durch die Seiten leicht verfolgen können, wie sich die Daten ändern.
Falls die Ansicht über mehr als eine Seite verfügt, wird das entsprechende Steuerelement zum
Navigieren durch die Seiten angezeigt. Mit den Pfeilen nach links und rechts können Sie die
Seiten einzeln durchgehen, oder Sie können das Dropdown-Menü in der Mitte verwenden, um
direkt auf eine bestimmte Seite zuzugreifen. Außerdem können Sie die Seiten nahtlos
durchlaufen, indem Sie den Schieberegler nutzen.
In der Ansicht unten sind die Seiten z. B. nach Jahren definiert. Mit dem Seitensteuerelement
können Sie für jedes Jahr BIP und Internetnutzung in Prozent anzeigen.
Aktivieren Sie unterhalb des Seitensteuerelements die Option Verlauf anzeigen, um die
Markierungen der vorherigen Seiten beim Durchlaufen der Seiten und beim Auswählen von
Markierungen jeweils beizubehalten. Der Autor der Ansicht kann angeben, wie die
Verlaufsmarkierungen angezeigt werden sollen.
-9-
Die Seite "Benutzerdefiniert"
Die Optionen auf der Seite "Benutzereinstellungen" haben Einfluss auf Ihre Tableau ServerWebsitzungen. Mit den Optionen können Sie Ihre Abonnementeinstellungen verwalten, Ihre
Startseite angeben, die Sprache und das Gebietsschema ändern, die in Tableau Server
angezeigt werden, Cookies für Datenverbindungskennwörter löschen oder Ihr Kennwort
ändern. Sie können diese Seite auch verwenden, um schnell die von Ihnen veröffentlichten
Artikel wiederzufinden.
Um auf "Die Seite "Benutzerdefiniert"" zuzugreifen, klicken Sie oben auf der Seite auf Ihren
Benutzernamen, und wählen Sie Benutzerdefiniert aus dem Dropdown-Menü aus.
Ändern Ihrer E-Mail-Adresse
Wenn Sie eine Ansicht oder Arbeitsmappe in Tableau Server abonniert haben, wird die EMail-Adresse, die das Abonnement empfängt, auf der Seite \"Benutzereinstellungen\"
- 10 -
angezeigt:
Um die E-Mail-Adresse, an die von Tableau Server Abonnements gesendet werden,
einzugeben oder zu ändern, geben Sie die neue E-Mail-Adresse in das Textfeld E-Mail sowie
in das Textfeld E-Mail bestätigen ein, und klicken Sie dann auf Festlegen:
Verwalten von Abonnementeinstellungen
Verwenden Sie die Optionen für Abonnements, um den Zeitplan für ein Abonnement, das Sie
erhalten, zu ändern.
So ändern Sie den Abonnementzeitplan:
1. Wählen Sie unter Zeitplan einen anderen Zeitplan aus:
2. Klicken Sie auf Aktualisieren.
Hier können Sie auch Abonnements für Ansichten oder Arbeitsmappen kündigen machen.
Weitere Informationen dazu finden Sie unter Abonnement für eine Ansicht oder
Arbeitsmappe kündigen Auf Seite 38.
Anpassen der Startseite
Tableau Server Bei der Installation wird Ansichten als Standardstartseite für alle Benutzer
festgelegt, der Administrator kann jedoch eine andere Startseite angeben. Um Ihre Startseite
zu ermitteln, klicken Sie auf Zur Startseite:
- 11 -
Sie können für sich selbst eine andere Startseite bestimmen, indem Sie zu der gewünschten
Serverseite navigieren (z. B. Arbeitsmappen) und den Befehl Zur eigenen Startseite
machen aus dem oben rechts befindlichen Dropdown-Menü auswählen.
Um erneut die vom Administrator festgelegte Startseite zu verwenden, klicken Sie auf der
Seite "Benutzerdefiniert" auf Auf Standardwerte zurücksetzen:
Sprache und Gebietsschema
Mit der Einstellung Sprache wird die Sprache der Tableau Server-Benutzeroberfläche
festgelegt, und Gebietsschema wirkt sich auf Elemente in Ansichten aus, wie die
Formatierung von Zahlen und die verwendete Währung. Ihr Administrator kann diese
Einstellungen für alle Serverbenutzer konfigurieren. Sie können die Einstellungen hier für sich
selbst ändern. Änderungen dieser Einstellungen werden nur wirksam, wenn eine unterstützte
Sprache gewählt wird. Weitere Informationen hierzu finden Sie unter Sprache und
Gebietsschema Auf Seite 264.
Nachdem Sie Sprache und Gebietsschema ausgewählt haben, klicken Sie auf Set
(Festlegen).
Bei der nächsten Anmeldung werden die Einstellungen für Ihre Serversitzungen verwendet.
- 12 -
Ändern Ihres Kennworts
Wenn der Server für die Verwendung des internen Benutzerverwaltungssystems (Lokale
Authentifizierung) anstelle von Active Directory konfiguriert ist, können Sie Ihr Tableau ServerKennwort ändern, indem Sie auf Kennwort ändern klicken. Wenn Sie auf diesen Link klicken,
werden Sie zur Eingabe von Aktuelles Kennwort und Neues Kennwort (zweimal)
aufgefordert. Nach Eingabe der erforderlichen Informationen klicken Sie auf Ändern, um die
Änderungen zu übernehmen.
Löschen der Kennwörter unter "Gespeicherte Kennwörter für Datenverbindungen".
Wenn Sie auf eine Ansicht oder eine Arbeitsmappe zugreifen, die über eine Verbindung zu
einer Livedatenbank verfügt und eine Authentifizierung erfordert, bietet Tableau an, das
Kennwort für Sie zu speichern. Wenn Sie dies akzeptieren, werden Ihre
Anmeldeinformationen in einem Cookie gespeichert. Klicken Sie unter "Gespeicherte
Kennwörter für Datenverbindungen" auf Alle löschen, um den Cookie von Tableau Server zu
entfernen:
Durchsuchen Ihrer veröffentlichten Artikel
Auf Ihrer Benutzerkonto-Seite sind alle Arbeitsmappen, Tags und Kommentare zu sehen, die
Sie veröffentlicht haben. Über diese Seite haben Sie schnellen Zugriff auf Ihre eigenen
Aktivitäten auf dem Server.
- 13 -
Anmeldeinformationen verwalten
Server-Administratoren können Benutzern genehmigen, Zugriffstoken von CloudDatenanbietern zu speichern, wenn diese den OAuth-Standard zur Authentifizierung
verwenden. Mit diesen Token wird der zweckgerichtete Datenzugriff auf Tableau gewährt. Sie
ermöglichen zudem eine sicherere Aufbewahrung von Datenbankanmeldeinformationen beim
Datenanbieter. Weitere Informationen zu dieser Art der Authentifizierung finden Sie unter
OAuth-Datenverbindungen Auf Seite 363.
Wenn Sie von Ihrem Serveradministrator die Berechtigung zum Speichern von Zugriffstoken
zu OAuth-Verbindungen erhalten haben, können Sie diese im Bereich
Anmeldeinformationen verwalten auf Ihrer Benutzereinstellungsseite finden und
verwalten. Wenn dieser Bereich nicht angezeigt wird, haben Sie von Ihrem Administrator
keine Berechtigung zum Speichern von Zugriffstoken auf Benutzerbasis erhalten.
Zur Verwaltung von Zugriffstoken (Anmeldeinformationen) können Sie eine der folgenden
Aufgaben durchführen:
l
Anmeldeinformationen hinzufügenSie können unabhängig von der Veröffentlichung
einer Arbeitsmappe oder Datenquelle ein Zugriffstoken aus Ihrer Cloud-Datenquelle
erhalten.Wenn Sie auf die Daten zugreifen müssen, ist die Authentifizierung bereits
erfolgt.
Sie können Zugriffstoken für Datenquellen aus Salesforce.com, Google BigQuery und
Google Analytics hinzufügen.
l
Token entfernen, um den Tableau-Datenzugriff zu sperren.
- 14 -
Ähnlich wie beim Erstellen eines Zugriffstoken wird durch Entfernen der Zugriff auf alle
Arbeitsmappen, die über dieses Token mit den Daten verbunden sind, gesperrt.
l
l
Verbindungen prüfen für gespeicherte Zugriffstoken.
Entfernen Sie alle verwalteten Anmeldeinformationen, die zu Ihrem
Benutzerkonto gespeichert wurden.
Neue Anmeldeinformationen hinzufügen.
1. Klicken Sie, während Sie bei Tableau Server angemeldet sind, in der oberen rechten
Ecke des Browserfensters auf Ihren Benutzernamen und wählen Sie danach Benutzereinstellungen aus.
2. Klicken Sie im Abschnitt "Anmeldeinformationen" neben der Art der Datenquelle, mit der
Sie eine Verbindung herstellen möchten, auf Hinzufügen.
Es wird ein neues Fenster angezeigt, über das Sie zur Site des Datenanbieters
zurückgeleitet werden.
3. Melden Sie sich im neuen Fenster mit Ihren Datenbankanmeldeinformationen an.
Wenn der Datenanbieter das Anmeldeformular überspringt, da Sie bereits angemeldet
sind, achten Sie darauf, dass Sie das richtige Konto verwenden. Wenn Sie
beispielsweise an einen einem persönlichen Konto angemeldet sind, melden Sie sich
zunächst mithilfe des Formulars ab und melden sich dann mit den richtigen
Anmeldeinformationen für den Zugriff auf Ihre Daten an.
4. Klicken Sie auf Akzeptieren oder Genehmigen, um den Tableau Server Zugriff auf
Ihre Daten zu bestätigen.
Ihre Anmeldeinformationen werden unter dem Namen des Datenanbieters angezeigt.
Nachdem Sie die neuen Anmeldeinformationen hinzugefügt haben, können Sie deren
Gültigkeit mithilfe des Links Test überprüfen.
Verwaltete Anmeldeinformationen entfernen
Wenn Sie zu Ihrem Konto keine Anmeldeinformationen mehr speichern möchten, können Sie
sie einfach aus dem Verwaltungsbereich für Anmeldeinformationen löschen.
- 15 -
Eine Option für den erneuten Datenzugriff besteht im Hinzufügen neuer
Anmeldeinformationen wie oben beschrieben und dem Abrufen eines neuen Tokens, das nur
mit Ihrem Tableau Server Konto verbunden ist.
Eine weitere Möglichkeit besteht darin, dass der Serveradministrator für alle Benutzer ein
gemeinsames Konto für die Verbindung mit solchen Daten festlegt.In diese, Fall sind die
Anmeldeinformationen mit der Datenquelle oder Verbindung für alle Benutzer verknüpft und
sie erscheinen nicht unter "Anmeldeinformationen verwalten" auf der
Benutzereinstellungsseite.
Wenn Sie Anmeldeinformationen nicht löschen können, hat der Serveradministrator u.
U. die Option Zugriffstoken speichern deaktiviert. Der Administrator muss dann die
Option erneut aktivieren, damit Sie die Anmeldeinformationen löschen können.
Verbindungen für verwaltete Anmeldeinformationen prüfen
1. Rufen Sie Ihre Benutzereinstellungsseite auf, während Sie bei Tableau Server
angemeldet sind.
2. Klicken Sie im Abschnitt "Anmeldeinformationen" neben der gespeicherten Verbindung
aus, die Sie prüfen möchten, auf Prüfen .
Bei diesem Test wird geprüft, ob Ihre Anmeldeinformationen für OAuth-Verbindungen und zur
Nutzung von Zugriffstoken genehmigt sind. Wenn Sie trotz erfolgreicher Überprüfung über
- 16 -
diese verwaltete Verbindung nicht auf Ihre Daten zugreifen können, bestätigen Sie, dass die
für die Verbindung angegebenen Anmeldeinformationen für einen Zugriff auf Ihre Daten
geeignet sind.
Wenn Sie die Verbindung versehentlich mit Ihrem persönlichen Gmail-Konto erstellt haben,
aber über ein anderes Konto auf eine Google Analytics-Datenbank zugreifen, müssen Sie die
Anmeldeinformationen löschen und neu erstellen.
Alle verwalteten Anmeldeinformationen löschen
Wenn Sie Alle Anmeldeinformationen und Kennwörter löschen auswählen, werden
folgende Elemente aus Ihrem Benutzerkonto entfernt.
l
Alle Zugriffstoken für OAuth-Verbindungen, die in Ihrem Konto gespeichert sind..
Vorsicht Werden solche Token mit veröffentlichten Arbeitsmappen oder
Datenquellen gespeichert, so ist auch der Zugriff auf die Datenquellen von diesen
Orten nicht mehr möglich. Hierdurch wird im Endeffekt das Design der
Umgebung, in der die betroffenen Token verwendet werden, geändert.
l
Kennwörter, die Sie für den Zugriff auf veröffentlichte Datenextrakte oder damit
verbundene Arbeitsmappen genutzt haben.
Ausführen von Aktionen
Wenn Sie über die Interactor-Lizenzstufe verfügen oder Administrator sind, haben Sie am
Anfang vieler Serverseiten Zugriff auf Befehle, mit denen Sie beispielsweise Berechtigungen
festlegen, Tags hinzufügen oder Ansichten und Arbeitsmappen löschen können.
- 17 -
Sie können die Befehle zusammen mit dem Kontrollkästchen verwenden, das neben jedem
Listeneintrag angezeigt wird. Anstatt Einträge einzeln auszuwählen, können Sie in der
Dropdown-Liste Alle Einträge, nur diejenigen auf der aktuellen Seite oder Keine Einträge
auswählen.
Anstatt das Dropdown-Menü zu verwenden, können Sie oberhalb der Liste auch mehrfach auf
das Kontrollkästchen klicken, um zwischen diesen Optionen zu wechseln. Das
Kontrollkästchen wird aktualisiert und zeigt an, welche Elemente ausgewählt sind.
Auswahl aller Einträge auf
mehreren Seiten
Auswahl der Einträge auf
der aktuellen Seite
Keine Auswahl
von Einträgen
Nach dem Auswählen der Einträge können Sie die relevanten Aktionen anwenden, z. B. das
Festlegen der Berechtigungen oder das Hinzufügen von Tags.
Durchsuchen des Inhalts
Mit dem Suchfeld auf der linken Seite und den Filtern darunter können Sie Ansichten und
andere Elemente schnell auffinden.Sie können auch Suchattribute und -operatoren bei Ihrer
Eingabe verwenden.
Verwenden der Filtersuche
Die Dropdown-Menüs für Projekt, Eigentümer und Tag zeigen Ihnen, was auf dem Server
definiert wurde, und die Filter Geändert am oder nach/vor, Favoriten und Zuletzt
verwendet können bei der weiteren Einschränkung der Suche helfen:
- 18 -
Um einen Filter zu entfernen, klicken Sie auf das X rechts neben dem Filterwert:
Um alle Filter zu löschen, klicken Sie oben auf Alle löschen:
Verwenden von Attributen bei der Suche
Sie können nicht nur allgemeine Suchanfragen starten, sondern eine Suche auf Tableau
Server auch auf bestimmte Attribute wie Namen, Arbeitsmappe, Datenquelle usw.
beschränken.Beispiel: Wenn Sie name:Umsatz Prognosen (ohne Leerzeichen vor bzw. nach
dem Doppelpunkt) eingeben, erhalten Sie nur Ergebnisse, deren Namen die Wörter Umsatz
oder Prognosen enthalten. Suchoperatoren unterstützen Sie derweil bei der Bestimmung der
Suchart, die durchgeführt werden soll.
Eine vollständige Liste der Attribute ist im Folgenden aufgeführt.
- 19 -
Dieses
Attribut ...
gefolgt von ...
Gibt
name:
Suchbegriff
Artikel, deren Namen sich mit dem Suchbegriff decken
title:
Suchbegriff
Ansichten, deren Titel sich mit dem Suchbegriff decken
caption:
Suchbegriff
Ansichten, deren Überschriften sich mit dem
Suchbegriff decken
Benutzername
Elemente, die von den angegebenen Benutzern besessen (veröffentlicht) werden
Hinweis: Vor Version 8.2 wurden Owner
bzw. Eigentümer in Tableau Server als Publisher aufgelistet. Das Suchattribut publisher wird weiterhin unterstützt und gibt
dieselben Ergebnisse zurück wie das Attribut owner.
owner:
publisher: Benutzername
(Siehe "owner" oben)
project:
Suchbegriff
Artikel, die Teil eines Projekts sind, dessen
Name sich mit dem Suchbegriff deckt
comment:
Suchbegriff
Ansichten, deren Kommentare sich mit dem
Suchbegriff decken
tag:
Suchbegriff
Artikel, deren Tags sich mit dem Suchbegriff
decken
field:
Suchbegriff
Ansichten mit passenden Feldern in den Zeilen, Spalten, der Detailgenauigkeit, den Seiten oder in Containern mit
Kodierungsfunktion
type:
workbook,
view, data- Artikel, die dem angegebenen Typ entsource, pro- sprechen
ject
Ansicht, Dassheettype: hboard oder
Story
class:
Ansichten, die dem angegebenen Blatttyp
entsprechen
Ansichten und Datenquellen, die mit dem
Datentypquelle
angegebenen Datenquellentyp über(z. B. mysql)
einstimmen
- 20 -
Dieses
Attribut ...
gefolgt von ...
Gibt
dbname:
Name der
Datenbank
Ansichten und Datenquellen, die mit der
angegebenen Datenquelle übereinstimmen
tablename: Suchbegriff
nviews:
number
Ansichten und Datenquellen, die mit dem
angegebenen Tabellennamen übereinstimmen
Arbeitsmappen, die die angegebene Anzahl
an Ansichten enthalten
Bei Suchbegriffen wird die Groß-/Kleinschreibung nicht berücksichtigt.
Sie können mehrere Attribute eingeben, um die Suchanfrage weiter zu spezifizieren.Wenn Sie
beispielsweise alle Dashboards finden möchten, die im Besitz von Schmidt sind, geben Sie
Folgendes in das Suchfeld ein: sheettype:dashboard owner:schmidt.
Verwenden von Suchoperatoren
Manchmal benötigen Sie vielleicht Suchanfragen mit logischen Operationen für Tableau
Server. Beispiel: Sie möchten nach allen Elementen suchen, die einen bestimmten Begriff
nicht enthalten.Oder Sie möchten Artikel finden, die sich mit einem von zwei Suchbegriffen
decken, aber nicht mit beiden. Sie können and, or, not und * verwenden, um
Suchausdrücke zu bilden.
Operator Definition
Beispiele
and
Dies führt zu Ergebnissen, die sich mit
Vertrieb and Marketing; Stifte and Papier
beiden Suchbegriffen
decken.
or
Dies führt zu Ergebnissen, die sich mit
Westen or Osten; Fußball and Football
einem der beiden
Suchbegriffe decken.
not
Schließt Artikel aus,
die den nach diesem
Operator angenot sheettype:Dashboard
gebenen Suchbegriff
enthalten.
*
Dient als Ersatz für
andere Zeichen oder
Wörter, die diesem
Abw* Umsatz*
Zeichen folgen, oder
als Teil des Such-
- 21 -
Operator Definition
Beispiele
begriffs. Dieser Operator kann alleinstehend oder am
Ende des Suchbegriffs verwendet
werden. Dieser Operator ist nützlich,
wenn Sie nicht genau
wissen, wonach Sie
suchen.
Leerzeichen bei der Suche
Wenn Ihr Suchbegriff Leerzeichen, Satzzeichen oder die tatsächlichen Wörter and, or oder
not enthält, setzen Sie den Suchbegriff in Anführungszeichen.
Verwenden von Listen
Bei der Navigation durch Tableau Server werden Sie feststellen, dass Elemente entweder als
Miniaturen oder in Listen angezeigt werden.Über Symbole oben auf Arbeitsmappen- und
Ansichtsseiten können Sie festlegen, ob Inhalte als Listen oder als Miniaturen angezeigt
werden sollen:
Sie können schnell zwischen diesen zwei Zuständen umschalten, indem Sie auf die Listenoder Miniaturbildsymbole klicken:
- 22 -
Sortieren von Miniaturbildern
Je nach Art der angezeigten Elemente stehen folgende Sortierkategorien zur Wahl: Name,
Projekt, Anzahl der Blätter, Geändert am und Publisher. Die Sortierweise richtet sich
danach, ob die aktuelle Liste in Textform oder mit Minitaturbildern angezeigt wird. Eine
sortierte Liste wird nach der ausgewählten Kategorie gruppiert. Die Gruppen sind an ihren
Titeln als solche erkennbar. Die unten angezeigten Miniaturbildansichten sind beispielsweise
alphabetisch und in aufsteigender Reihenfolge (A–Z) sortiert. Beachten Sie, dass der
Sortierpfeil nach oben zeigt:
- 23 -
Sortieren von Listen
In einer Textliste lässt sich die Liste nach Spaltenüberschriften sortieren. Der Pfeil zeigt wieder
an, ob die Elemente in aufsteigender (Pfeil nach oben) oder absteigender Reihenfolge (Pfeil
nach unten) sortiert sind. Klicken Sie auf eine Spaltenüberschrift, nach der die Liste sortiert
werden soll.
In der Listenansicht ist manchmal eine Spalte Bearbeiten verfügbar. Sie können eine Ansicht
auswählen und auf Bearbeiten klicken, um die Ansicht auf dem Server zu ändern. Weitere
Informationen zur Vorgehensweise erhalten Sie unter Bearbeiten und Erstellen von
Ansichten Auf Seite 67
Beim weiteren Ändern der Sortierung einer Liste von Arbeitsmappen, Ansichten oder
Projekten speichert der Server jeweils Ihre letzten drei Sortierungen und übernimmt sie
als mehrspaltige Sortierung. Wenn Sie also erst nach Geändert (Datum) sortieren und
dann nach Projekt, so wird die Liste in Projekte gruppiert, und innerhalb dieser Gruppen
werden die Arbeitsmappen oder Ansichten nach ihrem Änderungsdatum sortiert.
- 24 -
Speichern von Favoriten
Sie können Ansichten oder Arbeitsmappen als Favoriten speichern, damit Sie schneller darauf
zugreifen können. Favoriten werden im Menü "Favoriten" oben rechts angezeigt:
Im Favoritenmenü sind Ansichten durch ein -Symbol und Arbeitsmappen durch ein Symbol gekennzeichnet. Wenn Sie über eine große Anzahl von Favoriten verfügen, können
Sie die rechts befindliche Scrollbar verwenden, um alle anzuzeigen.
Sie können einfach mit dem oben befindlichen Suchfeld nach bestimmten Favoriten suchen.
Hinzufügen eines Favoriten
Sie können Favoriten entweder in der Miniaturbildansicht oder in der Listenansicht der Seiten
von Arbeitsmappen und Ansichten erstellen. Zum Erstellen eines Favoriten in der
Miniaturansicht zeigen Sie mit der Maus auf eine Ansicht oder eine Arbeitsmappe, und wählen
Sie dann den Favoritenstern in der daraufhin angezeigten QuickInfo:
- 25 -
In der Listenansicht erstellen Sie einen Favoriten, indem Sie auf den Stern neben einer Ansicht
oder einer Arbeitsmappe klicken, die Sie als Favorit speichern möchten.
Die Ansicht bzw. Die Arbeitsmappe wird zum Favoritenmenü hinzugefügt.
Entfernen eines Favoriten
Wenn Sie eine Ansicht oder eine Arbeitsmappe aus der Favoritenliste entfernen möchten,
zeigen Sie mit der Maus auf die entsprechende QuickInfo, und klicken Sie dann auf den Stern:
- 26 -
In der Listenansicht klicken Sie einfach auf den Stern, um die Ansicht bzw. Arbeitsmappe aus
der Liste der Favoriten zu entfernen:
Speichern von Kennwörtern
Bei einigen Ansichten kann es erforderlich sein, den Benutzernamen und das Kennwort für die
Datenbank einzugeben. Wenn Sie Zugriff auf die Datenbank haben, geben Sie Ihren
Benutzernamen und das dazugehörige Kennwort einfach in die entsprechenden Textfelder
ein. Falls Sie die Option Kennwort speichern aktivieren, wird die Anmeldung bei jedem
Anzeigen der Ansicht automatisch durchgeführt. Ihre Anmeldeinformationen werden auf dem
Server verschlüsselt gespeichert. Die automatische Anmeldung ist also auch über
Browsersitzungen hinweg und beim Zugreifen auf die Ansicht von unterschiedlichen
Computern aus möglich. Dies ist hilfreich, wenn Sie auf bestimmte Ansichten häufig zugreifen
müssen.
Hinweis:
Administratoren legen fest, ob Benutzer die Option zum Speichern der Datenbankkennwörter
verwenden können. Weitere Informationen für Administratoren finden Sie unter
Wartungseinstellungen Auf Seite 246.
- 27 -
Löschen und Zurücksetzen gespeicherter Kennwörter
Wenn Ihre Kennwörter gespeichert werden (auf der Wartungsseite ist Gespeicherte
Kennwörter aktiviert), können Sie diese auch löschen. Wenn Sie dies durchführen, werden
Sie beim nächsten Besuch des Servers zum Eingeben Ihres Benutzernamens und des
dazugehörigen Kennworts aufgefordert. Dies ist z. B. ratsam, wenn sich Ihr Benutzername
und das Kennwort ändern, damit Sie mit der Verwendung Ihrer neuen Anmeldeinformationen
beginnen und diese speichern können.
1. Öffnen Sie im Dropdown-Menü oben rechts die Seite "Benutzerdefiniert":
2. Klicken Sie unter "Gespeicherte Kennwörter für Datenverbindungen" auf Alle löschen.
Administratoren können auch alle gespeicherten Kennwörter auf dem Server löschen,
indem sie auf der Wartungsseite den Link Alle gespeicherten Kennwörter löschen
für alle Benutzer verwenden.
- 28 -
Arbeiten mit Ansichten
Nachdem Sie eine Ansicht, ein Dashbord oder eine Story gefunden haben, die Sie
interessieren, bieten sich Ihnen verschiedenste Möglichkeiten zur Anzeige und zur Interaktion
mit den Daten. Was Sie mit den Daten anfangen können, hängt von zwei Faktoren ab: Ihrer
Lizenzstufe und den vom Autor der Ansicht festgelegten Berechtigungen. Weitere
Informationen hierzu finden Sie unter Arbeiten mit Berechtigungen Auf Seite 89.
Teilen von Ansichten
Alle veröffentlichten Ansichten und Arbeitsmappen können per E-Mail weitergegeben oder in
eine andere Webseite, ein Wiki oder eine Webanwendung eingebettet werden.Jeder, der eine
weitergegebene Ansicht anzeigen möchte, muss über ein Tableau Server-Konto und
entsprechende Zugriffsberechtigungen verfügen.
Versenden einer Ansicht per E-Mail
1. Klicken Sie oben links in der Ansicht auf Freigeben.
2. Kopieren Sie den angegebenen Link in Ihre E-Mail.
Einbetten von Ansichten
Sie können eine Ansicht bereitstellen, indem Sie sie in eine andere Webseite einbetten, z. B. in
ein Wiki, einen Blog oder eine Webanwendung.
- 29 -
1. Klicken Sie links oben in der Ansicht auf den Link Freigeben.
2. Kopieren Sie den angegebenen HTML-Code, und fügen Sie ihn in den Quellcode der
Seite ein, in die Sie die Ansicht einbetten möchten.
Hinweis: Der von Tableau generierte Einbettungscode verweist dann automatisch auf
die aktuelle Ansicht. Informationen zum Anzeigen eingebetteter benutzerdefinierter
Ansichten in Tableau finden Sie unter Einbettungscode für benutzerdefinierte
Ansichten.
Anpassen einer eingebetteten Ansicht
In den Anzeigeoptionen können Sie das optische Erscheinungsbild einer eingebetteten
Ansicht an Ihre Wünsche anpassen. Dort können Sie eine feste Breite und Höhe festlegen und
auch bestimmen, ob die Symbolleiste oder Registerkarten ein- oder ausgeblendet werden
sollen.
- 30 -
Daten mittels QuickInfo-Elementen untersuchen
QuickInfo-Elemente sind zusätzliche Datendetails, die angezeigt werden, wenn Sie in der
Ansicht mit dem Mauszeiger auf eine oder mehrere Markierungen zeigen:
Über die QuickInfo-Elemente können Sie auch auf einfache Weise Markierungen filtern oder
entfernen sowie Daten anzeigen:
- 31 -
l
Nur beibehalten: Zeigt nur das an, was in der Ansicht ausgewählt wurde.
l
Ausschließen: Entfernt die ausgewählten Daten aus der Ansicht.
l
Daten anzeigen: Öffnet ein Fenster, in dem die Daten angezeigt werden. Sie können
die zusammengefassten Daten oder die zugrunde liegenden Daten anzeigen.
Um eine Gruppe von Markierungen zu filtern oder auszuschließen, wählen Sie diese einfach
aus und klicken dann auf die auszuführende Aktion:
Um die zusammengefassten Daten oder die zugrunde liegenden Daten anzuzeigen, treffen
Sie eine Auswahl und klicken auf das Symbol "Daten anzeigen":
- 32 -
Bei den Daten auf der Registerkarte Zusammenfassung handelt es sich um die aggregierten
Daten der Ansicht bzw. der von Ihnen ausgewählten Felder der Ansicht.
Bei den Daten unter Zugrunde liegend handelt es sich um die Werte für die einzelnen Zeilen
in der Datenquelle, wobei die Anzeige durch die von Ihnen ausgewählten Markierungen
eingeschränkt wird.
Bei Auswahl von Alle Spalten anzeigen werden alle Spalten der zugrunde liegenden
Datenquelle angezeigt, unabhängig davon, ob die Daten in der Ansicht enthalten sind:
- 33 -
Über Alle Zeilen als Textdatei herunterladen können Sie alle Zeilen über die Links am
oberen und unteren Rand der Tabelle als Textdatei herunterladen:
Abonnieren von Ansichten
Wenn Sie eine Ansicht auf Tableau Server anzeigen lassen können und sie über ein
Abonnementsymbol ( ) in der oberen rechten Ecke verfügt, hat Ihr Administrator
Abonnements für Ihre Site konfiguriert, und Sie können die Ansicht abonnieren.Dies bedeutet,
dass Sie regelmäßig und automatisch per E-Mail eine Momentaufnahme der Ansicht erhalten,
ohne sich bei Tableau Server anmelden zu müssen. Sie können auch Arbeitsmappen
abonnieren. Anstatt einer einzelnen Ansicht erhalten Sie alle Ansichten der Arbeitsmappe in
einer einzigen E-Mail. Sie können Abonnements, die Sie nicht mehr länger erhalten möchten,
auch wieder kündigen. Nähere Informationen hierzu finden Sie unter:
Sie können Ihre Abonnementeinstellungen auf der Seite "Benutzereinstellungen"
ändern. Weitere Informationen dazu finden Sie unter Verwalten von
Abonnementeinstellungen Auf Seite 11.
- 34 -
Abonnieren einer Ansicht
So abonnieren Sie eine Ansicht oder eine Arbeitsmappe:
1. Navigieren Sie zur Seite Ansichten oder Arbeitsmappen:
2. Klicken Sie auf eine Ansicht oder eine Arbeitsmappe.
3. Klicken Sie auf das Abonnementsymbol oben rechts in der Ecke.
- 35 -
4. Wenn Ihrem Tableau Server-Konto nicht bereits eine E-Mail-Adresse zugeordnet
wurde, werden Sie aufgefordert, eine einzugeben. Geben Sie Ihre E-Mail-Adresse ein
und Klicken Sie auf Weiter.
Sie können die E-Mail-Adresse ändern, an die das Abonnement gesendet werden
soll.Weitere Informationen dazu finden Sie unter Ändern Ihrer E-Mail-Adresse Auf
Seite 10.
5. Wählen Sie im nächsten Dialogfeld einen Abonnementzeitplan aus. Standardmäßig
bietet Tableau Server einen Zeitplan für werktäglich morgens und einen Zeitplan für
Montagmorgens. Der Tableau Server-Administrator kann auch benutzerdefinierte
Zeitpläne für Abonnements erstellen.
- 36 -
6. Als nächstes entscheiden Sie, ob Sie eine einzelne Ansicht (Dieses Blatt) oder die
gesamte Arbeitsmappe (Blätter in der Arbeitsmappe) abonnieren möchten und
klicken auf Abonnieren.
7. Wenn Sie das Abonnement später per E-Mail erhalten, klicken Sie auf die
- 37 -
Momentaufnahme der Ansicht, und sie wird auf Tableau Server geöffnet:
Abonnement für eine Ansicht oder Arbeitsmappe kündigen
So machen Sie das Abonnement einer Ansicht oder einer Arbeitsmappe rückgängig:
1. Öffnen Sie die Seite "Benutzereinstellungen" auf Tableau Server, indem Sie auf den
Link unten in einer Abonnement-E-Mail klicken.
- 38 -
Sie können die Seite "Benutzereinstellungen" auch über das Dropdown-Menü von
Tableau Server öffnen:
2. Aktivieren Sie neben der Ansicht, deren Abonnement Sie beenden möchten, das
- 39 -
Kontrollkästchen Abonnement rückgängig machen.
Sie können hier auch Ihre Abonnements ändern. Weitere Informationen dazu finden Sie
unter Verwalten von Abonnementeinstellungen Auf Seite 11.
3. Klicken Sie auf Aktualisieren.
Sortieren von Daten
Die Sortierreihenfolge der Elemente einer Ansicht lässt sich über die Sortierschaltflächen auf
Achse, Feldbeschriftung oder Kopfzeile ändern. Die Ansicht unten enthält z. B. die Ölmenge
verschiedener Bohrlöcher. Wenn Sie die Maus über die vertikale Achse bewegen, wird eine
Sortierschaltfläche mit der Sortierfolge angezeigt, die verwendet wird, wenn Sie auf die
Schaltfläche klicken (hier eine absteigende Sortierung):
Nach dem Sortiervorgang wird das Sortiersymbol weiterhin auf der vertikalen Achse
angezeigt:
Klicken Sie erneut auf das Sortiersymbol. Daraufhin werden die Daten in absteigender
Reihenfolge von der niedrigsten zur höchsten Fördermenge sortiert:
- 40 -
Wenn Sie ein drittes Mal klicken, wird der ursprüngliche Zustand des Balkendiagramms
wiederhergestellt:
Soll der ursprüngliche Zustand der gesamten Ansicht wiederhergestellt werden, klicken Sie in
der Symbolleiste auf die Schaltfläche Revert All (Alles wiederherstellen).
Daten filtern
Wenn Sie über die Lizenzstufe Interactor verfügen, können Sie Daten in einer Ansicht filtern,
um die Visualisierung der gewünschten Daten einzugrenzen. In einem Umsatzbericht können
z. B. die Umsätze für mehrere unterschiedliche Regionen angezeigt werden. Mithilfe von
Filtern können Sie die Anzeige auf die Ergebnisse für Ihre Region beschränken. Sie können
die gesetzten Filter dann wieder aufheben, um zur Originalansicht zurückzukehren und Ihre
Region mit anderen Regionen zu vergleichen. Es gibt zwei Möglichkeiten zum Filtern der
Ansicht: Schnellfilter und die QuickInfo-Befehle "Nur beibehalten" und "Ausschließen".
Arten von Schnellfiltern
Es gibt viele unterschiedliche Arten von Schnellfiltern. Der Autor der Ansicht wählt die Art von
Filter aus, mit der sich die zu filternden Werte am besten anzeigen lassen. Die einzelnen
Filterarten und die dazugehörige Interaktion ist unten beschrieben.
- 41 -
Art des Schnellfilters
Beschreibung
Liste mit mehreren Werten
Zeigt ein Liste mit Kontrollkästchen an. Wählen Sie
die einzubeziehenden Werte aus.
Liste mit Einzelwerten
Zeigt ein Liste mit Optionsfeldern an. Wählen Sie
die einzubeziehenden Werte einzeln aus.
Kompaktliste
Es wird eine Dropdown-Liste mit Werten
angezeigt. Wählen Sie die einzubeziehenden
Werte einzeln aus.
Schieberegler
Hiermit zeigen Sie die Werte eines Bereichs an.
Bewegen Sie den Schieberegler, oder verwenden
Sie die Pfeile, um einen einzelnen
einzubeziehenden Wert auszuwählen. Verwenden
Sie für quantitative Werte die beiden
Schieberegler, um einen Wertebereich anzugeben.
Platzhalterübereinstimmung
Es wird ein Textfeld angezeigt. Sie können alle
Werte einbeziehen, die eine bestimmte
Buchstabenfolge enthalten. Verwenden Sie ggf.
das Sternchen (*) als Platzhalterzeichen.
Eingabe
Es wird ein Textfeld angezeigt. Geben Sie einen
Wert ein, und klicken Sie auf das Pluszeichen, um
diesen in den Filter einzubeziehen. Alternativ dazu
können Sie eine kopierte Liste mit Werten in das
Textfeld einfügen.
Datumsfilter
Datumsfilter können für die meisten oben
beschriebenen Filtertypen angezeigt werden. Es
gibt jedoch noch einige weitere spezielle Filtertypen
für Zeiträume. Mithilfe von relativen Datumsfiltern
- 42 -
Art des Schnellfilters
Beschreibung
können Sie z. B. häufig verwendete Zeiträume wie
"Letzte 3 Wochen" oder "Bisheriges Jahr"
einbeziehen. Sie können auch unter vordefinierten
Datumszeiträumen wählen, z. B. 1 Tag, 1 Woche,
3 Monate usw.
Liste mit mehreren Werten (hierarchisch)
Falls für die Ansicht eine mehrdimensionale
Datenquelle verwendet wird, werden in der Liste
mit mehreren Werten die Hierarchieebenen
angezeigt. Verwenden Sie oben die
Steuerelemente zum Auswählen der Ebene, um
alle Werte einer Ebene einzubeziehen.
Filteroptionen
Viele Schnellfilter verfügen über zusätzliche Optionen, die angezeigt werden, wenn Sie auf der
Seite mit der Maus auf den Filterbereich zeigen. In einigen Fällen kann es z. B. einfacher sein,
die Elemente auszuwählen, die nicht einbezogen werden sollen, als alle Elemente, die
einbezogen werden sollen. Mit den Optionen im Dropdown-Menü einer Liste mit mehreren
Werten können Sie zwischen den Filtertypen Inklusive und Exklusive wechseln. Jeder
Filtertyp verfügt im Dropdown-Menü in der oberen rechten Ecke des Filterbereichs über einen
eigenen Satz von Optionen. Die Verfügbarkeit dieser Optionen wird vom Autor der Ansicht
gesteuert.
Falls ein Filter viele Werte umfasst, können Sie mithilfe der Suche schnell auf die gewünschten
Werte zugreifen. Klicken Sie auf die Schaltfläche Suche, die angezeigt wird, wenn Sie mit der
Maus auf den Schnellfilter zeigen. Beginnen Sie dann mit der Eingabe des gesuchten Werts.
- 43 -
Die Ergebnisse werden direkt unter dem Suchfeld angezeigt und können leicht ausgewählt
werden.
Sie können die im Schnellfilter angezeigten Werte auch eingrenzen, indem Sie die
Schaltfläche Mehr Werte anzeigen/Weniger Werte anzeigen verwenden. Wenn Sie mehr
Werte anzeigen, werden alle Werte des Felds angezeigt. Wenn Sie weniger Werte anzeigen,
werden die anderen aktiven Filter berücksichtigt. Es werden nur die Werte angezeigt, die die
Kriterien aller Filter erfüllen. Eine Ansicht kann z. B. so gefiltert werden, dass nur Umsätze
über 5000 Dollar für die Regionen "Western" und "Central" angezeigt werden. Wenn Sie mehr
Werte anzeigen, zeigt der Regionsfilter alle Regionen an. Wenn Sie weniger Werte anzeigen,
zeigt der Regionsfilter nur Regionen an, in denen der Umsatz größer als 5000 Dollar ist.
Wiederherstellen von Filtern
Wenn Sie den Filterzustand wiederherstellen möchten, der nach der Veröffentlichung der
Ansicht geherrscht hat, verwenden Sie die Schaltfläche Revert All (Alles wiederherstellen).
Exportieren von Ansichten
Sie können die Ansicht als Bild- oder PDF-Datei exportieren. Alternativ dazu können Sie die
Daten auch als Kreuztabelle oder Datei mit Kommas als Trennzeichen (Daten) exportieren.
Wählen Sie in der Symbolleiste oben in der Ansicht im Menü Exportieren die gewünschte
Option aus.
- 44 -
Beim Export eines Dashboards mit einem Webseitenobjekt in eine PDF-Datei wird das
Webseitenobjekt nicht exportiert. Wenn Sie eine Exportoption auswählen, muss zudem
die Bild-, die PDF- oder die Datendatei generiert werden. Der Abschluss dieses
Vorgangs wird in einer Meldung angezeigt, und Sie können dann mit dem
Herunterladen der Datei fortfahren.
So exportieren Sie eine Ansicht als PDF-Datei:
1. Öffnen Sie eine Ansicht, und wählen Sie in der Symbolleiste "Exportieren" die Option
PDF:
2. Wählen Sie als Ausrichtung entweder Hochformat oder Querformat, und legen Sie
ein Papierformat fest:
3. Entscheiden Sie, ob die gesamte Arbeitsmappe, das ausgewählte Dashboard bzw. die
Story oder nur bestimmte Blätter gedruckt werden sollen. Wenn Sie auf die
hervorgehobene Miniaturansicht für ein Blatt klicken, wird dieses Blatt nicht exportiert:
- 45 -
4. Klicken Sie auf OK und dann im Dialogfeld "PDF exportieren" auf Herunterladen. Die
PDF-Datei wird daraufhin angezeigt und kann gedruckt werden:
- 46 -
Zoomen und Schwenken von Karten
Wenn Sie in einer Ansicht mit einer Karte mit dem Mauszeiger auf die Karte zeigen, wird eine
Symbolleiste zum Zoomen eingeblendet. Über die Symbolleiste können Sie die Karte
vergrößern und verkleinern, Markierungen auswählen, die Karte wieder in die Anfangsansicht
zurücksetzen und die Karte schwenken:
- 47 -
Wenn der Autor der Arbeitsmappe die Zoom-Steuerelemente ausgeblendet hat (in Tableau
Desktop: Ansicht > Zoom-Steuerelemente > Ausblenden), wird die Symbolleiste nicht
angezeigt.
Die Modi werden im Folgenden beschrieben:
Zoomen: Eine Kartenansicht vergrößern, um mehr Details zu sehen.In
Tableau Server werden Kartentitel u. U. beim Zoomen nicht sofort angezeigt, wenn der Modus für clientseitiges Rendern nicht aktiv ist.Weitere
Informationen finden Sie unter Grundlegendes zum clientseitigen Rendern.
Auswählen: Markierungen in einer Kartenansicht auswählen, um eine
Teilmenge der Daten auszumachen.
Start: Die ursprüngliche Kartenansicht wiederherstellen.
Schwenken: Klicken und halten Sie die Maustaste einige Sekunden
lang gedrückt. Bewegen Sie den Mauszeiger anschließend, um den Kartenausschnitt mit der Maus nach oben oder unten sowie nach rechts
oder links zu schwenken. Während des Schwenkvorgangs sieht das
Cursorsymbol wie eine geschlossene Hand und nicht wie der normale
Zeiger aus. Das Schwenken über eine Karte ist besonders praktisch,
wenn Sie sich einen vergrößerten Bereich der Karte ansehen und dann
andere interessante Bereiche überprüfen möchten.
Anhalten automatischer Aktualisierungen
Beim Interagieren mit der Ansicht auf dem Server muss der Server in einigen Fällen eine
Abfrage an die Datenquelle senden, um die Daten in der Ansicht zu aktualisieren. Wenn Sie
mit einer komplexen Ansicht mit vielen Daten oder einer sehr großen Datenquelle arbeiten,
- 48 -
kann die automatische Aktualisierung sehr lange dauern. Um beim Vornehmen mehrerer
Änderungen nicht auf jede einzelne Aktualisierung warten zu müssen, können Sie auf der
Symbolleiste auf Automatische Aktualisierungen anhalten klicken.
Wenn Sie die automatischen Aktualisierungen mit derselben Symbolleistenschaltfläche
(Automatische Aktualisierungen fortsetzen) fortsetzen, müssen Sie nur auf eine Abfrage
an die Datenquelle warten.
Aktualisieren von Daten
Wenn die Datenquelle geändert wird, indem z. B. neue Felder hinzugefügt oder Datenwerte
und Feldnamen modifiziert wurden, zeigt die Ansicht diese Änderungen nach dem nächsten
Laden der Seite an. Es kann jedoch erforderlich sein, die Ansicht mit der Schaltfläche Daten
aktualisieren auf der Symbolleiste manuell zu aktualisieren.
Beim Aktualisieren der Daten löschen Sie alle im Cache vorhandenen Daten und rufen die
aktuellen Daten aus der Datenquelle ab. Diese Option unterscheidet sich von der Option
Anhalten automatischer Aktualisierungen Auf der vorherigen Seite, bei der die Ansicht
möglicherweise noch basierend auf Daten im Cache geladen wird. Je nach Größe der
Datenquelle und der Ansicht kann das Aktualisieren der Daten länger als andere Abfragen
dauern, bei denen Daten im Cache verwendet werden.
Herunterladen von Arbeitsmappen
Sie können Arbeitsmappen über den Link Herunterladen oben rechts in der Ansicht
herunterladen. Die heruntergeladene Arbeitsmappe kann mit einer Version von Tableau
Desktop geöffnet werden. Das Herunterladen der Arbeitsmappe vom Server entspricht dem
Auswählen der Optionen Server > Arbeitsmappe öffnen in der Desktopanwendung. Das
Öffnen der Arbeitsmappe ist nur möglich, falls die Veröffentlichung dieser Arbeitsmappe auf
dem Server noch besteht.
- 49 -
Diese Option ist nur verfügbar, wenn Sie vom Autor der Arbeitsmappe oder von einem
Administrator die Berechtigung Herunterladen/Im Web speichern unter erhalten haben.
Weitere Informationen hierzu finden Sie unter Arbeiten mit Berechtigungen Auf Seite 89.
Verwenden von Hyperlinks
Viele Ansichten enthalten Hyperlinks zu externen URLs oder anderen Blättern. Diese
Hyperlinks werden vom Autor hinzugefügt und können nützlich sein, um Benutzern das
Zugreifen auf weitere Informationen zu einer Reihe von Datenpunkten zu ermöglichen. Je
nach Erstellung der Ansicht gibt es drei Möglichkeiten zum Nutzen von Hyperlinks:
l
Auswählen: Klicken Sie in der Ansicht auf eine Markierung.
l
Mit der Maus zeigen: Bewegen Sie den Mauszeiger in der Ansicht auf die Markierung.
l
Bildschirmtipp: Der Hyperlink ist im Bildschirmtipp enthalten, der angezeigt wird,
wenn Sie den Mauszeiger auf eine Auswahl von Markierungen bewegen.
Links zu Webseiten
Eine Ansicht kann einen Link zu einer externen Webseite mit weiteren Informationen zu den
Daten enthalten. Beispielsweise kann eine Kartenansicht für einen bestimmten Standort einen
Link zu einem Satellitenbild enthalten. Ebenso kann in einem Umsatzbericht für eine Auswahl
von Produkten per Link auf den aktuellen Bestand im Intranet des Unternehmens verwiesen
werden. Beim Klicken auf einen Link gelangen Sie zu der externen Webseite, also einer
Webseite außerhalb von Tableau Server. Webseiten können auch in ein Dashboard
- 50 -
eingebettet werden. In diesem Fall wird die Webseite beim Klicken auf einen Link im aktuellen
Fenster geladen.
Links zu anderen Ansichten
Außer Links zu externen Webseiten enthalten manche Ansichten auch Hyperlinks zu anderen
Ansichten in Tableau Server. Bei diesen Links werden Daten in der Zielansicht basierend auf
Ihrer Auswahl in der Quellansicht gefiltert. Im Dashboard unten führt das Auswählen eines
Produkts in der Liste "Top Selling Products" dazu, dass die Kartenansicht gefiltert und
angezeigt wird, wo das Produkt verkauft wird.
- 51 -
Hervorheben von Markierungen, Legenden & Aktionen
Mithilfe der Hervorhebung können Sie die Aufmerksamkeit in einer Ansicht auf einen
bestimmten Teil der Daten lenken. Es gibt in Tableau Server drei Möglichkeiten der
Hervorhebung: Markierungen, Legenden und Aktionen.
Verwenden von Markierungen zum Hervorheben
Wenn Sie in einer Ansicht eine oder mehrere Markierungen auswählen, werden alle anderen
Markierungen abgeblendet, um die Aufmerksamkeit auf die Auswahl zu lenken. Wählen Sie
einzelne Markierungen aus, oder klicken Sie, und ziehen Sie mit der Maus einen Rahmen um
mehrere Markierungen auf. Halten Sie die STRG-Taste auf der Tastatur gedrückt, um in der
Ansicht mehrere Markierungen auszuwählen.
Verwenden von Legenden zum Hervorheben
Sie können die Legenden (für Farbe, Form und Größe) verwenden, um die Markierungen
hervorzuheben, die den einzelnen Elementen in der Legende entsprechen. Falls eine Ansicht
z. B. nach Produktkategorie farbig markiert ist, können Sie einen bestimmten Produkttyp
schnell hervorheben, indem Sie die Hervorhebung über die Legende nutzen. So aktivieren Sie
die Farblegendenhervorhebung:
1. Klicken Sie auf die Schaltfläche Hervorheben, die oben rechts angezeigt wird, wenn Sie
den Mauszeiger auf die Legende bewegen.
2. Wählen Sie in der Legende ein Element aus:
- 52 -
3. Sie können die STRG-Taste auf der Tastatur gedrückt halten, um in der Legende mehrere Elemente auszuwählen. Deaktivieren Sie die Legendenhervorhebung, indem Sie
erneut auf die Schaltfläche zum Hervorheben klicken.
Hervorhebungsaktionen
Einige Ansichten können über Hervorhebungsaktionen verfügen, mit denen basierend auf
Ihrer Auswahl in einer Quellansicht verwandte Daten in einer oder mehreren Ansichten
hervorgehoben werden. Hervorhebungsaktionen werden vorwiegend in DashboardAnsichten verwendet, in denen mehrere Ansichten gleichzeitig zu sehen sind. In der
Dashboard-Ansicht unten wurde z. B. eine Hervorhebungsaktion zum Hervorheben nach der
Region eingerichtet. Bei Auswahl von "West" im Streudiagramm wird die Kategorie "West" in
allen anderen Ansichten hervorgehoben.
- 53 -
Je nach Erstellung der Ansicht können Hervorhebungsaktionen gestartet werden, indem Sie
entweder eine Markierung auswählen, den Mauszeiger auf eine Markierung bewegen oder
den Bildschirmtipp verwenden, der angezeigt wird, wenn Sie mit dem Mauszeiger auf einer
Markierung verweilen.
Tagansichten
Bei einem Tag handelt es sich um ein Schlüsselwort, das eine Ansicht beschreibt. Autoren
können Tags hinzufügen, wenn sie Ansichten veröffentlichen.Nachdem eine Ansicht auf
einem Tableau Server veröffentlicht wurde, können Sie allen Ansichten, auf die Sie Zugriff
haben, Tags hinzufügen, und Sie können von Ihnen hinzugefügte Tags löschen.In einer
veröffentlichten Ansicht befindet sich das Textfeld Tags unterhalb der Ansicht:
Hinzufügen von Tags
Sie können Tags zu einer beliebigen Ansicht auf dem Server hinzufügen, auf die Sie Zugriff
haben. Bei Tags wird nicht zwischen Groß- und Kleinschreibung unterschieden. Sie werden
nach der Eingabe sogar in Kleinbuchstaben umgewandelt.
So ordnen Sie einer Ansicht Tags zu:
Geben Sie unter einer Ansicht in das Textfeld Tags die gewünschten Wörter ein und klicken
Sie auf Zuordnen. Wörter können durch Leerzeichen oder Kommas voneinander abgetrennt
werden.
- 54 -
So ordnen Sie mehreren Ansichten Tags zu:
Wenn Sie über eine Interactor-Lizenz verfügen, können Sie auch mehreren Ansichten
gleichzeitig Tags zuordnen.
1. Öffnen Sie eine Liste von Ansichten oder Arbeitsmappen.
2. Wählen Sie die Elemente aus, denen Sie ein Tag hinzufügen möchten, und klicken Sie
oben auf der Seite auf Tag. Wenn noch keine Tags vorhanden sind, wählen Sie
Hinzufügen:
- 55 -
Wenn Tags bereits vorhanden sind, wählen Sie ein Tag aus:
Löschen von Tags
Alle Tags, die Sie erstellt haben, können Sie auch wieder löschen.
1. Öffnen Sie die Tag-Ansicht.
2. Blättern Sie bis zum Textfeld Tags unterhalb der Ansicht.
3. Klicken Sie neben dem zu löschenden Tag auf x.
Kommentieren von Ansichten
Sie können allen Ansichten Kommentare hinzufügen, auf die Sie in Tableau Server Zugriff
haben. Außerdem sehen Sie alle Kommentare, die einer Ansicht zugeordnet sind.
Geben Sie den Text unterhalb der Ansicht in das Textfeld Kommentar ein, und klicken Sie auf
Hinzufügen.
- 56 -
Sie können den Kommentartext auch formatieren, indem Sie Hyperlinks, Fettdruck,
Kursivdruck und Unterstreichung verwenden. Beispiele für die Verwendung dieser Arten von
Formatierung sind in der Tabelle unten angegeben.
Formatieren Eingabe
Hyperlink
"Mein Link":http://www.tableausoftware.com
Fett
*Text in Fettdruck*
Kursiv
_Text in Kursivdruck_
Unterstrichen +Unterstrichener Text+
Beispiel
Mein Link
Text in Fettdruck
Text in Kursivdruck
Unterstrichener
Text
Benutzerdefinierte Ansichten (Änderungen speichern)
Es kann vorkommen, dass Sie eine Ansicht verwenden, an der Sie nach jedem Öffnen die
gleichen Änderungen vornehmen. Beispielsweise wenden Sie einen bestimmten Filter an, um
nur für Sie relevante Daten einzubeziehen, oder Sie möchten eine veröffentlichte Ansicht
anders sortieren. Sie können auch verschiedene Versionen derselben Ansicht speichern, z. B.
eine mit zwei ausgewählten Filtern und eine andere mit einem ausgewählten Filter. Wenn Sie
über eine Interactor-Lizenz verfügen, können Sie Ihre Änderungen in Tableau als eine oder
mehrere benutzerdefinierte Ansichten speichern, anstatt diese Änderungen bei jedem Öffnen
der Ansicht durchzuführen. Sie können Ihre angepassten Ansichten auch für andere Benutzer
bereitstellen bzw. "ankündigen". Benutzer mit Interactor- oder Viewer-Lizenz können
Ansichten anzeigen lassen, die von anderen Benutzern angekündigt wurden.
Weitere Informationen finden Sie in den folgenden Themen:
Zugreifen auf "Änderungen speichern"
Mit der Einstellung Änderungen speichern wird der oben dargestellte Ansichtsbereich
angezeigt, wenn Sie eine veröffentlichte Ansicht erstmals aufrufen (oder der unten
dargestellte, wenn Sie eine eingebettete Ansicht aufrufen):
- 57 -
Falls es benutzerdefinierte Versionen einer Ansicht gibt, wird beim ersten Aufrufen der
Ansicht, so wie sie veröffentlicht wurde, Originalansicht angezeigt. Wenn Sie auf das
Dropdown-Menü klicken und eine der benutzerdefinierten Ansichten auswählen, wird der
Name dieser Ansicht angezeigt.
Speichern der benutzerdefinierten Ansicht
Wenn Sie eine Ansicht filtern, sortieren oder mit ihr interagieren, wird ein grauer Punkt neben
dem Menü Änderungen speichern oder neben dem Namen der Ansicht angezeigt. Der
Punkt gibt an, dass Änderungen vorgenommen wurden. Verwenden Sie dieses Menü, um Ihre
Änderungen als benutzerdefinierte Ansicht zu speichern.
- 58 -
Eine benutzerdefinierte Ansicht, die Sie oder andere Benutzer erstellen, ist immer mit der
Originalansicht verknüpft. Wenn die Originalansicht aktualisiert oder neu veröffentlicht wird,
werden benutzerdefinierte Versionen der Ansicht ebenfalls aktualisiert. Wenn die
Originalansicht vom Server gelöscht wird, werden die zugehörigen benutzerdefinierten
Ansichten ebenfalls gelöscht. Falls Filter aus der Originalansicht entfernt werden und diese
erneut veröffentlicht wird, sind die Filter in den benutzerdefinierten Versionen der Ansicht nicht
verfügbar. Werden die Filter wiederhergestellt und die Originalansicht neu veröffentlicht,
werden benutzerdefinierte Versionen der Ansicht ebenfalls wiederhergestellt.
Hier finden Sie weitere Details zum Speichern von benutzerdefinierten Ansichten:
1. Öffnen Sie eine einzelne Ansicht, die Sie anpassen möchten.
2. Filtern Sie die Daten, ändern Sie die Sortierreihenfolge, heben Sie etwas hervor,
vergrößern oder verkleinern Sie die Ansicht usw.
3. Klicken Sie auf die Verknüpfung Änderungen speichern oder auf den Namen der
benutzerdefinierten Ansicht. Geben Sie dann einen Namen für die benutzerdefinierte
- 59 -
Ansicht ein, und klicken Sie auf Speichern.
Um die benutzerdefinierte Ansicht standardmäßig beim Öffnen der Ansicht anzuzeigen,
klicken Sie auf Standard ändern in <benutzerdefinierter Ansichtsname>. Rechts neben
dem Namen der benutzerdefinierten Ansicht wird das Wort (Standard) angezeigt, um
anzugeben, dass dies die Standardversion der Ansicht ist.
Ankündigen der benutzerdefinierten Ansicht
Standardmäßig ist Ihre benutzerdefinierte Ansicht privat; nur Sie können sie in der Liste sehen.
Wenn Sie über eine Interactor-Lizenz verfügen, können Sie sie für andere Benutzer
- 60 -
ankündigen. Jeder, der Zugriff auf die veröffentlichte Originalansicht hat, kann die
angekündigte benutzerdefinierte Ansicht sehen.
Hinweis:
Selbst wenn Sie Ihre benutzerdefinierte Ansicht nicht ankündigen, können Sie sie trotzdem
gemeinsam nutzen, indem Sie die URL kopieren oder auf die Schaltfläche "Bereitstellen"
klicken.
1. Wenn Sie eine benutzerdefinierte Ansicht anzeigen, die Sie ankündigen möchten,
klicken Sie auf den Namen der Ansicht und anschließend auf Benutzerdefinierte
Ansichten verwalten.
2. Klicken Sie unter "Benutzerdefinierte Ansichten verwalten" auf das Symbol neben dem
Namen der Ansicht, um zwischen angekündigt und privat umzuschalten. Ein Symbol mit
einer Person gibt an, dass die Ansicht privat ist, und ein Symbol mit zwei Personen
gibt an, dass die Ansicht angekündigt ist.
- 61 -
3. Klicken Sie auf Fertig.
Zugreifen auf andere benutzerdefinierte Ansichten
Beim Durchsuchen von Ansichten können Sie auf benutzerdefinierte, von anderen Benutzern
gespeicherte und bekannt gemachte Ansichten zugreifen, indem Sie auf den Link
Originalansicht klicken. Wenn die Verknüpfung Originalansicht verfügbar ist, bedeutet das,
dass es benutzerdefinierte Versionen dieser Ansicht gibt. Benutzerdefinierte Ansichten
anderer Benutzer sind im Abschnitt "Andere benutzerdefinierte Ansichten" des DropdownMenüs aufgeführt.
- 62 -
Festlegen der Ansicht als privat
Sie können eine angekündigte Ansicht wieder als private Ansicht verwenden. Wenn eine
benutzerdefinierte Ansicht privat ist, wird sie nicht mehr in der Dropdown-Liste für andere
angezeigt; nur Sie können sie in der Liste sehen.
1. Wenn Sie eine benutzerdefinierte Ansicht anzeigen, deren Ankündigung Sie rückgängig
machen wollen, klicken Sie auf den Namen der Ansicht und anschließend auf
Benutzerdefinierte Ansichten verwalten.
- 63 -
2. Klicken Sie unter "Benutzerdefinierte Ansichten verwalten" auf das Symbol neben dem
Namen der Ansicht, um zwischen gemeinsam genutzt und privat umzuschalten. Ein
Symbol mit zwei Personen
Symbol mit einer Person
gibt an, dass die Ansicht angekündigt ist, und ein
gibt an, dass die Ansicht privat ist.
- 64 -
3. Klicken Sie auf Fertig.
Löschen einer benutzerdefinierten Ansicht
Sie können eine benutzerdefinierte Ansicht jederzeit löschen. Das Entfernen der
benutzerdefinierten Ansicht hat keinerlei Auswirkungen auf die Originalansicht.
1. Wenn Sie eine benutzerdefinierte Ansicht anzeigen, die Sie löschen möchten, klicken
Sie auf den Namen der Ansicht und anschließend auf Benutzerdefinierte Ansichten
verwalten.
2. Klicken Sie unter "Benutzerdefinierte Ansichten verwalten" auf das Symbol x rechts
neben dem Namen der benutzerdefinierten Ansicht.
- 65 -
3. Wenn Sie eine benutzerdefinierte Ansicht entfernt haben, können Sie auf Rückgängig
klicken, um die benutzerdefinierte Ansicht wiederherzustellen. Nachdem Sie auf "Fertig"
geklickt haben, ist die Rückgängig-Schaltfläche nicht mehr verfügbar.
4. Klicken Sie auf Fertig. Die benutzerdefinierte Ansicht wird entfernt.
- 66 -
Bearbeiten und Erstellen von Ansichten
Benutzer mit den entsprechenden Berechtigungen für die
Webdokumenterstellungsumgebung können vorhandene Arbeitsmappen bearbeiten oder
neue Arbeitsmappen erstellen.
Wenn Sie sich bei Tableau Server anmelden, wird standardmäßig der Abschnitt "Ansichten"
angezeigt. Ansichten, auf die Sie Zugriff haben, werden hier als Ergebnis der folgenden
Aktionen angezeigt:
l
l
Ein Tableau Desktop-Benutzer veröffentlicht die Arbeitsmappe mit der Ansicht unter
Tableau Server.
Ein Benutzer erstellt die Ansicht und speichert die Arbeitsmappe direkt in der Web-Bearbeitungsumgebung von Tableau Server.
Erstellen einer Arbeitsmappe und Erstellen einer Ansicht
Sie können eine neue Ansicht erstellen, indem Sie ein neues Arbeitsblatt in einer vorhandenen
Arbeitsmappe oder eine neue Arbeitsmappe erstellen. In diesem Thema wird beschrieben,
wie Sie eine Ansicht in einer neuen Arbeitsmappe erstellen.
Im folgenden Beispiel wird die im Lieferumfang von Tableau Desktop enthaltene
Beispieldatenquelle Superstore verwendet und in Tableau Server veröffentlicht, um eine
Ansicht zu erstellen, die Informationen zum Umsatz nach Kategorie und Region enthält. Wenn
Sie Zugriff auf die Beispieldatenquelle "Superstore" haben, können Sie die Schritte in der
Prozedur ausführen.
1. Wählen Sie auf der Registerkarte Inhalt die Option Datenquellen aus.
2. Aktivieren Sie in der Liste der Datenquellen das Kontrollkästchen neben der zu
visualisierenden Datenquelle, und klicken Sie dann auf Neue Arbeitsmappe.
- 67 -
In der Tableau Server-Entwicklungsumgebung wird eine neue, leere Ansicht geöffnet.
Hinweis: Die Option Neue Arbeitsmappe ist nicht verfügbar, wenn die
Datenquelle eine Cube-basierte Datenbank ist. Weitere Informationen dazu
finden Sie unter Mehrdimensionale (Cube-)Datenquellen Auf Seite 252.
3. Ziehen Sie Sales aus dem Bereich "Kennzahlen" auf den Spaltencontainer.
- 68 -
4. Erweitern Sie im Bereich "Dimensionen" den Eintrag Produkt, um dessen Unterkategorien anzuzeigen, und ziehen Sie dann Kategorie in den Zeilencontainer.
Tableau verfügt nun über ausreichend Informationen, um die Daten in eine
Visualisierung (Ansicht) zu konvertieren, in diesem Fall ein horizontales
Balkendiagramm.
5. Ziehen Sie Region aus dem Bereich "Dimensionen" auf den Zeilencontainer.
Die Ansicht enthält nun eine weitere Datenebene, die Kategorien sind nach Region
unterteilt.
- 69 -
Angenommen, Sie möchten Umsatzzahlen nach Kategorie in einer einzelnen Region
anzeigen und vergleichen. Dies können Sie mit einem Filter realisieren.
6. Ziehen Sie Region aus dem Bereich "Dimensionen" auf den Filtercontainer.
Wenn Sie mit der Maus auf den Filtercontainer zeigen, wird ein kleines Dreieck links
neben dem Feld angezeigt. Dieses weist darauf hin, dass Sie Region auf dem
Container ablegen können.
Am rechten Rand der Seite wird ein Steuerelement "Filter" angezeigt.
7. Deaktivieren Sie die Kontrollkästchen aller Regionen bis auf eine, die Sie analysieren
möchten, und aktivieren Sie anschließend alle wieder.
8. Durch die Verwendung von Farben können Sie das Erscheinungsbild Ihrer
Visualisierung verbessern. Ziehen Sie Region auf Farbe auf der Karte "Markierungen".
- 70 -
Sie verfügen nun über eine nützliche Ansicht, um den Umsatz für unterschiedliche
Produktkategorien in den einzelnen Regionen zu vergleichen:
Tipp: Informationen zum Auswählen einer anderen Farbpalette für die Balken
oder zum Ändern der Balkengröße finden Sie unter Karte "Markierungen" Auf
Seite 82.
9. Anstatt sich auf den regionalen Umsatz der einzelnen Produkte zu konzentrieren,
möchten Sie vielleicht eine Ansicht erstellen, in der Sie den Gesamtproduktumsatz einer
Region einfacher analysieren können. Ziehen Sie im Zeilencontainer Region links
neben Kategorie.
- 71 -
Die Ansicht wird aktualisiert und zeigt den Umsatz aller Produkte nach Region an.
10. Wenn Sie doch die vorherige Version der Ansicht bevorzugen, können Sie in der
Symbolleiste auf Rückgängig klicken.
11. Um ein zweites Arbeitsblatt zu erstellen, wählen Sie die Registerkarte Neues
Arbeitsblatt am unteren Rand der Ansicht aus.
Wählen Sie die Arbeitsblatt-Registerkarte aus, und wählen Sie dann Arbeitsblatt
umbenennen, um dem Arbeitsblatt einen aussagekräftigeren Namen zuzuweisen.
- 72 -
12. Klicken Sie auf Speichern, um die Arbeitsmappe zu speichern. Führen Sie im
Dialogfeld Arbeitsmappe speichern die folgenden Schritte aus:
l Geben Sie den Arbeitsmappennamen an, und ändern Sie die Einstellung Standard für Projekt nicht.
l Aktivieren Sie die Option Blätter als Registerkarten anzeigen, wenn Sie mehrere Blätter erstellt haben und ihre Registerkarten am unteren Rand der Ansicht
angezeigt werden sollen.
l Aktivieren Sie das Kontrollkästchen Anmeldeinformationen für Datenquelle
einbetten, wenn Sie sicherstellen möchten, dass Benutzer ohne Datenbankkonto die Ansicht anzeigen können.
l Klicken Sie abschließend auf Speichern.
Bearbeiten einer Ansicht
Im Abschnitt "Ansichten" können Sie mit einem der folgenden Verfahren eine Ansicht zur
Bearbeitung öffnen:
l
l
Klicken Sie in der QuickInfo, die angezeigt wird, wenn Sie mit der Maus auf eine
Miniaturansicht zeigen, auf Bearbeiten.
Wählen Sie eine Ansicht aus, um sie anzuzeigen, und klicken Sie dann oben in der
Ansicht auf Bearbeiten.
- 73 -
Wenn die Person, die die Arbeitsmappe veröffentlicht hat, keine
Datenbankanmeldeinformationen eingebettet hat, werden Sie aufgefordert, sie
anzugeben.
Speichern oder Verwerfen von Änderungen
Während Sie eine Ansicht bearbeiten, können Sie die vorgenommenen Änderungen jederzeit
mithilfe der Links über dem Ansichtsbereich speichern oder verwerfen.
Wenn Sie Ihre Arbeit speichern, wird die gesamte Arbeitsmappe mit allen anderen
bearbeiteten oder nicht bearbeiteten Ansichten gespeichert, selbst wenn Sie die
Dokumenterstellungsumgebung über eine einzelne Ansicht aufgerufen haben.
l
l
Bei Auswahl von Speichern wird die ursprüngliche Arbeitsmappe überschrieben.
Bei Auswahl von Speichern unter wird eine neue Arbeitsmappe im selben Projekt
erstellt.
Wenn Sie sowohl die ursprüngliche als auch Ihre bearbeitete Version behalten
möchten, wählen Sie Speichern unter, um eine neue Arbeitsmappe zu erstellen.
Wenn Sie Blätter als Registerkarten anzeigen auswählen, überschreiben die
Arbeitsmappenberechtigungen die Berechtigungen der einzelnen Ansichten in der
Arbeitsmappe, bis die Arbeitsmappe wieder ohne Registerkarten gespeichert wird.
l
l
Bei Auswahl von Wiederherstellen werden Änderungen verworfen, und die letzte
gespeicherte Version der Arbeitsmappe wird wiederhergestellt.
Bei Auswahl von Fertig wird die Dokumenterstellungsumgebung geschlossen.
- 74 -
Wenn Sie die Änderungen noch nicht gespeichert haben, werden Sie dazu
aufgefordert. Wenn Sie die Änderungen nicht speichern, werden diese, solange Sie bei
der aktuellen Serversitzung angemeldet sind, weiterhin angezeigt, wenn Sie zum
Dokumenterstellungsmodus zurückkehren.
Ihre Möglichkeiten zum Speichern von Arbeitsmappen hängen von den Berechtigungen ab,
die Ihnen Ihr Administrator gewährt hat. Weitere Informationen finden Sie unter Gewähren
von Berechtigungen zum Bearbeiten und Speichern Auf Seite 102.
Die Dokumenterstellungsumgebung in Tableau Server
Die Webdokumenterstellungsumgebung ähnelt Tableau Desktop. Das Datenfenster wird auf
der linken Seite angezeigt und enthält die Namen der in der Arbeitsmappe enthaltenen
Datenquellen sowie die Felder, Parameter und Sätze der aktiven Datenquelle.
Entsprechend wird oben im Hauptbereich eine Symbolleiste angezeigt; die Karte
Markierungen sowie die Container Seiten und Filter werden links neben der Ansicht und die
Container Spalten und Zeilen über der Ansicht angezeigt. Alle in der Arbeitsmappe
enthaltenen Blattregisterkarten werden am unteren Rand der Ansicht angezeigt.
- 75 -
Wenn Sie eine Ansicht zur Bearbeitung öffnen, können Sie die anderen Ansichten in
derselben Arbeitsmappe ebenfalls bearbeiten, nicht jedoch die Dashboards und Storys. Sie
können auch die Registerkarte Neues Blatt wählen, um mit der Erstellung einer neuen
Ansicht zu beginnen:
Symbolleiste
Beim Bearbeiten einer Ansicht können Sie mit den Optionen in der Symbolleiste am oberen
Rand der Ansicht gängige Aktionen ausführen.
Rückgängig/Wiederholen
Machen Sie ein Aktion oder eine Reihe von Aktionen rückgängig, oder wiederholen Sie sie. Mit
diesen Symbolleisten-Schaltflächen können Sie nahezu jede Art von Änderung in der Ansicht
rückgängig machen oder wiederholen.
Updates aussetzen
Wenn Sie ein Feld in einem Container platzieren, generiert Tableau die Ansicht, indem die
Datenquelle abgefragt wird. Wenn eine Ansicht bei der Bearbeitung nur langsam aktualisiert
wird, können Sie die Updates während einer Reihe von Bearbeitungen aussetzen und danach
wieder einschalten.
- 76 -
Tauschen
Hiermit werden die Felder aus dem Zeilencontainer in den Spaltencontainer oder umgekehrt
verschoben. Wird am häufigsten mit Ansichtstypen verwendet, die auf x- und y-Achsen
basieren.
Summen
Sie können für die Daten in einer Ansicht automatisch Gesamtsummen und Zwischensummen
berechnen. Wählen Sie "Summen" aus, um vier Optionen anzuzeigen:
l
l
l
l
Spaltensummen anzeigen: Fügt eine Zeile hinzu, in der die Summe aller Spalten in
der Ansicht anzeigt werden.
Zeilensummen anzeigen: Fügt eine Spalte hinzu, in der die Summe aller Zeilen in der
Ansicht anzeigt werden.
Alle Zwischensummen hinzufügen: Fügt Zeilen und Spalten mit Zwischensummen
in die Ansicht ein, wenn eine Spalte oder Zeile mehrere Dimensionen aufweist.
Alle Zwischensummen entfernen Entfernt alle Zeilen bzw. Spalten, die Zwischensummen enthalten.
Beschriftungen anzeigen/Beschriftungen ausblenden
Wählen Sie diese Optionen, um Markierungsbeschriftungen in der Ansicht ein- oder
ausblenden.
Zellengröße
Verwenden Sie die Optionen unter Zellengröße, um die Proportionen der Ansicht innerhalb
des Browserfensters zu ändern und zwischen der Anzeige von Details und des Gesamtbilds
umzuschalten. Die Befehle unter "Zellengröße" haben je nach Visualisierungstyp
unterschiedliche Auswirkungen.
Arbeitsblatt
Enthält Optionen zum Vornehmen von Änderungen auf Arbeitsblattebene. Sie können
Arbeitsblätter erstellen, Blattnamen ändern, die Blattformatierung löschen oder das gesamte
Blatt löschen.
Exportieren
Verwenden Sie die Optionen unter "Exportieren", um Teile der Ansicht für die Verwendung in
anderen Anwendungen zu erfassen.
l
l
l
Bild: Zeigt die Ansicht, das Dashboard oder die Story als Bild in einer neuen Browserregisterkarte an.
Daten: Zeigt die Daten aus der Ansicht in einem neuen Browserfenster mit zwei Registerkarten an. Zusammenfassung zeigt aggregierte Daten für die in der Ansicht gezeigten Felder und Zugrunde liegend zeigt die zugrunde liegenden Daten für die in der
Visualisierung ausgewählten Markierungen. Wenn sich kein neues Fenster öffnet, müssen Sie möglicherweise den Popupblocker Ihres Browsers deaktivieren.
Kreuztabelle: Speichert die Daten, die den ausgewählten Markierungen zugrunde liegen, in einer CSV (Comma-separated Values)-Datei, die dann in Microsoft Excel geöffnet werden kann.
- 77 -
l
PDF: Öffnet die aktuelle Ansicht als PDF in einem neuen Browserfenster. Dort können
Sie diese in einer Datei speichern. Wenn sich kein neues Fenster öffnet, müssen Sie
möglicherweise den Popupblocker Ihres Browsers deaktivieren.
Zeig es mir!
Öffnet ein Steuerelement, in dem eine Reihe von Visualisierungstypen angezeigt wird, die in
Tableau verwendet werden können. Wenn Sie die Liste "Zeig es mir!" anzeigen, verwendet
Tableau die Daten in der aktuellen Ansicht, um festzulegen, welche Visualisierungstypen für
Sie zur Auswahl stehen. Unter allen verfügbaren Typen wird die Ansicht, die am besten für
Ihre Daten geeignet ist, mit einer andersfarbigen Umrahmung angezeigt.
Sie können auch mit der Maus auf einen Visualisierungstyp zeigen, um zu sehen, welche
Feldtypen erforderlich sind, um diesen Visualisierungstyp verfügbar zu machen.
Datenfenster
Oben im Datenfenster wird eine Liste aller verfügbaren Datenquellen für die Arbeitsmappe
aufgeführt. Wenn Sie eine bestehende Arbeitsmappe bearbeiten, kann es verschiedene
Datenquellen geben: Wählen Sie eine Datenquelle aus, um die Dimensionen und Kennzahlen
für diese Datenquelle anzuzeigen. Bei Erstellung einer neuen Arbeitsmappe wird nur die
Datenquelle angezeigt, auf deren Grundlage Sie die Arbeitsmappe erstellt haben.
Alle Datenquellen enthalten Felder. Diese Felder werden im Datenfenster unter der Liste von
Datenquellen angezeigt. Dimensionen und Kennzahlen werden immer angezeigt, andere
Feldtypen nur dann, wenn sie auch in der Datenquelle vorhanden sind.
l
l
l
l
Dimensionen sind Felder, die diskrete qualitative Daten enthalten. Beispiele für
Dimensionen sind Datumsangaben, Kundennamen und Kundensegmente.
Kennzahlen sind Felder, die numerische Daten enthalten, die aggregiert werden
können. Beispiele für Kennzahlen sind Umsatz, Gewinn, Anzahl der Angestellten,
Temperatur, Frequenz und Druck.
Sätze sind benutzerdefinierte Felder, die eine Teilmenge von Daten basierend auf
bestimmten Bedingungen definieren. Ein Satz kann auf einer berechneten Bedingung
basieren, die bei Änderung der Daten aktualisiert wird, oder auf einer konstanten Liste
von Werten. Sätze können in Arbeitsmappen, die Sie bearbeiten, vorkommen. Sie
können jedoch keine Sätze erstellen.
Parameter sind dynamische Werte, die in Berechnungen, Filtern und Referenzlinien
konstante Werte ersetzen können. Parameter können in Arbeitsmappen, die Sie
bearbeiten, vorkommen. Sie können jedoch keine Parameter erstellen.
Zur Erstellung von Visualisierungen verschieben Sie Felder aus dem Datenfenster in die
Zeilen- und Spaltencontainer, die Markierungskarte oder einen anderen verfügbaren
Container. Ein Beispiel finden Sie unter Erstellen einer Arbeitsmappe und Erstellen einer
Ansicht Auf Seite 67.
- 78 -
Container "Spalten" und "Zeilen"
Ziehen Sie Felder in den Container "Spalten", um die Spalten für eine Tabelle zu erstellen,
oder in den Container "Zeilen", um die Zeilen für eine Tabelle zu erstellen. Sie haben die
Möglichkeit, mehrere Felder in beide Container zu verschieben.
Diskrete Werte (i. d. R. Dimensionen) werden in den Spalten- und Zeilencontainern in blauer
Farbe angezeigt; fortlaufender Werte (i. d. R. Kennzahlen) werden in grüner Farbe angezeigt.
Am rechten Ende jedes Feldes, das Sie im Spalten- oder Zeilencontainer ablegen, befindet
sich ein Dropdown-Menü, das Sie für die Konfiguration der Dimension oder der Kennzahl
verwenden können:
Die verfügbaren Optionen hängen vom Feldtyp ab. Die vollständige Liste der Optionen
umfasst Folgendes:
l
In QuickInfo einbinden
Standardmäßig werden alle Felder im Spalten- und Zeilencontainer in den QuickInfos
behandelt, die angezeigt werden, wenn Sie mit der Maus über eine oder mehrere
Markierungen in der Ansicht fahren. Deaktivieren Sie diese Option, wenn Sie ein Feld
aus den QuickInfos entfernen möchten.
l
Filter anzeigen
Wählen Sie diese Option aus, um für dieses Feld einen Filter zur Ansicht hinzuzufügen.
Benutzer können dann festlegen, welche Daten für diese Dimension oder Kennzahl einund ausgeschlossen werden sollen.
l
Diskret/fortlaufend
Verwenden Sie diese Option, um eine fortlaufende Reihe von Werten in einen diskreten
Satz von Werten oder einen diskreten Satz in eine fortlaufende Reihe umzuwandeln.
- 79 -
l
Dimension/Attribut/Kennzahl
Verwenden Sie diese Optionen, um eine Dimension in eine Kennzahl oder eine
Kennzahl in eine Dimension umzuwandeln.
Sie können diese Option auch als Attribut definieren, wodurch der Wert des jeweiligen
Ausdrucks zurückgegeben wird, falls dieser nur über einen Wert für alle Zeilen der
Gruppe verfügt. Andernfalls wird ein Sternchen (*) angezeigt. Null-Werte werden
ignoriert.
l
Schnelle Tabellenberechnung
Bietet eine Reihe von Optionen für die Neudefinierung der Bedeutung von
Markierungen für den Wert.
l
Entfernen
Entfernt den Wert aus dem Spalten- oder Zeilencontainer.
Optionen für die Datumsdimension
Für Datumsdimensionen ist ein zusätzlicher Satz von Optionen verfügbar.
Wählen Sie eine der Optionen aus der oberen Gruppe, um die Granularität der Daten als
diskrete Werte zu bestimmen. Wenn Sie beispielsweise Monat auswählen, werden in Ihrer
Ansicht die Daten für jeden benannten Monat über alle Jahre hinweg dargestellt:
- 80 -
Es gibt genau 12 Markierungen in den Daten – eine für jeden Monat. Die
Novembermarkierung kombiniert die Daten aus November 2008, November 2009 usw.
Wählen Sie eine der Optionen aus der unteren Gruppe, um die Granularität der Daten als
fortlaufende Werte zu bestimmen. Wenn Sie beispielsweise "Monat" auswählen, werden in
Ihrer Ansicht die Daten sequenziell, d. h. über den Zeitraum der verfügbaren Monate hinweg
dargestellt:
In diesem Fall gibt es 48 Markierungen in den Daten – eine für jeden Monat seit November
2008.
- 81 -
Karte "Markierungen"
Wenn Sie Felder in die Ansicht ziehen, werden die Daten mit Markierungen angezeigt. Jede
Markierung stellt eine Schnittmenge aller Dimensionen in der Ansicht dar. Beispielsweise
enthält eine Ansicht mit den Dimensionen "Region" und "Year" Markierungen für jede
Kombination dieser beiden Felder (East 2011, East 2012, West 2011, West 2012 usw.).
Markierungen können auf viele verschiedene Arten angezeigt werden, wie Linien, Formen,
Balken, Karten usw. Mithilfe von Markierungseigenschaften, z. B. Farbe, Größe, Form,
Beschriftungen usw., können weitere Informationen zu Daten dargestellt werden. Die
verwendete Art der Markierung und die Markierungseigenschaften werden über die Karte
"Markierungen" gesteuert. Ziehen Sie Felder auf die Karte "Markierungen", um weitere Daten
anzuzeigen. Beispielsweise wird die oben dargestellte Ansicht unten noch einmal dargestellt,
wobei sich hier jedoch Profit auf "Farbe" befindet. Diese zusätzlichen Informationen
verdeutlichen, dass die Region "Southern" im Jahr 2010 profitabel war.
Steuern Sie über die Karte "Markierungen" die Markierungen in der Ansicht. Verwenden Sie
das Dropdown-Menü, um die Art der anzuzeigenden Markierung festzulegen. Ziehen Sie
Felder auf die Karte "Markierungen", und verwenden Sie die Dropdown-Steuerelemente, um
der Ansicht weitere Informationen hinzuzufügen und Farbe, Form, Größe, Beschriftungen und
Anzahl der Markierung in der Ansicht zu steuern.
- 82 -
Markierungstypen
Die Markierungstypen werden im Dropdown-Menü auf der Karte "Markierungen" ausgewählt.
Markierungseigenschaften
Sie können die Farben, die Größe, die Form und andere Eigenschaften der Markierungen in
der Ansicht steuern. Ziehen Sie ein Feld auf eine Eigenschaft auf der Karte "Markierungen",
um die Markierungen mit Ihren Daten zu codieren.
Je nach Markierungstyp stehen unterschiedliche Eigenschaften zur Verfügung. Beispielsweise
ist die Eigenschaft "Form" nur für den Markierungstyp "Form" verfügbar und die Eigenschaft
"Winkel" nur für den Markierungstyp "Kreisdiagramm".
Verfügbare Eigenschaften sind:
Eigenschaft
Farbe
Beschreibung
Codiert die Daten, indem den Markierungen in der Datenansicht
basierend auf den Werten eines Feldes verschiedene Farben
- 83 -
zugewiesen werden.
Quantitative Farbpaletten werden auf fortlaufende Felder wie z. B.
eine Profitkennzahl angewendet. Kategorie-Paletten werden auf
diskrete Felder angewendet, z. B. ein Feld, das geografische
Regionen darstellt.
Ändern Sie die Farbpalette oder die Transparenz, indem Sie "Farbe"
wählen und dann das Palettensteuerelement und den Schieberegler
verwenden.
Größe
Unterteilt die Markierungen basierend auf den Elementen in einer
Dimension und weist jedem Element eine eindeutige Größe zu. Da
Größen über eine systematische Reihenfolge verfügen (von klein zu
groß), sind Kategoriegrößen für geordnete Daten, z. B. Jahr oder
Quartal, optimal geeignet.
Um die Gesamtgröße von Markierungen in der Ansicht zu ändern,
wählen Sie "Größe" aus, und ziehen Sie den Schieberegler.
- 84 -
Beschriftung/Text
Kodiert die Daten, indem den Markierungen Textbeschriftungen
zugewiesen werden. Bei einer Texttabelle heißt diese Eigenschaft
"Text". Sie zeigt die einer Datenansicht zugeordneten Zahlen an.
Um die Beschriftungen auf den Markierungen anzuzeigen oder
auszublenden, wählen Sie "Beschriftung" aus, und aktivieren oder
deaktivieren Sie das Kontrollkästchen.
Detail
QuickInfo
Pfad
Form
Wenn Sie eine Dimension im Container "Zeilen" oder "Spalten"
platzieren, erstellen die Kategorieelemente entsprechende
Tabellenkopfzeilen. Die Kopfzeilen repräsentieren die
Detailgenauigkeit, da sie die Einträge der Datenquelle in bestimmte
Kategorien unterteilen. Sie können die einzelnen Kategorien anhand
des Elementnamens identifizieren.
Über die Eigenschaft "Detail" können Sie die Markierungen in einer
Datenansicht nach den Elementen (der Detailgenauigkeit) einer
Dimension trennen. Im Gegensatz zur Verwendung der Container
"Zeilen" und "Spalten" wird bei Verwendung dieser Eigenschaft die
Tabellenstruktur nicht verändert.
Fügt der QuickInfo für jede Markierung den Feldnamen und den Feldwert hinzu.
Ermöglicht das Codieren von Daten, indem Markierungen über eine
bestimmte Zeichnungsreihenfolge miteinander verbunden werden.
Die Pfadcodierung Ihrer Daten kann entweder über eine Dimension
oder über eine Kennzahl erfolgen. Wenn Sie eine Dimension in
"Pfad" platzieren, verbindet Tableau die Markierungen basierend auf
den Elementen in der Dimension. Wenn es sich bei der Dimension
um ein Datum handelt, wird die Zeichnungsreihenfolge von der
chronologischen Reihenfolge abgeleitet. Wenn die Dimension
Begriffe enthält, beispielsweise Kundennamen oder Produkttypen,
wird die Zeichnungsreihenfolge von der Sortierreihenfolge der
Elemente in der Datenquelle abgeleitet. Wenn Sie eine Kennzahl in
"Pfad" platzieren, verbindet Tableau die Markierungen basierend auf
den Werten der Kennzahl.
Die Eigenschaft "Pfad" ist nur verfügbar, wenn Sie im Menü
"Markierungen" den Markierungstyp "Linie" oder "Polygon"
auswählen.
Unterteilt die Markierungen basierend auf den Elementen in der
Dimension und weist jedem Element eine eindeutige Form zu.
- 85 -
Filtercontainer
Verwenden Sie den Filtercontainer, um festzulegen, welche Daten für eine Dimension oder
Kennzahl ein- und ausgeschlossen werden sollen. So können Sie beispielsweise festlegen,
dass der Gewinn für jedes Kundensegment analysiert werden soll, jedoch nur für bestimmte
Versandverpackungen und Lieferzeiten. Indem Sie die Containerdimension im Filtercontainer
platzieren, können Sie festlegen, welche Container eingeschlossen werden sollen. Genauso
können Sie das Feld "Lieferdatum" im Filtercontainer platzieren, um festzulegen, welche
Lieferzeiten eingeschlossen werden sollen.
Wenn Sie eine Dimension oder Kennzahl in den Filtercontainer ziehen, fügt Tableau
automatisch eine Filtersteuerung in die Ansicht ein, mit der die Anzeigewerte ausgewählt
werden können. Beispiel:
Für Dimensionen zeigt die Filtersteuerung diskrete Werte an (siehe oben). Für Kennzahlen
zeigt die Filtersteuerung einen fortlaufenden Bereich an:
Zeigen Sie mit der Maus rechts über den Titel der Filtersteuerung, um festzulegen, wie Werte
in der Steuerung angezeigt werden sollen:
- 86 -
Seitencontainer
Ziehen Sie eine Dimension oder Kennzahl in den Seitencontainer, um eine Ansicht in mehrere
Seiten aufteilen. Dadurch können Sie besser ermitteln, welche Auswirkungen ein bestimmtes
Feld auf die restlichen Daten in einer Ansicht hat. Wenn Sie eine Dimension im Container
"Seiten" platzieren, fügen Sie im Grunde eine neue Zeile für jedes Element der Dimension
hinzu. Wenn Sie eine Kennzahl im Container "Seiten" platzieren, wird die Kennzahl in eine
diskrete Kennzahl umgewandelt, die auf verschiedene Seiten verteilt sein können.
Wenn Sie eine Dimension oder Kennzahl in den Seitencontainer ziehen, fügt Tableau
automatisch eine Steuerung in die Ansicht ein, mit der Sie zwischen den Seiten der Ansicht
navigieren können. Beispiel:
Sie können mit folgenden möglichen Schritten manuell durch die Reihe von Seiten blättern:
l
l
l
Verwenden Sie das zweite Dropdown-Menü, um einen Wert auszuwählen.
Klicken Sie auf die Pfeilschaltflächen, die sich auf beiden Seiten neben der DropdownListe befinden, um durch die einzelnen Seiten zu blättern.
Verwenden Sie den Schieberegler, um in der Reihe von Seiten schnell vor- und zurückzublättern.
Wählen Sie Verlauf anzeigen, um neben den Markierungen aktueller Seiten auch
Markierungen von vorherigen Seiten anzuzeigen.
QuickInfo
Platzieren Sie den Cursor auf einer Markierung in der Ansicht, um die QuickInfo für diese
Markierung anzuzeigen.
QuickInfos bieten Informationen über die Dimensions- und Kennzahlenwerte der
ausgewählten Markierung:
QuickInfos bieten außerdem folgende Optionen:
l
Nur beibehalten
Schließt alle Markierungen der Ansicht bis auf diese aus.
l
Ausschließen
- 87 -
Schließt nur diese Markierung aus.
l
Elemente gruppieren
Klicken Sie auf das Büroklammersymbol, um eine neue Gruppe, d. h. eine Dimension,
aus der ausgewählten Markierung zu erstellen. In der Regel wählen Sie mehrere
Markierungen aus und erstellen dann eine Gruppe. Wenn Sie beispielsweise
Regionsdimensionen mit den Werten Norden, Süden, Osten und Westen haben,
können Sie z. B. Süden und Westen auswählen und eine Gruppe daraus erstellen.
l
Daten anzeigen
Klicken Sie auf das Tabellensymbol, um ein neues Browserfenster mit zwei
Registerkarten zu öffnen: Zusammenfassung zeigt nur Daten der aktuellen
Markierung und Zugrunde liegend zeigt Daten der gesamten Ansicht an.
- 88 -
Arbeiten mit Berechtigungen
Die möglichen Aktionen für Ansichten, Arbeitsmappen, Projekte und Datenquellen in Tableau
Server hängen sowohl von Ihrer Lizenzstufe (von einem Administrator festgelegt) als auch von
den Berechtigungen ab, die der Autor der Ansicht oder Datenquelle festgelegt hat.
Sie können die Berechtigungen für ein Objekt ändern, wenn Sie über die Lizenzstufe
"Interakteur" verfügen und mindestens eine der folgenden Bedingungen erfüllt ist:
l
Sie sind der Besitzer der Arbeitsmappe oder Datenquelle (Sie haben sie auf dem Server
veröffentlicht).
l
Sie verfügen über die Berechtigung "Berechtigungen festlegen".
l
Sie verfügen über die Berechtigung "Projektleiter" für das Projekt mit dem Objekt.
l
Sie verfügen über das Admin-Recht.
Weitere Informationen finden Sie in den folgenden Themen:
Festlegen von Berechtigungen
Das Diagramm unten veranschaulicht, wie Berechtigungen bewertet werden.
- 89 -
Wenn eine Arbeitsmappe so konfiguriert wurde, dass alle Blätter als Registerkarte
angezeigt werden, dann erben alle Ansichten selbst dann die
Arbeitsmappenberechtigungen, wenn für eine einzelne Ansicht andere Berechtigungen
festgelegt worden sind.
Festlegen von Berechtigungen für Arbeitsmappen und Ansichten
Führen Sie die Schritte unten aus, um Berechtigungen für eine Arbeitsmappe oder eine
Ansicht festzulegen.
1. Markieren Sie auf einer Seite, auf der ein oder mehrere Arbeitsmappen bzw. Ansichten
angezeigt werden, ein oder mehrere Arbeitsmappen oder Ansichten, und klicken Sie
anschließend auf Berechtigungen:
- 90 -
2. Klicken Sie auf Berechtigungen hinzufügen/bearbeiten auf der Seite
"Berechtigungen: Arbeitsmappe oder Berechtigungen: Ansicht":
Die Option Berechtigungen für Inhalt zuweisen wird für die Arbeitsmappen
aber nicht für die Ansichten angezeigt.
3. Wählen Sie im Fenster "Berechtigungen hinzufügen/bearbeiten" einen Benutzer bzw.
eine Gruppe aus der Liste auf der linken Seite aus:
- 91 -
Sie können die Liste so konfigurieren, dass Benutzer, Gruppen oder beide angezeigt
werden.
4. Wählen Sie im Dropdown-Menü Rolle eine vordefinierte Rolle aus, oder geben Sie
einzelne Berechtigungen in den unteren Bereich ein. Je nachdem, ob Sie
Berechtigungen für eine Arbeitsmappe oder eine Ansicht einrichten, können die
anzeigte Liste der Berechtigungen und die vordefinierten Rollen unterschiedlich sein.
Unter Berechtigungsreferenz Auf Seite 98 finden Sie eine Tabelle, in der die
verschiedenen Berechtigungen definiert sind und für welche Einträge sie gelten.
Folgende Rollen sind für Arbeitsmappen und Ansichten verfügbar:
Rolle
Viewer
Interactor
Editor
Gilt für...
Beschreibung
Arbeitsmappen Der Benutzer oder die Gruppe kann die Arbeitsmappe oder die Ansicht auf dem Server anzeiAnsichten
gen.
Arbeitsmappen Der Benutzer oder die Gruppe kann die
Arbeitsmappe oder die Ansicht auf dem Server
Ansichten
anzeigen, Arbeitsmappenansichten
bearbeiten, Filter anwenden, die zugrunde
liegenden Daten anzeigen sowie Bilder und
exportieren. Alle anderen Berechtigungen
werden von den Projektberechtigungen des
Benutzers oder der Gruppe geerbt.
Arbeitsmappen Der Benutzer oder die Gruppe erhält alle
Berchtigungen
- 92 -
DatenquellenConnector
Ansichten
Ansichten
Datenquellen-Editor Ansichten
Ermöglicht es dem Benutzer oder einer
Gruppe, eine Verbindung mit der Datenquelle
auf dem Server herzustellen. Diese Berechtigung ist für Ansichten relevant, wenn auf eine
Ansicht zugegriffen wird, die eine Verbindung
zu einer Datenquelle herstellt.
Ermöglicht es dem Benutzer oder einer
Gruppe, eine Verbindung mit den Datenquellen auf dem Server herzustellen. Außerdem können Berechtigungen für eine
Datenquelle veröffentlich, bearbeitet, heruntergeladen, gelöscht und eingerichtet sowie
Zeitpläne für die Aktualisierung der von Ihnen
veröffentlichten Datenquellen festgelegt werden. Diese Berechtigung ist für Ansichten relevant, wenn auf eine Ansicht zugegriffen wird,
die eine Verbindung zu einer Datenquelle herstellt.
5. Sie können Berechtigungen für einen Benutzer oder eine Gruppe sowie für mehrere
Benutzer und Gruppen konfigurieren. Klicken Sie abschließend auf Absenden.
Festlegen von Berechtigungen für eine Datenquelle
Führen Sie die folgenden Schritte aus, um Berechtigungen für eine Datenquelle festzulegen.
1. Markieren Sie auf der Seite "Datenquellen" eine oder mehrere Datenquellen, und
klicken Sie dann auf Berechtigungen.
2. Klicken Sie auf Berechtigungen hinzufügen/bearbeiten auf der Seite
"Berechtigungen: Datenquelle":
- 93 -
3. Wählen Sie im Fenster "Berechtigungen hinzufügen/bearbeiten" einen Benutzer bzw.
eine Gruppe aus der Liste auf der linken Seite aus:
4. Wählen Sie im Dropdown-Menü Rolle eine vordefinierte Rolle aus, oder geben Sie
einzelne Berechtigungen in den unteren Bereich ein. Unter Berechtigungsreferenz
Auf Seite 98 finden Sie eine Tabelle, in der die verschiedenen Berechtigungen definiert
sind und für welche Einträge sie gelten.
Die verfügbaren Rollen für Datenquellen sind:
Rolle
DatenquellenConnector
Datenquellen-Editor
Beschreibung
Der Benutzer oder die Gruppe kann eine Verbindung mit der
Datenquelle auf dem Server herstellen.
Der Benutzer oder die Gruppe kann eine Verbindung mit den
Datenquellen auf dem Server herstellen. Außerdem können
Berechtigungen für eine Datenquelle veröffentlich, bearbeitet,
heruntergeladen, gelöscht und eingerichtet sowie Zeitpläne für
die Aktualisierung der von Ihnen veröffentlichten Datenquellen
- 94 -
festgelegt werden.
Hinweis: Cube-Datenquellen wie jene für Microsoft Analysis Services- oder
Oracle Essbase-Verbindungen müssen lokal verwendet werden. Um die
veröffentlichte Datenquelle auf Tableau Desktop herunterzuladen, benötigen Sie
Berechtigungen für den Download/zum Speichern unter aus dem Web. Sie
müssen die Berechtigungen Herunterladen/Im Web speichern unter explizit
gewähren, da die Rolle "Datenquellen-Connector" diese nicht bereitstellt. Weitere
Informationen dazu finden Sie unter Mehrdimensionale (Cube-)Datenquellen
Auf Seite 252.
5. Sie können Berechtigungen für einen Benutzer oder eine Gruppe sowie für mehrere
Benutzer und Gruppen konfigurieren. Klicken Sie abschließend auf Absenden.
Festlegen von Berechtigungen für ein Projekt
Administratoren und Projektleiter können Projektberechtigungen festlegen. Wenn Sie ein
neues Projekt erstellen, erhält es die gleichen Berechtigungen wie das Projekt Standard. Sie
können Berechtigungen für das Projekt festlegen, um einzelnen Benutzern oder Gruppen
Zugriff auf das Projekt zu gewähren oder zu verweigern. So legen Sie Projektberechtigungen
fest:
1. Klicken Sie auf Admin > Projekte.
2. Markieren Sie ein oder mehrere Projekte, und klicken Sie dann auf Berechtigungen:
3. Klicken Sie auf Berechtigungen hinzufügen/bearbeiten auf der Seite
"Berechtigungen: Projekt":
- 95 -
4. Wählen Sie im Fenster "Berechtigungen hinzufügen/bearbeiten" einen Benutzer bzw.
eine Gruppe aus der Liste auf der linken Seite aus:
Sie können die Liste so konfigurieren, dass Benutzer, Gruppen oder beide angezeigt
werden.
5. Wählen Sie im Dropdown-Menü Rolle eine vordefinierte Rolle aus, oder geben Sie
- 96 -
einzelne Berechtigungen in den unteren Bereich ein. Unter Berechtigungsreferenz
Auf der nächsten Seite finden Sie eine Tabelle, in der die verschiedenen
Berechtigungen definiert sind und für welche Einträge sie gelten.
Folgende Rollen sind für Projekte verfügbar:
Rolle
Viewer
Interactor
Editor
DatenquellenConnector
Datenquellen-Editor
Projektleiter
Publisher
Beschreibung
Der Benutzer oder die Gruppe kann die Arbeitsmappen und
Ansichten im Projekt anzeigen.
Der Benutzer oder die Gruppe kann die Arbeitsmappen und
Ansichten im Projekt anzeigen, Arbeitsmappenansichten
bearbeiten, Filter anwenden, die zugrunde liegenden Daten
anzeigen sowie Bilder und exportieren.
Der Benutzer oder die Gruppe erhält alle Berechtigungen
Der Benutzer oder die Gruppe kann eine Verbindung mit den
Datenquellen im Projekt herstellen.
Der Benutzer oder die Gruppe kann eine Verbindung mit den
Datenquellen im Projekt herstellen. Außerdem können Berechtigungen für eine Datenquelle veröffentlich, bearbeitet, heruntergeladen, gelöscht und eingerichtet sowie Zeitpläne für die
Aktualisierung der von Ihnen veröffentlichten Datenquellen festgelegt werden. Diese Berechtigung ist für Ansichten relevant,
wenn auf eine Ansicht zugegriffen wird, die eine Verbindung zu
einer Datenquelle herstellt.
Der Benutzer oder die Gruppe kann Berechtigungen für alle
Objekte in einem Projekt festlegen.
Dem Benutzer oder der Gruppe werden alle erforderlichen
Berechtigungen erteilt, um Arbeitsmappen auf dem Server zu
veröffentlichen.
Die angegebenen Berechtigungen gelten für das Projekt an sich. Alle Berechtigungen, die
explizit für Arbeitsmappen, Ansichten und Datenquellen im Projekt festgelegt wurden, sind
davon nicht betroffen. Sie haben allerdings die Möglichkeit, die Projektberechtigungen allen im
Projekt enthaltenen Arbeitsmappen, Ansichten und Datenquellen zuzuweisen. In diesem Fall
überschreiben diese Berechtigungen die vorhandenen Berechtigungen für Arbeitsmappen
und Ansichten. Nehmen wir beispielsweise an, es sind einige Arbeitsmappen vorhanden, die
mit benutzerdefinierten Berechtigungen veröffentlicht wurden, und Sie fassen die
Arbeitsmappen in einem neuen Projekt mit einem neuen Berechtigungssatz zusammen. Sie
können die neuen Berechtigungen den einzelnen Arbeitsmappen zuweisen, indem Sie auf
Berechtigungen dem Inhalt zuweisen auf der Berechtigungsseite klicken.
Benutzerberechtigungen prüfen
Sie können die Berechtigungen eines Benutzers für bestimmte Ansichten, Arbeitsmappen,
Projekte oder Datenquellen jederzeit anzeigen. Wählen Sie auf einer beliebigen Seite, auf der
- 97 -
Sie Berechtigungen einrichten können, einen Benutzer aus der Dropdown-Liste
Benutzerberechtigungen prüfen
Die angezeigten Berchtigungen gelten für die ausgewählte Ansicht, Arbeitsmappe,
Datenquelle oder das ausgewählte Projekt.
Berechtigungsreferenz
Administratoren und andere entsprechend autorisierte Benutzer können anderen Benutzern
die Berechtigungen für Aktionen in Tableau Server gewähren oder verweigern.
Berechtigungen können auch in Tableau Desktop beim Veröffentlichen einer Arbeitsmappe
oder einer Datenquelle in Tableau Server festgelegt werden.
Administratoren haben immer uneingeschränkten Zugriff auf alle Objekte in Tableau Server,
und Site-Administratoren uneingeschränkten Zugriff auf alle Objekte einer Site. Wenn Sie eine
Arbeitsmappe oder eine Datenquelle in Tableau Server veröffentlichen, sind Sie der
Eigentümer des Objekts und behalten die volle Kontrolle darüber.
Die folgende Tabelle zeigt die Berechtigungen für verschiedene Objekte in Tableau Server
sowie die Aktionen, die Benutzer mit der entsprechenden Berechtigung ausführen können.
Berechtigung
Ansicht
Betrifft...
Mögliche Aktionen, falls zugelassen
Arbeitsmappen Die Benutzer können das Element in Tableau
Server anzeigen. Benutzer, die auf eine
Datenquellen
Ansicht zugreifen, die eine Verbindung mit
Ansichten
einer Datenquelle herstellt, müssen über eine
Berechtigung zum Anzeigen der Arbeitsmappe
Projekte
und über eine Berechtigung zum Herstellen
- 98 -
Berechtigung
Webbearbeitung
Betrifft...
Mögliche Aktionen, falls zugelassen
einer Verbindung mit der Datenquelle
verfügen.
Arbeitsmappen Die Benutzer können Ansichten in
Arbeitsmappen bearbeiten. Weitere
Ansichten
Informationen finden Sie unter Gewähren von
Projekte
Berechtigungen zum Bearbeiten und
Speichern Auf Seite 102
Wenn Sie eine Arbeitsmappe aus Tableau
Desktop veröffentlichen, werden die
Berechtigungen für Arbeitsblätter (Ansichten)
in einer Arbeitsmappe aus den
Berechtigungen der Arbeitsmappe kopiert
(überschrieben). Sie werden auch kopiert,
wenn Sie auf Berechtigungen für Inhalt
zuweisen auf der Seite
"Berechtigungen: Arbeitsmappe" klicken.
Wenn Sie beim Speichern einer Arbeitsmappe
Blätter als Registerkarten anzeigen
auswählen, werden die Berechtigungen für
alle Arbeitsblätter (Ansichten) der
Arbeitsmappe durch die Berechtigungen für
die Arbeitsmappe überschrieben, bis die
Registerkarten deaktiviert werden.
Schreiben/Im Web
Gesonderter Hinweis für die Gruppe Alle
Benutzer:Um die Inhalte eines Eigentümers
vor dem Überschreiben durch einen anderen
Benutzer zu schützen (entweder durch die
Veröffentlichung über Tableau Desktop oder
das Speichern einer online bearbeiteten
Arbeitsmappe auf Tableau Server), wird die
Berechtigung Schreiben/Im Web speichern
für die Gruppe Alle Benutzer standardmäßig
von "Zulassen" zu "Geerbt" geändert, wenn ein
Benutzer in einem Projekt veröffentlicht, für
das die Gruppe Alle Benutzer
Berechtigungen hat.Sie können diese
Berechtigung manuell von "Geerbt" auf
"Zulassen" setzen, indem Sie die Schritte unter
Festlegen von Berechtigungen für
Arbeitsmappen und Ansichten Auf Seite 90
befolgen.
Arbeitsmappen Der Benutzer kann das Objekt auf dem Server
- 99 -
Berechtigung
speichern
Betrifft...
Datenquellen
Ansichten
Projekte
Herunterladen/Im Web
speichern unter
Löschen
Mögliche Aktionen, falls zugelassen
überschreiben. Falls zulässig, kann der
Benutzer eine Arbeitsmappe oder Datenquelle
aus Tableau Desktop erneut veröffentlichen
und wird zum Eigentümer, dem alle
Berechtigungen erteilt werden. Anschließend
richtet sich der Zugriff auf die Arbeitsmappe
des ursprünglichen Eigentümers nach den
Gruppenberechtigungen des Benutzers und
nach allen weiteren Berechtigungen, die der
neue Eigentümer einrichtet.
Mit dieser Berechtigung haben der Benutzer
oder die Gruppe die Möglichkeit, eine
Arbeitsmappe zu überschreiben, nachdem sie
auf dem Server bearbeitet wurde. Weitere
Informationen finden Sie unter Gewähren von
Berechtigungen zum Bearbeiten und
Speichern Auf Seite 102
Arbeitsmappen Falls zugelassen, kann der Benutzer das
Objekt vom Server herunterladen und eine
Datenquellen
bearbeitete Arbeitsmappe als neue
Projekte
Arbeitsmappe auf dem Server speichern.
Weitere Informationen finden Sie unter
Herunterladen von Arbeitsmappen Auf
Seite 49 und Gewähren von
Berechtigungen zum Bearbeiten und
Speichern Auf Seite 102.
Arbeitsmappen Der Benutzer kann das Objekt löschen.
Datenquellen
Ansichten
Filter
Kommentar hinzufügen
Kommentare anzeigen
Projekte
Arbeitsmappen Benutzer können Schnellfilter sowie Filter vom
Typ "Nur beibehalten" und "Ausschließen"
Ansichten
ändern. Weitere Informationen finden Sie
Projekte
unter Kommentieren von Ansichten Auf
Seite 56.
Arbeitsmappen Benutzer können den Ansichten in einer
Arbeitsmappe Kommentare hinzufügen.
Ansichten
Projekte
Arbeitsmappen Benutzer können die Kommentare anzeigen,
die den Ansichten in einer Arbeitsmappe
Ansichten
- 100 -
Berechtigung
Betrifft...
Mögliche Aktionen, falls zugelassen
Projekte
zugeordnet sind.
Zusammenfassungsdaten Arbeitsmappen Die Benutzer können die aggregierten Daten
anzeigen
in einer Ansicht bzw. in den vom Benutzer
Ansichten
ausgewählten Feldern der Ansicht anzeigen
Projekte
und diese Daten als Textdatei herunterladen.
Zugrunde liegende Daten Arbeitsmappen Die Benutzer können alle Rohdaten für die
anzeigen
einzelnen Zeilen in einer Ansicht, ggf.
Ansichten
eingeschränkt durch vom Benutzer
Projekte
ausgewählte Markierungen, anzeigen und die
Daten als Textdatei herunterladen.
Bild exportieren
Arbeitsmappen Benutzer können jede Ansicht als Bild
exportieren. Weitere Informationen finden Sie
Ansichten
unter Exportieren von Ansichten Auf Seite
Projekte
44.
Angepasste Ansicht
Arbeitsmappen Die Benutzer können gespeicherte
freigeben
Anpassungen einer Ansicht für andere
Ansichten
veröffentlichen. Benutzer können mit der
Projekte
Option Änderungen speichern in Tableau
Server benutzerdefinierte Ansichten
speichern. Weitere Informationen finden Sie
unter Angepasste Ansichten Auf Seite 272.
Verschieben
Arbeitsmappen Benutzer können Arbeitsmappen zwischen
Projekten verschieben.
Ansichten
Projekte
Berechtigungen festlegen Arbeitsmappen Der Benutzer kann Berechtigungen für das
Objekt festlegen. Bei Arbeitsmappen erstreckt
Datenquellen
sich diese Berechtigung auf die Ansichten.
Ansichten
Verbinden
Projekte
Datenquellen
Ansichten
Projekte
Projektleiter
Projekte
Der Benutzer kann eine Verbindung zur
Datenquelle herstellen. Benutzer, die auf eine
Ansicht zugreifen, die eine Verbindung mit
einer Datenquelle herstellt, müssen über eine
Berechtigung zum Anzeigen der Datenquelle
und zum Herstellen einer Verbindung mit der
Datenquelle verfügen.
Der Benutzer kann Berechtigungen für alle
Objekte in einem Projekt und für das Projekt
selbst festlegen.
- 101 -
Gewähren von Berechtigungen zum Bearbeiten und Speichern
Dieses Thema erläutert, wie Administratoren Berechtigungen für allgemeine
Arbeitsmappenaufgaben festlegen können, beispielsweise:
l
l
l
Bearbeiten vorhandener Arbeitsmappen
Speichern von Änderungen an vorhandenen Arbeitsmappen mit Überschreibung früherer Versionen
Speichern der Änderungen an einer neuen Arbeitsmappe, Zulassen der Erstellung
neuer Arbeitsmappen, jedoch nicht des Überschreibens vorhandener
Es wird auch erläutert, wie das unzulässige Überschreiben von expliziten Berechtigungen aus
einem anderen Bereich der Berechtigungsstruktur verhindert wird.
Festlegen von Benutzerlizenz- und Veröffentlichungsstufen
Die Administratoren weisen eine Lizenzstufe und Benutzerrechte beim Erstellen oder Ändern
von Benutzern zu. Um Benutzern das Bearbeiten von Arbeitsmappen zu erlauben, sind
folgende Zuweisungen erforderlich:
l
Dem Benutzer muss die Lizenzstufe Interakteur zugewiesen werden.
l
Dem Benutzer muss das Recht Veröffentlichen zugewiesen werden.
Weitere Informationen finden Sie unter Benutzer Auf Seite 179 und unter Lizenzen und
Benutzerrechte Auf Seite 193.
Zulassen der Bearbeitung und Speicherung von Arbeitsmappen
Nachdem Sie Benutzer oder Gruppen eingerichtet, Lizenzstufen festgelegt und
Veröffentlichungsrechte gewährt haben, müssen Sie Berechtigungen auf den Ebenen
Projekt und Arbeitsmappe festlegen, je nachdem, welche Art von Bearbeitung Sie zulassen
möchten. Die primären Berechtigungen für das Bearbeiten und Speichern von Ansichten sind
Folgende:
l
l
l
Webbearbeitung legt fest, ob der Benutzer Arbeitsmappenansichten durch
Webentwicklung bearbeiten darf.
Herunterladen/Im Web speichern unter legt fest, ob dem Benutzer beim Bearbeiten
einer Ansicht die Befehle Speichern und Speichern unter angezeigt werden, also ob
er seine Änderungen in einer neuen Arbeitsmappe speichern kann. Legt außerdem fest,
ob Benutzer eine Arbeitsmappe auf dem Server mit Tableau Desktop öffnen können.
Schreiben/Im Web speichern legt fest, ob Benutzer Änderungen in einer
vorhandenen Arbeitsmappe auf dem Server speichern (eine Arbeitsmappe
überschreiben) können.
Um einem Benutzer oder einer Gruppe das Speichern von Änderungen in vorhandenen
Arbeitsmappen oder in neuen Arbeitsmappen zu erlauben, legen Sie diese drei
Berechtigungen auf Aufgabenebene entsprechend den Tabellen in den folgenden Abschnitten
fest.
- 102 -
Benutzern das Speichern von Änderungen in vorhandenen und neuen Arbeitsmappen
erlauben
Berechtigung
Für das Für entProjekt sprechende
Arbeitsmappen
im Projekt
Webbearbeitung
Zulassen Zulassen
Herunterladen/Speichern Zulassen Zulassen
unter
Schreiben/Speichern
Zulassen Zulassen
In diesem Szenario gilt Folgendes: Da Berechtigungen für Projekte und Arbeitsmappen
auf die gleiche Weise festgelegt werden, können Sie, wenn Sie Änderungen an
Berechtigungen auf Projektebene für alle Arbeitsmappen im Projekt anwenden
möchten, die Option Berechtigungen für Inhalt zuweisen auf der Seite
"Berechtigungen: Projekt" wählen.
Benutzern das Speichern neuer Arbeitsmappen erlauben, nicht aber das Überschreiben vorhandener Arbeitsmappen
Berechtigung
Für das Für entProjekt sprechende
Arbeitsmappen
im Projekt
Webbearbeitung
Zulassen Zulassen
Herunterladen/Speichern Zulassen Zulassen
unter
Schreiben/Speichern
Zulassen Verweigern
Wichtig: In diesem Szenario müssen Berechtigungen manuell für jede Arbeitsmappe
festgelegt werden. Wenn Sie die Option Berechtigungen für Inhalt zuweisen wie
unter Benutzern das Speichern von Änderungen in vorhandenen und neuen
Arbeitsmappen erlauben unten beschrieben auswählen, überschreiben
Projektberechtigungen die Arbeitsmappenberechtigungen, sodass Benutzer die
Berechtigung erhalten, Änderungen in vorhandenen Arbeitsmappen zu speichern.
Berechtigungen für Ansichten in Arbeitsmappen
Berechtigungen für Ansichten in Arbeitsmappen werden aus den
Arbeitsmappenberechtigungen übernommen (geerbt), wenn ein Benutzer eine Arbeitsmappe
aus Tableau Desktop veröffentlicht.
- 103 -
Wenn ein Benutzer beim Veröffentlichen einer Arbeitsmappe aus Tableau Desktop oder beim
Speichern der Arbeitsmappe in Tableau Server Blätter als Registerkarten anzeigen
auswählt, überschreiben die Arbeitsmappenberechtigungen die Berechtigungen für einzelne
Ansichten, bis die Arbeitsmappe wieder ohne Registerkarten gespeichert wird.
Weitere Informationen finden Sie unter Berechtigungsreferenz Auf Seite 98 und im
Knowledge Base-Artikel Creating Project-Based Permissions.
Beispiel: Webdokumenterstellung deaktivieren
Wenn Benutzer veröffentlichte Arbeitsmappen in Tableau Server anzeigen können, jedoch
nicht auf die Server-Dokumenterstellungsumgebung zugreifen können sollen, verwenden Sie
eine Einstellung auf Site-Ebene, um die Dokumenterstellung zu deaktivieren.
So könnte beispielsweise eine bestimmte Datenanalystengruppe mit Tableau Desktop
Arbeitsmappen erstellen und veröffentlichen und eine Vertriebsmitarbeitergruppe im
Außendienst Tableau Desktop zwar nicht zur Datenanalyse verwenden, es aber zur Ansicht
und Freigabe der veröffentlichten Dashboards über die Webumgebung benötigen.
Führen Sie die folgenden Schritte aus, um die Dokumenterstellung zu deaktivieren.
1. Melden Sie sich in einem Webbrowser als Administrator bei der Serverumgebung an.
2. Wählen Sie auf der Registerkarte "Admin" die Option Sites aus.
3. Wählen Sie auf der Seite "Sites" das Kontrollkästchen zur der Site aus, zu der Sie die
Dokumenterstellung deaktivieren möchten, und klicken Sie dann auch Bearbeiten.
4. Deaktivieren Sie im Dialogfeld "Site bearbeiten" das Kontrollkästchen zu
Webdokumenterstellung für diese Site zulassen, und klicken Sie auf OK.
- 104 -
Sie können auf der Seite "Sites" bestätigen, dass die Webdokumenterstellung
deaktiviert ist.
5. Wenn sich Ihre Site bereits in Produktion befindet und die Änderung unmittelbar
angewandt werden soll, starten Sie den Server neu.
Alternativ können Sie auch den Ablauf des Caching der Server-Sitzung abwarten.Bis zu
diesem Zeitpunkt haben Benutzer möglicherweise Zugang zur Dokumenterstellung,
wenn sie einen Bearbeitungslink in einer Ansicht anzeigen oder den
Bearbeitungsmodus der Ansicht aufrufen.Sie könnten beispielsweise die URL mit
einem Lesezeichen versehen haben, in der sie die Ansicht zum Bearbeiten geöffnet
hatten.
Wenn Sie die Webdokumenterstellung deaktivieren, während Sie eine neue Website
erstellen, sind keine Sitzungen im Cache vorhanden und die Einstellung wird sofort
umgesetzt.
- 105 -
Besitzrecht verwalten
Wenn Sie eine Datenquelle oder Arbeitsmappe in Tableau Server veröffentlichen oder ein
Projekt erstellen, werden Sie deren Besitzer. Die Besitzrechte sind änderbar. Wenn
beispielsweise der Mitarbeiter, der der ursprüngliche Besitzer ist, das Unternehmen verlässt,
kann der Administrator das Besitzrecht einem anderen Benutzer zuteilen. Sobald das
Besitzrecht anderweitig zugewiesen wurde, besteht für den ursprünglichen Besitzer keine
Verbindung zum Element mehr, sein Zugang ist dann von den Tableau ServerBerechtigungen abhängig.
Sie können keinen Tableau Server Benutzer löschen, der Elemente besitzt. Wenn Sie
versuchen, den Benutzer zu löschen, wird dessen Lizenzstufe auf "nicht lizenziert"
gesetzt. Sie müssen dann den Besitz der Elemente ändern und den Benutzer löschen.
Weitere Informationen finden Sie unter Löschen von Benutzern aus Tableau Server.
Ihre Möglichkeiten zum Ändern und Annehmen von Besitzrechten hängen von Ihren
Berechtigungen und Ihrer Beziehung zum Element ab.
Elementtyp
Projekte
Arbeitsmappen
und Datenquellen
Wer kann Besitzrechte ändern?
Systemadministrator
Wer kann Besitzrechte erhalten?
Site-Administrator
Systemadministrator
Site-Administrator
Systemadministrator
Site-Administrator
Site-Administrator
Projektleiter für das
Projekt mit dem Objekt
Element der Site, dass das Element
enthält, mit Lizenz (keine Gastlizenz)
Systemadministrator
Besitzer des Elements
Weitere Informationen finden Sie in den folgenden Themen:
Besitzer von Arbeitsmappen ändern
Der Veröffentlicher einer Arbeitsmappe ist standardmäßig auch ihr Besitzer. Der Besitzer
kann von Administratoren, Projektleitern und dem aktuellen Besitzer der Arbeitsmappe
geändert werden. Der neue Besitzer muss entweder System- oder Site-Administrator sein
oder über eine andere Lizenzstufe als "Gast" für die gleiche Site wie die Arbeitsmappe
verfügen.
So ändern Sie den Besitzer einer Arbeitsmappe:
1. Wählen Sie auf der Registerkarte "Inhalt" die Option Arbeitsmappen aus.
2. Wählen Sie auf der Seite "Arbeitsmappen" mindestens eine Arbeitsmappe aus, und
klicken Sie dann auf Besitzer wechseln.
- 106 -
3. Geben Sie den Namen eines Benutzers ein oder wählen Sie einen Benutzer aus der
Liste aus.
4. Klicken Sie auf OK, um den Besitzer zu ändern.
Besitzer einer Datenquelle ändern
Der Veröffentlicher einer Datenquelle ist standardmäßig auch ihr Besitzer. Der Besitzer kann
von Administratoren, Projektleitern und dem aktuellen Besitzer der Datenquelle geändert
werden. Der neue Besitzer muss entweder System- oder Site-Administrator sein oder über
eine andere Lizenzstufe als "Gast" für die gleiche Site wie die Datenquelle verfügen.
So ändern Sie den Besitzer einer Datenquelle:
1. Wählen Sie auf der Registerkarte "Inhalt" die Option Datenquellen aus.
2. Wählen Sie mindestens eine Datenquelle aus, und klicken Sie dann auf Besitzer
wechseln.
- 107 -
3. Geben Sie den Namen eines Benutzers ein oder wählen Sie einen Benutzer aus der
Liste aus.
4. Klicken Sie auf OK, um den Besitzer zu ändern.
Besitzer eines Projekts ändern
Der Ersteller eines Projekts ist standardmäßig auch sein Besitzer. Administratoren können
den Besitzer des Projekts ändern. Der neue Besitzer muss Systemadministrator oder
Administrator der Projekt-Site sein.
So ändern Sie den Besitzer eines Projekts:
1. Wählen Sie auf der Registerkarte "Admin" die Option Projekte aus.
2. Wählen Sie mindestens ein Projekt aus, und klicken Sie dann auf Besitzer wechseln.
- 108 -
3. Geben Sie den Namen eines Benutzers ein oder wählen Sie einen Benutzer aus der
Liste aus.
4. Klicken Sie auf OK, um den Besitzer zu ändern.
- 109 -
Administratorhandbuch
Das Administratorhandbuch ist die umfassende Referenz zur Handhabung von
Verwaltungsaufgaben in Tableau Server:
Vor der Installation...
Stellen Sie sicher, dass der Computer, auf dem Tableau Server installiert wird, die folgenden
Anforderungen erfüllt:
l
l
Unterstützte Betriebssysteme - Tableau Server ist als 32- und 64-Bit-Version
verfügbar. Sie können Tableau Server unter Windows Server 2003 R2 SP2 oder höher,
Windows Server 2008, Windows Server 2008 R2, Windows Server 2012, Windows
Server 2012 R2, Windows 7, Windows 8 oder Windows 8.1 installieren. Unter einem
64-Bit-Betriebssystem wird die 64-Bit-Version von Tableau Server empfohlen. Sie
können Tableau Server auch auf virtuellen oder physischen Plattformen installieren.
Empfehlungen zu Speicher, Kernen und Festplattenspeicherplatz: Die Tableau
Server-Systemvoraussetzungen hängen von verschiedenen Faktoren ab. Die
folgenden Angaben sind Mindestempfehlungen basierend auf der Anzahl der Benutzer
auf dem Server:
Bereitstellungstyp
Anzahl
CPU
Serverbenutze
r
Evaluierung/Konzeptnachwei 1-2
4
Kern
s (64 Bit Tableau Server)
e
Evaluierung/Konzeptnachwei 1-2
2
Kern
s (32 Bit Tableau Server)
e
Klein
<25
4
Kern
e
Mittel
<100
8
Kern
e
Unternehmen
>100
16
Kern
e
RA
M
Freier Festplattenspeicher
8 GB 1.5 GB
4 GB 1.5 GB
8 GB 5 GB
32
GB
50 GB
32
50 GB oder mehr
GB
oder
mehr
Die Mindestanforderungen für die Ausführung der 64-Bit-Version von Tableau Server
sind 4 Kerne und 8 GB RAM.
l
Administratorkonto: Das Konto, unter dem Sie Tableau Server installieren, muss
über Berechtigungen zum Installieren der Software und Services verfügen.
- 110 -
l
l
Optional: Run As Account (Konto "Als Benutzer ausführen": Ein Konto "Run As
User" (Als Benutzer ausführen), unter dem der Tableau Server-Dienst ausgeführt
werden soll, ist hilfreich, wenn Sie die NT-Authentifizierung mit Datenquellen
verwenden oder wenn Sie Identitätswechsel für SQL Server durchführen möchten.
Weitere Informationen finden Sie unter Run As User (Als Benutzer ausführen) Auf
Seite 373 und SQL Server-Identitätswechsel Auf Seite 382.
IIS und Port 80: Das Gateway von Tableau Server wird auf Port 80 überwacht, der
standardmäßig auch vom Internet Information Services (IIS) genutzt wird. Wenn Sie
Tableau Server auf einem Computer installieren, auf dem auch IIS ausgeführt wird,
sollten Sie die Gateway-Portnummer für Tableau ändern, um Konflikte mit IIS zu
vermeiden. Nähere Informationen hierzu finden Sie unter TCP/IP-Ports Auf Seite 388
und Bearbeiten der Standardports Auf Seite 392.
Konfigurationsdaten
Während der Installation und Konfiguration von Tableau Server werden Sie unter Umständen
zur Angabe der folgenden Informationen aufgefordert:
Option
Serverkonto
Beschreibung
Auf dem Server muss ein Benutzerkonto verfügbar
sein, das der Dienst verwenden kann. Standardmäßig
wird das integrierte Windows-Netzwerkdienstkonto
verwendet. Wenn Sie ein bestimmtes Benutzerkonto
verwenden, müssen Sie Domänennamen, Benutzernamen und Kennwort angeben.
Active Direc- Statt das integrierte Benutzerverwaltungssystem von
tory
Tableau zu verwenden, können Sie die Authentifizierung auch über Active Directory durchführen. In
diesem Fall benötigen Sie den vollständig qualifizierten Domänennamen.
Open port in Wenn diese Option ausgewählt wird, öffnet Tableau
Windows fire- Server den Port, der in der Windows Firewall-Softwall (Port in ware für HTTP-Anforderungen verwendet wird, damit
Windowsandere Computer im Netzwerk auf den Server zugreiFirewall öfffen können.
nen)
Ihre Informationen
Benutzername:
Password
(Kennwort):
Domain (Domäne):
Active DirectoryDomäne
__ - Yes
__ - No
Ports
Standardmäßig erfordert Tableau Server, dass die mehrere TCP/IP-Ports für den Server
verfügbar sind: Unter dem Thema TCP/IP-Ports Auf Seite 388 finden Sie eine vollständige
Liste, einschließlich welche Ports für alle Installationen vs. verteilte Installationen oder
Failover-Installationen verfügbar sein müssen. Die Standardports können geändert werden,
sollte ein Konflikt vorliegen. Informationen dazu finden Sie unter Bearbeiten der
Standardports Auf Seite 392.
- 111 -
Treiber
Möglicherweise müssen Sie zusätzliche Datenbanktreiber installieren. Laden Sie die Treiber
von www.tableausoftware.com/support/drivers herunter.
Installieren und Konfigurieren
Im Folgenden werden die wichtigsten Schritte beschrieben, die zur Installation und
Konfiguration von Tableau Server auszuführen sind:
Ausführen der Serverinstallation
Nachdem Sie die Tableau Server-Installationsdatei heruntergeladen haben, befolgen Sie die
unten angegebenen Anweisungen zur Installation des Servers.
1. Doppelklicken Sie auf die Installationsdatei.
2. Befolgen Sie die Bildschirmanweisungen, um das Setup-Programm auszuführen und
die Anwendung zu installieren.
3. Nachdem die Installation abgeschlossen worden ist, klicken Sie auf Weiter, um den
Product Key Manager zu öffnen.
Wenn Zeichen unterstützt werden müssen, die nicht im Zeichensatz Latin-1 enthalten
sind, dann installieren Sie die Windows-Sprachpakete über Systemsteuerung >
Regions- und Sprachoptionen. Die Sprachpakete müssen sowohl auf dem primären
Server als auch auf den Arbeitscomputern installiert werden.
- 112 -
Tableau aktivieren
Tableau Server erfordert mindestens einen Product Key, der sowohl den Server aktiviert als
auch die Anzahl von Lizenzebenen angibt, die Benutzern zugewiesen werden können. Das
Tableau Customer Account Center bietet Zugriff auf die Product Keys. Nach der Installation
und Konfiguration des Servers wird automatisch der Product Key Manager geöffnet, damit Sie
Ihren Product Key eingeben und das Produkt registrieren können. Informationen dazu, wie Sie
das Produkt auf einem Computer registrieren, der offline ist, finden Sie unter OfflineAktivieren von Tableau oben.
1. Wählen Sie "Aktivieren" aus, und fügen Sie Ihren Product Key ein:
2. Weitere Informationen finden Sie auf der Download-Hilfeseite auf der Website.
Offline-Aktivieren von Tableau
Wenn Sie offline arbeiten, können Sie die unten beschriebenen Schritte ausführen, um die
Offline-Aktivierung durchzuführen.
1. Wenn der Product Key Manager geöffnet wird, klicken Sie auf Aktivieren Sie das
Produkt.
Fügen Sie Ihren Server Product Key in das entsprechende Textfeld ein, und klicken Sie
auf "Aktivieren". Sie erhalten den Product Key im Tableau -Kundenportal.
2. Wenn Sie offline sind, schlägt die Aktivierung fehl, und Sie erhalten die Möglichkeit, eine
Datei zu speichern, die Sie zur Offline-Aktivierung verwenden können. Klicken Sie auf
- 113 -
Speichern.
3. Wählen Sie einen Speicherort für die Datei aus, und klicken Sie auf Speichern. Die
Datei wird unter dem Namen offline.tlq gespeichert.
4. Zurück in Tableau klicken Sie auf Beenden, um das Dialogfeld "Aktivierung" zu
schließen.
5. Öffnen Sie auf einem Computer mit Internetzugang einen Webbrowser, und rufen Sie
die Seite zur Produktaktivierung auf der Website von Tableau auf. Folgen Sie den
Anweisungen, um die Datei "offline.tlq" zu übermitteln.
Nachdem Sie die Datei offline.tlq online übertragen haben, wird im Browser weiterhin
die Seite für die Produktaktivierung angezeigt. Gleichzeitig wird eine Datei namens
activation.tlf erstellt, und Sie werden von Tableau aufgefordert, die Datei auf Ihrem
Computer zu speichern.
6. Speichern Sie die Datei activation.tlf, und verschieben Sie sie auf den Computer, auf
dem Sie Tableau Server installieren. Wenn Tableau Desktop auf dem Computer
installiert ist, können Sie auf die neue Datei doppelklicken, um die Aktivierung
abzuschließen. Wenn Tableau Desktop bei Ihnen nicht installiert ist, fahren Sie mit
Schritt 7 fort.
7. Öffnen Sie auf dem Computer, auf dem Sie Tableau Server installieren, eine
Eingabeaufforderung als Administrator, und führen Sie folgenden Befehl aus:
cd "C:\Program Files\Tableau\Tableau Server\8.3\bin"
8. Geben Sie dann tabadmin activate --tlf <path>\activation.tlf ein,
wobei<path> für den Speicherort der Tableau-Antwortdatei steht, die Sie von der
Seite für die Produktaktivierung gespeichert haben. Beispiel:
tabadmin activate --tlf \Desktop\activation.tlf
Lassen Sie das Befehlseingabefenster geöffnet.
9. Nachdem die Lizenz initialisiert wurde, werden Sie aufgefordert, das Produkt erneut zu
aktivieren.Klicken Sie auf dem Tableau Server auf Start > Alle Programme > Tableau
Server 8.3
10. Klicken Sie mit der rechten Maustaste auf Produktschlüssel verwalten, und wählen
Sie dann Als Administrator ausführen.
Auch wenn Sie als Administrator beim Tableau Server-Computer angemeldet sind,
müssen Sie diesen Schritt ausführen, um einen möglichen Registrierungsfehler zu
vermeiden.
11. Klicken Sie auf Produkt aktivieren.
12. Geben Sie den Product Key erneut ein (derselbe, den Sie in Schritt 1 eingegeben
haben).
13. Speichern Sie die TLQ-Datei.
14. Öffnen Sie auf einem Computer mit Internetzugang einen Webbrowser, und rufen Sie
- 114 -
die Seite zur Produktaktivierung auf der Website von Tableau auf.Folgen Sie den
restlichen Anweisungen.
Tableau erstellt erneut eine Datei namens activation.tlf, und fordert Sie auf, sie zu
speichern.
15. Speichern Sie die Datei, und verschieben Sie sie auf den Computer, auf dem Sie
Tableau Server installieren.
16. Wechseln Sie erneut zum Eingabeaufforderungsfenster von Tableau Server, und
geben Sie tabadmin activate --tlf <path>\activation.tlf ein, wobei
<path> der Speicherort der zweiten Antwortdatei ist, die Sie von der Seite für die
Produktaktivierung gespeichert haben. Beispiel:
tabadmin activate --tlf \Desktop\activation.tlf
Tableau Server ist jetzt aktiviert. Wenn Sie weitere Unterstützung benötigen, wenden
Sie sich an den Kundendienst von Tableau.
Konfigurieren des Servers
Das Konfigurationsdialogfeld erscheint während des Setups. Sie können die Anwendung nach
dem Setup öffnen, indem Sie im Startmenü von Windows Alle Programme > Tableau
Server 8.3 > Tableau Server konfigurieren auswählen. Bevor Sie Änderungen an der
Konfiguration vornehmen, müssen Sie den Server anhalten. Die dafür erforderlichen Schritte
werden unter Neukonfigurieren des Servers Auf Seite 134 beschrieben.
Zwei weitere Punkte sind bei der Festlegung von Einstellungen im Konfigurationsdialogfeld zu
beachten:
l
l
Die Einstellungen gelten für das gesamte System: Die Einstellungen, die Sie
anwenden, gelten für den gesamten Server. Wenn der Server mehrere Sites ausführt,
beeinflussen diese Einstellungen alle Sites.
Benutzerauthentifizierung ist "permanent".Alle Einstellungen können nach dem
Setup geändert werden, indem der Server angehalten und neukonfiguriert wird. Die
Ausnahme bildet die Einstellung Benutzerauthentifizierung (Registerkarte
"Allgemein"). Sie wird als "permanent" bezeichnet, da die Änderung von Lokale
Authentifizierung verwenden zu Active Directory verwenden die Deinstallation
und Neuinstallation des Servers erfordert.
Weitere Informationen zu den verschiedenen Konfigurationsregisterkarten finden Sie in den
folgenden Themen:
Allgemein
Führen Sie die unten beschriebenen Schritte aus, um die Optionen auf der Registerkarte
"Allgemein" zu konfigurieren.
1. Tableau Server wird standardmäßig unter dem Konto mit der Bezeichnung "Network
Service" (Netzwerkdienst) ausgeführt. Wenn Sie ein Konto verwenden möchten, das
- 115 -
eine NT-Authentifizierung mit Datenquellen zulässt, dann geben Sie einen
Benutzernamen und ein Kennwort an. Der Benutzername sollte den Domänennamen
enthalten. Nähere Informationen zur Verwendung eines bestimmten Benutzerkontos
finden Sie unter Run As User (Als Benutzer ausführen) Auf Seite 373.
2. Geben Sie an, ob Active Directory zur Authentifizierung der Benutzer auf dem Server
verwendet werden soll. Wählen Sie Use Local Authentication (Lokale
Authentifizierung verwenden) aus, um mit dem integrierten Benutzerverwaltungssystem
von Tableau Server Benutzer anzulegen und Kennwörter zuzuweisen. Sie können
später nicht zwischen Active Directory und lokaler Authentifizierung hin- und
herwechseln.
3. Wenn Sie Active Directory verwenden:
l
l
Optional können Sie die automatische Anmeldung aktivieren, wobei Microsoft
SSPI zur automatischen Anmeldung der Benutzer mit deren WindowsBenutzernamen und -Kennwort verwendet wird. Dieser Vorgang ähnelt dem
SSO-Verfahren für die einmalige Anmeldung. Wählen Sie die Option zum
Aktivieren der automatischen Anmeldung nicht aus, wenn Sie Tableau
Server für SAML, die vertrauenswürdige Authentifizierung oder einen
Proxyserver konfigurieren möchten.
Geben Sie den vollständig qualifizierten Domänennamen (FQDN) und
Spitznamen ein.
So ermitteln Sie den FQDN: Wählen Sie Start > Ausführen, und geben Sie
dann sysdm.cpl in das Textfeld "Ausführen" ein. Wählen Sie im Dialogfeld
"Systemeigenschaften" die Registerkarte Computername aus. Der FQDN wird
etwa in der Mitte des Dialogfelds angezeigt. Wenn sich die Benutzer zum ersten
Mal anmelden, müssen sie den vollständig qualifizierten Domänennamen
angeben (z. B. myco.lan\jsmith). Bei nachfolgenden Anmeldungen können
sie den Spitznamen (myco\jsmith) verwenden.
4. Als Standardport für den Webzugriff auf Tableau Server (über HTTP) wird Port 80
- 116 -
verwendet. Sie müssen die Portnummer unter Umständen ändern, wenn ein anderer
Server oder andere Netzwerkfunktionen Port 80 nutzen. Beispielsweise kann dem
Tableau Server-Host eine Hardware-Firewall oder ein Proxy vorgeschaltet sein. In
diesem Fall ist es nicht wünschenswert, dass Port 80 vom Back-End-System verwendet
wird.
5. Wählen Sie aus, ob ein Port in der Windows-Firewall geöffnet werden soll. Wenn dieser
Port nicht geöffnet werden soll, können Benutzer auf anderen Computern
möglicherweise nicht auf den Server zugreifen.
6. Wählen Sie aus, ob Beispieldaten und -benutzer aufgenommen werden sollen. Die
Beispieldaen können Ihnen den Einstieg in Tableau Server erleichtern, insbesondere,
wenn Sie eine Testversion des Produkts installieren. Anfänglich benutzt der
Beispielbenutzer eine Interactor-Lizenz. Sie können die Lizenzstufe dieses Benutzers in
"unlicensed" (nicht lizenziert) ändern, um die Lizenzstufen neu festzulegen. Weitere
Informationen zur entsprechenden Vorgehensweise finden Sie unter Lizenzen und
Benutzerrechte Auf Seite 193. Wenn Sie die Option für den Beispielbenutzer
auswählen, wird ein Benutzer installiert. Benutzername und Kennwort werden unten
dargestellt:
Benutzername
Kennwort
Tableau Software test
7. Fahren Sie optional mit der nächsten Seite fort, um Optionen für Zwischenspeicherung
und SQL-Anfangsdaten zu konfigurieren. Wenn Sie diese Optionen nicht konfigurieren
möchten, klicken Sie auf OK.
Domänen
Wenn die Active Directory-Authentifizierung für den Server verwendet wird, können Sie eine
Liste der Domänen anzeigen, die verwendet werden, und deren Domänennamen und
Spitznamen bearbeiten. Dies ist unter Umständen erforderlich, um beispielsweise
sicherzustellen, dass Tableau Server den richtigen Spitznamen zur SSPI-Authentifizierung
oder den richtigen Domänennamen verwendet.
Ändern von Domänennamen
So ändern Sie einen Domänennamen:
- 117 -
1. Wählen Sie im Verwaltungsbereich in der linken Hälfte der Seite den Link "Benutzer"
aus.
2. Klicken Sie am Ende der Benutzerliste auf den Link "Domänen". In der Liste der
Domänen wird die Anzahl der Benutzer und Gruppen anzeigt, die dem Server aus jeder
Domäne hinzugefügt worden sind.
3. Um eine Liste der Benutzer anzuzeigen, die Mitglied einer Domäne sind, klicken Sie auf
den Domänennamen.
4. Um den Domänennamen oder Spitznamen zu ändern, klicken Sie auf den Link
Bearbeiten, geben einen neuen Namen, einen vollständig qualifizierten
Domänennamen oder einen Spitznamen ein und klicken dann auf Ändern.
Sie können den Spitznamen jeder vom Server verwendeten Domäne ändern. Im
Allgemeinen können Sie den kompletten Domänennamen für jede Domäne ändern,
außer für die Domäne, die Sie für die Anmeldung verwendet haben. Wenn der
Benutzername, unter dem Sie aktuell angemeldet sind, jedoch in der aktuellen und in
der neuen Domäne vorhanden ist, können Sie den vollständigen Namen für die aktuelle
Domäne ändern.
Datenverbindungen
Verwenden Sie die Optionen auf der Registerkarte "Datenverbindungen", um die
Zwischenspeicherung zu konfigurieren und festzulegen, wie Sie SQLAnfangsdatenanweisungen von Datenquellen handhaben möchten.
Zwischenspeicherung
In Tableau Server veröffentlichte Ansichten sind interaktiv und verfügen manchmal über eine
Live-Verbindung zu einer Datenbank. Während Benutzer mit den Ansichten in einem
Webbrowser interagieren, werden die Daten, die abgefragt werden, im Cache gespeichert.
Bei nachfolgenden Besuchen werden die Daten aus diesem Cache abgerufen, wenn sie
verfügbar sind.Sie konfigurieren die Aspekte der Zwischenspeicherung, die für alle
Datenverbindungen gelten, auf der Registerkarte "Datenverbindungen".
- 118 -
Zur Konfiguration der Zwischenspeicherung wählen Sie eine der folgenden Optionen: :
l
l
l
Refresh Less Often (Weniger häufig aktualisieren): Daten werden
zwischengespeichert und wieder verwendet, sobald sie verfügbar sind, unabhängig
davon, wann sie dem Cache hinzugefügt worden sind. Diese Option minimiert die
Anzahl von Abfragen, die an die Datenbank gesendet werden. Wählen Sie diese
Option, wenn Daten nicht häufig geändert werden. Weniger häufige Aktualisierungen
können die Leistung verbessern.
Balanced (Ausgewogen): Daten werden nach der angegebenen Anzahl von Minuten
aus dem Zwischenspeicher gelöscht. Wenn die Daten innerhalb des angegebenen
Zeitraums dem Cache hinzugefügt worden sind, dann werden die
zwischengespeicherten Daten verwenden, andernfalls werden neue Daten aus der
Datenbank abgefragt.
Refresh More Often (Häufiger aktualisieren): Die Datenbank wird jedes Mal, wenn
eine Seite geladen wird, neu abgefragt. Die Daten werden zwischengespeichert und
wiederverwendet, bis der Benutzer die Seite neu lädt. Diese Option stellt sicher, dass
die Benutzer die aktuellsten Daten sehen, kann jedoch die Leistung beeinträchtigen.
- 119 -
Unabhängig davon, wie die Zwischenspeicherung konfiguriert wird, kann der
Benutzer in der Symbolleiste auf die Schaltfläche Daten abrufen klicken, um den
Server zu zwingen, eine Abfrage zu senden und neue Daten abzurufen.
SQL-Anfangsdaten
Bei Ansichten, die eine Verbindung mit Teradata-Datenquellen herstellen, können die Ersteller
von Arbeitsmappen einen SQL-Befehl angeben, der einmal beim Laden der Arbeitsmappe in
den Browser ausgeführt wird. Dieser Befehl wird hier als SQL-Anfangsdaten bezeichnet. Aus
Sicherheitsgründen oder um die Leistung nicht zu beeinträchtigen, können Administration
diese Funktion deaktivieren. Sie gehen dazu auf der Registerkarte Datenverbindungen wie
folgt vor: Um die Funktion der SQL-Anfangsdaten zu deaktivieren, aktivieren Sie das Kontrollkästchen
SQL-Anfangsdatenanweisungen für alle Datenquellen ignorieren. Arbeitsmappen, die
mit SQL-Anfangsdatenanweisungen erstellt wurden, werden geöffnet, doch die SQLAnfangsdatenbefehle werden nicht gesendet.
Warnungen und Abonnements
Tableau Server kann Ihnen im Fall eines Systemfehlers eine E-Mail-Warnung senden und EMail-Abonnements an Tableau Server-Benutzer mit Momentaufnahmen ihrer favorisierten
- 120 -
Ansichten senden. Auf der Registerkarte Warnungen und Abonnements können Sie den
SMTP-Server festlegen, den Tableau Server für das Versenden von E-Mails verwendet.
Verschlüsselte SMTP-Verbindungen werden weder für Warnungen noch für
Abonnements unterstützt.
Konfigurieren von E-Mail-Warnungen
Wenn Sie Warnungen konfigurieren, sendet Tableau Server bei jedem Anhalten oder
Neustart der Daten-Engine-, Repository- oder Gateway-Serverprozesse eine E-Mail an die
unter E-Mail senden an angegebenen Empfänger.Im Falle einer Einzelserver-Installation
(alle Prozesse auf dem gleichen Computer), bedeuten HERUNTERGEFAHRENWarnungen, dass der gesamte Server angehalten wurde und nachfolgende
HOCHGEFAHREN-E-Mail-Warnungen, dass der Server wieder läuft. Wenn Sie eine verteilte
Installation ausführen, die für Failover konfiguriert wurde (siehe Konfigurieren für Failover
und mehrere Gateways Auf Seite 164) bedeutet eine HERUNTERGEFAHREN-Warnung,
dass die aktive Repository- oder Daten-Engine-Instanz fehlgeschlagen ist und nachfolgende
HOCHGEFAHREN Warnungen, dass die Standby-Instanz für diesen Prozess übernommen
hat und aktiv ist.
So konfigurieren Sie eine E-Mail-Warnung:
1. Wählen Sie E-Mail-Warnungen bei Problemen mit Serverstatus senden.
2. Geben Sie unter SMTP-Server den Namen Ihres SMTP-Servers ein. Geben Sie
Benutzername und Kennwort für das SMTP-Serverkonto ein, falls es erforderlich ist
(je nach Server unterschiedlich). Der Standardwert für den SMTP-Port ist 25. Geben
Sie unter E-Mail senden von die E-Mail-Adresse ein, von der bei einem Systemausfall
eine Warnmeldung gesendet wird. Die eingegebene E-Mail-Adresse muss zwar über
eine gültige Syntax verfügen (z. B. [email protected] or noreply@myco), es muss
sich jedoch nicht um ein aktives E-Mail-Konto auf Tableau Server handeln.
- 121 -
Lassen Sie das Kontrollkästchen TLS aktivieren unmarkiert, damit die Verbindung mit
Ihrem Mailserver nicht verschlüsselt wird.
3. Geben Sie unter E-Mail senden an mindestens eine E-Mail-Adresse ein, die die
Warnmeldung erhält. Trennen Sie bei Eingabe mehrerer E-Mail-Adressen die Adressen
durch ein Komma, nicht ein Semikolon.
4. Klicken Sie auf OK. Wenn Sie Starten Sie den Server ausführen, wird eine E-MailWarnung ausgelöst zur Bestätigung, dass Sie die Warnungen ordnungsgemäß
eingerichtet haben.
Konfigurieren von E-Mail-Abonnements
Gehen Sie wie folgt vor, um einen SMTP-Server für das Versenden von E-Mail-Abonnements
einzurichten:
1. Wählen Sie E-Mail-Abonnements aktivieren.
2. Geben Sie unter SMTP-Server den Namen Ihres SMTP-Servers ein. Geben Sie
Benutzername und Kennwort für das SMTP-Serverkonto ein, falls es erforderlich ist
(je nach Server unterschiedlich). Der Standardwert für den SMTP-Port ist 25. Geben
Sie unter E-Mail senden von die E-Mail-Adresse ein, von der Abonnements an
Tableau Server-Benutzer gesendet werden sollen.
Die eingegebene E-Mail-Adresse muss zwar über eine gültige Syntax verfügen (z. B.
<text>@<text>, wie [email protected] oder noreply@myco), es muss
sich jedoch nicht um ein aktives E-Mail-Konto auf Tableau Server handeln (dennoch
kann es bei einigen SMTP-Servern notwendig sein, dass es sich um ein aktives E-Mail-
- 122 -
Konto handelt). Sie können diese systemweite Adresse für E-Mail senden von auf
Site-Basis für Abonnements überschreiben. Weitere Informationen hierzu finden Sie
unter Hinzufügen oder Bearbeiten von Sites Auf Seite 222.
Lassen Sie das Kontrollkästchen TLS aktivieren unmarkiert, damit die Verbindung mit
Ihrem Mailserver nicht verschlüsselt wird.
3. Geben Sie unter Tableau Server-URL entweder http:// oder https:// ein,
gefolgt vom Namen des Tableau Servers. Dieser Name wird in den Abonnement-EMails als Fußzeile verwendet.
4. Klicken Sie auf OK.
SSL
Sie können Tableau Server so konfigurieren, dass der gesamte HTTP-Datenverkehr eine auf
SSL (Secure Socket Layer)-Ebene verschlüsselte Kommunikation ist. Durch die Einrichtung
von SSL wird erreicht, dass der Zugriff auf Tableau Server sicher ist und dass vertrauliche
Daten, die zwischen dem Webbrowser und dem Server oder Tableau Desktop und dem
Server übertragen werden, geschützt sind. Die Vorgehensweise zur Konfiguration des
Servers für SSL werden im nachstehenden Thema beschrieben. Sie müssen allerdings erst
ein Zertifikat von einer vertrauenswürdigen Zertifizierungsstelle erwerben und die
Zertifikatsdateien in Tableau Server importieren. Wenn Sie einen Tableau Server-Cluster
betreiben und SSL verwenden möchten, finden Sie unter Konfigurieren von SSL für einen
Cluster Auf Seite 125 weitere Empfehlungen.
Konfigurieren von SSL
So konfigurieren Sie Tableau Server für die Verwendung von SSL:
- 123 -
1. Erwerben Sie von einer vertrauenswürdigen Zertifizierungsstelle (z. B. Verisign,
Thawte, Comodo, GoDaddy usw.) ein Apache SSL-Zertifikat. Sie können auch ein von
Ihrem Unternehmen ausgestelltes internes Zertifikat verwenden. Platzhalterzertifikate,
die es Ihnen ermöglichen, SSL mit vielen Hostnamen innerhalb der gleichen Domäne zu
verwenden, werden ebenfalls unterstützt.
Bei einigen Browsern müssen zur Annahme von Zertifikaten von bestimmten Anbietern
zusätzliche Konfigurationsschritte ausgeführt werden. Schlagen Sie dazu in der
Dokumentation nach, die von der Zertifizierungsstelle bereitgestellt wurde.
2. Platzieren Sie Zertifikatdateien in einem Ordner mit dem Namen "SSL", wie der Ordner
8.3 auf Tableau Server. Beispiel:
C:\Program Files\Tableau\Tableau Server\SSL
Dieser Speicherort gibt dem Konto, unter dem Tableau Server ausgeführt wird, die
notwendigen Berechtigungen für die Dateien.
3. Öffnen Sie das Dienstprogramm zur Tableau Server-Konfiguration, indem Sie im
Startmenü Start > Alle Programme > Tableau Server 8.3 > Tableau Server
konfigurieren auswählen.
4. Wählen Sie im Dialogfeld "Tableau Server-Konfiguration" die Registerkarte SSL aus.
5. Wählen Sie SSL für die Serverkommunikation verwenden, und geben Sie den
Speicherort der folgenden Zertifikatsdateien an:
SSL-Zertifikatsdatei: Muss ein gültiges PEM-codiertes x509-Zertifikat mit der
Erweiterung CRT enthalten.
SSL-Zertifikatsschlüsseldatei: muss einen gültigen RSA- oder DSA-Schlüssel mit
einer eingebetteten Passphrase enthalten, der nicht kennwortgeschützt ist und über die
Dateinamenerweiterung .key verfügt.
SSL-Zertifikatskettendatei (Optional): Einige Zertifikatsanbieter stellen zwei
Zertifikate für Apache aus. Das zweite Zertifikat ist eine Kettendatei, die einer
Verkettung aller Zertifikate entspricht, die die Zertifikatskette für das Serverzertifikat
bilden. Alle Zertifikate in der Datei müssen x509 PEM-codiert sein, und die Datei muss
die Erweiterung .crt (nicht .pem) haben.
- 124 -
6. Klicken Sie auf OK. Die Änderungen werden beim nächsten Serverneustart wirksam.
Wenn der Server für SSL konfiguriert worden ist, akzeptiert er Anforderungen am NichtSSL-Port (standardmäßig Port 80) und leitet diese automatisch zum SSL-Port 443 um.
SSL-Fehler werden im Installationsordner unter dem folgenden Speicherort
protokolliert. Verwenden Sie dieses Protokoll zur Behebung von Validierungs- und
Verschlüsselungsproblemen.
C:\ProgramData\Tableau\Tableau
Server\data\tabsvc\logs\httpd\error.log
Tableau Server unterstützt als sicheren Port nur Port 443.Das Programm kann
nicht auf Computern ausgeführt werden, auf denen eine andere Anwendung
Port 443 verwendet.
Konfigurieren von SSL für einen Cluster
Sie können einen Tableau Server-Cluster so konfigurieren, dass SSL verwendet wird.
Wenn der primäre Tableau Server der einzige Datenknoten ist, auf dem der GatewayProzess ausgeführt wird (das ist die Standardoption), muss SSL nur dort konfiguriert
werden. Die dazu erforderlichen Schritte sind weiter oben beschrieben.
- 125 -
SSL und mehrfache Gateways
Ein Tableau Server-Cluster mit hoher Verfügbarkeit kann mehrere Gateways
einschließen, vor die ein Lastenausgleichsmodul geschaltet ist (weitere Informationen).
Beim Konfigurieren dieses Clustertyps für SSL haben Sie zwei Wahlmöglichkeiten:
l
l
Konfigurieren des Lastenausgleichs für SSL: Der Datenverkehr zwischen
den Client-Webbrowsern und dem Lastenausgleichsmodul ist verschlüsselt. Der
Datenverkehr vom Lastenausgleichsmodul zu den Tableau Server-GatewayProzessen ist nicht verschlüsselt. In Tableau Server ist keine SSL-Konfiguration
notwendig, da der Vorgang vom Lastenausgleichsmodul erledigt wird.
Konfigurieren von Tableau Server für SSL: Der Datenverkehr von den
Client-Webbrowsern zum Lastenausgleichsmodul und vom
Lastenausgleichsmodul zu den Tableau Server-Gateway-Prozessen ist
verschlüsselt. Weitere Details können Sie dem unten beschriebenen Verfahren
entnehmen.
Konfigurieren eines Server-Clusters für SSL
Beim Konfigurieren eines Tableau Server-Clusters für die Verwendung von SSL legen
Sie das SSL-Zertifikat und die Schlüsseldateien auf jedem Computer ab, auf dem ein
Gateway-Prozess ausgeführt wird. So konfigurieren Sie ein Tableau Server-Cluster für
die Verwendung von SSL:
1. Konfigurieren Sie den Lastenausgleich für SSL-Passthrough. Schlagen Sie dazu
in der Dokumentation für das Lastenausgleichsmodul nach.
2. Vergewissern Sie sich, dass das SSL-Zertifikat, das Sie verwenden, auf den
Hostnamen des Lastenausgleichsmoduls ausgestellt wurde.
3. Konfigurieren Sie den primären Tableau Server, wie oben beschrieben.
4. Legen Sie dasselbe SSL-Zertifikat und dieselbe Schlüsseldatei, das bzw. die Sie
für den primären Server verwendet haben, auch auf jedem Tableau WorkerRechner ab, auf dem ein Gateway-Prozess ausgeführt wird. Verwenden Sie den
gleichen Ordnerpfad auf den Worker-Rechnern wie auf dem primären Server.
Auf den Worker-Rechnern sind keine weiteren Konfigurationen erforderlich.
Dies lässt sich an einem Clusterbeispiel mit einem primären Tableau Server und
drei Worker-Rechnern zeigen. Die Gateway-Prozesse werden auf dem primären
Server und auf Worker 2 und Worker 3 ausgeführt. In diesem Fall konfigurieren
Sie den primären Tableau Server für SSL, dann kopieren Sie dasselbe SSLZertifikat und die dieselben Schlüsseldateien auf Worker 2 und Worker 3. Da sich
diese Dateien auf dem primären Server im Ordner
C:\Programme\Tableau\Tableau Server\SSL befinden, müssen Sie auch auf
Worker 2 und Worker 3 an derselben Stelle abgelegt werden.
SAML
Sie können Tableau Server so konfigurieren, dass ein externer Identitätsprovider zum
Authentifizieren von Tableau Server-Benutzern über SAML verwendet wird. Die gesamte
Benutzerauthentifizierung erfolgt außerhalb von Tableau, unabhängig davon, ob Sie Active
- 126 -
Directory oder die lokale Authentifizierung in Tableau Server zur Verwaltung Ihrer
Benutzerkonten in Tableau Server verwenden. Dies ermöglicht Ihnen, eine Single Sign-OnUmgebung (einmaliges Anmelden) für alle Anwendungen in Ihrem Unternehmen
bereitzustellen.
Bevor Sie Tableau Server für SAML konfigurieren, stellen Sie sicher, dass die SAMLAnforderungen Auf Seite 285 erfüllt sind.
Konfigurieren von SAML
So konfigurieren Sie Tableau Server für die Verwendung von SAML:
1. Speichern Sie die Zertifikatsdateien in einem Ordner mit der Bezeichnung "SAML",
parallel zum Tableau Server 8.3-Ordner. Beispiel:
C:\Program Files\Tableau\Tableau Server\SAML
Dieser Speicherort gibt dem Konto, unter dem Tableau Server ausgeführt wird, die
notwendigen Berechtigungen für die Dateien.
2. Die SAML-Konfiguration wird auf der Registerkarte SAML vorgenommen, die beim
Setup von Tableau Server angezeigt wird. Wenn Sie SAML nach dem Setup
konfigurieren, greifen Sie auf die Registerkarte "SAML" zu, indem Sie das
Dienstprogramm zur Tableau Server-Konfiguration öffnen (Start > Alle Programme >
Tableau Server 8.3 > Tableau Server konfigurieren) und auf die Registerkarte
SAML klicken.
3. Wählen Sie auf der Registerkarte "SAML" die Option SAML für einmaliges
Anmelden verwenden, und geben Sie die folgenden Speicherorte an:
Tableau Server-Rückgabe-URL: Die URL, auf die Benutzer von Tableau Server
zugreifen, z. B. http://tableau_server. Es wird davon abgeraten, http://localhost zu
verwenden, und URLs mit einem nachgestellten Schrägstrich (Beispiel: http://tableau_
server/) werden nicht unterstützt.
SAML-Entitäten-ID: Die Entitäten-ID, die die Tableau Server-Installation beim IdP
eindeutig identifiziert. Sie können hier erneut die Tableau Server-URL eingeben, dies
muss jedoch nicht sein.
SAML-Zertifikatdatei: Ein PEM-codiertes x509-Zertifikat mit der Erweiterung .crt.
Diese Datei wird von Tableau Server und nicht vom IdP verwendet.
SAML-Zertifikatsschlüsseldatei: Ein RSA- oder DSA-Schlüssel, der nicht
kennwortgeschützt ist und die Dateinamenerweiterung .key aufweist. Diese Datei wird
von Tableau Server und nicht vom IdP verwendet.
4. Lassen Sie das Textfeld IdP-Metadatendatei zunächst leer, und klicken Sie auf
Metadatendatei exportieren.
- 127 -
5. Es wird ein Dialogfeld geöffnet, in dem Sie die SAML-Einstellungen für Tableau Server
als XML-Datei speichern können. An diesem Punkt sind die Metadaten des
Identitätsproviders noch nicht eingeschlossen.
Speichern Sie die XML-Datei unter einem beliebigen Namen.
6. Gehen Sie auf der Website Ihres Identitätsproviders oder der entsprechenden
Anwendung wie folgt vor:
l
l
Fügen Sie Tableau Server als Dienstanbieter hinzu. Informationen hierzu finden
Sie in der Dokumentation Ihres Identitätsproviders. Hierbei importieren Sie auch
die Datei, die Sie in Schritt 5 gespeichert haben.
Überprüfen Sie, dass der Identitätsprovider username als Attributelement für die
Verifizierung verwendet
7. Exportieren Sie die Metadaten-XML-Datei des Identitätsproviders, während Sie sich
noch in dessen Anwendung oder auf der Website befinden.
8. Kopieren Sie die Metadaten-XML-Datei des Identitätsproviders in den folgenden Ordner
auf dem Computer mit Tableau Server:
C:\Program Files\Tableau\Tableau Server\SAML
9. Geben Sie im Dialogfeld "Tableau Server-Konfiguration" auf der Registerkarte "SAML"
den Speicherort der Datei in das Textfeld SAML IdP-Metadatendatei ein:
- 128 -
10. Klicken Sie auf "OK". Tableau Server ist jetzt für die SAML-Authentifizierung
konfiguriert.
So konfigurieren Sie ein Server-Cluster für SAML
Beim Konfigurieren eines Tableau Server-Clusters für die Verwendung von SAML legen Sie
das gleiche SAML-Zertifikat und die SAML IdP-Metadatendateien auf jedem Computer ab, auf
dem der Tableau-Anwendungsserverprozess ausgeführt wird (wird auch als wgserver
bezeichnet). So konfigurieren Sie ein Tableau Server-Cluster für die Verwendung von SAML:
1. Konfigurieren Sie den primären Tableau Server, wie oben beschrieben.
2. Legen Sie dasselbe SAML-Zertifikat, dieselbe SAML-Schlüsseldatei und die SAML IdPMetadatendateien, das bzw. die Sie für den primären Server verwendet haben, auch
auf jedem TableauWorker-Rechner ab, auf dem ein Anwendungsserverprozess
ausgeführt wird. Verwenden Sie den gleichen Ordnerpfad auf den Worker-Rechnern
wie auf dem primären Server. Auf den Worker-Rechnern sind keine weiteren
Konfigurationen erforderlich.
Dies lässt sich an einem Clusterbeispiel mit einem primären Tableau Server und drei
Worker-Rechnern zeigen. Die Anwendungsserverprozesse werden auf dem primären
Server und auf Worker 2 und Worker 3 ausgeführt. In diesem Fall konfigurieren Sie den
primären Tableau Server für SAML, dann kopieren Sie dasselbe SAML-Zertifikat, die
SAML-Schlüsseldatei und die SAML IdP-Metadatendateien auf Worker 2 und Worker 3.
Da sich diese Dateien auf dem primären Server im Ordner C:\Program
Files\Tableau\Tableau Server\SAML befinden, müssen Sie auch auf Worker 2 und
Worker 3 an derselben Stelle abgelegt werden.
- 129 -
Testen der Konfiguration
Testen Sie die SAML-Konfiguration, indem Sie eine neue Browserinstanz öffnen und den
Namen von Tableau Server in das URL-Fenster eingeben:
Beachten Sie hierbei, dass die angezeigte Anmeldeaufforderung von Ihrem Identitätsprovider
und nicht von Tableau Server stammt:
Konfigurieren von Kerberos
Sie können Tableau Server für die Verwendung von Kerberos konfigurieren. Dies ermöglicht
Ihnen, eine Single Sign-On-Umgebung (einmaliges Anmelden) für alle Anwendungen in Ihrem
Unternehmen bereitzustellen.
Bevor Sie Tableau Server für Kerberos konfigurieren:
l
l
l
Führen Sie vor der Konfiguration von Kerberos die Ersteinrichtung von Tableau Server
aus, einschließlich der Konfiguration für die Active Directory-Authentifizierung und eines
AD-Dienstkontos.
Dabei müssen die Kerberos-Anforderungen Auf Seite 295 erfüllt sein.
Wenn Sie Kerberos zur Authentifizierung bei MS SQL oder MSAS oder zur Delegierung
für einmaliges Anmelden bei Cloudera Impala verwenden, müssen Sie das Konto "Als
Benutzer ausführen" für die Ausführung als Teil des Betriebssystems aktivieren. Wei-
- 130 -
tere Informationen finden Sie unter Ermöglichen, dass das Konto "Als Benutzer
ausführen" als Betriebssystem agiert Auf Seite 300.
Hinweis:Wenn Sie einen externen Lastenausgleich oder einen Reverse-Proxy
verwenden, müssen Sie diese Konfiguration vor der Konfiguration von Kerberos
ausführen. Andernfalls verwendet das vom Tableau ServerKonfigurationsdienstprogramm generierte Konfigurationsskript möglicherweise die
falschen Hostnamen. Weitere Informationen finden Sie unter Hinzufügen eines
Lastenausgleichs Auf Seite 171 und Konfigurieren von Tableau für die
Verwendung eines Proxyservers Auf Seite 352.
Konfigurieren von Kerberos
1. Konfigurieren Sie Kerberos auf der Registerkarte Kerberos des
Konfigurationsdienstprogramms von Tableau Server. Öffnen Sie das
Konfigurationsdienstprogramm von Tableau Server (Start > Alle Programme >
Tableau Server 8.3 > Tableau Server konfigurieren), und klicken Sie auf die
Registerkarte Kerberos.
2. Wählen Sie auf der Registerkarte Kerberos die Option Kerberos für einmaliges
Anmelden aktivieren.
3. Klicken Sie auf Kerberos-Konfigurationsskript exportieren, um das Batch-Skript zu
generieren, mit dem Sie Active Directory für die Verwendung von Kerberos mit Tableau
Server konfigurieren können.
Das Konfigurationsskript konfiguriert Ihre Active Directory-Domäne für die Verwendung
von Kerberos mit Tableau Server. Weitere Informationen finden Sie unter KerberosKonfigurationsskript Auf Seite 299.
Hinweis: Überprüfen Sie die Hostnamen auf den setspn-Zeilen des Skripts.
Wenn Sie einen externen Lastenausgleich oder einen Reverse-Proxy verwenden
und die Hostnamen mit dem Namen übereinstimmen sollen, den Sie bei der
Konfiguration von Tableau Server für den Lastenausgleich oder Proxy verwendet
haben. Wenn Sie Tableau Server nicht für Ihren Proxy oder einen externen
Lastenausgleich konfiguriert haben, holen Sie das nach, und exportieren Sie das
- 131 -
Kerberos-Konfigurationsskript erneut, um sicherzustellen, dass es die richtigen
Hostnamen enthält.
4. Bitten Sie Ihren Active Directory-Domänenadministrator, das Konfigurationsskript
auszuführen, um Service Principal Names (SPNs) und die .keytab-Datei zu erstellen.
Der Domänenadministrator muss das Skript an der Eingabeaufforderung eines
beliebigen Computers in der Domäne ausführen. Das Skript sollte gelesen werden, um
die enthaltenen Werte zu überprüfen, und durch Eingabe des Skriptnamens an einer
Eingabeaufforderung ausgeführt werden (nicht durch Doppelklicken auf das Skript in
Windows Explorer). Das Skript erstellt die Datei kerberos.keytab im Ordner
\keytabs des Verzeichnisses, in dem das Skript ausgeführt wurde.
5. Erstellen Sie eine Kopie der vom Skript erstellten .keytab-Datei, und speichern Sie diese
auf dem Computer mit Tableau Server. Geben Sie den Pfad zu der .keytab-Datei ein,
oder klicken Sie auf die Schaltfläche "Durchsuchen", um zu der Datei zu navigieren.
Wenn Sie auf OK klicken, um die Konfigurationsänderungen zu speichern, wird die
keytab-Datei in alle Gateway-Knoten der Tableau Server-Installation kopiert.
Hinweis:Benennen Sie die .keytab-Datei. Das Skript erstellt die Datei
kerberos.keytab, und Sie müssen sie unter diesem Namen speichern.
6. Sie können auch auf Konfiguration testen klicken, um zu überprüfen, ob Ihre
Umgebung ordnungsgemäß für die Verwendung von Kerberos mit Tableau Server
konfiguriert ist.
Wenn SPNs ordnungsgemäß konfiguriert sind, wird "OK"angezeigt. Die Anzahl der für
die Kerberos-Delegierung konfigurierten Datenquelle wird angegeben. Wenn Sie keine
Datenquelle für die Kerberos-Delegierung konfiguriert haben, wird "0" angezeigt.
7. Klicken Sie auf OK, um die Kerberos-Konfiguration zu speichern.
Testen der Konfiguration
Wenn Tableau Server erneut gestartet wurde, testen Sie die Kerberos-Konfiguration in einem
Webbrowser auf einem anderen Computer, indem Sie den Namen des Tableau Server im
URL-Fenster eingeben:
- 132 -
Sie sollten automatisch bei Tableau Server authentifiziert werden.
Hinzufügen eines Administratorkontos
Der letzte Schritt zur Aktivierung von Tableau Server besteht im Hinzufügen eines
Administratorkontos. Der Administrator hat uneingeschränkten Zugriff auf den Server und
unter Anderem kann Benutzer, Gruppen und Projekte verwalten. Abhängig davon, ob Sie mit
Active Directory oder der lokalen Authentifizierung arbeiten, sind die Schritte zum Hinzufügen
eines Administratorkontos unterschiedlich.
Active Directory
Falls Sie Active Directory verwenden, müssen Sie den Benutzernamen und das Kennwort
für einen vorhandenen Active Directory-Benutzer eingeben, der als Administrator fungieren
soll. Klicken Sie dann auf Add user (Benutzer hinzufügen).
Hinweis:
Wenn sich das Administratorkonto in derselben Domäne wie der Server befindet, geben Sie
einfach den Benutzernamen ohne Domäne ein. Andernfalls sollten Sie auch den vollständig
qualifizierten Domänennamen angeben. Beispiel: test.lan\username.
Lokale Authentifizierung
- 133 -
Wenn Sie die lokale Authentifizierung verwenden, erstellen Sie ein Administratorkonto, indem
Sie einen Benutzernamen, einen Anzeigenamen und ein Kennwort Ihrer Wahl (zweimal)
eingeben. Klicken Sie dann auf Add user (Benutzer hinzufügen).
Neukonfigurieren des Servers
Die Eingabe der Tableau Server-Konfigurationseinstellungen ist Teil der Installation, doch Sie
können im Dialogfeld "Tableau Server-Konfiguration" auch später Änderungen vornehmen.
Weitere Informationen hierzu finden Sie in den folgenden Schritten. Sie können auch das
tabadmin Auf Seite 417 Befehlszeilenprogramm verwenden, um die
Konfigurationsänderungen vorzunehmen. Unabhängig davon, wie Sie die Änderung
eingeben, werden die neuen Einstellungen in die Konfigurationsdatei tabsvc.yml geschrieben,
die sich im Ordner config befindet.
Hinweis: Sie können nicht zwischen Active Directory und lokaler Authentifizierung hin- und
herwechseln. Diese Optionen können nur während der Installation konfiguriert werden.
Gehen Sie wie folgt vor, um eine Einstellung im Dialogfeld "Tableau Server-Konfiguration" zu
ändern:
1. Halten Sie den Server an, indem Sie im Startmenü von Windows Alle Programme >
Tableau Server 8.3 > Tableau Server anhalten auswählen.
2. Wählen Sie nun im Windows-Startmenü Configure Tableau Server (Tableau Server
konfigurieren) aus.
3. Wenn Sie ein Active Directory-Konto als Serverkonto "Run As User" (Als Benutzer
ausführen) verwenden, geben Sie das Kennwort auf der Registerkarte General
(Allgemein) ein.
4. Nehmen Sie die Konfigurationsänderungen vor.
- 134 -
5. Klicken Sie auf OK.
6. Starten Sie den Server, indem Sie im Startmenü von Windows Alle Programme >
Tableau Server 8.3 > Tableau Server starten auswählen.
Neukonfigurieren von Prozessen
Führen Sie die unten beschriebenen Schritte aus, um zu ändern, wie Prozesse für eine
einzelne Serverinstallation konfiguriert werden. Anweisungen zum Ändern, wie Prozesse für
einen Arbeitscomputer konfiguriert werden, finden Sie unter Installieren und Konfigurieren
von Arbeitsservern Auf Seite 153.
1. Bevor Sie Änderungen an dieser Konfiguration vornehmen können, müssen Sie
Tableau Server anhalten. Klicken Sie im Startmenü auf Alle Programme > Tableau
Server 8.3 > Tableau Server anhalten.
2. Öffnen Sie das Dialogfeld "Tableau Server-Konfiguration" über das Startmenü, indem
Sie zu Alle Programme > Tableau Server 7.0 8.3 > Tableau Server konfigurieren
navigieren.
3. Geben Sie, sofern erforderlich, Ihr Kennwort auf der Registerkarte Allgemein ein, und
klicken Sie dann auf die Registerkarte Server:
4. Markieren Sie Dieser Computer und klicken Sie dann auf Bearbeiten:
- 135 -
5. Im Dialogfeld "Tableau Server bearbeiten" können Sie die Anzahl der Prozesse ändern:
6. Sie können bis zu jeweils acht Instanzen der VizQL-, Anwendungsserver-, Datenserveroder Hintergrundprozesse ausführen. Dieser Grenzwert kann bei Bedarf jedoch
geändert werden. Weitere Informationen hierzu finden Sie unter Info zum
Serverprozess-Limit Auf Seite 148. Tableau Server kann nur funktionieren, wenn
immer eine aktive Instanz der Daten-Engine und das Repository vorhanden sind.
Anweisungen, wie sie auf einen anderen Computer verschoben werden können, finden
Sie unter Verschieben der Daten-Engine und Repository-Prozesse Auf Seite 147.
Anweisungen zum Konfigurieren von Standby-Instanzen aus ihnen finden Sie unter
Hochverfügbarkeit Auf Seite 158.
Klicken Sie nach der Vornahme Ihrer Änderungen auf "OK". Klicken Sie dann erneut auf
"OK", um das Konfigurationsdialogfeld zu beenden.
- 136 -
7. Starten Sie Tableau Server erneut. Klicken Sie im Startmenü auf Alle Programme >
Tableau Server 8.3 > Tableau Server starten.
Tableau Server-Prozesse
Die Standardkonfiguration der sechs vorhandenen Tableau-Serverprozesse kann geändert
werden, um andere Ergebnisse zu erzielen. Die Themen Verbessern der Serverleistung
Auf Seite 308 und Hochverfügbarkeit Auf Seite 158 beschreiben einige der möglichen
Ansätze. Der oberste Status eines jeden Prozesses wird auf der Wartungsseite des Servers
angezeigt. Weitere Einzelheiten zu einigen Prozessen, wie z B. dem Hintergrundprozess, sind
unter Verwaltungsansichten Auf Seite 265 zu finden.
Im Hinblick auf die Architektur verwendet die 64-Bit-Version von Tableau Server native 64-BitProzesse; die 32-Bit-Version von Tableau Server verwendet 32-Bit-Prozesse. Die Ausnahme
ist die Daten-Engine. Wenn die 32-Bit-Version von Tableau Server unter einem 64-BitBetriebssystem installiert wird, wird die 64-Bit-Version des Daten-Engine-Prozesses
verwendet.
Informationen zu den mit diesen Prozessen erstellten Dateien finden Sie unter Speicherorte
von Server-Protokolldateien Auf Seite 461.
Multithreade Leistungsmerkmale
d?
Anwendungsser wgserver.exe Handhabt die
Ja
Verbraucht nur während
ver
Webanwendung,
seltener Vorgänge, wie z. B
unterstützt
beim Veröffentlichen einer
Navigation und
Arbeitsmappe mit einem
Suche.
Extrakt oder beim Erstellen
eines statischen Bildes für
eine Ansicht, eine auffällige
Menge von Ressourcen.
Seine Auslastung kann
durch browserbasierte
Interaktion oder durch
tabcmd erstellt werden.
Hintergrund
backgrounder. Führt
Nein
Ein Singlethread-Prozess,
exe
Serveraufgaben
bei dem mehrere Prozesse
aus, darunter
auf einem beliebigen oder
Extraktaktualisierun
auf allen Computern im
gen, "Jetzt
Cluster ausgeführt werden
ausführen"können, um die Kapazität
Aufgaben und über
zu erweitern. Die
tabcmd gestartete
Hintergrundprozesskompo
Aufgaben
nente verbraucht
gewöhnlich nicht viel
Prozessspeicher, kann
Prozess
Dateiname
Zweck
- 137 -
Prozess
Daten-Engine
Dateiname
Multithreade
d?
Zweck
tdeserver64.ex Speichert
e
Datenextrakte und
tdeserver.exe beantwortet
Abfragen.
- 138 -
Ja
Leistungsmerkmale
jedoch je nach der ihr
präsentierten
Arbeitsauslastung CPU-,
I/O- oder
Netzwerkressourcen
verbrauchen.
Beispielsweise kann beim
Durchführen großer
Extrakt-Aktualisierungen
zum Abruf von Daten
Netzwerkbandbreite
verwendet werden. CPURessourcen können durch
Datenabruf- oder komplexe
tabcmd-Aufgaben
verbraucht werden.
Die Arbeitsauslastung der
Daten-Engine wird durch
Anforderungen von dem
VizQL-Server-Vorgang
generiert. Es handelt sich
um die Komponente, die
Extrakte in den Speicher
lädt und Abfragen an ihnen
durchführt. Der
Speicherverbrauch basiert
hauptsächlich auf der
Größe der zu ladenden
Datenextrakte. Unter 64Bit-Betriebssystemen wird
standardmäßig die 64-BitBinärdatei verwendet,
selbst wenn die 32-BitVersion von Tableau Server
installiert ist. Die DatenEngine ist multithreaded
und kann mehrere
Anforderungen gleichzeitig
handhaben. Bei hoher
Auslastung kann sie CPU-,
I/O- und
Prozess
Dateiname
Multithreade
d?
Zweck
Datenserver
dataserver.exe Handhabt
Verbindungen zu
Tableau ServerDatenquellen.
Ja
Repository
postgres.exe
VizQL Server
vizqlserver.exe Lädt und stellt
Ja
Ansichten dar,
berechnet und führt
Abfragen durch
In der Datenbank
k. A.
von Tableau Server
werden
Arbeitsmappen- und
Benutzer-Metadaten
gespeichert.
- 139 -
Leistungsmerkmale
Netzwerkressourcen
verbrauchen, was zu einem
Leistungsengpass führen
kann. Bei hoher Auslastung
kann eine einzige Instanz
der Daten-Engine sämtliche
CPU-Ressourcen zur
Verarbeitung von
Anforderungen in Anspruch
nehmen.
Da es sich um einen Proxy
handelt, ist er
normalerweise nur durch
das Netzwerk gebunden,
kann bei einer gewissen
Anzahl von gleichzeitigen
Benutzersitzungen jedoch
durch die CPU gebunden
sein. Seine Auslastung wird
durch browser- und
Tableau-Desktop-basierte
Interaktion und ExtraktAktualisierungsaufgaben
für Tableau ServerDatenquellen generiert.
Verbraucht in der Regel
wenige Ressourcen. In
seltenen Fällen kann es bei
sehr großen
Bereitstellungen (mit
Tausenden von Benutzern)
zu einem Engpass
kommen, während
Vorgänge wie die Ansicht
aller Arbeitsmappen nach
Benutzer oder das Ändern
von Berechtigungen
durchgeführt werden.
Verbraucht beim Laden von
Ansichten und bei der
interaktiven Verwendung
Prozess
Dateiname
Multithreade
d?
Zweck
Leistungsmerkmale
über einen Webbrowser
eine auffällige Menge von
Ressourcen. Kann CPUgebunden, E/A-gebunden
oder netzwerkgebunden
sein. Die
Prozessauslastung kann
nur durch browserbasierte
Interaktion erstellt werden.
Es kann sein, dass der
Prozessarbeitsspeicher
nicht ausreicht.
Info zum Serverprozess-Limit
Die Serverprozesse wgserver, data engine, data server und VizQL sind multithreaded und
mehrfach verarbeitet. Auf einer einzelnen Prozessinstanz können daher mehr als 16 Threads
gleichzeitig laufen. Tableau Server wird standardmäßig mit bis zu zwei Instanzen von jedem
Serverprozess installiert.
Wenn Sie die 64-Bit-Version von Tableau Server verwenden (ab Version 8.1 verfügbar),
sollten Sie nicht mehr als zwei Instanzen eines Prozesses ausführen.
Wenn Sie die 32-Bit-Version von Tableau Server verwenden und die
Standardeinstellungen nicht ausreichend sind, können Sie sie während der Installation (nur bei
Upgrades) oder nach der Installation mithilfe des Dialogfelds "Konfiguration" auf bis zu acht
Instanzen abändern.Acht Prozessinstanzen sind die Standardobergrenze. Wenn Ihr
Computer über genügend Arbeitsspeicher (RAM) und CPU-Core-Prozessoren verfügt,
können Sie dieses obere Limit über die Einstellung service.max_procs tabadmin ändern.
Tableau empfiehlt, dass auf dem Computer, auf dem die Prozesse ausgeführt werden, für jede
Prozessinstanz mindestens 1 GB Arbeitsspeicher und 1 logischer CPU-Core-Prozessor
vorhanden sein sollen.
So ändern Sie die maximale Anzahl zulässiger Prozesse:
1. Nach der Installation halten Sie den Server an.
2. Vergewissern Sie sich, dass das bin-Verzeichnis von Tableau Server noch das aktuelle
Verzeichnis ist, und geben Sie den folgenden Befehl ein, wobei number für die
maximale Anzahl von Prozessinstanzen steht, die Sie zulassen möchten:
tabadmin set service.max_procs number
Beispiel:
- 140 -
tabadmin set service.max_procs 10
3. Starten Sie den Server, damit die Änderungen wirksam werden.
Upgrade auf 8.3
In den folgenden Themen erhalten Sie Informationen zum Upgrade der Tableau Server
Software auf Version 8.3. Wenn Sie ein Upgrade von einer früheren Version als 8.2
durchführen, wenden Sie sich bitte an den Tableau Kundensupport unter.
Checkliste vor dem Upgrade
Hier erhalten Sie Informationen zu den erforderlichen Schritten, die Sie vor einem Upgrade
von Tableau Server auf Version 8.3.x beachten und durchführen müssen.
Hinweis: Mit jeder Version von Tableau Server wird eine neue Version von tabcmd
veröffentlicht.Wenn Sie das Befehlszeilenprogramm auf Computern installiert haben,
auf denen Tableau Server nicht ausgeführt wird, müssen Sie auf diesen Computern
möglicherweise ein Upgrade von tabcmd ausführen, wenn Sie ein Upgrade von
Tableau Server ausführen. Weitere Informationen finden Sie unter Installieren von
tabcmd Auf Seite 395.
Anmeldeinformationen, Installationsdateien und Anpassungen
Stellen Sie vor einem Upgrade sicher, dass Sie über die folgenden Informationen verfügen:
l
l
l
Anmeldeinformationen für das Benutzerkonto: Sie benötigen für jeden Computer,
bei dem Sie ein Upgrade durchführen möchten, die Anmeldeinformationen für ein
Benutzerkonto mit lokalen Administratorberechtigungen.
RunAs-Kontoanmeldeinformationen: Stellen Sie sicher, dass Sie über den
Benutzernamen und das Kennwort für das Run As-Konto von Tableau Server verfügen.
Sofern Sie "NT AUTHORITY\NetworkService" (Standard) verwenden, ist ein Kennwort
nicht erforderlich.
Installationsdateien: Neben der EXE-Datei für das Upgrade, das Sie durchführen
möchten, müssen Sie auch über die EXE-Datei für die Installation der aktuell
verwendeten Serverversion verfügen bzw. diese möglicherweise erneut herunterladen
(siehe Herunterladen von Tableau-Produkten). So können Sie bei unerwarteten
Problemen während des Upgrade bei Bedarf schneller entsprechende
Wiederherstellungsoptionen nutzen.
Obwohl Tableau die Konfigurationseinstellungen während eines Upgrade beibehält,
empfehlen wir, dass Sie sich individuelle Anpassungen an den Einstellungen notieren, damit
Sie diese später überprüfen können. Beispiele hierfür sind das Konfigurieren von SSL,
Änderungen am Standardport von Tableau, Werte für Zeitüberschreitungen sowie die
Verwendung von benutzerdefinierten Logos. Wenn Sie Ihre derzeitige Tableau ServerVersion zur Windows-Umgebungsvariable PATH hinzugefügt haben, müssen Sie außerdem
- 141 -
diesen Eintrag nach dem Upgrade aktualisieren, damit er auf die neuere Version von Tableau
Server verweist.
Bit-Version
Ab Version 8.1 wird Tableau Server als native 64-Bit-Anwendung und als 32-Bit-Anwendung
bereitgestellt. Frühere Versionen von Tableau Server waren nur als 32-Bit-Versionen
verfügbar.
Wenn Sie zuvor die 32-Bit-Version von Tableau Server unter einem 64-Bit-Betriebssystem
ausgeführt haben, wird ein Upgrade auf die 64-Bit-Version von Tableau Server empfohlen.
Unter Vor der Installation... Auf Seite 110 finden Sie eine Übersicht über die
Mindestanforderungen.
Wenn Sie If you are upgrading a distributed installation of Tableau Server, the entire cluster
must run the same bit version—either all 32-bit or all 64-bit Tableau server software.When
upgrading from the 32-bit version of Tableau Server to the 64-bit version, you must first
uninstall the 32-bit version on each worker before installing the 64-bit version of the worker
software. Weitere Informationen dazu finden Sie unter Upgrade einer verteilten Tableau
Server-Installation von 32-Bit auf 64-Bit Auf Seite 146.
Überprüfen des Wartungsvertrags für Ihr Produkt
Wenn Sie ein Upgrade von Tableau Server auf einem Server ausführen möchten, dessen
Wartungsvertrag abgelaufen ist, führt dies zu einer nicht lizenzierten Instanz von Tableau
Server.
So können Sie feststellen, ob der Wartungsvertrag für Ihren Server abgelaufen ist:
l
Wählen Sie Start > Alle Programme > Tableau Server > Product Keys verwalten,
und überprüfen Sie die Spalte Wartungsvertrag läuft ab.
If your maintenance has expired, select the key and Klick Refresh. Wenn das Wartungsdatum
nicht aktualisiert wird, wenden Sie sich an den Tableau-Kundensupport. Die erneute
Aktivierung des Product Key ist Teil der Installation. Nähere Informationen hierzu finden Sie
unter Tableau aktivieren Auf Seite 113. Sollte für den Server keine Internetverbindung
vorliegen, finden Sie weitere Informationen hierzu unter Offline-Aktivieren von Tableau Auf
Seite 113.
- 142 -
Erstellen einer bereinigten Sicherung
Neben den regulären Tableau Server-Sicherungen ist es von Vorteil, wenn Sie vor dem
Upgrade eine zusätzliche Sicherung erstellen. Führen Sie vor dem Erstellen der Sicherung
den Befehl "tabadmin cleanup" aus, um alle unwichtigen Dateien von der Sicherung
auszuschließen. Weitere Informationen hierzu finden Sie unter Bereinigung durchführen und
Sichern der Tableau-Daten Auf Seite 447.
Nur verteilte Installationen: Arbeitscomputer vor dem Erstellen der Sicherung entfernen?
Die Tableau-Sicherungsdatei (.tsbak) enthält Konfigurationsinformationen und Daten. Daher
umfasst eine Sicherung einer verteilten Installation von Tableau Server
Konfigurationsinformationen zu den Arbeitscomputern, z. B. deren IP-Adressen. Wenn Sie
diese Informationen aus der Sicherung ausschließen möchten (etwa, weil Sie
Arbeitscomputer beim Upgrade auf neue Hardware migrieren), haben Sie dazu zwei
Möglichkeiten:
l
l
Entfernen Sie die Arbeitscomputer aus der Tableau Server-Konfiguration, bevor Sie die
Sicherung erstellen.
Verwenden Sie die Option --no-config, wenn Sie die Sicherungsdatei in Ihrer
neuen Installation wiederherstellen. Beachten Sie, dass bei dieser Option keine
Konfigurationseinstellungen wiederhergestellt werden – auch nicht die des primären
Tableau Servers.
Sollten Sie über eine verteilte Installation von Tableau Server mit Arbeitscomputern verfügen,
auf denen Windows XP oder Windows Server 2003 SP1 oder höher ausgeführt wird, müssen
Sie diese Computer aus der Konfiguration entfernen, bevor Sie mit dem Upgrade beginnen.
Diese Betriebssysteme werden in Version 8.3 nicht unterstützt. Windows Server 2003 R2 SP2
oder höher wird jedoch unterstützt.
So löschen Sie einen Arbeitscomputer aus der Tableau Server-Konfiguration:
1. Halten Sie den Server an (primärer Tableau Server).
2. Öffnen Sie auf dem primären Server das Dienstprogramm zur Konfiguration, indem Sie
im Startmenü Tableau Server <Version> > Tableau Server konfigurieren
auswählen.
3. Wählen Sie im Dialogfeld zur Konfiguration die Registerkarte Servers (Server) aus.
4. Wenn der Arbeitscomputer Extrakte und/oder das Repository hostet, verschieben Sie
diese Dienste auf einen anderen Computer. Informationen zur Vorgehensweise finden
- 143 -
Sie unter Verschieben der Daten-Engine und Repository-Prozesse Auf Seite 147.
5. Heben Sie nun den Arbeitscomputer hervor, und klicken Sie auf Löschen.
6. Klicken Sie auf OK.
7. Starten Sie den Server.
Bereinigung durchführen
Durch das Ausführen des Befehls "tabadmin cleanup" werden alle Dateien aus dem Tableau
Server-System entfernt, die für die Sicherungsdatei nicht erforderlich sind. Die Bereinigung
sollte einmal durchgeführt werden, wenn der Server ausgeführt wird, um auch die TableauDatenbank zu berücksichtigen. Dann sollte die Bereinigung ein zweites Mal durchgeführt
werden, wenn der Server angehalten wurde, damit Protokolldateien entfernt werden können.
So führen Sie den Befehl "tabadmin cleanup" aus:
1. Öffnen Sie als Administrator eine Eingabeaufforderung:
2. Navigieren Sie zum BIN-Ordner von Tableau Server. Beispiel:
cd “C:\Program Files (x86)\Tableau\Tableau Server\8.2\bin”
3. Stellen Sie sicher, dass der Server ausgeführt wird.
tabadmin status
4. Führen Sie die Bereinigung durch folgende Eingabe aus:
tabadmin cleanup
5. Halten Sie den Server an:
tabadmin stop
6. Führen Sie die Bereinigung erneut aus:
- 144 -
tabadmin cleanup
Stellen Sie sicher, dass der Server weiterhin angehalten ist, um eine Sicherung zu
erstellen (nächster Schritt).
Erstellen der Sicherungsdatei
Mit dem tabadmin-Befehl backup wird eine .tsbak-Datei erstellt. Diese Datei enthält
Informationen aus dem Repository, aus Datenextrakten und der Serverkonfiguration.
Speichern Sie diese Datei nach dem Erstellen auf einem separaten Computer. Informationen
zur Vorgehensweise finden Sie unter Sichern der Tableau-Daten Auf Seite 447. Wenn Sie
eine Sicherung mit Tableau Server Version 8.0 oder früher erstellen muss der Server
angehalten werden, bevor Sie eine Sicherung erstellen. Ab Version 8.1 kann die Sicherung
erstellt werden, ohne dass der Server angehalten werden muss.
Nur verteilte Installationen: Wenn Sie vor dem Erstellen der Sicherung
Arbeitscomputer aus der Serverkonfiguration entfernt haben und als Teil des Upgrades
nicht auf neue Hardware migrieren, können Sie die Arbeitscomputer nun wieder zur
Konfiguration hinzufügen. Befolgen Sie hierzu die Schritte unter Upgrade auf 8.3 oben.
Die Arbeitscomputer sollten jedoch aus der Konfiguration ausgeschlossen bleiben,
wenn Sie im Rahmen des Uprades auf neue Hardware migrieren. Weitere
Informationen erhalten Sie unter Migrieren auf neue Hardware Auf Seite 148.
Upgrade auf 8.3
Nachdem Sie die Schritte unter Checkliste vor dem Upgrade Auf Seite 141 durchgeführt
haben, können Sie wie folgt ein Upgrade Ihrer Installation von Tableau Server auf Version 8.3
durchführen. Wenn Sie im Rahmen des Upgrades eine Migration auf neue Hardware
durchführen, lesen Sie Migrieren auf neue Hardware Auf Seite 148 statt der unten
aufgeführten Verfahren.
Wenn Sie eine neuere Version von Tableau Server installieren, sollten Sie diese im gleichen
Laufwerk oder Verzeichnis wie die vorherige Version installieren. Dadurch werden die Daten
und Konfigurationseinstellungen der vorherigen Version automatisch importiert.
Wenn Sie ein Upgrade von Tableau Server von 32-Bit auf 64-Bit vornehmen möchten,
müssen Sie vor dem Installieren der neuen Version erst die bestehende Version von Tableau
Server deinstallieren.
Einzelserverinstallationen
Upgrade einer Einzelserverinstallation von Tableau Server auf Version 8.3 oder 8.3.x:
1. Deinstallieren Sie die ältere Version auf Ihrem Tableau Server über die entsprechende
Option zum Hinzufügen/Entfernen von Programmen.
Durch die Deinstallation wird die Server-Software entfernt. Die Daten und
Konfigurationseinstellungen werden jedoch beibehalten.
2. Installieren Sie Tableau Server. Bei der Installation von Tableau Server werden die
- 145 -
Daten und Konfigurationseinstellungen aus der früheren Version automatisch
importiert.
Verteilte Installationen
Wenn Sie Ihren Cluster im Rahmen des Upgrades auf Version 8.3 von Tableau Server zu
einer 64-Bit-Version übertragen, sollten Sie sich über die Richtlinien zur "Bit-Version" in der
Checkliste vor dem Upgrade Auf Seite 141 informieren.
Upgrade einer verteilten Installation von Tableau Server von Version 8.2 auf Version 8.3 oder 8.3.x:
1. Deinstallieren Sie die ältere Version auf Ihrem primären Tableau Server über die
entsprechende Option zum Hinzufügen/Entfernen von Programmen.
2. Deinstallieren Sie die ältere Version auf Ihren Arbeitsservern über die entsprechende
Option zum Hinzufügen/Entfernen von Programmen.
Durch die Deinstallation wird die Server-Software entfernt. Die Daten und
Konfigurationseinstellungen werden jedoch beibehalten.
3. Installieren Sie Tableau Worker Server auf den Arbeitsservern.
4. Installieren Sie Tableau Server auf dem primären Tableau Server.
Bei der Installation von Tableau Server werden die Daten und
Konfigurationseinstellungen aus der früheren Version automatisch importiert.
Upgrade einer verteilten Installation von Tableau Server von Version 8.3.x auf Version 8.3.x:
1. Deinstallieren Sie die ältere Version auf Ihrem primären Tableau Server über die
entsprechende Option zum Hinzufügen/Entfernen von Programmen.
Durch die Deinstallation wird die Server-Software entfernt. Die Daten und
Konfigurationseinstellungen werden jedoch beibehalten.
2. Installieren Sie Tableau Server auf Ihrem primären Tableau Server. Da es sich um ein
Upgrade derselben Version handelt (Version 8.3.x auf 8.3.x), muss die Serversoftware
auf den Tableau-Arbeitsservern nicht erst deinstalliert und anschließend wieder neu
installiert werden. Bei einem Upgrade werden die Updates vom primären Tableau
Server auf die Arbeitsserver übertragen.
Hinweis: Wenn Sie ein Upgrade von Tableau Server von 32-Bit auf 64-Bit
vornehmen möchten, müssen Sie deinstallieren und dann neu installieren.
Weitere Informationen zum Upgrade einer verteilten Tableau Server-Installation
von 32-Bit auf 64-Bit finden Sie unten.
Bei der Installation von Tableau Server werden die Daten und
Konfigurationseinstellungen aus der früheren Version automatisch importiert.
Upgrade einer verteilten Tableau Server-Installation von 32-Bit auf 64-Bit
Beim Upgrade einer verteilten Installation von 32-Bit auf 64-Bit gehen Sie wie folgt vor:
- 146 -
1. Deinstallieren Sie mit "Programme hinzufügen/entfernen" die 32-Bit-Version auf Ihrem
primären Tableau Server.
2. Deinstallieren Sie mit "Programme hinzufügen/entfernen" die 32-Bit-Versionen auf
Ihren Tableau Server-Arbeitsservern.
3. Installieren Sie auf jedem Arbeitsserver die 64-Bit-Version von Tableau Server.
4. Installieren Sie die 64-Bit-Version von Tableau Server auf Ihrem primären Tableau
Server.
Verschieben der Daten-Engine und Repository-Prozesse
Wenn Sie einen Arbeitscomputer aus der Tableau Server-Konfiguration löschen müssen, der
die einzige Instanz des Repository oder der Daten-Engine (die Extrakte hostet), müssen Sie
zunächst den Dienst auf einen anderen Computer verschieben. Der Grund ist, dass immer
eine aktive Instanz der Repository- und Daten-Engine-Prozesse vorhanden sein muss.
So verschieben Sie die Daten-Engine und Repository-Prozesse:
1. Sofern noch nicht geschehen, halten Sie den primären Tableau Server an, und öffnen
Sie auf dem primären Tableau Server das Dialogfeld "Tableau Server-Konfiguration"
(Start > Tableau Server 8.3 > Tableau Server konfigurieren).
2. Markieren Sie auf der Registerkarte Server die IP-Adresse oder den Namen des
Computers, auf den Sie den Prozess verschieben möchten. Dabei kann es sich um
einen anderen Arbeitscomputer oder den primären Server (This Computer
(Primary)) handeln.
3. Klicken Sie auf Bearbeiten.
4. Aktivieren Sie im Dialogfeld "Tableau Server bearbeiten" das Kontrollkästchen für den
Prozess, den Sie verschieben: entweder Data-Engine, Repository oder beide, und
klicken Sie auf "OK".
5. Klicken Sie im Dialogfeld "Tableau Server-Konfiguration" auf "OK".
6. Starten Sie den primären Tableau Server, damit die Änderungen wirksam werden.
7. Halten Sie den Server an, und öffnen Sie das Dialogfeld "Tableau ServerKonfiguration".
8. Markieren Sie auf der Registerkarte Server die IP-Adresse oder den Computernamen
des Arbeitscomputers, von dem Sie den Prozess verschieben, und klicken Sie auf
Bearbeiten.
9. Deaktivieren Sie das Kontrollkästchen für den verschobenen Prozess, und klicken Sie
auf "OK".
10. Klicken Sie erneut auf "OK", und starten Sie den primären Server, damit die
Änderungen wirksam werden.
- 147 -
Wenn Sie diese Schritte beim Löschen eines Arbeitscomputers aus der Tableau ServerKonfiguration ausführen (wie unter Checkliste vor dem Upgrade Auf Seite 141
beschrieben), halten Sie den Server erneut an, bevor Sie fortfahren.
Info zum Serverprozess-Limit
Die Serverprozesse wgserver, data engine, data server und VizQL sind multithreaded und
mehrfach verarbeitet. Auf einer einzelnen Prozessinstanz können daher mehr als 16 Threads
gleichzeitig laufen. Tableau Server wird standardmäßig mit bis zu zwei Instanzen von jedem
Serverprozess installiert.
Wenn Sie die 64-Bit-Version von Tableau Server verwenden (ab Version 8.1 verfügbar),
sollten Sie nicht mehr als zwei Instanzen eines Prozesses ausführen.
Wenn Sie die 32-Bit-Version von Tableau Server verwenden und die
Standardeinstellungen nicht ausreichend sind, können Sie sie während der Installation (nur bei
Upgrades) oder nach der Installation mithilfe des Dialogfelds "Konfiguration" auf bis zu acht
Instanzen abändern.Acht Prozessinstanzen sind die Standardobergrenze. Wenn Ihr
Computer über genügend Arbeitsspeicher (RAM) und CPU-Core-Prozessoren verfügt,
können Sie dieses obere Limit über die Einstellung service.max_procs tabadmin ändern.
Tableau empfiehlt, dass auf dem Computer, auf dem die Prozesse ausgeführt werden, für jede
Prozessinstanz mindestens 1 GB Arbeitsspeicher und 1 logischer CPU-Core-Prozessor
vorhanden sein sollen.
So ändern Sie die maximale Anzahl zulässiger Prozesse:
1. Nach der Installation halten Sie den Server an.
2. Vergewissern Sie sich, dass das bin-Verzeichnis von Tableau Server noch das aktuelle
Verzeichnis ist, und geben Sie den folgenden Befehl ein, wobei number für die
maximale Anzahl von Prozessinstanzen steht, die Sie zulassen möchten:
tabadmin set service.max_procs number
Beispiel:
tabadmin set service.max_procs 10
3. Starten Sie den Server, damit die Änderungen wirksam werden.
Migrieren auf neue Hardware
Führen Sie die folgenden Schritte aus, um Tableau Server von einem Computer auf einen
anderen Computer zu migrieren. Dabei wird insbesondere beschrieben, wie Sie die Daten und
Konfigurationseinstellungen von Tableau Server von einem aktuell verwendeten Computer
auf einen anderen Computer verschieben, auf dem Tableau Server Version 8.3 installiert ist.
Stellen Sie vor der Migration sicher, dass Sie die Schritte unter Checkliste vor dem Upgrade
Auf Seite 141 ausgeführt haben, darunter auch das Erstellen einer .tsbak-Datei.
1. Installieren Sie Tableau Server auf dem neuen Computer.
2. Kopieren Sie die .tsbak-Datei in den BIN-Ordner auf Ihrem neuen Tableau Server (z. B.
- 148 -
C:\Program Files\Tableau\Tableau Server\8.3\bin).
3. Anschließend halten Sie Tableau Server an.
4. Stellen Sie die Daten und Konfigurationseinstellungen auf dem neuen Tableau Server
wieder her, indem Sie tabadmin restore <filename> eingeben. Dabei ist
<filename> der Name der .tsbak-Datei. Beispiel:
tabadmin restore mybackup.tsbak
Wenn Sie ausschließlich die Daten von Ihrem aktuell verwendeten Tableau Server und
keine Konfigurationseinstellungen wiederherstellen möchten, geben Sie Folgendes ein:
tabadmin restore --no-config mybackup.tsbak
5. Starten Sie den Server.
6. Nur verteilte Installationen: Führen Sie das Installationsprogramm für Tableau
Worker auf allen zusätzlichen Computern aus, die Sie Ihrem Tableau Server-Cluster
hinzufügen möchten. Informationen zur Vorgehensweise finden Sie unter Installieren
und Konfigurieren von Arbeitsservern Auf Seite 153.
7. Jeder Product Key für Tableau Server kann dreimal aktiviert werden: einmal für eine
Produktionsumgebung, einmal für eine Testumgebung und einmal für eine
Qualitätskontrollumgebung. Wenn Sie die Tableau Server-Installation getestet haben
und der Auffassung sind, dass sie zur Produktion bereit ist, müssen Sie die vorherige
Produktionsversion von Tableau Server deaktivieren und deinstallieren. So deaktivieren
Sie die ältere Version:
- Wählen Sie Start > Alle Programme > Tableau Server > Product Keys
verwalten.
- Markieren Sie die gewünschten Product Keys, und klicken Sie auf Deaktivieren.
Wenn keine Internetverbindung besteht, werden Sie aufgefordert, eine OfflineAktivierungsdatei zu erstellen, um den Deaktivierungsprozess abzuschließen.
Weitere Informationen finden Sie unter Offline-Aktivieren von Tableau Auf
Seite 113.
Verteilte Umgebungen
Die nachstehenden Themen enthalten Informationen zum Ausführen einer verteilten
Installation von Tableau Server:
Verteilte Anforderungen
Stellen Sie sicher, dass die folgenden Anforderungen erfüllt sind, bevor Sie mit der
Konfiguration eines Tableau Server-Clusters beginnen.
- 149 -
Hardware
Die im Cluster verwendeten Computer müssen zwar die unter Vor der Installation... Auf
Seite 110 beschriebenen Anforderungen erfüllen; sie müssen jedoch nicht identisch sein.
Hardware-Richtlinien für Hochverfügbarkeit
Die folgenden Richtlinien gelten für Systeme, die Sie für Failover und Hochverfügbarkeit
verwenden:
l
l
l
l
Failover – zwei oder drei Computer: Zur Konfiguration eines Clusters, der FailoverUnterstützung für die Daten-Engine- und Repository-Prozesse bereitstellt, benötigen
Sie mindestens zwei Computer oder VMs: einen für den primären Tableau Server und
den anderen für den Tableau-Arbeitscomputer. In dieser Konfiguration ist
möglicherweise auch eine Website oder ein Computer erforderlich, auf der/dem
Tableau nicht ausgeführt wird (weitere Informationen). Die empfohlene FailoverKonfiguration erfordert drei Computer oder VMs: einen für den primären Tableau
Server und zwei für die Arbeitscomputer.
Unterstützung von Failover und mehreren Gateways – zwei oder drei Computer
und ein Lastenausgleichsmodul: Zur Konfiguration eines Clusters, der die oben
beschriebenen Leistungen erbringt und mehrere Gateways unterstützt, benötigen Sie
mindestens zwei Computer oder VMs und ein Lastenausgleichsmodul für den Cluster.
Die empfohlene Failover-Konfiguration mit Unterstützung für mehrere Gateways
besteht aus drei Computern oder VMs und einem Lastenausgleichsmodul.
Hochverfügbarkeit – vier Computer und ein Lastenausgleichsmodul: Für die
Konfiguration für Hochverfügbarkeit benötigen Sie die oben beschriebenen Ressourcen
sowie einen zusätzlichen Computer als primären Sicherungsserver für den primären
Tableau Server.
Primäre Computer: Bei der Konfiguration für Hochverfügbarkeit führen der primäre
Tableau Server und der primäre Sicherungsserver nur wenige oder gar keine Tableau
Server-Prozesse aus. Deshalb benötigen die Computer, die als primärer Server und
primärer Sicherungsserver fungieren, nicht so viele Kerne wie die Arbeitsserver. Sie
müssen allerdings über ausreichenden Festplattenspeicher für die Sicherungsdateien
verfügen, da der primäre Computer während der Datenbanksicherung und während
des Wiederherstellungsprozesses verwendet wird. Zusätzlich zu dem für die
Sicherungsdatei benötigten Speicherplatz ist temporärer Festplattenspeicher
erforderlich, der ungefähr zehnmal so groß sein muss wie die Sicherungsdatei (wenn
die Sicherungsdatei 4 GB groß ist, müssen Sie also über 40 GB temporären
Festplattenspeicher verfügen).
Software
Tableau Server ist als 32- und 64-Bit-Version verfügbar. Wenn Sie einen Tableau ServerCluster ausführen, muss auf jedem Computer dieselbe Bit-Version verwendet werden, d. h.,
auf allen muss entweder eine 64-Bit-Version oder eine 32-Bit-Version vorhanden sein. Wenn
beispielsweise der primäre Tableau Server die 64-Bit-Version von Tableau Server ausführt,
müssen die Arbeitscomputer im Cluster ebenfalls die 64-Bit-Version von Tableau Server
- 150 -
Worker ausführen. Sie dürfen nicht die 32-Bit-Version von Tableau Server Worker
verwenden.
Netzwerk und Ports
l
l
l
Ports: Wie bei jedem verteilten System müssen die verwendeten Computer oder VMs
miteinander kommunizieren können. Eine Liste der Ports, die auf Gateways und
Arbeitscomputern zur Verfügung stehen müssen, finden Sie unter TCP/IP-Ports Auf
Seite 388.
Dieselbe Domäne: Alle Computer in einem Cluster müssen derselben Domäne
angehören. Das Konto Run As User (Als Benutzer ausführen) Auf Seite 373 des
Servers, das für den primären Tableau Server festgelegt ist, muss ein Domänenkonto in
dieser Domäne sein.
Statische IP-Adressen: Alle Computer, auf denen Tableau Server ausgeführt wird
(entweder als einzelne Serverinstallation oder als Teil eines Clusters), müssen eine
statische IP-Adresse haben (weitere Informationen).
Bewährte Methoden
Hier finden Sie einige Tipps, die Sie beachten sollten, bevor Sie mit der Installation und
Konfiguration beginnen:
l
l
l
l
IP-Adressen oder Computernamen: Notieren Sie sich die IPv4-Adressen oder
Computernamen der Computer oder VMs, mit denen Sie arbeiten. Sie benötigen sie
während des Tableau Worker-Setups und für die Konfiguration. Wie oben erwähnt,
muss jeder Computer im Cluster eine statische IP-Adresse verwenden, selbst wenn Sie
während der Konfiguration den Computernamen zur Identifizierung nutzen.
CNAME-Datensatz: Verwenden Sie bei der Konfiguration für Hochverfügbarkeit ohne
Lastenausgleich denselben CNAME-Datensatz für den primären Tableau Server und
den primären Sicherungsserver, damit Tableau Server-Benutzern einen nahtlosen
Übergang zu ermöglichen, wenn ein primärer Server ausfällt und Sie den anderen
aktivieren. Falls Sie ein Lastenausgleichsmodul verwenden, nutzen die Benutzer den
Namen des Lastenausgleichsmoduls als Tableau Server-URL, unabhängig vom
Gateway, das die eigentliche Anfrage bearbeitet.
Anmeldeinformationen für das Benutzerkonto: Sie benötigen für jeden Computer
die Anmeldeinformationen für ein Benutzerkonto mit lokalen
Administratorberechtigungen. Bei der Konfiguration für Hochverfügbarkeit muss das für
den primären Tableau Server verwendete RunAs-Serverkonto mit dem Konto für den
primären Tableau-Sicherungsserver identisch sein.
Sicherung: Es hat sich bewährt, eine Sicherungskopie zu erstellen, bevor
grundlegende Systemänderungen vorgenommen werden. Informationen zur
Vorgehensweise finden Sie unter Sichern der Tableau-Daten Auf Seite 447.
- 151 -
SSL
Wenn Sie beabsichtigen, SSL für einen Tableau Server-Cluster mit Hochverfügbarkeit,
mehreren Gateways und einem Lastenausgleichsmodul zu konfigurieren (weitere
Informationen), müssen Sie darauf achten, dass das SSL-Zertifikat für den Hostnamen des
Lastenausgleichsmoduls ausgestellt wurde. Weitere Informationen finden Sie unter
Konfigurieren von SSL für einen Cluster Auf Seite 125.
Unterstützung für Hostnamen in Tableau Server
Ab Version 8.1 bietet Tableau Server Unterstützung für Hostnamen. Das bedeutet, dass Sie
beim Konfigurieren von Tableau Server einen anderen Rechner, mit dem Tableau Server
zusammenarbeiten soll, anhand des Rechnernamens anstatt der IPv4-Adresse identifizieren
können. Intern nutzt Tableau Server jedoch nach wie vor die IP-Adressen, um mit anderen
Services wie z. B. mit Tableau-Arbeitsservern oder vertrauenswürdigen Hosts zu
kommunizieren. Auch wenn Sie den Namen eines Computers anstatt seiner IP-Adresse
angegeben haben, darf sich die IP-Adresse dieses Computers nicht ändern, und es darf sich
nicht um eine nur begrenzt gültige IP-Adresse handeln.
Wenn ein Computer, auf dem Tableau Server ausgeführt wird, eine neue IP-Adresse erhält
(z. B. nach einem VM-Neustart oder in einer Netzwerkumgebung, in der DHCP verwendet
wird), muss tabadmin config ausgeführt werden, um die Konfiguration von Tableau
Server entsprechend zu ändern. Die genauen Schritte können Sie dem unten beschriebenen
Verfahren entnehmen.
Neben DHCP kann auch ein Feature des -Betriebssystems eine Änderung der IP-Adresse
bewirken. Dieses Feature zur Fortsetzung des Setups wirkt sich auf IPv6-Adressen aus und
wird als "temporäre IPv6-Adressen" bezeichnet. Weitere Informationen dazu, wie Sie dieses
Feature erkennen und deaktivieren, finden Sie in der Knowledge Base.
So aktualisieren die Konfiguration von Tableau Server
1. Öffnen Sie auf dem primären Tableau Server eine Eingabeaufforderung als
Administrator.
2. Geben Sie folgenden Befehl ein:
cd "C:\Program Files\Tableau\Tableau Server\8.3\bin"
3. Halten Sie den Server an:
tabadmin stop
4. Ändern Sie die Konfiguration des Servers durch folgende Eingabe:
tabadmin config
- 152 -
5. Starten Sie den Server:
tabadmin start
Installieren und Konfigurieren von Arbeitsservern
Nachdem Sie die erste Konfiguration abgeschlossen haben, können Sie Tableau Server für
die Ausführung auf mehreren Computern einrichten. Dies wird als verteilte Installation oder
Cluster bezeichnet. Bei der Ausführung einer verteilten Installation werden auf dem primären
Tableau Server zusätzliche Ports verwendet. Bestimmte Ports müssen für die Bindung
während des Setups auf den Tableau-Arbeitsservern vorhanden sein. Weitere Informationen
hierzu finden Sie unter TCP/IP-Ports Auf Seite 388. Beim Ausführen einer verteilten
Installation müssen außerdem zusätzliche Anforderungen beachtet werden. Weitere Details
finden Sie unter Verteilte Anforderungen Auf Seite 149.
So installieren und konfigurieren Sie einen Tableau Worker Server:
1. Stellen Sie sicher, dass Tableau Server auf dem primären Computer installiert worden
ist.
2. Halten Sie den Server auf dem primären Computer an. (Informationen zur
Vorgehensweise finden Sie unter Tableau Server Monitor Auf Seite 248.)
3. Laden Sie die Tableau Server Worker Software vom Tableau Customer Account
Center herunter.
4. Führen Sie das Tableau Server Worker-Setup auf allen Computern aus, die Sie dem
Tableau Server-Cluster hinzufügen möchten.
5. Während der Installation werden Sie zur Eingabe der IPv4-Adressen oder des
Computernamens des primären Servers aufgefordert. Die Verwendung eines
Computernamens wird empfohlen.
Wenn der primäre Server über mehrere aktive Netzschnittstellenkarten (NICs) verfügt
und Sie sich zur Eingabe der IPv4-Adressen entschieden haben, geben Sie alle IPv4Adressen des primären Servers an, indem Sie sie durch ein Komma voneinander
trennen. Die IP-Adresse(n) des Computers, der als primärer Server ausgeführt wird,
muss/müssen statisch sein. Dies gilt auch, wenn Sie zur Identifizierung des primären
Servers einen Computernamen eingeben (weitere Informationen).
Wenn auf einem Arbeitscomputer Windows 7 mit aktivierter Firewall ausgeführt wird,
beziehen Sie sich auf die Tableau Knowledge Base, bevor Sie fortfahren.
6. Sobald die Worker-Software auf den Arbeitscomputern installiert worden ist, kehren Sie
zum (noch immer angehaltenen) primären Tableau Server zurück, und öffnen Sie das
Konfigurationsdienstprogramm, indem Sie im Startmenü Tableau Server8.3 >
Tableau Server konfigurieren auswählen.
7. Geben Sie im Konfigurationsdienstprogramm auf der Registerkarte Allgemein Ihr
Kennwort ein, wählen Sie dann die Registerkarte Server aus, und klicken Sie auf
Hinzufügen.
- 153 -
8. Geben Sie im nächsten Dialogfeld die IPv4-Adresse oder den Computernamen für
einen der Arbeitscomputer ein, und geben Sie die Anzahl der VizQL-,
Anwendungsserver-, Datenserver-, Hintergrund- oder Daten-Engine-Prozesse für
den Computer an.
Bei der 64-Bit-Version von Tableau Worker Server können Sie bis zu zwei Instanzen
jedes Prozesses ausführen. In seltenen Fällen und sofern die Serverhardware es
zulässt, kann diese Beschränkung auch geändert werden. Weitere Informationen finden
Sie unter Info zum Serverprozess-Limit Auf Seite 148 und Leistung Auf Seite 305.
Standardmäßig werden Daten-Engine, Repository und Gateway auf dem primären
Server gehostet. Die Ausführung dieser Prozesse auf einem zusätzlichen Server oder
ihre Verlagerung auf den primären Server ist Teil der Konfiguration für
Hochverfügbarkeit. Weitere Informationen hierzu finden Sie unter Hochverfügbarkeit
Auf Seite 158.
9. Klicken Sie auf OK. Die Aktualisierung kann einige Minuten dauern.
10. Wiederholen Sie diese Schritte für jeden Computer, den Sie der verteilten Umgebung
- 154 -
hinzufügen möchten. Wenn Sie alle gewünschten Arbeitscomputer hinzugefügt haben,
klicken Sie nochmals auf OK, um die Änderungen zu speichern. Starten Sie dann den
primären Tableau Server.
Datenbanktreiber
Oracle EssbaseDie Installationsprogramme von Tableau Server und Tableau Server Worker
installieren automatisch Treiber für Oracle- und Oracle Essbase-Datenbanken. Wenn Sie
Arbeitsmappen und Datenquellen veröffentlichen möchten, die eine Verbindung mit anderen
Datenbanken herstellen, müssen Sie sicherstellen, dass sowohl der primäre Computer als
auch der Arbeitsserver über die entsprechenden Treiber verfügen.
Arbeitscomputer, auf denen VizQL-, Anwendungsserver-, Datenserver- oder
Hintergrundprozesse ausgeführt werden, benötigen diese Datenbanktreiber. Wenn
beispielsweise ein Arbeitsserver dediziert als VizQL-Server und ein anderer Computer als
Extraktionsspeicher genutzt wird, dann müssen Sie die Treiber nur auf dem Computer
installieren, auf dem der VizQL-Serverprozess ausgeführt wird.
Serverprozess
Datenbanktreiber
erforderlich?
VizQL
Ja
Anwendungsserver
Ja
Datenserver
Ja
Hintergrund
Ja
Daten-Engine (Extraktionsspeicher)
Nein
Repository
Nein
Gateway
Nein
Erneute Installation und Konfiguration des Arbeitsservers
Möglicherweise müssen Sie einen der Tableau-Arbeitsserver neu installieren. Führen Sie
dazu eines der folgenden Verfahren aus. Die genauen Schritte hängen davon ab, ob auf dem
neu zu installierenden Arbeitscomputer Daten-Engine- oder Repository-Komponenten
vorhanden sind und ob diese in einem weiteren Knoten der Installation dupliziert sind.
Hinweis: Bei gleichzeitiger Neuinstallation mehrerer Arbeitscomputer können
Datenverluste auftreten.
Gehen Sie wie folgt vor, um einen Arbeitscomputer-Knoten neu zu installieren und zu
konfigurieren, der die einzige Daten-Engine oder das einzige Repository in der verteilten
Installation hostet.
- 155 -
So installieren Sie den Arbeitscomputer neu, der die Daten-Engine- oder Repository-Instanz hostet
1. Erstellt eine vollständige Sicherungsdatei von Tableau Server. TableauWeitere
Informationen dazu finden Sie unter Sichern der Tableau-Daten Auf Seite 447
2. Halten Sie Tableau Server auf dem primären Server an, indem Sie im Startmenü von
Windows Tableau Server8.3 > Tableau Server anhalten auswählen oder an der
Befehlszeile den Befehl tabadmin stop ausführen.
3. Wählen Sie im Startmenü Tableau Server 8.3 > Tableau Server konfigurieren aus.
4. Im Konfigurationsdienstprogramm:
l Geben Sie auf der Registerkarte Allgemein Ihr Kennwort ein.
l Fügen Sie auf der Registerkarte Server die Daten-Engine- und/oder RepositoryKomponenten, die der Arbeitscomputer hostet, einem anderen Arbeitscomputer
oder dem primären Server hinzu, und speichern Sie dann Ihre Änderungen.
Wenn beispielsweise der Arbeitscomputer, den Sie neu installieren, derzeit die
Daten-Engine hostet, fügen Sie die Daten-Engine einem anderen Knoten hinzu.
5. Starten Sie Tableau Server, und warten Sie einige Minuten, damit die Synchronisierung
zwischen dem neu zu installierenden Arbeitscomputer und dem Arbeitscomputer oder
primären Server, dem Sie die Daten-Engine- und/oder Repository-Komponenten
hinzugefügt haben, abgeschlossen werden kann.
6. Überprüfen Sie, ob die Synchronisierung abgeschlossen ist, indem Sie auf dem neu zu
installierenden Arbeitscomputer und dem primären Server oder dem Arbeitscomputer,
dem Sie die Daten-Engine und das Repository hinzugefügt haben, die folgenden
Ordner vergleichen. Größe und Inhalt dieser Ordner sollten identisch sein:
l
l
Daten-Engine-Ordner: ProgramData\Tableau\Tableau
Server\data\tabsvc\dataengine
Repositoryordner: ProgramData\Tableau\Tableau
Server\data\tabsvc\pgsql
Hinweis: Wenn Sie nicht durch Ordnervergleich überprüfen, ob die
Synchronisierung abgeschlossen ist, gehen beim Fortfahren
möglicherweise Daten verloren.
7. Beenden Sie Tableau Server.
8. Im Konfigurationsdienstprogramm:
l Geben Sie auf der Registerkarte Allgemein Ihr Kennwort ein.
l Wählen Sie auf der Registerkarte Server den Arbeitscomputer aus, den Sie neu
installieren möchten, und klicken Sie auf Löschen.
l Speichern Sie Ihre Änderungen.
9. Starten Sie Tableau Server, und überprüfen Sie, ob alles wie erwartet ausgeführt
wurde.
10. Auf dem Arbeitscomputer:
- 156 -
l
l
l
Deinstallieren Sie die Worker-Software über die Windows-Systemsteuerung vom
Tableau Server.
Löschen Sie die folgenden Ordner (oder benennen Sie sie um): C:\Program
Files\Tableau und C:\ProgramData\Tableau (der Ordner \ProgramData ist ausgeblendet).
Installieren Sie die aktualisierte Worker-Software.
11. Halten Sie Tableau Server auf dem primären Tableau Server an, fügen Sie der
Konfiguration den Arbeitscomputer wieder hinzu, und speichern Sie dann die
Änderungen.
Hinweis: Die Daten-Engine und das Repository müssen in mindestens einem
Knoten verbleiben, während Sie den Arbeitscomputer erneut hinzufügen.
12. Starten Sie Tableau Server.
Gehen Sie wie folgt vor, um einen Tableau-Arbeitscomputer neu zu installieren und zu
konfigurieren, der entweder nicht die Daten-Engine oder das Repository hostet oder aber eine
Komponente, die auch in einem weiteren Knoten gehostet wird.
So installieren und konfigurieren Sie den Arbeitscomputer-Knoten neu, der entweder keine Komponente hostet oder aber eine Komponente, die auch in einem weiteren Knoten gehostet wird
1. Erstellt eine vollständige Sicherungsdatei von Tableau Server.
2. Halten Sie Tableau Server auf dem primären Server an, indem Sie im Startmenü
Tableau Server8.3 > Tableau Server anhalten auswählen oder an einer
Eingabeaufforderung den Befehl tabadmin stop ausführen.
3. Öffnen Sie das Konfigurationsdienstprogramm, indem Sie im Startmenü Tableau
Server8.3 > Konfigurieren auswählen.
4. Im Konfigurationsdienstprogramm:
l Geben Sie auf der Registerkarte Allgemein Ihr Kennwort ein.
l Wählen Sie auf der Registerkarte Server den Arbeitscomputer aus, den Sie neu
installieren möchten, und klicken Sie dann auf Löschen.
l Speichern Sie Ihre Änderungen.
5. Starten Sie Tableau Server, und überprüfen Sie, ob alles wie erwartet ausgeführt wird.
6. Auf dem Arbeitscomputer:
l Deinstallieren Sie die Tableau Server Worker-Software über die Systemsteuerung.
l Löschen Sie die folgenden Ordner (oder benennen Sie sie um): C:\Program
Files\Tableau und C:\ProgramData\Tableau. (Der Ordner \ProgramData ist ausgeblendet und daher möglicherweise nicht sichtbar.
l Installieren Sie die aktualisierte Worker-Software.
7. Halten Sie Tableau Server auf dem primären Server an, fügen Sie den Arbeitscomputer
- 157 -
im Konfigurationsdienstprogramm der Konfiguration wieder hinzu, und speichern Sie
dann die Konfiguration.
Hinweis: Die Daten-Engine und das Repository müssen in mindestens einem
Knoten verbleiben, während Sie den Arbeitscomputer erneut hinzufügen.
8. Starten Sie Tableau Server.
Warten einer verteilten Umgebung
Nachdem Sie den primären Server und einen oder mehrere Arbeitsserver für eine verteilte
Installation eingerichtet haben, können Sie alle nachfolgenden Konfigurationen und
Aktualisierungen mithilfe der Befehlszeilenprogramme und des Dienstprogramm zur
Konfiguration auf dem primären Server durchführen. Aktualisierungen werden automatisch
auf den Arbeitscomputern veröffentlicht.
Bei der Installation der Arbeitsserver haben Sie die IPv4-Adresse oder der Computername
des primären Servers angegeben. Wenn sich diese IP-Adresse oder der Computername
ändert, müssen Sie alle Arbeitsserver neu installieren.
Sie können den Status des Tableau Server-Clusters auf der Wartungsseite des Servers
überwachen. Unter Serverwartung Auf Seite 239 finden Sie weitere Informationen zur
Wartung des Servers.
Hochverfügbarkeit
Verwenden Sie die Links weiter unten, um weitere Informationen zur Unterstützung der
Hochverfügbarkeit durch Tableau Server zu erhalten:
Grundlegendes zur Hochverfügbarkeit
Wenn Sie ein Tableau Server-System für Hochverfügbarkeit konfigurieren, dienen die
ausgeführten Schritte der Redundanz, sodass die potenziellen Ausfallzeiten reduziert werden.
Die vier Bereiche, die Redundanz erfordern, sind der Daten-Engine-, der Repository- und der
Gateway-Prozess sowie der primäre Tableau Server, der die Lizenzierungskomponente des
Servers ausführt. Da es jederzeit jeweils eine aktive Instanz der Daten-Engine- und
Repository-Prozesse geben muss, ist die Cluster-Konfiguration ein mehrstufiges Verfahren,
für das der primäre Tableau Server mehrfach angehalten und neu gestartet werden muss,
damit die Einstellungen wirksam werden. Die einzelnen Schritte finden Sie unter
Konfigurieren für Failover und mehrere Gateways Auf Seite 164 und Konfigurieren
eines primären Sicherungsservers Auf Seite 173. Lesen Sie außerdem auch distrib_
requ.htm.
- 158 -
In den Themen unten ist angegeben, wie sich die Serversystemtopologie entwickelt, wenn Sie
sie für hohe Verfügbarkeit konfigurieren. Die empfohlene Mindestkonfiguration für
Hochverfügbarkeit ist ein System mit drei Knoten. Dazu gehören ein primärer Server, der die
Lizenz ausführt, und zwei Arbeitsserver, die die wichtigsten Prozesse hosten. Sie können die
Systemzuverlässigkeit erhöhen, indem Sie einen vierten Computer hinzufügen, der als
Sicherung des primären Servers dient. Falls Sie einen Gateway-Prozess auf allen Knoten
ausführen, ist es außerdem sinnvoll, einen Lastenausgleich für die Gateways zu verwenden.
Einzelserversystem
Nachdem Sie den primären Tableau Server installiert haben, wird auf ihm mindestens eine
Instanz aller Serverprozesse ausgeführt. Dies ist die Grundkonfiguration von Tableau Server.
Sie bietet keine Redundanz.
So sieht die Statustabelle auf der Wartungsseite in der Regel für ein Einzelserversystem aus:
Für die Redundanz benötigen Sie weitere Server, um die Standby- und aktiven Daten-Engineund Repository-Prozesse zu hosten. Außerdem können, um die Systemanfälligkeit zu
reduzieren, mehrere Gateways ausgeführt werden, und der primäre Server sollte in einem
eigenen Knoten isoliert werden und idealerweise so wenig Serverprozesse wie möglich
ausführen. Die Mindestanzahl von Computern, mit denen sich dies erreichen lässt, ist drei
(siehe System mit drei Knoten Auf Seite 161); Sie können jedoch auch mit zwei Computern
eine gewisse Redundanz erzielen.
- 159 -
System mit zwei Knoten
Falls es Hardwarebeschränkungen gibt und ein Cluster mit drei Knoten nicht machbar ist,
können Sie eine gewisse Redundanz mit zwei Computern und einem Host erzielen, die sich
außerhalb vom Tableau Server-Cluster befinden.
In dem oben angegebenen System führen der primäre Tableau Server und ein Arbeitsserver
die aktiven und Standby-Instanzen der Daten-Engine und des Repositorys sowie der
Gateways aus. Ein dritter Computer befindet sich extern vom Tableau Server-Cluster und wird
als dritter Kontaktpunkt für die beiden Gateways verwendet. Der Grund dafür ist Folgendes:
Tableau ServerWenn ein Tableau Server, der die Daten-Engine und das Repository ausführt,
die Verbindung zu anderen Knoten verliert, prüft er über einen Gateway-Prozess (der sich
extern von ihm, aber noch innerhalb des Tableau Server-Clusters befindet), welcher Knoten
ausgefallen ist und ob jetzt Standby-Prozesse aktiviert werden müssen. In einem Cluster mit
zwei Knoten ist es nicht möglich, den anderen Tableau-Gateway-Prozess zu erreichen, wenn
die Verbindung unterbrochen wird. In diesen Fällen kann eine Website oder ein Computer
außerhalb des Tableau Server-Clusters verwendet werden. Informationen zur Konfiguration
finden Sie unter Externe Failover-Bestätigung Auf Seite 169.
Dies ist die Statustabelle der obigen Konfiguration. Da der dritte Computer kein Tableau
Server ist, wird er nicht in der Tabelle aufgelistet.
- 160 -
System mit drei Knoten
Während einige der oben beschriebenen Systeme mit zwei Knoten eine gewisse FailoverUnterstützung für die Daten-Engine- und Repository-Prozesse bereitstellen, kann ein System
mit drei Knoten Ihnen helfen, die Anfälligkeit des primären Servers zu reduzieren:
Die Statustabelle auf der Wartungsseite sieht nun in etwa wie folgt aus:
In einem Cluster mit drei Knoten wurden die Daten-Engine- und Repository-Prozesse vom
primären Server auf einen Arbeitsserver verschoben, und der primäre Server führt nur den
Gateway-Prozess aus. Da die Such- und Lizenzierungsfunktion in den primären Server
integriert sind und nicht entfernt werden können, werden sie nicht in der Statustabelle
- 161 -
angezeigt. Falls der aktive Arbeitscomputer in dieser Konfiguration ausfällt, wird der StandbyArbeitscomputer automatisch aktiv. Die genaue Vorgehensweise in diesem Cluster mit drei
Knoten, einschließlich des Hinzufügens der Arbeitscomputer und Entfernens der Prozesse
vom primären Server, ist unter Konfigurieren für Failover und mehrere Gateways Auf
Seite 164 beschrieben.
Es gibt zwei Dinge, die Sie tun können, um den Cluster mit drei Knoten zu verbessern: 1) Sie
fügen einen Lastenausgleich als Schnittstelle mit den drei aktiven Gateways hinzu, und 2) Sie
erstellen eine Sicherung für den Ausfallpunkt: den primären Server. Weitere Informationen
hierzu finden Sie in den folgenden Themen.
Hinzufügen eines Lastenausgleichs
An diesem Punkt habe alle drei Knoten Gateways, die verwendet werden, um Anforderungen
an die verfügbaren Serverprozesse weiterzuleiten. Im Gegensatz zum Repository-Prozess
gibt es keine aktiven und Standby-Gateways. Alle Gateways sind aktiv. Um potenzielle
Ausfallzeiten des Clusters weiter zu reduzieren, sollten Sie einen Lastenausgleich
konfigurieren.
Hinzufügen eines primären Sicherungsservers
Das Hinzufügen eines primären Sicherungsservers bietet einen zusätzlichen Schutz für Ihr
System. Der primäre Sicherungsserver ist ein zusätzlicher Server, der zum System
hinzugefügt wird und bereitsteht, falls der primäre Server ausfällt. Auch wenn es sich nicht um
einen aktiven Server handelt, kann er jederzeit aktiviert werden, nachdem Sie die ersten
Schritte unter Konfigurieren eines primären Sicherungsservers Auf Seite 173 ausgeführt
haben. Der primäre Sicherungsserver muss zwar während der Installation lizenziert werden,
zählt aber nicht als eine der drei Umgebungen, die im Rahmen der Endbenutzervereinbarung
für Tableau zulässig sind.
So sieht das System mit einem primären Sicherungsserver aus:
- 162 -
Die Statustabelle für die oben angegebene Konfiguration sieht genauso wie für ein System mit
drei Knoten aus. Wenn der primäre Server ausfällt und Sie die Schritte zur Aktivierung des
primären Sicherungsservers ausführen, geht das System mit dem neuen primären Server
wieder online:
Die Lizenzierung kann nur auf dem primären Tableau Server ausgeführt werden. Die
Lizenzierung wird alle 8 Stunden überprüft. Wenn auf dem primären Server nur die
Lizenzierungskomponente ausgeführt wird, haben Sie nach der letzten Lizenzierungsprüfung
bis zu 8 Stunden Zeit, den primären Sicherungsserver online zu schalten. Während dieses
Zeitfensters ist der Cluster weiterhin funktionsfähig. Wenn die Lizenzierung beispielsweise vor
7 Stunden und 50 Minuten erfolgte, bleiben Ihnen noch 10 Minuten. Wenn die Lizenzierung vor
1 Minute erfolgte, haben Sie noch 7 Stunden und 59 Minuten Zeit.
- 163 -
Konfigurieren für Failover und mehrere Gateways
Gehen Sie wie folgt vor, um einen Cluster mit drei Computern zu konfigurieren, der mehrere
Gateways und Failover-Unterstützung bietet:Beachten Sie, dass das Ausführen von mehreren
Gateways nur sinnvoll ist, wenn Sie außerdem einen Lastenausgleich planen.
1. Installieren Sie Tableau Server auf dem primären Computer.
2. Nachdem das Setup abgeschlossen wurde, überprüfen Sie die Statustabelle auf der
Wartungsseite. Alle Prozesse sollten den grünen Status "Wartet auf Anforderung"
aufweisen:
3. Halten Sie den Server an (primärer Server).
4. Führen Sie das Tableau Worker-Setup auf zwei zusätzlichen Computern oder VMs aus,
die die Failover-Unterstützung und das zusätzliche Gateway bereitstellen. Während des
Worker-Setups werden Sie zur Angabe des Computernamens bzw. der IPv4-Adresse
des primären Tableau Servers aufgefordert: Wenn Sie mehrere IPv4-Adressen
eingeben, trennen Sie die einzelnen Adressen jeweils durch ein Komma voneinander.
Dem primären Server muss eine statische IP-Adresse zugewiesen werden,
selbst wenn Sie den primären Computernamen zur Identifizierung nutzen
(weitere Informationen).
5. Öffnen Sie das Konfigurationsdialogfeld, während der primäre Server noch angehalten
ist: Wählen Sie Start > Alle Programme > Tableau Server > Tableau Server
konfigurieren. Geben Sie auf der Registerkarte "Allgemein" das Kennwort des RunAsServerkontos ein.
6. Klicken Sie auf der Registerkarte "Server" auf Hinzufügen, um einen Arbeitscomputer
hinzuzufügen.
7. Geben Sie die IPv4-Adresse oder den Computernamen des Arbeitscomputers und
- 164 -
dann 1 für die Daten-Engine ein. Aktivieren Sie anschließend das Kontrollkästchen
Repository:Setzen Sie vorläufig kein Häkchen in das Kontrollkästchen Gateway. Sie
fügen diesem Arbeitscomputer später eine Gateway hinzu.
Wenn Sie möchten, dass der Arbeitscomputer andere Serverprozesse ausführt, geben
Sie die Anzahl der auszuführenden Instanzen ein, z. B. 1 oder 2. Klicken Sie auf "OK",
um das Dialogfeld "Tableau Server hinzufügen" zu schließen.
8. Starten Sie den Server (primärer Server).
9. Wichtig: Warten Sie mehrere Minuten, bis der Synchronisierungsprozess des Servers
die Daten kopiert hat. Je nach Größe der Installation und der Anzahl der Extrakte kann
dies zwischen 5 und 15 Minuten (unter Umständen sogar noch länger) dauern.
10. Bestätigen Sie, dass die Synchronisierung abgeschlossen ist, indem Sie die folgenden
Ordner auf dem primären Server und dem ersten Arbeitscomputer vergleichen:
l
Daten-Engine-Ordner:ProgramData\Tableau\Tableau
Server\data\tabsvc\dataengine
Dieser Ordner sollte auf dem primären Server und dem ersten Arbeitscomputer
den gleichen Inhalt und die gleiche Größe haben.
l
Repositoryordner: ProgramData\Tableau\Tableau
Server\data\tabsvc\pgsql
Dieser Ordner sollte auf dem primären Server und dem ersten Arbeitscomputer
die gleiche oder annähernd die gleiche Größe haben.
Wenn Sie die oben beschriebene Bestätigung nicht durchführen, bevor Sie den
Server im nächsten Schritt anhalten, können Daten verloren gehen.
- 165 -
11. Halten Sie den primären Server an, nachdem Sie den vollständigen Abschluss der
Synchronisierung bestätigt haben.
12. Öffnen Sie das Dialofeld "Konfiguration", und klicken Sie auf der Registerkarte "Server"
auf Hinzufügen, um einen weiteren Arbeitscomputer hinzuzufügen.
13. Geben Sie die IPv4-Adresse oder den Computernamen des zweiten Arbeitscomputers
und dann mindestens 1 für jeden Prozess außer für die Daten-Engine ein (setzen Sie
diese auf 0). Deaktivieren Sie das Kontrollkästchen Repository, und wählen Sie
Gateway aus.
Sie müssen für die Daten-Engine und das Repository nicht angeben, welcher
Arbeitscomputer aktiv ist und welcher im Standby betrieben wird.
Klicken Sie auf "OK".
14. Markieren Sie au der Registerkarte "Server" den Eintrag Dieser Computer (Primär),
und klicken Sie auf Bearbeiten.
15. Setzen Sie im Dialogfeld "Tableau Server bearbeiten" Daten-Engine auf 0, und
- 166 -
deaktivieren Sie das Kontrollkästchen Repository. Lassen Sie Gateway ausgewählt.
Wenn der primäre Tableau Server nur noch den Gateway-Prozess (Apache) ausführen
soll, können Sie die verbleibenden Prozesse vom primären Computer entfernen, indem
Sie in die einzelnen Textfelder 0 eingeben.
Aus Core-basierter Lizenzierungssicht konsumiert der Gateway-Prozess keine Cores.
Wen Sie den primären Tableau Server so konfigurieren, dass nur das Gateway
ausgeführt wird, ist dies eine hilfreiche Strategie, wenn Sie beispielsweise über eine 8Core-Serverlizenz und zwei 4-Core-Arbeitscomputer verfügen. Sie können zwar drei
Server ausführen (den primären Server plus zwei Arbeitscomputer), Cores werden
jedoch nur von den Arbeitscomputerservern konsumiert.
Klicken Sie auf "OK".
16. Wählen Sie auf der Registerkarte "Server" den ersten Arbeitscomputer aus, klicken Sie
auf Bearbeiten, und markieren Sie das Kontrollkästchen Gateway. Lassen Sie die
anderen Einstellungen unverändert. Klicken Sie auf "OK".
17. Wählen Sie dann auf der Registerkarte "Server" den zweiten Arbeitscomputer aus, und
klicken Sie auf Bearbeiten.
18. Setzen Sie Daten-Engine auf 1, und aktivieren Sie das Kontrollkästchen Repository.
- 167 -
19. Klicken Sie auf OK.
Die Registerkarte "Server" sollte nun in etwa wie folgt aussehen:
20. Sie können auch E-Mail-Benachrichtigungen einrichten, um über Serverausfälle oder
Statusänderungen der Daten-Engine- und Repository-Prozesse informiert zu werden.
Klicken Sie dazu im Dialogfeld "Konfiguration" auf die Registerkarte "Warnungen und
Abonnements", und befolgen Sie die Schritte in Konfigurieren von E-MailWarnungen Auf Seite 121.
21. Klicken Sie auf OK, um das Dialogfeld "Konfiguration" zu schließen.
22. Starten Sie den Server (primärer Server) (es kann einige Minuten dauern, bis die
Änderungen wirksam werden). Das System ist jetzt dafür konfiguriert, FailoverUnterstützung für die Daten-Engine- und Repository-Prozesse bereitzustellen. Es ist
auch für mehrere Gateways konfiguriert. Sie können nun einen Lastenausgleich
verwenden, um die Verfügbarkeit des Clusters bei einem Gateway-Ausfall zu
gewährleisten und um die Arbeitslast des Clusters zu verteilen.
- 168 -
Die Statustabelle auf der Wartungsseite sollte nun in etwa wie folgt aussehen:
Ein hellgrünes Häkchen gibt an, dass sich ein Prozess im Standby befindet und bereit
ist, bei einem Ausfall des aktiven Prozesses (dunkelgrünes Häkchen) zu übernehmen.
Externe Failover-Bestätigung
Nachdem Sie einen zweiten Server hinzugefügt haben, der die Daten-Engine oder das
Repository ausführt, können Sie auf der Registerkarte "Server" das Kontrollkästchen Externe
Hosts zur Bestätigung von Failover verwenden aktivieren. Mit dieser Option können Sie
einen oder mehrere Computer oder Websites außerhalb vom Tableau Server-Cluster
auflisten, die verwendet werden, um den Konnektivitätsstatus des Clusters bei Failover zu
prüfen.
Die Verwendung eines externen Hosts oder einer Website zur Failover-Bestätigung ist
besonders bei Tableau Server-Systemen mit zwei Knoten wie dem Folgenden nützlich:
- 169 -
In dem oben angegebenen System führen der primäre Tableau Server und ein Arbeitsserver
die aktiven und Standby-Instanzen der Daten-Engine und des Repositorys sowie der
Gateways aus. Der dritte Computer befindet sich extern vom Tableau Server-Cluster und wird
als dritter Kontaktpunkt für die beiden Gateways verwendet. Der Grund dafür ist Folgendes:
Tableau ServerWenn ein Tableau Server, der die Daten-Engine und das Repository ausführt,
die Verbindung zu anderen Knoten verliert, prüft er über einen Gateway-Prozess (der sich
extern von ihm, aber noch innerhalb des Tableau Server-Clusters befindet), welcher Knoten
ausgefallen ist und ob jetzt Standby-Prozesse aktiviert werden müssen. In einem Cluster mit
zwei Knoten ist es nicht möglich, den anderen Tableau-Gateway-Prozess zu erreichen, wenn
die Verbindung unterbrochen wird. In diesen Fällen kann ein Computer, auf dem nicht Tableau
läuft, verwendet werden, um eine einfache TCP-Verbindung herzustellen. Falls der im
Diagramm oben dargestellte Arbeitsserver keine Verbindung mehr mit dem primären Server
hat, aber noch immer mit dem externen Host verbunden ist, wäre dies der Auslöser für ihn, die
aktiven Instanzen von Daten-Engine und Repository zu starten.
Wenn der externe Host oder die Website nicht erreicht wird, kann weder die aktive noch die
Standby-Daten-Engine gestartet werden, und auf den Servern, die als Host für die DatenEngines verwendet werden, wird eine Meldung in eine der beiden Protokolldateien
geschrieben:
l
tabspawnpg.log — Wenn der Zugriff auf den externen Server beim Starten von
Tableau Server möglich ist, der externe Server jedoch beim Starten (oder Neustarten)
- 170 -
der Daten-Engine nicht verfügbar ist, wird der Fehler unter
ProgramData\Tableau\Tableau Server\data\tabsvc\logs\pgsql\tabspawnpg.log
protokolliert.
oder
l
tabadmin.log — Wenn der externe Server beim Starten von Tableau Server nicht
erreichbar ist, wird Tableau Server nicht erfolgreich gestartet, und der Fehler wird unter
ProgramData\Tableau\Tableau Server\Logs\tabadmin.log protokolliert.
Beispielprotokollmeldungen:
2013-11-04 14:42:23.934 -0800 ERROR root: Not "Primary": No
quorum. Cannot reach external failover confirmation host on
myco.example.lan:80 from 10.98.7.65
2013-11-04 14:42:23.945 -0800 ERROR root: Not "Secondary": No
quorum. Cannot reach external failover confirmation host on
myco.example.lan:80 from 10.98.7.65
Hinzufügen eines Lastenausgleichs
Sie können die Zuverlässigkeit eines Tableau Server-Clusters verbessern, indem Sie mehrere
Gateways ausführen und einen Lastenausgleich konfigurieren, um Anfragen auf die Gateways
zu verteilen. Im Gegensatz zum Repository-Prozess, der aktiv oder auf Standby sein kann,
sind alle Gateway-Prozesse aktiv. Sobald ein Gateway im Cluster nicht mehr verfügbar ist,
sendet der Lastenausgleich keine Anfragen mehr dorthin. Der von Ihnen festgelegte
Lastenausgleichs-Algorithmus bestimmt, wie die Gateways Client-Anforderungen
weiterleiten.
Wenn Sie die Erstellung eines primären Sicherungsservers planen und dieser einen GatewayProzess ausführen soll, müssen Sie dieses Gateway zusammen mit den anderen Gateways
im Lastenausgleichsmodul identifizieren.
Hinweis:Wenn Sie die Kerberos-Authentifizierung verwenden, müssen Sie Tableau
Server für den Lastenausgleich konfigurieren, bevor Sie Tableau Server für Kerberos
konfigurieren. Weitere Informationen finden Sie unter Konfigurieren von Kerberos
Auf Seite 296.
Richtlinien
Beachten Sie Folgendes, wenn Sie den Lastenausgleich für Tableau Server konfigurieren:
l
l
l
Getestete Lastenausgleichsmodule: Tableau Server-Cluster mit mehreren
Gateways wurden mit Apache- und F5-Lastenausgleichsmodulen getestet.
Tableau Server-URL: Falls sich das Lastenausgleichsmodul vor einem Tableau
Server-Cluster befindet, verwenden Tableau Server-Benutzer die URL des
Lastenausgleichsmoduls, nicht die des primären Tableau Servers.
X-Forwarded-For- und X-Forwarded-Host-Kopfzeilen: Auf der Tableau Server-
- 171 -
Verwaltungsansicht Benutzeraktivitäten werden unter anderem die IP-Adressen der
Clients angezeigt. Wenn in dieser Ansicht die IP-Adressen von Clients anstelle der IPAdressen des Lastenausgleichsmoduls für den Cluster angezeigt werden sollen,
müssen unter Umständen die Kopfzeilen X-Forwarded-For und X-Forwarded-Host
auf dem Lastenausgleichsmodul explizit aktiviert werden (bei manchen
Lastenausgleichsmodulen ist dies bereits der Fall, bei anderen jedoch nicht).
l
l
Einstellungen für einen vertrauenswürdigen Host: Der Computer, auf dem der
Lastenausgleich ausgeführt wird, muss gegenüber Tableau Server als
vertrauenswürdiger Host identifiziert sein. Das dazu erforderliche Verfahren für die
Konfiguration von Tableau Server wird weiter unten beschrieben.
Konfigurationen für Proxyserver: Die Einstellungen für die Identifikation eines
Lastenausgleichsmoduls gegenüber Tableau Server sind mit den Einstellungen
identisch, die zur Identifikation eines Proxyservers verwendet werden. Wenn der
Tableau Server-Cluster sowohl einen Proxyserver als auch einen Lastenausgleich
erfordert, ist für beide derselbe Prozess auf demselben Rechner zuständig.
Konfigurieren von Tableau Server für die Verwendung eines Lastenausgleichsmoduls
Sie können Tableau Server für die Zusammenarbeit mit einem Lastenausgleichsmodul
konfigurieren, indem Sie die folgenden Schritte ausführen.
1. Halten Sie den Server an.
2. Geben Sie im BIN-Verzeichnis von Tableau Server den folgenden Befehl ein, wobei
name für die URL steht, die zum Erreichen von Tableau Server über das
Lastenausgleichsmodul dient:
tabadmin set gateway.public.host "name"
Wenn Tableau Server beispielsweise durch Eingabe von tableau.example.com in
die Adressleiste eines Browsers erreicht wird, geben Sie folgenden Befehl ein:
tabadmin set gateway.public.host "tableau.example.com"
3. Standardmäßig wird in Tableau davon ausgegangen, dass das Lastenausgleichsmodul
Port 80 auf externe Datenübertragungen überwacht. Wenn Sie einen anderen Port
verwenden möchten, geben Sie folgenden Befehl ein, wobei port_number für den
Port steht:
tabadmin set gateway.public.port "port_number"
4. Geben Sie nun folgenden Befehl ein, wobei server für die IPv4-Adresse oder den
Computernamen des Lastenausgleichsmoduls steht:
tabadmin set gateway.trusted "server"
Bei dem Wert für server kann es sich um eine Liste mit Kommas als Trennzeichen
handeln, beispielsweise:
tabadmin set gateway.trusted "123.45.67.890, 123.45.67.880,
123.45.67.870"
oder
- 172 -
tabadmin set gateway.trusted "proxy1, proxy2, proxy3"
5. Im nächsten Befehl geben Sie alternative Namen für das Lastenausgleichsmodul an,
zum Beispiel seinen vollständig qualifizierten Domänennamen, alle nicht vollständig
qualifizierten Domänennamen und Aliasnamen. Dies sind die Namen, die die Benutzer
in einen Browser eingeben können. Trennen Sie die einzelnen Namen jeweils durch ein
Komma voneinander:
tabadmin set gateway.trusted_hosts "name1, name2, name3"
Beispiel:
tabadmin set gateway.trusted_hosts "lb.example.com, lb,
ftp.example.com, www.example.com"
6. Führen Sie den Befehl config aus:
tabadmin config
7. Starten Sie den Server, damit die Änderungen wirksam werden.
Konfigurieren eines primären Sicherungsservers
Bevor Sie die Anleitung in diesem Thema befolgen, führen Sie die Schritte unter
Konfigurieren für Failover und mehrere Gateways Auf Seite 164 aus. Nachdem Sie diese
Schritte ausgeführt haben, haben Sie zwei Arbeitsserver, die Failover-Unterstützung bieten.
Jeder Server führt auch ein Gateway aus, für das ein Lastenausgleich konfiguriert werden
kann. Der primäre Tableau Server führt einen Gateway-Prozess und Lizenzierung aus, die
nicht angezeigt oder als Prozess zugewiesen werden kann. Nachdem Sie nun Redundanz für
Daten-Engine, Repository und Gateway geschaffen haben, müssen Sie Redundanz für den
primären Tableau Server integrieren. Erstellen Sie dazu eine Sicherung. Der primäre
Sicherungsserver muss zwar während der Installation lizenziert werden, zählt aber nicht als
eine der drei Umgebungen, die im Rahmen der Endbenutzervereinbarung für Tableau
zulässig sind.
Beachten Sie, dass die Lizenzierung alle 8 Stunden überprüft wird. Wenn auf dem primären
Server nur die Lizenzierungskomponente ausgeführt wird, haben Sie nach der letzten
Lizenzierungsprüfung bis zu 8 Stunden Zeit, um den primären Sicherungsserver online zu
schalten. Während dieses Zeitfensters ist der Cluster weiterhin funktionsfähig. Wenn die
Lizenzierung beispielsweise vor 7 Stunden und 50 Minuten erfolgte, bleiben Ihnen noch
10 Minuten. Wenn die Lizenzierung vor 1 Minute erfolgte, haben Sie noch 7 Stunden und
59 Minuten Zeit. Um anzuzeigen, wann die letzte Lizenzierung überprüft wurde, öffnen Sie die
Datei checklicense_lic.log und andere Protokolldateien unter ProgramData\Tableau\Tableau
Server\data\tabsvc\logs\licensing folder.
In dem ersten Verfahren unten ist beschrieben, wie Sie eine Sicherung des primären Servers
durchführen. Das zweite Verfahren enthält eine schrittweise Anleitung, wie Sie vorgehen,
wenn der aktuelle primäre Server ausfällt.
Erstellen eines primären Sicherungsservers
Gehen Sie wie folgt vor, um einen primären Sicherungsserver zu erstellen:
- 173 -
1. Halten Sie den Server an (primärer Tableau Server).
2. Öffnen Sie auf dem primären Server als Administrator eine Eingabeaufforderung, und
wechseln Sie zum BIN-Ordner von Tableau Server:
C:\Program Files\Tableau\Tableau Server\8.3\bin
3. Version 8.1.3 und früher: Geben Sie den folgenden Befehl ein, wobei <primary1>
die IPv4-Adresse oder der Computername des aktuellen primären Servers und
<primary2> die IPv4-Adresse oder der Computername des primären
Sicherungsservers ist:
tabadmin failoverprimary --primary <primary1> --secondary
<primary2>
Version 8.1.4 und später: Geben Sie den folgenden Befehl ein, und verwenden Sie
dabei die Computernamen für die aktuellen und primären Sicherungsserver
(empfohlen) oder alle IPv4-Adressen für die aktuellen und primären Sicherungsserver.
Wenn Sie mehrere IPv4-Adressen eingeben, trennen Sie die einzelnen Adressen
jeweils durch ein Komma voneinander.
tabadmin failoverprimary --primary "primary1_name,primary2_
name"
oder
tabadmin failoverprimary --primary "primary1_IP,primary2_IP"
Wenn der Computername des aktuellen primären Servers beispielsweise TABLEAU_
SERVER lautet und der Computername des primären Sicherungsservers TABLEAU_
SERVER2, würden Sie Folgendes eingeben:
tabadmin failoverprimary --primary "TABLEAU_SERVER,TABLEAU_
SERVER2"
Es folgt ein Beispielbefehl, in dem IPv4-Adressen verwendet werden. In diesem Beispiel
hat der primäre Server (primary1_IP) die einzelne IPv4-Adresse 123.45.67.90
und der primäre Sicherungsserver (primary2_IP) die einzelne IPv4-Adresse
123.45.67.89:
tabadmin failoverprimary --primary
"123.45.67.90,123.45.67.89"
Verfügen der primäre Server und der primäre Sicherungsserver über mehrere IPv4Adressen, geben Sie alle Adressen ein. Beispiel:
tabadmin failoverprimary --primary
"123.45.67.90,123.45.67.91,123.45.67.89,123.45.67.88"
4. Erstellen Sie anschließend eine Kopie der Datei tabsvc.yml des primären Servers (im
Ordner ProgramData\Tableau\Tableau Server\config), und legen Sie die Kopie in
einem Temp-Verzeichnis auf dem primären Sicherungsserver ab.
- 174 -
Die Datei tabsvc.yml enthält die Serverkonfigurationseinstellungen. In der Datei wird
geschrieben, wenn Sie die Konfigurationseinstellungen im Dialogfeld "Tableau ServerKonfiguration" oder über tabadmin ändern. Wenn tabsvc.yml geändert wird, müssen Sie
auch die Kopie von tabsvc.yml auf dem primären Sicherungsserver aktualisieren.
5. Öffnen Sie auf dem primären Sicherungsserver die Datei tabsvc.yml, und ersetzen Sie
die IP-Adresse(n) oder den Computernamen des primären Servers durch die IPAdresse(n) oder den Computernamen des primären Sicherungsservers (des
Computers, auf dem Sie sich zurzeit befinden). Wenn auf dem primären Server wie hier
beschrieben nur die Gateway ausgeführt wird, muss lediglich die Zeile worker.hosts
bearbeitet werden. Wenn auf dem primären Server andere Prozesse ausgeführt
werden, müssen Sie die IP-Adresse(n) des primären Servers bzw. seinen Namen an
allen Stellen, an denen diese Informationen vorhanden sind, durch die Angaben des
primären Sicherungsservers ersetzen.
- 175 -
6. Installieren Sie Tableau Server auf dem primären Sicherungsserver. Verwenden Sie
dieselben RunAs-Serverkonto- und Konfigurationseinstellungen, die Sie für das
Tableau Server-Setup auf dem primären Server verwendet haben.
7. Nachdem das Setup abgeschlossen ist, halten Sie den Server an (primärer
Sicherungsserver).
8. Geben Sie auf dem primären Sicherungsserver den folgenden Befehl ein, um dessen
Tableau Server-Dienst zu deaktivieren:
- 176 -
sc config tabsvc start= disabled
Sie haben nun den primären Sicherungsserver erstellt. Im nächsten Schritt erfahren
Sie, wie Sie vorgehen, wenn der aktuelle primäre Server ausfällt. Falls Sie in einer
Testumgebung arbeiten, können Sie an diesem Punkt Ihre Konfiguration testen, indem
Sie den aktuellen primären Server herunterfahren, um einen Systemausfall zu
simulieren.
Konfiguration des primären Sicherungsservers
Folgen Sie bei einem Serverausfall dieser zweiten schrittweisen Anleitung. Alle Schritte
werden auf dem primären Sicherungsserver ausgeführt.
1. Verwenden Sie die Datei tabsvc.yml auf dem primären Sicherungsserver, die Sie in
Schritt 5 der vorhergehenden Anleitung bearbeitet haben, um die lokal installierte Datei
in ProgramData\Tableau\Tableau Server\config zu überschreiben.
2. Öffnen Sie als Administrator eine Eingabeaufforderung, und wechseln Sie zum BINVerzeichnis von Tableau Server:
C:\Program Files\Tableau\Tableau Server\8.3\bin
3. Version 8.1.3 und früher: Geben Sie den folgenden Befehl ein, wobei primary2 für
die IPv4-Adresse oder den Computernamen des primären Sicherungsservers
(zukünftig Ihr neuer primärer Server) steht und primary1 für die IPv4-Adresse oder
den Computernamen des ehemaligen primären Servers (zukünftig Ihr
Sicherungsserver):
tabadmin failoverprimary --primary <primary2> --secondary
<primary1>
Version 8.1.4 und später: Geben Sie den folgenden Befehl ein, und verwenden Sie
dabei entweder den Computernamen des primären Sicherungsservers (zukünftig der
neue primäre Server) oder die IPv4-Adressen des primären Sicherungsservers
(zukünftig der neue primäre Server) und des primären Servers (zukünftig der primäre
Sicherungsserver). Wenn Sie mehrere IPv4-Adressen eingeben, trennen Sie die
einzelnen Adressen jeweils durch ein Komma voneinander.
tabadmin failoverprimary --primary "primary2_name,primary1_
name"
oder
tabadmin failoverprimary --primary "primary2_IP,primary1_IP"
Lautet der Computername des primären Sicherungsservers TABLEAU_SERVER2 und
der Name des vorherigen primären Servers TABLEAU_SERVER, geben Sie Folgendes
ein:
tabadmin failoverprimary --primary "TABLEAU_SERVER2,TABLEAU_
SERVER"
- 177 -
Es folgt ein Beispiel für die Verwendung von IPv4-Adressen. In diesem Beispiel hat der
primäre Sicherungsserver (primary2_IP) die einzelne IPv4-Adresse
123.45.67.89 und der vorherige primäre Server (primary1_IP) die einzelne IPv4Adresse 123.45.67.90:
tabadmin failoverprimary --primary
"123.45.67.89,123.45.67.90"
Weisen der primäre Sicherungsserver und der vorherige primäre Server mehrere IPv4Adressen auf, geben Sie alle Adressen ein. Beispiel:
tabadmin failoverprimary --primary
"123.45.67.89,123.45.67.88,123.45.67.90,123.45.67.91"
4. Geben Sie folgenden Befehl ein:
sc config tabsvc start= auto
5. Starten Sie den Server. Der Sicherungsserver ist nun der primäre Server. In der
Statustabelle auf der Wartungsseite hat sich die IP-Adresse oder der Computername
des primären Servers geändert:
6. Da der vorherige primäre Server nun als Sicherungsserver dient, müssen Sie
Folgendes ausführen:
l
l
l
Entfernen Sie Tableau Server über die Option zum Hinzufügen/Entfernen von
Programmen vom vorherigen primären Server. Am Ende des
Deinstallationsprogramms wird ein Backup-Fehler angezeigt, den Sie ignorieren
können.
Löschen Sie die Tableau-Ordner unter "Program Files" und "ProgramData" auf
dem vorherigen primären Server.
Wiederholen Sie die Schritte in diesem Thema ab Schritt 4 unter "Erstellen eines
primären Sicherungsservers".
Arbeiten mit Servern
In den folgenden Themen erhalten Sie Informationen zur Verwendung der Tableau ServerBenutzeroberfläche zur Verwaltung der Installation:
Benutzer und Lizenzen
Jeder, der auf Tableau Server zugreifen muss, sei es, um Daten zu veröffentlichen, zu
durchsuchen oder zu verwalten, muss als Benutzer hinzugefügt werden. Zudem muss
Benutzern eine Lizenzebene zugewiesen werden.
- 178 -
Benutzer
Jede Person, die zum Veröffentlichen, Durchsuchen oder Verwalten auf Tableau
Serverzugreifen muss, muss als Benutzer hinzugefügt werden. Wenn Tableau Server
mehrere Sites ausführt, können Systemadministratoren dies auf der Seite Alle Benutzer
durchführen. Wenn Tableau Server dagegen nur eine Site ausführt, können System- und SiteAdministratoren Benutzer auf der Seite Benutzer hinzufügen.
Standardbenutzer
Tableau Server erstellt automatisch das "Tableau Software"-Benutzerkonto und weist diesem
eine der verfügbaren Interactor-Lizenzen zu. Dieses Konto wird zum Veröffentlichen von
Beispiel-Arbeitsmappen verwendet. Standardmäßig hat dieses Konto kein Kennwort, und es
kann nicht zum Anmelden verwendet werden.
Sie können entweder die Lizenzstufe dieses Kontos ändern, sodass die Lizenz auch anderen
Benutzern zur Verfügung steht (siehe Ändern von Lizenzstufen Auf Seite 195). Wenn aber
der Server so konfiguriert ist, dass das interne Benutzerverwaltungssystem verwendet wird
(lokale Authentifizierung), können Sie dem Konto auch ein Kennwort hinzufügen und so den
Zugriff erlauben (siehe Bearbeiten von Benutzern Auf Seite 191)
Nachdem Benutzer hinzugefügt worden sind, können Sie diese bearbeiten und löschen, sie zu
Sites hinzufügen und von dort entfernen und ihnen Lizenzstufen und Benutzerrechte
zuweisen. Weitere Informationen dazu finden Sie unter den folgenden Themen.
Hinzufügen von Benutzern
Sowohl System- als auch Site-Administratoren mit den richtigen Berechtigungen können
Benutzer auf der Seite Benutzer hinzufügen:
- 179 -
So fügen Sie einen Benutzer hinzu:
1. Klicken Sie auf der Seite Benutzer über der Benutzerliste auf den Link Hinzufügen:
2. Geben Sie einen Benutzernamen ein.
l
l
Lokale Authentifizierung: Wenn der Server für lokale Authentifizierung
konfiguriert ist, lassen sich Benutzernamenskonflikte am besten durch die
Angabe der E-Mail-Adresse als Benutzername vermeiden (z. B.
[email protected] statt jsmith). Klicken Sie nach der Eingabe in
Benutzername auf Benutzer hinzufügen.
Active Directory: Wenn Sie einen Benutzer hinzufügen, der derselben Active
Directory-Domäne wie der Server angehört, dann können Sie den
Benutzernamen ohne die Domäne eingeben. Dann wird die Domäne des
Servers angenommen.
Wenn eine bidirektionale Vertrauensstellung zwischen der Domäne des Servers
und einer anderen Domäne eingerichtet worden ist, dann können Sie Benutzer
aus beiden Domänen hinzufügen. Beim ersten Hinzufügen eines Benutzers aus
der "Nicht-Server-Domäne" müssen Sie den Benutzernamen mit dem vollständig
qualifizierten Domänennamen angeben. Nachfolgende Benutzer können mithilfe
des Domänenspitznamens hinzugefügt werden. Beispielsweise geben Sie den
ersten Benutzer aus der "Nicht-Server-Domäne" mybiz.lan als [email protected]
oder mybiz.lan\user1 ein. Der nächste Benutzer kann dann mithilfe des
Domänenspitznamens hinzugefügt werden, z. B. user2@mybiz oder
mybiz\user2.
Hinweis: Geben Sie in diesem Feld nicht den Vollständigen Namen ein, da
dieser beim Import Fehler verursachen kann.
3. Nur lokale Authentifizierung: Geben Sie Folgendes an:
l
Vollständiger Name: Geben Sie einen Anzeigenamen für den Benutzer ein
(z. B. John Smith).
- 180 -
l
Kennwort: Geben Sie ein Kennwort für den Benutzer ein.
l
Bestätigen: Geben Sie das Kennwort noch einmal ein.
4. Lizenzstufe: Wählen Sie eine Lizenzstufe aus. Weitere Informationen hierzu finden Sie
unter Lizenzen und Benutzerrechte Auf Seite 193 und Berechtigungsreferenz Auf
Seite 98.
5. Benutzerrechte: Legen Sie fest, ob der Benutzer Arbeitsmappen veröffentlichen und
Administratorrechte zuweisen kann. Weitere Informationen finden Sie unter Gewähren
und Verweigern von Benutzerrechten Auf Seite 198.
6. Klicken Sie auf Hinzufügen.
Hinweis für Server mit mehreren Sites:
Site-Administratoren können das Konto eines bestehenden Benutzers bearbeiten, sofern
dieser nur Mitglied von Sites ist, die vom betreffenden Site-Administrator verwaltet werden.
Angenommen, der Benutzer Joe ist Mitglied von Site A und Site B und der Site-Administrator
ist nur Administrator von Site B, dann kann der Site-Administrator weder den vollständigen
Namen von Joe bearbeiten noch sein Kennwort zurücksetzen.
Hinzufügen von Benutzern zu einer Site
Wenn Sie eine Site zu Tableau Server hinzugefügt haben, entsteht ein System mit mehreren
Sites, und das, was zuvor die Seite Benutzer gewesen ist, wird nun zu zwei Seiten: Alle
Benutzer und Site-Benutzer. Als Systemadministrator können nur Sie auf die Seite Alle
Benutzerzugreifen. Dies gilt für das gesamte Serversystem. Dies ist die einzige Stelle, von der
aus Sie gleichzeitig mehreren Sites Benutzer hinzufügen, Benutzer entfernen und, sofern auf
dem Server die lokale Authentifizierung verwendet wird, Kennwörter zurücksetzen können.
- 181 -
Die Seite Site-Benutzer ist bietet eine einfache Übersicht darüber, welche Benutzer sich auf
der Site befinden, bei der Sie aktuell angemeldet sind. Sie können hier Benutzer hinzufügen,
aber diese werden nur zu dieser Site hinzugefügt.
Im Folgenden werden die Schritte für das Hinzufügen von Benutzern von der Seite Alle
Benutzer aus beschrieben. Dies kann auf zweierlei Weise geschehen: Einzeln (siehe
Beschreibung unten) oder in Gruppen mithilfe des Importieren-Befehls, der auf einer CSVDatei basiert (siehe Beschreibung in Importieren von Benutzern aus einer CSV-Datei Auf
der nächsten Seite).
So fügen Sie einen Benutzer hinzu:
1. Klicken Sie auf der Seite Alle Benutzer am Anfang der Benutzerliste auf den Link
Hinzufügen:
- 182 -
2. Geben Sie einen Benutzernamen ein:
l
l
Lokale Authentifizierung: Wenn auf dem Server die lokale Authentifizierung
verwendet wird, dann lassen sich Benutzernamenskonflikte am besten durch die
Angabe der E-Mail-Adresse als Benutzername vermeiden (z. B.
[email protected] statt jsmith).
Active Directory— Wenn Sie einen Benutzer hinzufügen, der derselben Active
Directory-Domäne wie der Server angehört, dann können Sie den
Benutzernamen ohne die Domäne eingeben. Dann wird die Domäne des
Servers angenommen.
Wenn eine bidirektionale Vertrauensstellung zwischen der Domäne des Servers
und einer anderen Domäne eingerichtet worden ist, dann können Sie Benutzer
aus beiden Domänen hinzufügen. Beim ersten Hinzufügen eines Benutzers aus
der "Nicht-Server-Domäne" müssen Sie den Benutzernamen mit dem vollständig
qualifizierten Domänennamen angeben. Nachfolgende Benutzer können mithilfe
des Domänenspitznamens hinzugefügt werden. Beispielsweise geben Sie den
ersten Benutzer aus der "Nicht-Server-Domäne" mybiz.lan als [email protected]
oder mybiz.lan\user1 ein. Der nächste Benutzer kann dann mithilfe des
Domänenspitznamens hinzugefügt werden, z. B. user2@mybiz oder
mybiz\user2.
Hinweis: Geben Sie in diesem Feld nicht den Vollständigen Namen ein, da
dieser beim Import Fehler verursachen kann.
3. Wenn der Server die lokale Authentifizierung verwendet, müssen Sie Folgendes
angeben:
l
Vollständiger Name: Geben Sie einen Anzeigenamen für den Benutzer ein
(z. B. John Smith).
l
Kennwort: Geben Sie ein Kennwort für den Benutzer ein.
l
Bestätigen: Geben Sie das Kennwort noch einmal ein.
4. Sitemitgliedschaft: Wählen Sie die Site/s aus, der/denen der Benutzer angehören soll.
Standardmäßig wird die Site ausgewählt, bei der Sie angemeldet sind.
5. Lizenzstufe und Benutzerrechte: Wählen Sie eine Lizenzstufe und Administratorrolle
aus, und legen Sie fest, ob der Benutzer Arbeitsmappen und Datenquellen
veröffentlichen kann. Benutzer, die Mitglied mehrerer Sites sind, können bei jeder Site
über andere Lizenzstufen und Benutzerrechte verfügen. Weitere Informationen finden
Sie unter Grundlegendes zu Lizenzstufen Auf Seite 193, Berechtigungsreferenz
Auf Seite 98 und Grundlegendes zu Benutzerrechten Auf Seite 196.
6. Klicken Sie auf Benutzer hinzufügen.
Importieren von Benutzern aus einer CSV-Datei
Sie können das Hinzufügen von Benutzern mithilfe einer CSV-Datei automatisieren.
Anforderungen
- 183 -
l
l
l
l
Die CSV-Datei muss im UTF-8-Format mit der Bytereihenfolge-Markierung (BOM)
gespeichert werden.
Von UTF-8 abweichende Zeichenkodierungen, wie z. B. BIG-5, müssen konvertiert
werden. Sie können hierzu die Option "Speichern unter" verwenden.
Verwenden Sie keine Spaltenköpfe. Wenn Sie Spaltenköpfe (Username, Password
usw.) verwenden, versucht Tableau Server, diese als Anmeldeinformationen für den
ersten Benutzer in der Datei zu importieren.
Die beiden folgenden Spalten sind stets erforderlich:
l
l
l
Password: Wenn in Tableau Server die Active Directory-Authentifizierung
verwendet wird, dann muss der Spaltenkopf Password vorhanden sein, die
Kennwortspalte sollte jedoch leer gelassen werden. Wenn der Server die lokale
Authentifizierung verwendet, müssen Sie Kennwörter für neue Benutzer
angeben. Weitere Informationen finden Sie unter "Umgebung mit mehreren Sites
und Ausgangsposition für den Import".
Die CSV-Datei kann auch die folgenden optionalen Spalten in der unten angezeigten
Reihenfolge enthalten (nach den Spalten Username und Password ):
l
l
l
Username
Full Name
License Level (Interactor/Viewer/Unlicensed) (Interakteur/Betrachter/Nicht
lizenziert)
l
Administrator (System, Site, Site oder None)
l
Publisher (yes/true/1 oder no/false/0)
l
Email Address
Die Reihenfolge der Spalten ist unbedingt zu beachten. Die erste Spalte wird unabhängig vom Spalteninhalt als Username, die zweite als Password, die dritte als Full
Name usw. behandelt.
Umgebung mit mehreren Sites und Ausgangsposition für den Import
Wenn der Server mehrere Sites ausführt und Sie Systemadministrator sind, dann können Sie
von zwei Seiten aus einen Benutzerimport über eine CSV-Datei ausführen. Jede Seite verfügt
über verschiedene Funktionen in Bezug auf vorhandene Serverbenutzerkonten.
l
Seite Alle Benutzer: Diese Seite wird angezeigt, wenn Tableau Server mehrere Sites
ausführt, und nur Systemadministratoren können darauf zugreifen.
- 184 -
Wenn Sie eine CSV-Datei mit Benutzerdaten von hier aus importieren, können Sie
sowohl vorhandene Serverbenutzerkonten aktualisieren als auch neue Konten
hinzufügen. Wenn Sie einen Import von CSV-Daten durchführen, die für jeden
vorhandenen Benutzer ein neues Kennwort enthalten, dann werden die Kennwörter
zurückgesetzt.
Die Seite Site-Benutzer:
l
- 185 -
Wenn der Systemadministrator von hier aus startet, hat er die gleichen Rechte wie SiteAdministratoren. Das heißt, er kann mit dem CSV-Import neue Benutzerkonten
hinzufügen. Wenn die importierten Daten bestehende Benutzer enthalten, dann
müssen die Felder Kennwort und Vollständiger Name entweder mit den
vorhandenen Daten übereinstimmen oder leer gelassen werden. Wenn neue
Kennwörter oder vollständige Namen angegeben werden, schlägt der Import fehl.
Wenn Sie Site-Administrator auf einem Server mit mehreren Sites sind, können Sie von der
Seite Benutzer aus einen CSV-Benutzerimport ausführen.
Benutzer können Mitglied mehrerer Sites auf einem Serversystem sein, müssen aber für jede
Site dieselben Anmeldeinformationen verwenden. Dies ist dann relevant, wenn Sie Benutzer
hinzufügen, die kein Mitglied der Site, aber möglicherweise schon Serverbenutzer sind
(anders ausgedrückt, sie sind bereits Mitglied einer anderen Site auf dem Server). Wenn Sie
vermuten, dass dies der Fall ist, lassen Sie die Spalte Password leer (geben jedoch den
erforderlichen Spaltenkopf Password an). Wenn der Server für die Verwendung der lokalen
Authentifizierung konfiguriert wurde und ein neuer Sitebenutzer auch im Serversystem neu ist,
dann wird im CSV-Importfenster eine Meldung angezeigt, die Sie zur Eingabe eines
Kennworts für den Benutzer auffordert.
Hinzufügen von Benutzern aus einer CSV-Datei
So fügen Sie Benutzer aus einer CSV-Datei hinzu:
- 186 -
1. Klicken Sie auf der Seite Benutzer oder Alle Benutzer auf den Link Importieren:
2. Klicken Sie auf Durchsuchen, navigieren Sie zu der Datei, und klicken Sie auf Datei
überprüfen:
3. Es werden vorläufige Ergebnisse angezeigt. Zur Anzeige kontospezifischer
Informationen wählen Sie Details einblenden aus:
4. Um fortzufahren, klicken Sie auf Benutzer importieren und im letzten Dialogfeld auf
Beenden.
Hinzufügen von Benutzern zu einer Gruppe
Eine Methode zur Vereinfachung der Verwaltung von Benutzern ist die Zuweisung von
Benutzern zu Gruppen. Berechtigungen können dann einer gesamten Gruppe statt jedem
einzelnen Benutzer zugewiesen werden. Benutzer können nur einer bereits vorhandenen
Gruppe zugewiesen werden. Weitere Informationen erhalten Sie unter Erstellen von
Gruppen Auf Seite 199.
So fügen Sie einen Benutzer einer Gruppe hinzu:
- 187 -
1. Öffnen Sie die auf der Registerkarte "Admin" die Seite "Benutzer":
Wenn Sie Systemadministrator für einen Server sind, der mehrere Sites ausführt,
müssen Sie dies auf Site-Basis mithilfe der Seite "Site-Benutzer" ausführen:
2. Wählen Sie einen oder mehrere Benutzer aus.
3. Klicken Sie auf den Link Gruppe + über der Benutzerliste, und wählen Sie dann die
Gruppe aus, zu der Sie Benutzer hinzufügen möchten:
- 188 -
Anzeigen, Bearbeiten und Löschen von Benutzern
In diesem Thema erfahren Sie, wie Tableau Server-Benutzer angezeigt, bearbeitet und
gelöscht werden.
Anzeigen von Benutzern
Wenn Tableau Server mehrere Sites ausführt, werden unter Alle Benutzer alle Benutzer des
Serversystems aufgelistet, und unter Site-Benutzer werden alle Benutzer der Site angezeigt,
bei der Sie gegenwärtig angemeldet sind:
Hinweis:
Die Liste der Benutzer ist standardmäßig privat und kann nur von Administratoren angezeigt
werden. Sie können die Benutzerliste öffentlich machen, indem Sie in den Einstellungen auf
der Wartungsseite die Option "Public User List" (Öffentliche Benutzerliste) aktivieren. Wenn
der Server mehrere Websites ausführt, dann bewirkt die Aktivierung dieser Einstellung, dass
die Benutzer nur die Namen der Benutzer ihrer Website anzeigen können.
- 189 -
Benutzer können auf mehreren Seiten aufgelistet werden. Wenn Sie Benutzer in der Liste
auswählen, werden diese der Liste zur Schnellauswahl in der linken obere Ecke hinzugefügt.
Dieser Liste können Sie entnehmen, wie viele Benutzer Sie ausgewählt haben, und Sie
können dann rasch Benutzer aus der Auswahl entfernen. Klicken Sie auf die Schaltfläche "x"
neben dem Benutzernamen in der Schnellauswahlliste, um einen Benutzer aus der Auswahl
zu entfernen.
Mithilfe des Felds Suchen links unter Filter können Sie schnell bestimmte Benutzer in der
Liste finden.
Geben Sie den gesamten Benutzernamen oder einen Namensteil ein, und drücken Sie die
Eingabetaste. Sie können das Sternchen (*) als Platzhalterzeichen in der Suche verwenden.
Wenn Sie z. B. nach John* suchen, werden alle Namen zurückgegeben, die mit John
beginnen.
Veröffentlichungsrechte
Administratoren können die Benutzerliste einsehen, um festzustellen, wer über
Veröffentlichungsrechte verfügt und ob es sich dabei um explizite oder implizite Rechte
handelt. Wenn die Einstellung für explizite Rechte gewählt wurde, wird die QuickInfo Zulässig
(gewährt) angezeigt, wenn Sie mit der Maus auf das grüne Häkchen in der Spalte
"Veröffentlichen" zeigen:
- 190 -
Benutzer, die veröffentlichen können, weil es sich um Administratoren oder Projektleiter
handelt, verfügen über implizite Veröffentlichungsrechte. Sie erhalten also die Rechte
aufgrund ihrer Rolle. Wenn Sie mit der Maus auf das Häkchen zeigen, erscheint die QuickInfo
Zulässig (implizit):
Bearbeiten von Benutzern
Wenn der Server für die Verwendung des internen Benutzerverwaltungssystems (Lokale
Authentifizierung) anstelle von Active Directory konfiguriert ist, können Sie den
Anzeigenamen und das Kennwort von hinzugefügten Benutzern bearbeiten. Wenn Sie viele
Änderungen vornehmen, empfiehlt sich das Importieren der Änderungen aus einer CSVDatei. Weitere Informationen finden Sie unter Hinzufügen von Benutzern Auf Seite 179.
So bearbeiten Sie Benutzerinformationen:
1. Wählen Sie einen Benutzer in der Benutzerliste aus.
2. Klicken Sie oben in der Liste auf den Link Bearbeiten.
3. Geben Sie in die Textfelder Anzeigename und Kennwort einen neuen Anzeigenamen
- 191 -
bzw. ein neues Kennwort ein.
4. Klicken Sie auf Absenden.
Hinweis für Server mit mehreren Sites:
Site-Administratoren können das Konto eines bestehenden Benutzers bearbeiten, sofern
dieser nur Mitglied von Sites ist, die vom betreffenden Site-Administrator verwaltet werden.
Angenommen, der Benutzer Joe ist Mitglied von Site A und Site B und der Site-Administrator
ist nur Administrator von Site B, dann kann der Site-Administrator weder den vollständigen
Namen von Joe bearbeiten noch sein Kennwort zurücksetzen.
Löschen von Benutzern
So löschen Sie Benutzer:
1. Wählen Sie einen oder mehrere Benutzer aus, die gelöscht werden sollen.
2. Klicken Sie oben in der Liste auf den Link Löschen.
3. Klicken Sie im Bestätigungsdialog auf Ja.
- 192 -
Sie können einen Benutzer nur aus Tableau Server entfernen, wenn der Benutzer keine
Inhalte (Arbeitsmappen, Datenquellen usw.) besitzt. Wenn Sie das vorstehend
beschriebene Verfahren auf einen Benutzer anwenden, der Inhalte besitzt, wird der
Benutzer auf "Unlicensed" gesetzt, jedoch nicht entfernt.
Lizenzen und Benutzerrechte
Die Lizenzstufe und Benutzerrechte, die Sie Benutzern zuweisen, bestimmen den Umfang an
möglichen Aktivitäten in Tableau Server.
Grundlegendes zu Lizenzstufen
Um die Seite "Lizenzen" zu öffnen, klicken Sie auf der Registerkarte "Admin" auf den Link
Lizenzen:
Allen Benutzern auf Tableau Server muss eine Lizenzstufe zugewiesen werden, selbst wenn
diese Stufe "Nicht lizenziert" lautet. Die Lizenzstufen von Tableau Server entsprechen nicht
den nach Tableau Server benannten Benutzerlizenzen, die Sie bei Tableau erworben haben
(wenn Sie eine benutzerbasierte anstelle einer core-basierten Serverlizenzierung
verwenden). Diese Lizenzen ermöglichen Ihnen eine bestimmte Anzahl von Benutzern auf
dem Server. Lizenzstufen ermöglichen Administratoren die Steuerung des Zugriffs von
Benutzern auf der Site.
Sie können die folgenden Lizenzstufen zuweisen:
Lizenzstufe
Nicht lizenziert
Beschreibung
Der Benutzer kann sich
nicht beim Server anmel-
- 193 -
Lizenzstufe
Viewer
Interactor
Guest (Gast)
Beschreibung
den. Alle Benutzer werden
standardmäßig als nicht
lizenzierte Benutzer hinzufügt.
Der Benutzer kann sich
anmelden und veröffentlichte Ansichten auf
dem Server anzeigen,
jedoch nicht mit den Ansichten interagieren. Benutzer
mit dieser Ebene können
nur die Berechtigung zum
Anzeigen, Hinzufügen von
Kommentaren und Anzeigen von Kommentaren
erhalten. Sie können nicht
mit Schnellfiltern interagieren oder Daten in einer
Ansicht sortieren.
Der Benutzer kann sich
anmelden, den Server
durchsuchen und mit veröffentlichten Ansichten interagieren. Dabei ist es wichtig
zu wissen, dass bestimmte
Ansichten, Arbeitsmappen
und Projekte möglicherweise mit Berechtigungen hinzugefügt
wurden, die Benutzerrechte
einschränken. Berechtigungseinstellungen können vom Autor der
Arbeitsmappe oder von
einem Administrator bearbeitet werden.
Die GastLizenzstufe ist verfügbar, um es Benutzern
ohne Konto auf dem Server
zu ermöglichen, eine eingebettete Ansicht anzuzeigen und damit zu
interagieren. Wenn diese
- 194 -
Lizenzstufe
Beschreibung
Ebene aktiviert wurde, kann
der Benutzer eine Webseite
mit einer eingebetteten
Ansicht laden, ohne sich
anmelden zu müssen.
Diese Option ist nur bei
einem core-basierten Server verfügbar.
Wenn Sie über eine benutzerbasierte Tableau Server-Lizenz verfügen, können Sie prüfen,
wie diese Stufen auf der Lizenzseite verteilt wurden.
Wenn Sie über eine kernbasierte Tableau Server-Lizenz verfügen, wird auf der Lizenzseite
angezeigt, ob Gastverbindungen zulässig sind:
Hier ist ebenfalls zu sehen, wie viele Kerne für Sie lizenziert sind und wie viele verwendet
werden:
Ändern von Lizenzstufen
Eine Lizenzstufe wird für gewöhnlich bei der Erstellung eines Benutzers zugewiesen.Führen
Sie die folgenden Schritte aus, um die Lizenzstufe für einen oder mehrere Benutzer zu ändern:
- 195 -
1. Klicken Sie auf der Registerkarte "Admin" auf Benutzer.
2. Wählen Sie einen oder mehrere Benutzer aus.
3. Klicken Sie oben in der Liste auf den Link Lizenzbenutzer.
4. Wählen Sie für die gewählten Benutzer Nicht lizenziert, Viewer (Betrachter) oder
Interactor (Interakteur) aus.
In der Benutzerliste wird die Spalte Lizenzstufe aktualisiert, um die vorgenommenen
Änderungen widerzuspiegeln.
Grundlegendes zu Benutzerrechten
Außer der Lizenzstufe werden die Berechtigungen eines Benutzers auf Tableau Server auch
durch die jeweiligen Benutzerrechte bestimmt.
- 196 -
Benutzerrecht
Veröffentlichen
Admin
Beschreibung
Ermöglicht Benutzern die Verbindung
mit Tableau Server aus Tableau
Desktop, um Arbeitsmappen und
Datenquellen zu veröffentlichen und
herunterzuladen.
Verleiht dem Benutzer
Administratorrechte.
Es gibt zwei Arten von Administratoren:
Site-Administratoren und
Systemadministratoren.
l
l
Site-Administratoren können
Gruppen, Projekte,
Arbeitsmappen und
Datenverbindungen verwalten.
Site-Administratoren können
standardmäßig auch Benutzer
hinzufügen sowie
Benutzerrechte und
Lizenzstufen zuweisen, diese
Einstellungen können jedoch von
einem Systemadministrator
deaktiviert werden (siehe
Hinzufügen oder Bearbeiten
von Sites Auf Seite 222).
Systemadministratoren
verfügen über sämtliche Rechte
von Site-Administratoren und
können zusätzlich nicht
lizenzierte Benutzer lizenzieren,
steuern, ob Site-Administratoren
Benutzer hinzufügen können,
weitere Systemadministratoren
erstellen und den Server
verwalten. Hierzu gehören die
Durchführung von
Wartungsaufgaben, das
Festlegen von Zeitplänen und
die Verwaltung des Suchindex.
Das Admin-Recht kann nur
Benutzern mit der Lizenzstufe
"Interactor" (Interakteur) und
dem Veröffentlichen-Recht
- 197 -
Benutzerrecht
Beschreibung
zugewiesen werden.
Gewähren und Verweigern von Benutzerrechten
Benutzerrechte werden für gewöhnlich bei der Erstellung eines Benutzers
zugewiesen.Führen Sie die folgenden Schritte aus, um die Benutzerrechte für einen oder
mehrere Benutzer zu ändern:
1. Klicken Sie auf der Registerkarte "Admin" auf Benutzer.
2. Wählen Sie einen oder mehrere Benutzer aus.
3. Klicken Sie oben in der Liste auf Veröffentlichen oder Admin.
4. Wählen Sie Zulassen oder Verweigern aus, um das Veröffentlichungsrecht für den/die
ausgewählten Benutzer zu ändern.
- 198 -
5. Wählen Sie unter Admin entweder System, Site oder Keine aus, um die Adminrechte
für die ausgewählten Benutzer zu ändern. In der Benutzerliste werden die Spalten
"Admin" und "Publish" (Veröffentlichen) aktualisiert, um die vorgenommenen
Änderungen widerzuspiegeln.
Gruppen und Projekte
Gruppen und Projekte unterstützen Sie bei der Verwaltung von Arbeitsmappen und Benutzern
in Tableau Server.
Gruppen
Sie können die Tableau Server-Benutzer in Gruppen unterteilen und sich so bei einer
größeren Anzahl von Benutzern die Verwaltung erleichtern. Gruppen können entweder lokal
auf dem Server erstellt oder aus Active Directory importiert werden. Erstellen und verwalten
können Sie Gruppen auf der Gruppenseite. Dort sind alle Gruppen aufgelistet, die auf dem
Server oder der Website (bei einem Server, auf dem mehrere Websites gehostet sind)
vorhanden sind.
Erstellen von Gruppen
Je nach Konfiguration des Servers, können Sie Gruppen mit dem internen
Benutzerverwaltungssystem (lokale Authentifizierung) hinzufügen oder aus Active Directory
importieren.
Erstellen einer lokalen Gruppe
Lokale Gruppen werden mit dem internen Benutzerverwaltungssystem auf Tableau Server
erstellt. Nach dem Erstellen einer Gruppe können Sie Benutzer hinzufügen und entfernen. So
erstellen Sie eine lokale Gruppe:
1. Klicken Sie oben in der Liste mit den Gruppen auf Neu.
- 199 -
2. Geben Sie einen Namen für die Gruppe ein, und klicken Sie auf Gruppe hinzufügen:
3. Klicken Sie auf Return to Groups (Zurück zu Gruppen), um zur Liste der Gruppen
zurückzukehren.
Erstellen einer Gruppe über Active Directory
Gruppen können auch aus Active Directory importiert werden. Wenn Sie Active DirectoryGruppen importieren, wird eine entsprechende Gruppe auf dem Server erstellt, und für jedes
Gruppenmitglied wird ein Benutzer auf dem Server erstellt. Jeder Benutzer ist nicht lizenziert
und verfügt nicht über die Berechtigung zum Veröffentlichen. Wenn der Benutzer bereits auf
dem Server vorhanden ist, wird er der neuen Gruppe hinzugefügt und seine Berechtigungen
werden nicht geändert. Weitere Informationen zu Lizenzstufen und Benutzerrechten finden
Sie unter Lizenzen und Benutzerrechte Auf Seite 193.
1. Klicken Sie am unteren Rand der Gruppenliste auf Active Directory-Gruppe
importieren.
2. Geben Sie den Namen der zu importierenden Active Directory-Gruppe ein, und klicken
Sie auf Importieren.
3. Wenn Sie nicht wissen, wie der genaue Name der Gruppe lautet, können Sie ihn
- 200 -
ermitteln, indem Sie einen Teil des Gruppennamens in das Textfeld "Suchen" eingeben.
Klicken Sie anschließend auf Suchen. Verwenden Sie ggf. das Sternchen (*) als
Platzhalterzeichen.
4. Wählen Sie die Gruppe in der Liste der Suchergebnisse aus.
5. Der Gruppenname wird automatisch dem Textfeld "Import" (Importieren) hinzugefügt.
Klicken Sie auf Importieren, um die Gruppe Tableau Server hinzuzufügen.
Hinweis: Der Name von Gruppen, die aus Active Directory importiert worden sind, kann
nicht geändert werden. Der Gruppenname kann nur in Active Directory geändert
werden.
Synchronisieren einer Active Directory-Gruppe
Sie können eine Active Directory-Gruppe jederzeit mit Tableau Server synchronisieren,
sodass neue Active Directory-Benutzer auch dem Server hinzugefügt werden. Sie können
einzelne Gruppen oder mehrere Gruppen gleichzeitig synchronisieren.
1. Wählen Sie auf der Gruppenseite eine oder mehrere Gruppen aus.
2. Klicken Sie auf Synchronisieren.
- 201 -
Wenn Sie eine Gruppe hinzufügen, die derselben Active Directory-Domäne wie der
Server angehört, dann können Sie einfach den Gruppennamen eintippen. Wenn eine
bidirektionale Vertrauensstellung zwischen der Domäne, in der der Server ausgeführt
wird, und einer anderen Domäne eingerichtet worden ist, dann können Sie Gruppen aus
beiden Domänen hinzufügen. Wenn Sie zum ersten Mal eine Gruppe aus einer anderen
Domäne als der Domäne, in der der Server ausgeführt wird, hinzufügen, müssen Sie
den Gruppennamen zusammen mit dem vollständig qualifizierten Domänennamen
angeben. Beispiel: domain.lan\group oder [email protected]. Alle nachfolgenden
Gruppen können unter Verwendung des Spitznamens der Domäne hinzugefügt
werden.Nähere Informationen zum Verwalten von Domänennamen finden Sie unter
Ändern von Domänennamen Auf Seite 117.
Benutzer werden entfernt
Wenn Sie einen Benutzer aus Active Directory entfernen und dann mit der Gruppe dieses
Benutzers synchronisieren, wird der Benutzer:
l
Aus der Tableau Server-Gruppe entfernt, die Sie synchronisiert haben.
l
In Tableau Server in der Gruppe "Alle Benutzer" platziert.
l
Anmeldung in Tableau Server fehlgeschlagen.
Da der Benutzer weiter am Server als Administrator angemeldet bleibt, können Sie den Inhalt
des Benutzers prüfen und neu zuweisen, bevor Sie das zugehörige Konto vollständig
entfernen. Der Benutzer kann sich dann nicht beim Server anmelden. Um den Benutzer
vollständig aus Tableau Server zu entfernen, gehen Sie wie folgt vor:
l
l
Deaktivieren Sie die Lizenz für das Benutzerkonto (wenn in Tableau Server eine
benutzerdefinierte Lizenzierung verwendet wird)
Löschen Sie den Benutzer von der Seite "Alle Benutzer" in Tableau Server.
- 202 -
Löschen von Gruppen
Sie können jede beliebige Gruppe vom Server löschen. Wenn Sie eine Gruppe löschen,
werden die Benutzer aus der Gruppe entfernt, aber nicht vom Server gelöscht.
1. Wählen Sie auf der Seite "Gruppen" eine oder mehrere Gruppen aus, die Sie löschen
möchten.
2. Klicken Sie über der Gruppenliste auf Löschen:
Projekte
Ein Projekt ist eine Sammlung verwandter Arbeitsmappen. Als Administrator können Sie an
zwei Orten eine Liste der Projekte einsehen: Unter der Registerkarte Inhalt sowie unter der
Registerkarte Admin. Verwenden Sie unter der Registerkarte Admin die Seite Projekte,
wenn Sie neue Projekte erstellen, Berechtigungen zuweisen oder Projekte löschen möchten, :
- 203 -
Zwar können nur Administratoren neue Projekte erstellen, doch kann Benutzern und Gruppen
die Berechtigung "Projektleiter" zugewiesen werden. Benutzer oder Gruppen mit dieser
Berechtigung können Projektberechtigungen bestimmen und Arbeitsmappen in Projekte
verschieben. Informationen zu den Vorgehensweisen und zur Arbeit mit Projekten finden Sie
in nachfolgenden Themen:
Hinzufügen von Projekten
So fügen Sie ein oder mehrere Projekt/e hinzu:
1. Klicken Sie auf den Link Hinzufügen.
2. Geben Sie einen Namen und eine Beschreibung für das Projekt ein, und klicken Sie auf
Hinzufügen. Sie können in der Projektbeschreibung Formatierungen und Hyperlinks
verwenden.
Verschieben von Arbeitsmappen in Projekte
Alle Arbeitsmappen müssen zu einem Projekt gehören.Standardmäßig werden alle
Arbeitsmappen einem Projekt namens Standard hinzugefügt. Nachdem Sie eigene Projekte
- 204 -
erstellt haben, können Sie Arbeitsmappen zwischen Projekten verschieben.Sie können
Arbeitsmappen in Projekte verschieben, wenn Sie über die Lizenzstufe "Interactor" verfügen
und mindestens eine der folgenden Bedingungen erfüllt ist:
l
Sie verfügen über die Berechtigung zum Schreiben im Projekt.
l
Sie verfügen über die Berechtigung "Project Leader" (Projektleiter) für das Projekt.
l
Sie verfügen über das Admin-Recht.
So verschieben Sie eine Arbeitsmappe in ein Projekt:
1. Wählen Sie eine oder mehrere Arbeitsmappe/n, und klicken Sie auf den Link
Verschieben über der Liste mit Arbeitsmappen.
2. Wählen Sie ein Projekt aus, in das die Arbeitsmappe verschoben werden soll.
Da alle Arbeitsmappen Bestandteil eines Projekts sein müssen, können Sie eine
- 205 -
Arbeitsmappe aus einem Projekt entfernen, indem Sie sie in das Projekt "Default"
(Standardprojekt) verschieben. Jede Arbeitsmappe nur zu einem Projekt gehören.
Löschen von Projekten
Nur Administratoren können Projekte löschen. Wenn ein Projekt gelöscht wird, werden alle zu
diesem Projekt gehörigen Arbeitsmappen und Ansichten ebenfalls vom Server gelöscht. So
löschen Sie ein Projekt:
1. Wählen Sie das Projekt in der Projektliste aus.
2. Klicken Sie über der Projektliste auf Löschen:
3. Klicken Sie im Dialogfeld mit der Bestätigung auf Ja.
Das Projekt Standard kann nicht gelöscht werden.
Festlegen von Zeitplänen für Aktualisierungen und Abonnements
Das Aktualisieren von Extrakten und die Lieferung von Abonnements sind Aufgaben, die von
Tableau Server ausgeführt und über Zeitpläne gesteuert werden.
Als Serveradministrator haben Sie die größte Kontrolle über Serveraufgaben und Zeitpläne;
es gibt jedoch zwei Arten von Aufgaben, die Tableau Server-Benutzer planen können.Autoren
von Arbeitsmappen können bei der Veröffentlichung einer Arbeitsmappe oder Datenquelle mit
Extrakt Extraktaktualisierungen planen, und Tableau Server-Benutzer können Ansichten
abonnieren, die nach einem Zeitplan geliefert werden.Als Administrator können Sie den
Zeitplan eines Extrakts oder eines Abonnements anpassen, neue Zeitpläne erstellen,
Aufgaben aktualisieren und löschen. Sie können außerdem steuern, ob Autoren von
Arbeitsmappen Zeitpläne erstellen dürfen (siehe Aktivieren von Zeitplänen Auf Seite 208),
und steuern, ob die Serverkonfiguration es zulässt, Abonnements zu senden (siehe
Verwalten von Abonnements Auf Seite 215). Jegliche Änderungen, die Sie am Zeitplan
- 206 -
eines Extrakts vornehmen, werden im Dialogfeld "Tableau Desktop Schedule" (Tableau
Desktop-Zeitplan) angezeigt, wenn der Arbeitsmappenautor das nächste Mal eine
Veröffentlichung durchführt. Wenn Sie ein neues Abonnement erstellen oder ein bestehendes
löschen, wird dies in der für Tableau Server-Benutzer angezeigten Zeitplanauswahl deutlich,
wenn diese eine Ansicht abonnieren.
Weitere Informationen finden Sie in den folgenden Themen:
Grundlegendes zu Extrakten und Zeitplänen
Tableau Desktop ermöglicht es Autoren, ein Datenextrakt zu erstellen, d. h. eine Kopie oder
Teilmenge der Daten aus der Originaldatenquelle. Arbeitsmappen, in denen Datenextrakte
verwendet werden, werden im allgemeinen schneller geladen als Arbeitsmappen mit
Verbindungen mit Livedatenbanken, weil die extrahierten Daten in das integrierte schnelle
Datenmodul von Tableau importiert werden. Extrakte können auch die Funktionalität
verbessern. Nach dem Veröffentlichen einer Datenquelle oder einer Arbeitsmappe mit einem
Extrakt verbleibt der Extrakt auf Tableau Server.
Direktes Aktualisieren von Extrakten auf Tableau Server:
l
Webbrowser: Als Administrator können Sie Extrakte ändern oder
Extraktaktualisierungszeitpläne neu zuweisen, ungeachtet dessen, ob einer
Arbeitsmappe oder Datenquelle mit einem Extrakt zum Zeitpunkt ihrer Veröffentlichung
ein Aktualisierungszeitplan zugeordnet wurde.Alle Änderungen im Zeitplan, die ein
Administrator in Tableau Server vornimmt, werden in Tableau Desktop in das Dialogfeld
"Zeitplan" übernommen, wenn die Arbeitsmappe oder Datenquelle erneut veröffentlicht
wird.
Sie können Extrakte auch unmittelbar aktualisieren, indem Sie die Option Jetzt
ausführen verwenden. Weitere Informationen finden Sie unter Verwalten von
Aktualisierungsaufgaben Auf Seite 212 und Erstellen oder Ändern eines
Zeitplans Auf der nächsten Seite. Bedenken Sie, dass Sie die Zeitplanung auf dem
Server aktivieren müssen, um Aktualisierungszeitpläne erstellen zu können. Weitere
Informationen hierzu finden Sie unter Aktivieren von Zeitplänen Auf der nächsten
Seite.
l
tabcmd-Befehlszeilenprogramm: Das tabcmd-Befehlszeilenprogramm stellt einen
refreshextracts-Befehl zur Verfügung, denn Sie in der Befehlzeile nutzen oder in
Ihr eigenes Skript integrieren können. Weitere Informationen finden Sie unter
Automatisieren von Aktualisierungsaufgaben Auf Seite 213.
Aktualisieren von Extrakten über Tableau Desktop:
l
At publish time (Zum Zeitpunkt der Veröffentlichung): Wenn ein Autor eine
Arbeitsmappe oder Datenquelle mit einem Extrakt veröffentlicht, kann dieser Autor sie
einem sich wiederholenden Aktualisierungszeitplan auf Tableau Server zuweisen. Die
Aktualisierung kann vollständig oder inkrementell erfolgen.Inkrementelle
Aktualisierungen verweisen auf eine Spalte im Extrakt mit den Datentypen Datum,
Datum/Uhrzeit oder Ganzzahl wie z. B. einen Zeitstempel. Tableau identifiziert anhand
- 207 -
dieser Spalte neue Zeilen, die dem Extrakt hinzugefügt werden müssen.Weitere
Informationen finden Sie unter Aktualisieren von Extrakten und Zeitpläne in der Hilfe von
Tableau Desktop.
l
l
Benutzeroberfläche: Mit den Optionen Aktualisieren aus der Quelle und Daten aus
Datei hinzufügen undDaten aus Datenquelle hinzufügen in Tableau Desktop
können Sie dem Extrakt auf Tableau Server eine Ergänzung hochladen bzw. einen
Extrakt aktualisieren. Sie sollten so vorgehen, wenn dieser Tableau Server nicht über
die notwendigen Anmeldeinformationen für die Aktualisierung von Daten aus einer
ursprünglichen Datenquelle verfügt. Weitere Informationen zum Hochladen finden Sie
in der Onlinehilfe von Tableau Desktop unter Aktualisieren von Extrakten auf Tableau
Server.
Befehlszeilenprogramm für die Datenextraktion: Das Befehlszeilenprogramm für
die Datenextraktion wird zusammen mit Tableau Desktop installiert. Damit können Sie
Zusätze zu einem Extrakt auf Tableau Server hochladen oder einen Extrakt dort
aktualisieren. Weitere Informationen zum Hochladen erhalten Sie in der Tableau
Desktop-Onlinehilfe unter Befehlszeilenprogramm für die Tableau-Datenextraktion.
Aktivieren von Zeitplänen
Sie müssen die Zeitplanung auf dem Server aktivieren, um Zeitpläne für die Aktualisierung von
Extrakten erstellen zu können. Nachdem die Zeitplanung aktiviert wurde, können Sie
Zeitplänen Arbeitsmappen und Datenquellen hinzufügen, Zeitpläne erstellen und bearbeiten,
geplante Aufgaben verwalten und Zeitplaneinstellungen ändern, sodass Publisher Zeitplänen
eine Arbeitsmappe zuweisen können. Diese Einstellung hat keinen Einfluss auf
Abonnementzeitpläne.
Um die Zeitplanung zu aktivieren, aktivieren Sie auf der Serverwartungsseite das
Kontrollkästchen Zeitplanung unter Einstellungen.
Da zum Aktualisieren von Extrakten möglicherweise Datenbankkennwörter erforderlich
sind, müssen Sie die Option Embedded Credentials (Eingebettete
Anmeldeinformationen) aktivieren, um die Zeitplanung zu ermöglichen.
Erstellen oder Ändern eines Zeitplans
Die Seite "Zeitpläne" enthält eine Liste der Zeitpläne mit Namen, Typ, Zweck (Bereich), Anzahl
der Aufgaben, Verhalten (parallele oder serielle Verarbeitung) und dem geplanten
Ausführungszeitpunkt.
- 208 -
1. Um einen neuen Zeitplan zu erstellen, klicken Sie auf Neu:
2. Um einen bestehenden Zeitplan zu ändern, wählen Sie diesen aus, und klicken Sie
dann auf Ändern:
3. Geben Sie im Feld Name einen beschreibenden Namen für den Zeitplan ein (z. B.
Jeden Samstagmorgen, Monatsende).
4. Wählen Sie einen Planungsbereich, der den Umfang bestimmt, den der Zeitplan
umfasst – entweder Extraktaktualisierungen oder das Liefern von Abonnements.
5. Optional können Sie eine Default Priority (Standardpriorität) zwischen 0 und 100
definieren. Diese Priorität wird standardmäßig den Aufgaben zugeordnet. Wenn die
Warteschlange zwei ausstehende Aufgaben enthält, dann wird zuerst die Aufgabe mit
der höheren Priorität ausgeführt. Nähere Informationen zum Ändern der Priorität von
Aufgaben finden Sie unter Verwalten von Aktualisierungsaufgaben Auf Seite 212.
6. Geben Sie an, ob die Aufträge im Zeitplan gleichzeitig (parallel, Standardeinstellung)
oder nacheinander (seriell) ausgeführt werden sollen.
- 209 -
7. Schließen Sie die Definition oder Bearbeitung des Zeitplans ab. Sie können einen
stündlichen, täglichen, wöchentlichen oder monatlichen Zeitplan definieren.
8. Klicken Sie auf Zeitplan erstellen wenn es sich um einen neuen Zeitplan handelt bzw.
auf Zeitplan speichern, wenn Sie einen bestehenden Zeitplan bearbeitet haben.
Hinzufügen einer Datenquelle oder einer Arbeitsmappe zu einem Zeitplan
Wenn Sie die Zeitplanung aktiviert haben, können Sie eine Arbeitsmappe einem Zeitplan aus
der Arbeitsmappenliste hinzufügen oder eine Datenquelle einem Zeitplan aus der
Datenquellenliste hinzufügen. Standardmäßig verfügt Tableau Server über drei integrierte
Zeitpläne zur Aktualisierung von Extrakten.Sie können auch Ihren eigenen Zeitplan erstellen.
Nähere Informationen hierzu finden Sie unter Erstellen oder Ändern eines Zeitplans Auf
Seite 208.
1. Wenn Sie eine Extraktaktualisierung für eine Arbeitsmappe planen, wählen Sie eine
oder mehrere auf der Arbeitsmappenseite aus, und klicken Sie auf Geplante
Aufgaben:
- 210 -
Wenn Sie eine Extraktaktualisierung für eine Datenquelle planen, wählen Sie eine oder
mehrere auf der Seite "Datenquellen" aus, und klicken Sie auf Geplante Aufgaben:
2. Wählen Sie entweder Vollständige Aktualisierung hinzufügen oder Inkrementelle
Aktualisierung hinzufügen aus, und wählen Sie anschließend aus der Liste einen
Zeitplan aus:
Add Full Refresh (Vollständige Aktualisierung hinzufügen) ist nur verfügbar, wenn die
ausgewählte Datenquelle eine Verbindung mit einer Extraktion herstellt. Inkrementelle
Aktualisierung hinzufügen ist nur verfügbar, wenn die ausgewählte Datenquelle eine
Verbindung mit einer Extraktdatenquelle herstellt, für die Sie eine inkrementelle
Aktualisierung definiert haben. Tableau Server kann keine Datenquellen aktualisieren,
die eine Verbindung mit lokalen Dateidatenquellen auf einem verbundenen Laufwerk
herstellen.Aktualisieren Sie die Verbindung, sodass der vollständige Pfad zur
Datenquelle verwendet wird.
- 211 -
Verwalten von Aktualisierungsaufgaben
Die Seite "Aufgaben" zeigt alle vollständigen und inkrementellen Aufgaben für
Extraktaktualisierungen, die vom Server ausgeführt werden. System- und SiteAdministratoren können mithilfe dieser Seite die Priorität einer Aufgabe ändern bzw. eine
Aufgabe in einen anderen Zeitplan verschieben, ausführen oder löschen. Sie können die Seite
"Aufgaben" öffnen, indem Sie auf der Admin-Registerkarte auf Aufgaben klicken:
Bearbeiten eines Aufgabenzeitplans
Verschieben Sie eine Extraktaktualisierung von einem Zeitplan in einen anderen, indem Sie
wie folgt vorgehen:
1. Wählen Sie auf der Seite "Tasks" (Aufgaben) eine oder mehrere Aufgaben aus, die Sie
ändern möchten.
2. Klicken Sie auf Zeitplan bearbeiten. Wählen Sie einen neuen Zeitplan in der Liste der
Zeitpläne aus:
Sie können eine oder mehrere Aufgaben auch löschen und ausführen, indem Sie diese in der
Liste markieren und die entsprechende Option in der Symbolleiste auswählen.
- 212 -
Aufgabe jetzt ausführen
Sie können die Aktualisierung einer Aufgabe sofort erzwingen, z. B. eine
Extraktaktualisierungsaufgabe, indem Sie Jetzt ausführen auswählen.
1. Wählen Sie auf der Seite "Aufgaben" eine auszuführende Aufgabe aus.
2. Klicken Sie auf Jetzt ausführen.
Ändern der Aufgabenpriorität
So ändern Sie die Priorität einer Aufgabe für die Extraktaktualisierung:
1. Wählen Sie auf der Seite "Tasks" (Aufgaben) eine oder mehrere Aufgaben aus, die Sie
ändern möchten.
2. Klicken Sie auf Priorität bearbeiten.
3. Geben Sie eine neue Priorität zwischen 0 und 100 ein, und klicken Sie auf Absenden.
Automatisieren von Aktualisierungsaufgaben
Zur Automatisierung der Aktualisierung von Datenextrakten können Sie
Extraktaktualisierungsaufgaben in Tableau Server Zeitplänen zuweisen. Das Aktualisieren
von Datenextrakten kann ferner mit tabcmd automatisiert werdenHierbei handelt es sich um
ein Befehlszeilenprogramm, das im Lieferumfang von Tableau Server enthalten ist und auf
einem anderen Computer als dem Tableau Server-Computer installiert werden kann. Sie
haben auch die Möglichkeit, den refreshextracts -Befehl zusammen mit anderen
Befehlen in Ihrem eigenen Skript zu verwenden. Beispiel:
tabcmd login - http://mytabserver -u jsmith -p P@ssw0rd!
refreshextracts --datasource salesq4
Handhaben von Warnungen zu Extraktaktualisierungen
Wenn geplante Extraktaktualisierungen nicht erfolgreich sind, zeigt Tableau oben rechts das
Menü "Warnungen" an:
- 213 -
Dieses Menü wird nur angezeigt, wenn eine Extraktaktualisierung fehlgeschlagen ist und Sie
folgende Funktion haben:
l
Systemadministrator oder Site-Administrator
l
Autor einer Arbeitsmappe oder Datenquelle, die nicht aktualisiert werden konnte
l
Autor einer Arbeitsmappe, die mit einer nicht aktualisierbaren Datenquelle verbunden ist
Wenn Sie das Menü "Warnungen" öffnen, können Sie weitere Informationen zu
Aktualisierungsfehlern anzeigen:
Wenn eine Datenquelle als Eingebettet aufgelistet ist, ist die Datenquellendefinition (mit
Anmeldeinformationen für die Datenquelle, Datenbankname usw.) eingebettet oder befindet
sich in der Arbeitsmappe selbst, die ursprünglich in Tableau Desktop erstellt wurde.
- 214 -
Wenn ein Datenquellen- oder Arbeitsmappenname als Datenquelle aufgelistet ist (z. B.
Datenquelle: sales_data), handelt es sich bei der Datenquelle um eine Tableau ServerDatenquelle. Die Datenquellendefinition befindet sich in Tableau Server.
Im Datenfenster können Sie Arbeitsmappen oder Datenquellen erkennen, die ursprünglich in
Tableau Desktop erstellt wurden. Anstelle eines Datenbanksymbols ist neben dem Namen der
Datenquelle ein Tableau-Symbol zu sehen:
Lösen von Problemen bei der Extraktaktualisierung
Sie können manche Extraktaktualisierungsprobleme beheben, indem Sie in der Warnmeldung
auf den Link Verbindungsinformationen bearbeiten klicken, die fehlenden Informationen
eingeben und dann auf Speichern klicken:
Wenn das Problem durch das Bearbeiten der Datenverbindung nicht korrigiert werden kann,
müssen Sie es in Tableau Desktop lösen und die Arbeitsmappe dann erneut veröffentlichen.
Tipp: Administratoren können auf der Seite Datenverbindungen, die über die Registerkarte
Admin aufgerufen wird, jederzeit Datenverbindungen bearbeiten.
Verwalten von Abonnements
Als Abonnement gelten regulär an Abonnenten übermittelte E-Mail-Sendungen, die eine
Tableau Server-Ansicht oder -Arbeitsmappe enthalten. Wenn der Abonnent in der E-Mail auf
das Bild der Ansicht oder Arbeitsmappe klickt, wird die entsprechende Ansicht oder
Arbeitsmappe auf Tableau Server geöffnet.
- 215 -
Klicken Sie auf der Registerkarte "Admin" auf Abonnements, um auf Informationen zu jedem
Abonnement zuzugreifen, wie z. B. E-Mail-Adresse und Name des Abonnenten, Name der
Ansicht und Zustellungsplan.
Anforderungen
Für Tableau Server ist Folgendes erforderlich, um Abonnements zu erhalten:
l
l
l
l
Konfiguration der E-Mail-Einstellungen: Als Systemadministrator konfigurieren Sie
die Grundeinstellungen des SMTP-Servers für Abonnements auf der Registerkarte
Warnungen und Abonnements im Dialogfeld "Konfiguration", das während des
Setups angezeigt wird. Dies ist die "von Adresse",mit der Tableau Server E-MailAbonnements an Serverbenutzer sendet.Sie haben auch nach dem Setup noch Zugriff
auf diese Registerkarte.Weitere Schritte hierzu finden Sie unter Neukonfigurieren des
Servers Auf Seite 134 und Konfigurieren von E-Mail-Abonnements Auf Seite 122.
Anmeldeinformationen eingebettet oder nicht erforderlich: Für Tableau Server
enthält ein Abonnement eine Arbeitsmappe, Daten und einen Zeitplan.Um das
Datensegment zu liefern, muss Tableau Server ohne Endbenutzerbeteiligung auf die
Daten zugreifen können. Dies ist entweder durch die Verwendung einer Arbeitsmappe
mit eingebetteten Datenbank-Anmeldeinformationen, einer Tableau ServerDatenquelle oder die Verwendung von Daten möglich, für die keine
Anmeldeinformationen erforderlich sind. z. B. einer Datei, die zum Zeitpunkt der
Veröffentlichung zur Arbeitsmappe gehört.Arbeitsmappen, für die
Anmeldeinformationen für Livedatenbankverbindungen erforderlich sind, können nicht
abonniert werden.
Benutzeranforderungen: Wenn ein Benutzer eine Ansicht oder Arbeitsmappe auf
Tableau Server anzeigen lassen kann und diese in der oberen rechten Ecke über das
Abonnementsymbol verfügt ( ), kann der Benutzer diese abonnieren. Die Möglichkeit
zur Anzeige einer Ansicht oder Arbeitsmappe wird über die Berechtigung Ansicht
gesteuert. Ein Benutzer muss auch über eine E-Mail-Adresse verfügen.Tableau Server
fordert einen Benutzer zum Zeitpunkt der Anmeldung für ein Abonnement zur Eingabe
einer E-Mail-Adresse auf, wenn noch keine vorhanden ist.Benutzer können ihre
Lieferoptionen ändern, das Abonnement abbestellen oder ihre E-Mail-Adresse auf der
Seite "Benutzereinstellungen" aktualisieren.
Keine vertrauenswürdige Authentifizierung: Wenn Tableau Server für
vertrauenswürdige Authentifizierung konfiguriert ist, sind Abonnements
deaktiviert.Vertrauenswürdige Authentifizierung ermöglicht in Kombination mit der
lokalen Authentifizierung von Tableau den Anwendern eine Nutzung ohne Anmeldung,
jedoch mit Authentifizierung.Wenn Sie dasselbe Erlebnis mit Abonnements benötigen,
verwenden Sie stattdessen Active Directory (mit Automatische Anmeldung aktivieren)
als Art der Benutzerauthentifizierung.Die Art der Benutzerauthentifizierung wird
während des Setups ausgewählt.Weitere Informationen finden Sie unter
Konfigurieren des Servers Auf Seite 115.
Zusätzliche Abonnementeinstellungen
Solange Abonnements auf der Registerkarte Warnungen und Abonnements konfiguriert
werden und Tableau Server die Standardeinstellungen verwendet, können Serverbenutzer
- 216 -
die für sie angezeigten Ansichten und Arbeitsmappen abonnieren. So verhindern Sie, dass
Benutzer Abonnements beenden oder Ihr Abonnementerlebnis anpassen:
l
l
l
Sites-Seite: Standardmäßig sind Abonnements für alle Sites aktiviert, Sie können auf
der Sites-Seite jedoch Abonnements für einzelne Sites deaktivieren oder diese
anpassen. Sie können beispielsweise anstelle der im Konfigurationsdialogfeld
festgelegten Adresse eine benutzerdefinierte Von Adresse für Abonnements
eingeben. Sie können auch eine eigene Fußzeile für die E-Mails erstellen, die Ihre
Benutzer abonniert haben.
Zeitpläne-Seite: Ihre Benutzer benötigen mindestens einen Abonnementzeitplan, den
sie für ein Abonnement auswählen können.Tableau bietet standardmäßig zwei an.Als
Systemadministrator können Sie zusätzliche Zeitpläne erstellen oder die
Standardzeitpläne entfernen. Weitere Informationen finden Sie unter Erstellen oder
Ändern eines Zeitplans Auf Seite 208.
Abonnements-Seite: Auf dieser Seite werden alle Abonnements auf dem Server, oder
– für Administratoren – auf der Site aufgelistet. Systemadministratoren können auf
dieser Seite den Abonnementzeitplan eines Benutzers ändern oder dessen
Abonnement löschen.Systemadministratoren könen auch den Abonnementzeitplan
eines Serverbenutzers ädern oder dessen Abonnement löchen Weitere Informationen
hierzu finden Sie in den folgenden Themen.
Schritte zum Testen der Abonnementkonfiguration finden Sie unter Testen der
Abonnementkonfiguration Auf der nächsten Seite. Informationen zu Problemen mit
Abonnements finden Sie unter Behandeln von Abonnementproblemen Auf Seite 472.
Löschen eines Abonnements
Um ein Abonnement zu löschen, wählen Sie das zu entfernende Abonnement, und klicken Sie
auf Löschen.
Bearbeiten eines Abonnementzeitplans
Um den Zeitplan für ein Abonnement zu ändern, wählen Sie das Abonnement aus, klicken Sie
auf Zeitplan bearbeiten, und wählen Sie einen Zeitplan aus:
- 217 -
Testen der Abonnementkonfiguration
Als Administrator können Sie wie folgt testen, ob Sie Abonnements richtig konfiguriert haben:
1. Abonnieren Sie eine Ansicht.
2. Wählen Sie auf der Zeitpläne-Seite den Zeitplan, der Ihr Abonnement enthält.
3. Klicken Sie auf Jetzt ausführen:
4. Einige Momente später sollte Ihr Abonnement in Ihrem Posteingang erscheinen.
Behandeln von Abonnementproblemen
"Die Momentaufnahme der Ansicht in dieser E-Mail konnte nicht richtig gerendert werden.
Wenn Sie diese Fehlermeldung bei einem Abonnement erhalten, kann dies mehrere Gründe
haben:
l
l
l
Fehlende Anmeldeinformationen: Einige Ansichten werden mit eingebetteten
Anmeldeinformationen veröffentlicht. Sie erhalten die oben genannte Fehlermeldung,
wenn die eingebetteten Anmeldeinformationen veraltet sind oder die Ansicht ohne
eingebettete Anmeldeinformationen erneut veröffentlicht wurde.
Datenbank vorübergehend nicht verfügbar: Wenn die Ansicht eine Verbindung zu
einer Livedatenbank aufweist, und die Datenbank beim Generieren des Abonnements
vorübergehend nicht verfügbar war, wird unter Umständen die oben genannte
Fehlermeldung angezeigt.
Zeitüberschreitung bei Hintergrundprozess: Der Hintergrundprozess, der
Abonnements verarbeitet, läuft nach 30 Minuten ab. In der Regel ist diese Zeit
- 218 -
ausreichend. Wenn jedoch ein extrem großes und komplexes Dashboard vom
Hintergrundprozess verarbeitet wird, reicht diese Zeit möglicherweise nicht aus. In der
Admin-Ansicht Hintergrundaufgaben Auf Seite 269 können Sie nachsehen, ob dies
der Fall ist. Mit der tabadmin-Option subscriptions.timeout können Sie den
Schwellenwert für die Zeitüberschreitung erhöhen.
Abonnieren nicht möglich
Wenn Sie eine Ansicht auf Tableau Server anzeigen können und ein Abonnementsymbol (
in der oberen rechten Ecke angezeigt wird, können Sie die Ansicht abonnieren.
)
Damit Sie eine Ansicht abonnieren können, müssen zwei Voraussetzungen erfüllt sein:
Tableau Server muss richtig konfiguriert werden (siehe Verwalten von Abonnements Auf
Seite 215), und die abonnierte Ansicht muss entweder über eingebettete
Anmeldeinformationen für ihre Datenquelle verfügen, oder es dürfen keine
Anmeldeinformationen dafür erforderlich sein. Beispiele für den letzteren Typ: Arbeitsmappen,
die eine Verbindung mit einem Extrakt herstellen, der nicht aktualisiert wird, oder
Arbeitsmappen, deren Daten sich in einer Datei befinden, die zum Zeitpunkt der
Veröffentlichung zur Arbeitsmappe gehörte.Das Einbetten von Anmeldeinformationen
geschieht in Tableau Desktop (siehe die Hilfe zu Tableau Desktop).
Kein Abonnementsymbol
Es ist möglich, dass Sie eine Ansicht auf Tableau Server anzeigen lassen, aber nicht
abonnieren können.Dies ist der Fall bei Ansichten mit Livedatenbankverbindungen, bei denen
Sie zur Eingabe Ihrer Anmeldeinformationen aufgefordert werden, wenn Sie das erste Mal auf
die Ansicht klicken.Ein Abonnement enthält eine Ansicht (oder Arbeitsmappe), Daten und
einen Zeitplan.Um das Datensegment zu liefern, benötigt Tableau Server entweder
eingebettete Datenbank-Anmeldeinformationen oder Daten, für die keine
Anmeldeinformationen erforderlich sind.Bei Livedatenbankverbindungen verfügen nur die
einzelnen Benutzer über die Anmeldeinformationen, nicht aber Tableau Server.Daher können
Sie nur Ansichten abonnieren, für die entweder keine Anmeldeinformationen erforderlich sind
oder in die sie eingebettet sind.
Es ist auch möglich, dass Sie eine Ansicht anzeigen lassen, aber nicht abonnieren können
(kein Abonnementsymbol), wenn Tableau Server für vertrauenswürdige Authentifizierung
konfiguriert ist.Weitere Informationen hierzu finden Sie unter Abonnementanforderungen.
Eingehende Daten ungültig oder "unterbrochen" Abonnements
Wenn Sie Abonnements nicht nur in Ihrer aktuell verwendeten Instanz sondern auch in Testoder Entwicklungsinstanzen von Tableau Server konfiguriert haben, deaktivieren Sie die
Abonnements in Ihren nicht zu Produktionszwecken dienenden Instanzen. Wenn die
Abonnements auf allen Instanzen aktiviert bleiben, erhalten Benutzer anscheinend gültige
Abonnements, die nicht funktionieren, oder Abonnements, obwohl sie die Ansicht oder
Arbeitsmappe nicht abonniert haben.
Abonnements werden nicht empfangen ("Fehler beim Senden der E-Mail.Der Befehl an den SMTP-Host
kann nicht gesendet werden.")
Der obige Fehler wird möglicherweise in der Windows Ereignisanzeige angezeigt, wenn
Abonnements scheinbar gesendet werden (laut der Admin-Ansicht für
Hintergrundaufgaben Auf Seite 269), jedoch nicht ankommen und der SMTP-Server
- 219 -
verschlüsselte Sitzungen (SSL) verwendet. Abonnements werden nur bei unverschlüsselten
SMTP-Verbindungen unterstützt. Zur Lösung des Problems sollte ein unverschlüsselter
SMTP-Server verwendet werden.
Benutzerdefinierte Skripts können nach einem Upgrade auf 8.1 nicht mehr ausgeführt werden
Ab Version 8.1 wird die Sitzungsverwaltung besser unterstützt, indem ein Rautenzeichen (#)
am Ende der Ansichts-URLs eingefügt wurde. Wenn Sie über benutzerdefinierte
Abonnement-Skripts verfügen, die die Ansichten als PDFs oder PNGs generieren, müssen
Sie Ihre Skripte möglicherweise aktualisieren, damit das Rautenzeichen unterstützt wird.
Bis Version 8.1 sahen Ansichts-URLs folgendermaßen aus:
http://tableauserver/views/SuperStore/sheet1, und Sie konnten eine Ansicht
als PNG-Datei generieren, indem Sie .png an das Ende der URL angehängt haben,
beispielsweise http://tableauserver/views/SuperStore/sheet1.png. Ab
Version 8.1 sehen Ansichts-URLs folgendermaßen aus:
http://tableauserver/views/SuperStore/sheet1#1. Um eine PNG-Datei zu
genieren, müssen Sie .png vor dem Rautenzeichen einfügen. Beispiel:
http://tableauserver/views/SuperStore/sheet1.png#1
Sites
Verwenden Sie die Seite "Sites", um auf einem Serversystem voneinander unabhängige Sites
für verschiedene Organisationen oder Gruppen zu erstellen. Die Arbeitsmappen, Daten und
Benutzerlisten jeder Site sind von denen anderer Sites getrennt. Nur Systemadministratoren
können die verschiedenen Sites anzeigen und Aktionen ausführen, wie Sites erstellen und
systemweit gültige Änderungen vornehmen. Weitere Informationen finden Sie in den
folgenden Themen:
Arbeiten mit Sites
In den unten angegebenen Themen werden verschiedene Aspekte der Verwendung mehrerer
Sites beschrieben, darunter beispielsweise welcher Authentifizierungstyp verwendet wird
sowie Wissenswertes zu Benutzerlizenzen und Administratorrollen.
Authentifizierung und Anmeldeinformationen
Für alle Sites auf einem Server wird dasselbe Konto "Run As User" (Ausführen als Benutzer)
und der gleiche Benutzerauthentifizierungsmodus verwendet. Sie legen beide Einstellungen
während der Installation von Tableau Server fest. Weitere Informationen hierzu finden Sie
unter Allgemein Auf Seite 115.
Benutzer, die Mitglied mehrerer Sites auf einem Serversystem sind, verwenden für jede Site
dieselben Anmeldeinformationen. Wenn beispielsweise Jane Smith bei Site A den
Benutzernamen jsmith und das Kennwort "MyPassword" verwendet, dann verwendet sie
dieselben Anmeldeinformationen auch für Site B. Bei der Anmeldung bei Tableau Server kann
Sie dann auswählen, auf welche Site zugegriffen werden soll.
Die Standardsite
Um die Umstellung von einem Serversystem mit einer Site auf ein Serversystem mit mehreren
Sites zu erleichtern, wird Tableau Server mit einer Site namens "Default" (Standard) installiert.
- 220 -
Wenn Sie nur eine Site betreiben, müssen Sie die Site "Default" (Standard) nicht explizit
auswählen, da dies automatisch geschieht. Sobald allerdings eine oder mehrere Sites
hinzugefügt werden, wird die Site "Standard" zu einer der Sites, die bei der Anmeldung bei
Tableau Server zur Auswahl stehen. Die Standardsite unterscheidet sich wie folgt von
anderen Sites, die Sie dem System hinzufügen:
l
l
l
Sie können die Site nicht löschen, aber wie andere von Ihnen hinzugefügte Sites
umbenennen.
Sie enthält Beispiele und Datenverbindungen, die zum Lieferumfang von Tableau
Server gehören.
Der URL, die für die Standardsite verwendet wird, ist kein entsprechender Webordner
namens "Default" (Standard) zugeordnet. So lautet die URL für eine Ansicht namens
Profits auf einer Site namens Sales beispielsweise
http://localhost/t/sales/views/profits. Die URL für die gleiche Ansicht
auf der Sites "Default" (Standard) lautet http://localhost/views/profits.
Die Rollen Site-Administrator und Systemadministrator
Es gibt zwei Typen von Administratoren in Tableau Server: Systemadministratoren und SiteAdministratoren. Die Systemadministratoren können im Dialogfeld "Neue Site hinzufügen"
(oder "Site bearbeiten") steuern, ob Site-Administratoren Benutzer hinzufügen und entfernen
können:
Wenn Nur Systemadministratoren aktiviert wird, können Site-Administratoren Sitebenutzer
weder hinzufügen noch entfernen. Sie können jedoch Gruppen, Projekte, Arbeitsmappen und
Datenverbindungen innerhalb ihrer Site verwalten. Wenn System- und SiteAdministratoren ausgewählt wird, dann können Site-Administratoren die oben genannten
Aktionen ausführen und zudem Benutzer hinzufügen und entfernen.
- 221 -
Lizenzierung und Benutzerlimits
Die Benutzer können Mitglied mehrerer Sites sein, wobei jede Site über andere Lizenzstufen
und Benutzerrechte verfügen kann. Ein Benutzer, der Mitglied mehrerer Sites ist, braucht nicht
für jede Site eine Lizenz. Jeder Serverbenutzer braucht nur eine Lizenz.
Systemadministratoren können über die Einstellung Maximale Site-Benutzer <n> ein
Benutzerlimit für eine Site festlegen. Es werden nur lizenzierte Benutzer gezählt;
Systemadministratoren werden ausgeschlossen. Wenn eine Site beispielsweise über 90
lizenzierte Benutzer, 20 nicht lizenzierte Benutzer und einen Systemadministrator verfügt,
dann beträgt die Benutzeranzahl 90. Wenn Maximale Site-Benutzer auf 100 festgelegt wird,
dann können noch 10 lizenzierte Benutzer hinzugefügt werden.
Hinzufügen oder Bearbeiten von Sites
Wenn Sie Systemadministrator sind, können Sie mit folgenden Schritten eine Site zu Tableau
Server hinzufügen oder eine bestehende bearbeiten:
1. Öffnen Sie die Seite "Sites", indem Sie unter "Admin" auf den Link "Sites" klicken.
Klicken Sie anschließend auf Hinzufügen.
Wenn Sie eine Site bearbeiten, wählen Sie die zu ändernde Site aus, und klicken Sie auf
Bearbeiten. Wenn Sie keine Sites zu Tableau Server hinzugefügt haben, wird nur eine
Site zur Auswahl angezeigt: Standard.
2. Geben Sie einen Sitenamen und eine Site-ID für die Site ein (bei Bearbeitung der
Standardsite kann die Site-ID nicht geändert werden):
- 222 -
Das "t" in der URL (beispielsweise http://localhost/t/wsales) kann nicht geändert
werden. In Serversystemen mit mehreren Sites ist es in den URL für andere Sites als
die Standardsite enthalten.
3. Arbeitsmappen, Extrakte und Datenquellen verbrauchen alle Speicherplatz auf dem
Server. Wählen Sie entweder Unbeschränkt oder Kontingent, und geben Sie die
Anzahl in GB an, die Sie als Grenze möchten. Wenn Sie ein Kontingent festlegen und
die Site dieses überschreitet, können Publisher keine weiteren Inhalte hochladen, bis
sich der Speicher der Site wieder unterhalb des Grenzwerts befindet.
Systemadministratoren können mithilfe der Spalten Speicherkontingent und % des
Kontingents verwendet auf der Seite Sites nachverfolgen, inwiefern der
Speicherstatus im Hinblick auf das Kontingent ausgelastet ist.
4. Geben Sie nun an, ob nur Sie als Systemadministrator Benutzer hinzufügen und
entfernen können (Nur Systemadministratoren) oder ob beide Typen von
Administratoren (System- und Site-Administratoren) dies können.
Wenn Sie Site-Administratoren das Hinzufügen von Benutzern erlauben, geben Sie an,
wie viele Benutzer sie der Site hinzufügen können, indem Sie eine der folgenden
Optionen auswählen:
l
l
Bis zu Serverkapazität: Bei einem Server mit benutzerbasierter Lizenzierung
entspricht dieses Limit der Anzahl verfügbarer Serverplatzlizenzen. Bei einem
Server mit core-basierter Lizenzierung gibt es kein Limit für die Anzahl der
Benutzer, die hinzugefügt werden können.
Maximale Site-Benutzer <n>: Erlaubt es Site-Administratoren, bis zum
angegebenen Limit Benutzer hinzuzufügen. Weitere Informationen zur
Lizenzierung und zu den Benutzerlimits finden Sie unter Arbeiten mit Sites.
5. Wählen Sie Leistungsaufzeichnung zulassen, um den Benutzern Ihrer Site die
- 223 -
Berechtigung zum Sammeln von Kennzahlen zur Arbeitsmappenleistung (z. B. wie
schnell diese geladen werden usw.) zu gewähren.
Zusätzlich zu diesem für Ihre Site aktivierten Kontrollkästchen müssen Benutzer für den
Beginn mit der Aufzeichnung einen Parameter zur Arbeitsmappen-URL hinzufügen.
Weitere Informationen hierzu finden Sie unter Erstellen einer
Leistungsaufzeichnung Auf Seite 321.
6. Behalten Sie die Auswahl von Webdokumenterstellung für diese Website
zulassen bei oder deaktivieren Sie sie, um die Dokumenterstellung für die Server
vollständig zu deaktivieren.
Bei einer Deaktivierung der Webdokumenterstellung können Benutzer keine
veröffentlichten Arbeitsmappen aus der Server-Webumgebung bearbeiten.Zur
Aktualisierung einer auf dem Server veröffentlichten Arbeitsmappe muss diese von
einem Tableau Desktop-Benutzer erneut veröffentlicht werden. Weitere Informationen
finden Sie unter Beispiel: Webdokumenterstellung deaktivieren Auf Seite 104.
7. Lassen Sie unter "Site-Abonnementeinstellungen"die Einstellung Abonnements
aktivieren aktiviert, wenn Sie möchten, dass Site-Benutzer Ansichten abonnieren
können. Diese Option ist nur verfügbar, wenn Sie im Dialogfeld "Konfiguration"
Abonnementeinstellungen konfiguriert haben.
Sie können für diese Abonnements auch eine benutzerdefinierte Von Adresse
eingeben. Die eingegebene E-Mail-Adresse sollte über eine gültige Syntax verfügen
(z. B. [email protected] oder noreply@sales), bei Tableau Server ist jedoch
kein aktives E-Mail-Konto erforderlich (dennoch kann es bei einigen SMTP-Servern
notwendig sein, dass es sich um ein aktive Adresse handelt).
8. Wählen Sie unter E-Mail-Fußzeile den Wert Benutzerdefiniert aus, und geben Sie
den Text ein, der über der URL von Tableau Server in den Abonnement-Fußzeilen
angezeigt werden soll. Geben Sie beispielsweise folgenden Text ein:
Die E-Mail-Fußzeile wird ungefähr aussehen wie folgt:
- 224 -
9. Klicken Sie auf OK.
Wenn Sie Ihre erste Site zu Tableau Server hinzufügen, verändert sich die Registerkarte
"Admin". Benutzer wird zu Alle Benutzer, da alle Benutzer auf dem Server betroffen sind,
und die Kategorie Site-Benutzer wird angezeigt.
Hinzufügen von Benutzern zu einer Site
Wenn Sie eine Site zu Tableau Server hinzugefügt haben, entsteht ein System mit mehreren
Sites, und das, was zuvor die Seite Benutzer gewesen ist, wird nun zu zwei Seiten: Alle
Benutzer und Site-Benutzer. Als Systemadministrator können nur Sie auf die Seite Alle
Benutzerzugreifen. Dies gilt für das gesamte Serversystem. Dies ist die einzige Stelle, von der
aus Sie gleichzeitig mehreren Sites Benutzer hinzufügen, Benutzer entfernen und, sofern auf
dem Server die lokale Authentifizierung verwendet wird, Kennwörter zurücksetzen können.
- 225 -
Die Seite Site-Benutzer ist bietet eine einfache Übersicht darüber, welche Benutzer sich auf
der Site befinden, bei der Sie aktuell angemeldet sind. Sie können hier Benutzer hinzufügen,
aber diese werden nur zu dieser Site hinzugefügt.
Im Folgenden werden die Schritte für das Hinzufügen von Benutzern von der Seite Alle
Benutzer aus beschrieben. Dies kann auf zweierlei Weise geschehen: Einzeln (siehe
Beschreibung unten) oder in Gruppen mithilfe des Importieren-Befehls, der auf einer CSV-
- 226 -
Datei basiert (siehe Beschreibung in Importieren von Benutzern aus einer CSV-Datei Auf
Seite 183).
So fügen Sie einen Benutzer hinzu:
1. Klicken Sie auf der Seite Alle Benutzer am Anfang der Benutzerliste auf den Link
Hinzufügen:
2. Geben Sie einen Benutzernamen ein:
l
l
Lokale Authentifizierung: Wenn auf dem Server die lokale Authentifizierung
verwendet wird, dann lassen sich Benutzernamenskonflikte am besten durch die
Angabe der E-Mail-Adresse als Benutzername vermeiden (z. B.
[email protected] statt jsmith).
Active Directory— Wenn Sie einen Benutzer hinzufügen, der derselben Active
Directory-Domäne wie der Server angehört, dann können Sie den
Benutzernamen ohne die Domäne eingeben. Dann wird die Domäne des
Servers angenommen.
Wenn eine bidirektionale Vertrauensstellung zwischen der Domäne des Servers
und einer anderen Domäne eingerichtet worden ist, dann können Sie Benutzer
aus beiden Domänen hinzufügen. Beim ersten Hinzufügen eines Benutzers aus
der "Nicht-Server-Domäne" müssen Sie den Benutzernamen mit dem vollständig
qualifizierten Domänennamen angeben. Nachfolgende Benutzer können mithilfe
des Domänenspitznamens hinzugefügt werden. Beispielsweise geben Sie den
ersten Benutzer aus der "Nicht-Server-Domäne" mybiz.lan als [email protected]
oder mybiz.lan\user1 ein. Der nächste Benutzer kann dann mithilfe des
Domänenspitznamens hinzugefügt werden, z. B. user2@mybiz oder
mybiz\user2.
Hinweis: Geben Sie in diesem Feld nicht den Vollständigen Namen ein, da
dieser beim Import Fehler verursachen kann.
3. Wenn der Server die lokale Authentifizierung verwendet, müssen Sie Folgendes
angeben:
- 227 -
l
Vollständiger Name: Geben Sie einen Anzeigenamen für den Benutzer ein
(z. B. John Smith).
l
Kennwort: Geben Sie ein Kennwort für den Benutzer ein.
l
Bestätigen: Geben Sie das Kennwort noch einmal ein.
4. Sitemitgliedschaft: Wählen Sie die Site/s aus, der/denen der Benutzer angehören soll.
Standardmäßig wird die Site ausgewählt, bei der Sie angemeldet sind.
5. Lizenzstufe und Benutzerrechte: Wählen Sie eine Lizenzstufe und Administratorrolle
aus, und legen Sie fest, ob der Benutzer Arbeitsmappen und Datenquellen
veröffentlichen kann. Benutzer, die Mitglied mehrerer Sites sind, können bei jeder Site
über andere Lizenzstufen und Benutzerrechte verfügen. Weitere Informationen finden
Sie unter Grundlegendes zu Lizenzstufen Auf Seite 193, Berechtigungsreferenz
Auf Seite 98 und Grundlegendes zu Benutzerrechten Auf Seite 196.
6. Klicken Sie auf Benutzer hinzufügen.
Löschen von Sites
Systemadministratoren können Sites löschen, die Tableau Server hinzugefügt worden sind.
Zusammen mit der Site werden auch die Arbeitsmappen und Datenquellen, die in der Site
veröffentlicht wurden, sowie die Benutzer entfernt. Wenn der Benutzer Mitglied weiterer Sites
ist, werden diese nicht entfernt. Um einen Benutzer endgültig zu entfernen, müssen Sie die
Seite "Alle Benutzer" verwenden.
So löschen Sie eine Site:
- 228 -
1. Öffnen Sie die Seite "Sites" unter Server:
2. Wählen Sie die zu entfernende Site aus, und klicken Sie auf Löschen:
3. Klicken Sie im erscheinenden Bestätigungsdialogfeld auf Ja.
Importieren oder Exportieren einer Site
Sie können eine neue Tableau Server-Site bereitstellen, indem Sie eine vorhandene Site als
Datei exportieren und diese dann in eine neue Site importieren. Die Site, die Sie exportieren,
wird als Quellsite bezeichnet. Die Site, in die Sie importieren, wird als Zielsite bezeichnet.
Die Quellsite kann von Tableau Online stammen, einer cloudbasierten Installation von Tableau
Server, die von Tableau gehostet wird, oder von einer Tableau Server-Implementierung, die
Sie verwalten. Beim Importieren einer Seite werden alle Ressourcen der Quellsite
- 229 -
(Arbeitsmappen, Projekte, Datenquellen, Benutzer) importiert. Berechtigungen,
Abonnements sowie die von Benutzern erstellten Favoritenlisten werden beim Importvorgang
ebenfalls übertragen. Alle Site-spezifischen Einstellungen der Quellsite (einschließlich SiteKontingente, Abonnements und Einstellungen für die Webdokumenterstellung) bleiben auf der
Zielsite erhalten.
Vor dem Export...
Beachten Sie Folgendes vor dem Export einer Site:
Nicht verwendete Elemente löschen: Stellen Sie sicher, dass die Quellsite nur Elemente
enthält, die Sie importieren möchten. Löschen Sie nicht genutzte Arbeitsmappen, Projekte
oder Datenquellen.
Nicht verwendete Benutzer entfernen: Vergewissern Sie sich, dass alle Benutzer lizenziert
sind, und entfernen Sie alle Benutzer, die keine aktuellen Benutzer sind. Alle Benutzer, die Sie
aus der Quellsite exportieren, müssen in die Zielsite importiert werden. Sie können während
des Imports keine Benutzer entfernen.
Benutzerkonten auf dem Zielserver erstellen: Beim Importvorgang werden die Benutzer
einer Zielsite zugewiesen. Die Benutzer müssen auf dem Zielserver bereits über
Benutzerkonten verfügen. Wenn Sie eine Site in eine andere auf dem gleichen Tableau Server
exportieren, verfügen Sie über alle benötigten Benutzerkonten. Wenn Sie eine Site von
Tableau Online oder von einem anderen Tableau-Server exportieren, müssen Sie vor dem
Import auf dem Zielserver entsprechende Benutzerkonten erstellen.
Benutzerauthentifizierung überprüfen: Die Benutzerauthentifizierung ist eine
serverübergreifende Einstellung, und alle Sites auf einem Server müssen die gleichen
Einstellungen aufweisen. Sie können von Servern exportieren bzw. auf Server importieren, die
unterschiedliche Methoden zur Benutzerauthentifizierung verwenden. Sie müssen jedoch die
Zuordnungsdateien für den Import anpassen. Dieser Schritt ist Bestandteil des
Importvorgangs und wird unter Site-Zuordnungen überprüfen Auf Seite 232 beschrieben.
Da auf Tableau Online-Sites eine benutzerdefinierte Methode zur Benutzerauthentifizierung
zum Tragen kommt, werden beim Export von einer Tableau Online-Site Änderungen an den
benutzerspezifischen Zuordnungsdateien erforderlich. Somit wird ein einwandfreier Import
unabhängig von der Konfiguration des Zielservers sichergestellt.
Zeitpläne überprüfen: Auf der Seite "Zeitpläne" in Tableau Server werden die
Standardzeitpläne aufgelistet, die Sie für Aktualisierungen von Datenextrakten und Zeitplänen
verwenden können:
Die den Standardzeitplänen auf der Quellsite zugewiesenen Aktualisierungen und
Abonnements werden den gleichen Zeitplänen auf der Zielsite zugeordnet. Benutzerdefinierte
- 230 -
Zeitpläne auf der Quellsite werden in die Zielsite importiert und können optional beim
Bearbeiten der Zuordnungsdateien umbenannt werden.
Zielserver für die Abonnementübermittlung konfigurieren: Abonnements werden in die
neue Site importiert, Sie müssen jedoch den Zielserver für die Abonnementübermittlung
entsprechend konfigurieren, falls dies noch nicht erfolgt ist. Weitere Informationen finden Sie
unter Warnungen und Abonnements Auf Seite 120.
Zielsite erstellen oder angeben: Bevor Sie eine Sitedatei importieren können, müssen Sie
eine Zielsite auf Tableau Server erstellen. Alle Elemente, die zwar auf der Zielsite, aber nicht
auf der Quellsite vorhanden sind, werden bei Import entfernt. Aus diesem Grund wird eine
leere Site empfohlen. Weitere Informationen zum Erstellen oder Ändern von Sites finden Sie
unter Sites hinzufügen oder bearbeiten.
Site-IDs suchen: Für die Befehle zum Exportieren oder Importieren einer Site ist eine SiteID als Parameter erforderlich. Mit einer Site-ID wird eine Site von Tableau Server eindeutig
identifiziert. Wenn Sie an einer Site angemeldet sind, wird die Site-ID direkt hinter t/ in der URL
angezeigt:
Site exportieren
Während des Exports oder Imports muss Tableau Server nicht angehalten werden. So
exportieren Sie eine Site:
1. Öffnen Sie als Administrator eine Eingabeaufforderung, und wechseln Sie zum BinVerzeichnis von Tableau Server. Beispiel:
C:\Program Files\Tableau\Tableau Server\8.3\bin
2. Geben Sie folgenden Befehl ein:
tabadmin exportsite <site ID> --file <filename or path>.
Geben Sie beispielsweise Folgendes ein, wenn Sie eine Site mit der Site-ID wsales in
die Datei C:\sites\exported_sites\sales_export.zip exportieren:
tabadmin exportsite wsales --file C:\sites\exported_sites\sales_export.zip
Weitere Optionen, die Sie mit dem Befehl exportsite nutzen können, finden Sie
unter exportsite Auf Seite 427.
Während des Exports sperrt Tableau Server die Website.
Site importieren
Erstellen Sie eine Zielsite für den Import, falls dies noch nicht geschehen ist. Weitere Schritte
finden Sie unter Sites hinzufügen oder bearbeiten.
- 231 -
Der Import einer Site umfasst drei Schritte.Zunächst führen Sie den Befehl tabadmin
importsite aus, um die zu importierenden Dateien zu generieren. Anschließend
überprüfen Sie die Dateien, die anzeigen, wie die Site importiert wird. Zum Schluss beenden
Sie dem Import mit dem Befehl tabadmin importsite_verified.
Als Erstes benötigen Sie die exportierte Sitedatei und die Site-ID der Zielsite. Die Site-ID für
die Tableau Server-Standard-Site lautet ""(doppelte Anführungszeichen, kein
Leerzeichen).Wenn Sie Befehle innerhalb der Windows PowerShell ausführen, müssen Sie
die doppelten Anführungszeichen der Standardsite mit einfache Anführungszeichen
einschließen ('""').
Während des Importprozesses muss Tableau Server nicht angehalten werden, allerdings
muss die empfangende Site bis zum Abschluss des Imports gesperrt bleiben werden.
Site-Import starten
So starten Sie einen Site-Import:
1. Öffnen Sie als Administrator eine Eingabeaufforderung, und wechseln Sie zum BinVerzeichnis von Tableau Server. Beispiel:
C:\Program Files\Tableau\Tableau Server\8.3\bin
2. Geben Sie folgenden Befehl ein:
tabadmin importsite <site ID> --file <filename or path>
wobei <site ID> für die Site-ID der Zielsite und <filename or path> für den
vollständigen Pfad zur exportierten Sitedatei steht.
Geben Sie beispielsweise Folgendes ein, um die Datei C:\sites\exported_sites\sales_
export.zip in eine Site mit der Site-ID esales importieren:
tabadmin importsite esales --file C:\sites\exported_sites\sales_export.zip
Weitere Optionen, die Sie mit dem Befehl importsite nutzen können, finden Sie
unter importsite Auf Seite 429.
3. Nach Eingabe des Befehls werden die zu überprüfenden Zuordnungsdateien in
ProgramData\Tableau\Tableau Server\data\tabsvc\temp\import_<site ID>_
<datetime>\mappings abgelegt. Merken Sie sich diesen Speicherort für den nächsten
Schritt.
Site-Zuordnungen überprüfen
Die Zuordnungsdateien, die nach Initiierung des Site-Imports mit dem Befehl importsite
erstellt werden, zeigen, wie die Site-Ressourcen nach Abschluss des Imports zugewiesen
werden. Elemente, die von Tableau Server nicht zugeordnet werden können und bearbeitet
werden müssen, werden in den CSV-Dateien mit Fragezeichen (???) gekennzeichnet. Bevor
Sie den abschließenden Befehl importsite_verified ausführen können, müssen Sie die
Fragezeichen so auflösen, dass sie gültige Zuweisungen auf der Zielsite darstellen.
- 232 -
Im Rahmen Ihrer Änderungen können Benutzer nicht hinzugefügt oder entfernt werden.
Alle Benutzernamen der zu importierenden Benutzer müssen bereits auf dem Zielserver
vorhanden sein.
So überprüfen Sie die Zuordnungsdateien einer Site:
1. Navigieren Sie zum Verzeichnis, das nach Eingabe des Befehls importsite
angezeigt wird.
2. Öffnen Sie in Microsoft Excel (empfohen) oder in einem Texteditor die einzelnen CSVDateien im Ordner mit den Zuordnungen.
Die einzelnen Dateien zeigen an, wie die Elemente aus der Quellsite zugeordnet oder
verarbeitet werden, nachdem der Import in die Zielsite abgeschlossen ist.
3. Stellen Sie sicher, dass die Zuordnungen richtig sind. Ersetzen Sie alle angezeigten
Fragezeichen (???) durch einen gültigen Wert. Nutzen Sie diese Tabelle als
Orientierungshilfe:
CSV-Dateiname
Spaltenübersc Bearbeitu Beschreibung
hrift
ng
möglich?
mappingsDomainMapperForGroups
source_name
Nein
Ein Benutzer-Gruppenname auf der Quellsite.
source_
domain_name
Nein
Der Benutzer-Authentifizierungstyp auf der
Quellsite: local (für
lokale Authentifizierung) oder ein
Domänenname (für
Active Directory).
- 233 -
target_domain_
name
Ja*
Der BenutzerAuthentifizierungstyp
auf der Quellsite: local
für lokale
Authentifizierung oder
ein Domänenname
(wie example.com
oder example.lan) für
Active Directory.
*Ändern Sie nicht den
Wert target_domain_
name für alle
Benutzer. Belassen
Sie den Wert auf local,
auch wenn der
Zielserver für die
Active DirectoryBenutzerauthentifizier
ung konfiguriert ist. Die
Gruppe Alle Benutzer
ist eine spezielle
StandardBenutzergruppe, die
auf jedem Tableau
Server vorhanden sein
muss.
mappingsScheduleMapper
source_name
Nein
Die Namen der benutzerdefinierten und
Standardpläne für
Extrakte oder Abonnements auf der Quellsite.
source_scheduled_action_
type
Nein
Die Art des Plans,
Extrakt für Extraktaktualisierungen oder
Abonnement für die
Abonnementübermittlung
auf der Quellsite.
target_name
Ja
Die Namen der benutzerdefinierten Pläne
auf der Zielsite. Sie
- 234 -
können diese Werte
bearbeiten. Wenn der
Plan beispielsweise
Freitag Update auf
der Quellsite heißt, können Sie ihn auf der Zielsite in Freitag
Aktualisierung umbenennen.
target_scheduled_action_
type
Nein*
Die Art des Plans,
Extrakt für
Extraktaktualisierunge
n oder Abonnement
für die
Abonnementübermittlu
ng auf der Zielsite.
*In seltenen Fällen
werden in dieser
Spalte Fragezeichen
(???) angezeigt. Wenn
Fragezeichen
angezeigt werden,
ersetzen Sie diese
durch Extrakt oder
Abonnement, in
Übereinstimmung mit
dem Eintrag unter
source_scheduled_
action_type.
mappingsSiteMapper
mappingsSystemUserNameMapper
source_url_
namespace
Nein
Die Site-ID der Quellsite.
target_url_
namespace
Nein
Die Site-ID der Zielsite.
source_name
Nein
Der Benutzername
eines Benutzers auf
der Quellsite.
source_
domain_name
Nein
Der BenutzerAuthentifizierungstyp
auf der Quellsite: local
für lokale
Authentifizierung oder
- 235 -
ein Domänenname
(wie example.com
oder example.lan) für
Active Directory bzw.
external (für eine
Tableau Online-Seite).
target_name
Ja
Benutzernamen der
Benutzer, die der
Zielsite beim Import
zugewiesen werden.
Bestätigen Sie, dass
alle aufgeführten
Benutzernamen auf
dem Zielserver
vorhanden sind, und
ersetzen Sie
vorhandene
Fragezeichen (???)
durch einen gültigen
Benutzernamen des
Zielservers.
Sie können keine
Benutzernamen
erstellen, indem Sie
der CSV-Datei Zeilen
hinzufügen. Analog
dazu können Sie keine
Benutzernamen
entfernen, indem Sie
Zeilen löschen.
Sie können einen
Benutzernamen in der
Spalte target_name
bearbeiten, damit er
sich von seinem QuellBenutznamen
unterscheidet, wenn
dieser auf dem
Zielserversystem
bereits unter diesem
unterschiedlichen
Namen vorhanden ist.
- 236 -
Ein Benutzer kann
beispielsweise als
Wert für source_
name
[email protected]
und für target_name
johnsmith@example
.com haben, solange
der Benutzername
johnsmith@example
.com auf dem
Zielserver vorhanden
ist.
Sie können einen
Benutzer auf der
Quellsite nicht
mehreren
Benutzernamen auf
der Zielsite zuordnen.
target_domain_
name
Ja
Der Benutzer-Authentifizierungstyp auf der
Zielsite: local für lokale
Authentifizierung oder
ein Domänenname
(wie example.com
oder example.lan) für
Active Directory.
4. Speichern Sie während der Bearbeitung Ihre Änderungen, und behalten Sie die
Formatierung der CSV-Dateien bei. Belassen Sie die Zuordnungsdateien an ihrem
aktuellen Speicherort.
Site-Import beenden
So beenden Sie den Site-Import:
1. Öffnen Sie als Administrator eine Eingabeaufforderung, und wechseln Sie zum BinVerzeichnis von Tableau Server. Beispiel:
C:\Program Files\Tableau\Tableau Server\8.3\bin
2. Geben Sie folgenden Befehl ein:
tabadmin importsite_verified <site ID> --importjobdir <PATH>
- 237 -
wobei <site ID> für die Site-ID der Zielsite und <PATH> für das Verzeichnis steht,
das sie eine Ebene über dem Zuordnungsverzeichnis befindet, das Sie SiteZuordnungen überprüfen Auf Seite 232 verwendet haben. Beispiel:
tabadmin importsite_verified esales --importjobdir
C:\ProgramData\Tableau\Tableau
Server\data\tabsvc\temp\import_esales_20140409185810071
Weitere Optionen, die Sie mit dem Befehl importsite_verified nutzen können,
finden Sie unter importsite_verified Auf Seite 430.
3. Öffnen Sie die neue Site, die Sie soeben importiert haben, und bestätigen Sie, dass der
Import wie erwartet durchgeführt wurde.
Navigation in mehreren Sites
Im Folgenden sind einige Tipps aufgeführt, wie Sie von Site zu Site navigieren und die Site
identifizieren können, die Sie verwenden.
Site-Anmeldung
Wenn Sie Mitglied mehrerer Sites sind, werden Sie bei der Anmeldung am Server
aufgefordert, eine Site auszuwählen:
Navigation zu anderen Sites
Wenn Sie zu verschiedenen Sites gehören, wird oben auf der Seite ein Site-Menü angezeigt:
Um sich bei einer anderen Site anzumelden, klicken Sie auf das Site-Menü, und wählen Sie
die Site aus:
- 238 -
Identifizieren der Site
Wenn auf dem Server mehrere Sites ausgeführt werden, Sie aber nur zu einer Site gehören,
werden Sie bei der Anmeldung am Server nicht zur Auswahl einer Site aufgefordert. Nach der
Anmeldung wird oben auf der Seite kein Site-Menü angezeigt:
Dennoch zeigt die URL im Webbrowser ein t gefolgt von der Site-ID für Ihre Site:
Wenn der Server nur eine Site ausführt, sieht die URL im Webbrowser ähnlich aus (kein t und
keine Site-ID). Wenn Sie Folgendes sehen, verwenden Sie die integrierte Site von Tableau
mit dem Namen "Standard".
Serverwartung
Als Systemadministrator sollten Sie den Serverstatus überprüfen, die Aktivitäten auf dem
Server analysieren und überwachen, geplante Aufgaben verwalten und bestimmte
Verwaltungsaktivitäten ausführen, z. B. den Suchindex neu erstellen. Zudem können Sie
einige Einstellungen angeben, um die Bedienung für Personen, die den Server nutzen,
anzupassen. Sie können alle diese Aufgaben von der Wartungsseite aus ausführen.
Anzeigen des Status eines Serverprozesses
In der Statustabelle auf der Wartungsseite können Sie den Zustand der Tableau-Prozesse auf
den einzelnen Tableau-Servern betrachten:
Informationen zum nicht lizenzierten Status für einen VizQL-Serverprozess finden Sie
- 239 -
unter Verarbeiten eines nicht lizenzierten VizQL-Serverprozesses Auf Seite 469.
Um eine maschinenlesbare Version der obigen Informationen anzuzeigen, geben Sie auf der
Wartungsseite Ihre URL ein, wobei Sie den Begriff "status" durch "systeminfo" ersetzen (z. B.
http://jsmith/admin/systeminfo). Daraufhin wird eine Webseite angezeigt, die der folgenden
Abbildung ähnelt:
Die Statustypen für einen Tableau Service sind "OK", "Beschäftigt", "Nicht verfügbar" und
"Standby".
Remotezugriff auf den Status
Nur als Tableau-Administrator können Sie die Tools auf der Wartungsseite, darunter die
Tabelle "Status", sehen. Sie können jedoch die maschinenlesbare Version der Statustabelle
für Benutzer, die keine Administratoren sind, und für andere Computer als den Computer, der
als Host von Tableau Server fungiert, beispielsweise als Bestandteil eines
Remoteüberwachungsprozesses verfügbar machen. So gewähren Sie Remotezugriff auf den
Tableau Service-Status:
1. Öffnen Sie auf dem Computer, auf dem der primäre Tableau Server ausgeführt wird, die
Tableau Server-Konfigurationsdatei:
ProgramData\Tableau\Tableau Server\config\tabsvc.yml
- 240 -
2. Fügen Sie die Zeile wgserver.systeminfo.allow_referrer_ips: <IP
address or name> zu tabsvc.yml, wobei <IP address or name> für die IPv4Adresse oder den Computernamen des Computers steht, der hinzugefügt werden soll.
Wenn Sie mehreren Computern Zugriff auf den Dienststatus gewähren möchten,
verwenden Sie Kommas (nicht Leerzeichen) als Trennzeichen zwischen den einzelnen
Einträgen. Beispiel:
3. Speichern und schließen Sie tabsvc.yml.
4. Öffnen Sie als Administrator eine Eingabeaufforderung, und geben Sie Folgendes ein:
cd "C:\Program Files\Tableau\Tableau Server\8.3\bin"
5. Verwenden Sie dann den folgenden Befehl, um die Tableau Serverprozesse neu zu
starten:
tabadmin restart
Jetzt können die Benutzer auf den Computern, deren IP-Adressen oder
Computernamen Sie tabsvc.yml hinzugefügt haben, den Tableau-Prozessstatus
anzeigen, indem Sie die URL http://<server>/admin/systeminfo in einen
Browser oder in die Befehlszeile (beispielsweise curl
http://jsmith/admin/systeminfo) eingeben. Diese Funktionalität kann auch
im Rahmen eines automatisierten Remoteüberwachungsprozesses eingesetzt werden.
Neuerstellen des Suchindex
Wenn der Suchindex aus irgendeinem Grund nicht mehr die richtigen Ergebnisse liefert oder
Ergebnisse fehlen, sollten Sie den Suchindex neu erstellen. Außerdem sollten Sie den
Suchindex neu erstellen, wenn der Indexer über einen längeren Zeitraum ausfällt.
1. Um den Suchindex neu zu erstellen, klicken Sie auf der Registerkarte "Admin" auf
"Wartung":
- 241 -
2. Klicken Sie auf Suchindex neu erstellen, um den Vorgang zu starten.
Löschen der gespeicherten Kennwörter für Datenverbindungen
Wenn Sie als Administrator die Einstellung Gespeicherte Kennwörter aktivieren, dann können
die Serverbenutzer Kennwörter für Datenquellen sitzungs- und browserübergreifend
speichern. Sie können alle Kennwörter für alle Benutzer von Tableau Server zurücksetzen und
sie dadurch zwingen, sich beim nächsten Besuch einer Ansicht, die eine
Datenbankauthentifizierung erfordert, bei der Datenquelle anzumelden. Serverbenutzer
können Ihre gespeicherte Kennwörter für Datenverbindungen individuell auf der Seite
Benutzereinstellungen löschen.
So löschen Sie gespeicherte Kennwörter für Datenverbindungen für alle Serverbenutzer:
1. Klicken Sie in der linken Hälfte der Seite im Abschnitt "Administration" auf den Link
"Wartung":
- 242 -
2. Klicken Sie unter "Aktivitäten" auf Alle gespeicherten
Datenverbindungskennwörter für alle Benutzer löschen.
Protokolle auf Wartungsseite archivieren (Momentaufnahme)
Sie haben die Möglichkeit, eine Momentaufnahme(ein Archiv) der Tableau ServerProtokolldateien aus einem Webbrowser heraus zu erstellen und herunterzuladen, ohne die
Eingabeaufforderung zu öffnen. Diese gezippte Momentaufnahme enthält eine Kopie von
Protokolldateidaten von bis zu sieben Tagen aus Tableau Server sowie sämtlichen
Arbeitsservern (in verteilten Umgebungen). Durch den Vorgang der Momentaufnahme
werden die Protokolldateien aus Tableau Server oder die mit tabadmin erstellten
Protokollarchive nicht verändert oder entfernt.
Hinweis Zur Angabe der zu erfassenden Datenmenge oder des Namens der zu
erstellenden Zip-Datei können Sie mithilfe von tabadmin ein Archiv der Serverprotokolle
erstellen. Weitere Informationen hierzu finden Sie unter Archivieren von Protokollen
in der Befehlszeile (tabadmin) Auf Seite 460.
So erstellen Sie eine Momentaufnahme von Server-Protokolldateien:
- 243 -
1. Klicken Sie auf der Registerkarte "Admin" auf Wartung:
2. Klicken Sie unter "Aktivitäten" auf Momentaufnahme von Protokolldateien erstellen
und herunterladen, um die Momentaufnahmeoptionen zu öffnen:
3. Klicken Sie auf Momentaufnahme generieren, um eine Momentaufnahme der
Tableau Server-Protokolle zu erstellen. Die Schaltfläche "Momentaufnahme
generieren" ist nur dann verfügbar, wenn noch keine Momentaufnahme vorhanden ist.
Mit tabadmin erstellte Protokollarchive wirken sich nicht auf die Verfügbarkeit
dieser Option aus.
4. Klicken Sie auf Momentaufnahme herunterladen, um die Protokoll-
- 244 -
Momentaufnahme in den Standard-Download-Ordner Ihres Webbrowsers
herunterzuladen. Diese Option ist verfügbar, sobald Sie eine Momentaufnahme erstellt
haben.
In Google Chrome wird der Download am unteren Rand des Fensters angezeigt:
5. Klicken Sie auf den Pfeil und danach auf Öffnen, um die Momentaufnahme zu
entzippen, oder auf In Ordner anzeigen, um zu sehen, an welcher Stelle sie
gespeichert wurde:
6. (Optional) Klicken Sie auf Momentaufnahme löschen, um die Momentaufnahme
eines Protokolls zu löschen. Diese Option ist verfügbar, sobald Sie eine
Momentaufnahme erstellt haben. Sie müssen die vorhandene Momentaufnahme
löschen, bevor Sie eine neue erstellen können.
- 245 -
Dies ist beispielsweise der Fall, wenn Sie die Momentaufnahme löschen möchten, die
Sie vor einem zu untersuchenden Ereignis erstellt haben.
Wartungseinstellungen
Die folgenden Einstellungen sind im Abschnitt "Einstellungen" der Wartungsseite auf dem
Server verfügbar:
Einstellung
Eingebettete Anmeldeinformationen
Zeitplanung
Gespeicherte Kennwörter
Beschreibung
Publisher können veröffentlichten Arbeitsmappen Kennwörter
zuordnen, damit Webanwender automatisch authentifiziert
werden können, um eine Verbindung mit Datenquellen herstellen
zu können. Die Kennwörter werden den Arbeitsmappen
zugeordnet und sind nur auf dem Server zugänglich. Das heißt,
selbst wenn die Arbeitsmappe in Tableau Desktop geöffnet ist,
müssen die Benutzer einen Benutzernamen und Kennwort
eingeben, um eine Verbindung mit der Datenquelle herstellen.
Wenn diese Einstellung deaktiviert ist, werden alle vorhandenen
eingebetteten Kennwörter gespeichert, aber nicht zur
Authentifizierung verwendet. Wenn Sie die Einstellung wieder
aktivieren, Benutzer müssen die Kennwörter nicht erneut
einbetten.
Gibt Publishern die Möglichkeit, Arbeitsmappen Zeitpläne zuordnen. Diese Option ist nur verfügbar, wenn Embedded Credentials (Eingebettete Anmeldeinformationen) aktiviert worden
ist. Wenn diese Einstellung aktiviert ist, sehen Publisher die Zeitplanungsoptionen im Dialogfeld "Veröffentlichen".
Benutzer können Kennwörter für Datenquellen sitzungs- und
browserübergreifend speichern. Die Standard-Benutzerauswahl
lautet "Kennwort nur für diese Sitzung speichern".Dadurch können Benutzer ihr Kennwort für eine einzige Browser-Sitzung speichern.Wenn die Einstellung Saved Passwords (Gespeicherte
Kennwörter) aktiviert ist, können die Benutzer stattdessen die
Option Kennwort speichern wählen, mit der das Kennwort über
mehrere Sitzungen und für verschiedene Browser gespeichert
wird, sodass die Benutzer automatisch authentifiziert werden,
gleich, welchen Computer sie verwenden. Sie als Administrator
- 246 -
Zugangs-Token speichern
Gast aktivieren
Standardstartseite
Standardsprache und
Gebietsschema
Alle Einstellungen auf
die Standardwerte
zurücksetzen
können jederzeit alle gespeicherten Kennwörter löschen. Außerdem können die Benutzer ihre eigenen gespeicherten Kennwörter löschen.
Ermöglicht es Benutzern, Zugriffstoken mit ihren Benutzereinstellungen zu speichern. Zugriffstoken werden aus CloudDatenquellen bereitgestellt, die OAuth-Verbindungen unterstützen. Sie werden anstelle von Benutzernamen und Kennwörtern für den Datenzugriff verwendet. Weitere Informationen
finden Sie unter OAuth-Datenverbindungen Auf Seite 363.
Benutzer können eingebettete Ansichten anzeigen und damit
interagieren, ohne sich bei einem Tableau Server-Konto anmelden zu müssen. Die Berechtigung kann dem Benutzerkonto
"Gast" zugewiesen werden, um die für jede Ansicht zulässige
Interaktivität zu steuern. Diese Option ist nur bei Verwendung
einer core-basierten Serverlizenz verfügbar. Diese Option kann in
Verbindung mit Automatische Anmeldung aktivieren verwendet werden, einer Option, die Sie während des Setups auswählen können.
Öffnet für alle Benutzer die aktuelle Startseite des Servers. Unter
Standardstartseite für alle Benutzer festlegen oben erfahren
Sie, wie Sie diese Seite ändern. Bestimmte Benutzer können
diese Einstellung überschreiben (siehe Die Seite "Benutzerdefiniert" Auf Seite 10).
Legt fest, welche Sprache für die Server-Benutzeroberfläche und
welches Gebietsschema für Ansichten verwendet wird.
Bestimmte Benutzer können diese Einstellung auf Ihrer Seite
Benutzereinstellungen überschreiben. Zudem wird zuerst anhand
der Webbrowser-Einstellungen bestimmt, welche Sprache und
welches Gebietsschemas verwendet werden. Weitere Informationen hierzu finden Sie unter Sprache und Gebietsschema
Auf Seite 264.
Alle Servereinstellungen, die seit dem Setup verändert wurden,
werden auf die ursprüngliche Einstellung zurückgesetzt.
Standardstartseite für alle Benutzer festlegen
Bei der Installation von Tableau Server wird die Ansichten-Seite als Standardstartseite für alle
Benutzer festgelegt. Der Administrator kann allerdings eine andere Startseite bestimmen, auf
die alle Benutzer zugreifen können, wie die Arbeitsmappen-Seite. Bestimmte Benutzer
können diese Einstellung überschreiben (siehe Die Seite "Benutzerdefiniert" Auf Seite 10).
So legen Sie die Standardstartseite für alle Benutzer fest:
1. Navigieren zu der Seite, die Sie als Standardseite festlegen möchten.
2. Klicken Sie auf Ihren Namen oben rechts in der Ecke.
- 247 -
3. Wählen Sie Zur Startseite für alle Benutzer machen aus.
Tableau Server Monitor
Tableau Server Monitor wird als Bestandteil von Tableau Server installiert und ist über die
Windows-Taskleiste zugänglich.
Mit diesem Tool können Sie den Server starten und anhalten, Tableau Server öffnen und den
Serverstatus anzeigen.
Open the Server (Server öffnen)
Mit diesem Befehl wird Tableau Server in Ihrem Webbrowser gestartet. Dies ist eine einfache
Möglichkeit, auf die Webanwendung und die zugehörigen Wartungstools zuzugreifen.
Start/Stop the Server (Server starten/anhalten)
Mit diesen Befehlen können Sie den Server starten und stoppen. Wen Sie den Server
anhalten, machen Sie ihn für alle Benutzer verfügbar und beenden alle Sitzungen, die
gegenwärtig ausgeführt werden. Wenn jemand eine Arbeitsmappe veröffentlicht, wenn der
Server angehalten wurde, dann wird der Prozess angehalten. Das kann dazu führen, dass nur
einige Arbeitsblätter der Arbeitsmappe auf dem Server veröffentlicht werden. Weil die Arbeit
der Benutzer durch das Anhalten des Servers stark beeinträchtigt werden kann, müssen Sie
sie unbedingt warnen, bevor Sie diesen Vorgang ausführen oder die Durchführung von
Wartungsaufgaben außerhalb der Geschäftszeiten planen.
Restart the Server (Server neu starten)
Mit diesem Befehl wird der Server neu gestartet. Während der Server neu gestartet wird, ist er
für keinen Benutzer verfügbar. Warnen Sie die Benutzer unbedingt vor dem Ausfall, bevor Sie
- 248 -
diesen Vorgang durchführen. Der Server muss neu gestartet werden, wenn Sie die Tableau
Server-Konfiguration geändert haben.
Display Status (Status anzeigen)
Mit diesem Befehl wird ein QuickInfo mit dem Status der einzelnen Prozesse geöffnet. Um
ausführlichere Statusinformationen zu erhalten, öffnen Sie die Wartungsseite.
Product Keys verwalten
Mit diesem Befehl wird der Produkt Key Manager geöffnet, in dem Sie Product Keys
hinzufügen und entfernen können.
Beenden
Mit diesem Befehl wird Tableau Server Monitor beendet. Tableau Server wird nicht beendet.
Sie können die Anwendung erneut öffnen, indem Sie im Startmenü von Windows Alle
Programme > Tableau Server 8.3 > Tableau Server Monitor auswählen.
Datenquellen
Eine Tableau Server-Datenquelle ist eine mehrfach aufrufbare Verbindung mit Daten. Sie
kann einen Datenextrakt oder Informationen für eine Pass-Through-Verbindung auf eine
relationale Livedatenbank umfassen. Sie kann auch einen Layer mit Anpassung wie
Berechnungen, Gruppen oder Sätze enthalten. (Cube-Datenquellen weisen bestimmte
Limitierungen auf. Weitere Informationen dazu finden Sie unter Mehrdimensionale (Cube-)
Datenquellen Auf Seite 252.)
Tableau Server Datenquellen werden in Tableau Desktop erstellt und dann auf dem Server
veröffentlicht. Weitere Informationen zum Erstellen, Herunterladen und Bearbeiten von
Tableau Server-Datenquellen finden Sie in der Hilfe zu Tableau Desktop.
Nachdem eine Datenquelle veröffentlicht wurde, können Tableau Server-Benutzer mit den
entsprechenden Berechtigungen mit einer Datenquelle eine komplett neue Arbeitsmappe auf
dem Server erstellen. Weitere Informationen finden Sie unter Erstellen einer Arbeitsmappe
und Erstellen einer Ansicht Auf Seite 67.
Administratoren können mit den Tableau Server-Datenquellen folgende Aufgaben ausführen:
l
l
Bearbeiten und Anzeigen von Datenquellenberechtigungen: Mit Berechtigungen
legen Sie fest, welche Benutzer oder Gruppen eine Verbindung mit Datenquellen
herstellen und diese bearbeiten sowie herunterladen dürfen. Weitere Informationen
hierzu finden Sie unter Festlegen von Berechtigungen für eine Datenquelle.
Erstellen von Aktualisierungszeitplänen für Datenquellenextrakte: Wenn eine
Datenquelle einen Extrakt umfasst, können Sie für den Extrakt einen
Aktualisierungszeitplan festlegen. Weitere Informationen hierzu finden Sie unter
Zeitplanaufgaben.
Die oben beschriebenen Aufgaben können zwar in Tableau Desktop auch von der Person
ausgeführt werden, die die Datenquelle veröffentlicht hat. Im Allgemeinen ist es jedoch
sinnvoller, wenn Administratoren diese Aufgabe auf dem Server verwalten. Administratoren
können auch eine Datenquelle entfernen oder der Datenquelle Tags hinzufügen.
- 249 -
Verwalten von Datenquellen
Benutzer können mit Tableau Server-Datenquellen arbeiten, sofern sie über die
entsprechenden Berechtigungen für die Datenquelle verfügen. Bei Proxy-Verbindungen als
Datenquellen müssen Sie auch berücksichtigen, wie sich die Benutzer gegenüber der
Datenbank authentifizieren und ob die richtigen Treiber auf Tableau Server installiert sind.
Weitere Informationen finden Sie im Folgenden.
Festlegen von Berechtigungen für eine Datenquelle Auf Seite 93
Datenbanktreiber Auf Seite 155
Datensicherheit Auf Seite 280
Informationen zu Tableau Data Server
Der Datenserver von Tableau ist eine Serverkomponente für die zentrale Verwaltung und
Speicherung von Tableau Server-Datenquellen. Eine Datenquelle ist eine mehrfach
aufrufbare Verbindung auf Daten. Die Daten können sich entweder als Extrakt in der DatenEngine von Tableau befinden oder in einer relationalen Livedatenbank. Bei relationalen
Datenbankverbindungen werden die in der Datenquelle gespeicherten Informationen für eine
Pass-Through-Verbindung verwendet. Die Datenquelle kann auch individuell angepasst sein
und die Einstellungen widerspiegeln, die Sie auf Feldebene in Tableau Desktop vorgenommen
haben, beispielsweise Berechnungen, Dimensionsaliase, Gruppen oder Sätze.
Administratoren bietet die Verwendung von Tableau Server-Datenquellen viele Vorteile. Da
ein Datenquellenextrakt von vielen Arbeitsmappen verwendet werden kann, können Sie
Speicherplatz auf dem Server sowie Zeit für die Verarbeitung einsparen. Zur Aktualisierung
von Datenquellen können Sie für jeden Extrakt anstatt für jede Arbeitsmappe einen Zeitplan
erstellen. Wenn dann eine Arbeitsmappe mit einer Tableau Server-Datenquelle
heruntergeladen wird, verbleibt das Datenextrakt auf dem Server, und es fällt weniger
Datenverkehr im Netzwerk an. Schließlich müssen Sie für den Fall, dass für eine Verbindung
ein Datenbanktreiber erforderlich ist, den Treiber nur einmal auf Tableau Server und nicht auf
den einzelnen Desktopcomputern der Benutzer installieren.
Zur Verwendung des Datenservers brauchen Autoren lediglich eine Verbindung mit den
Daten in Tableau Desktop herzustellen, indem sie einen Extrakt oder eine Verbindung mit
einer relationalen Livedatenbank erstellen und dies in Tableau Server veröffentlichen. Nach
der Veröffentlichung können die Autoren mit diesen mehrfach aufrufbaren Datenquellen und
dem Server schnell und einfach Daten abrufen und Arbeitsmappen erstellen.Um eine
veröffentlichte Datenquelle zu ändern, laden Sie sie in Tableau Desktop, nehmen Sie die
Änderungen vor, veröffentlichen Sie sie erneut und überschreiben Sie dabei das
Original.Beachten Sie, dass sämtliche neuen Mitglieder, die Sie zu einem Parameter
hinzufügen sowie sämtliche an der Standardreihenfolge vorgenommenen Änderungen nicht
Teil der Datenquelle sind (sondern Teil der Arbeitsmappe).
Wenn Sie Tableau Server für eine verteilte Installation eingerichtet haben und davon
ausgehen, dass die Datenquellen häufig und intensive genutzt werden, gibt es verschiedene
Möglichkeiten, die Serverbereitstellung zu optimieren. Weitere Informationen hierzu finden Sie
unter Verteilte Umgebungen Auf Seite 149.
- 250 -
Hinweis: Zur Verwendung von veröffentlichten mehrdimensionalen (Cube-)
Datenquellen müssen Sie diese auf Tableau Desktop herunterladen, wobei viele der
oben beschriebenen Vorteile dann nicht gelten. Weitere Informationen dazu finden Sie
unter Mehrdimensionale (Cube-)Datenquellen Auf der nächsten Seite.
Verwenden von Datenquellen
Wenn Sie Autor einer Arbeitsmappe sind, können Sie mit einer Tableau Server-Datenquelle
eine neue Arbeitsmappe erstellen oder eine vorhandene bearbeiten. Sie können mit
Datenquellen aus Tableau Desktop oder der Tableau Server
Webdokumenterstellungsumgebung arbeiten.
Arbeiten mit Datenquellen aus Tableau Desktop
Klicken Sie auf der Seite "Verbindung zu Daten herstellen" in Tableau Desktop auf Tableau
Server, und geben Sie Ihre Anmeldeinformationen ein:
Nach der Anmeldung bei Tableau Server werden die verfügbaren Datenquellen rechts
aufgelistet.
- 251 -
Hinweis: Weitere Informationen speziell zu Cube-Datenquellen finden Sie unter
Mehrdimensionale (Cube-)Datenquellen oben.
Damit eine Datenquelle angezeigt werden kann, muss die Person, die die Datenquelle
veröffentlicht, die Berechtigung "Connect" (Verbinden) für die Benutzer auf Zulassen setzen.
Standardmäßig verfügen alle Benutzer über diese Berechtigung.
Wählen Sie eine Datenquelle aus, die Sie verwenden möchten. Die Datenquelle wird in das
Datenfenster in der Arbeitsmappe geladen. Tableau Server Datenquellen sind mit einem
Tableau-Symbol anstelle eines Datenbanksymbols gekennzeichnet:
Arbeiten mit einer Datenquelle in der Webdokumenterstellungsumgebung
Nachdem Sie sich in der linken Navigationsspalte in Tableau Server angemeldet haben,
wählen Sie Datenquellen aus. Bei Administratoren befindet sich dies auf der Registerkarte
"Inhalt".
Aktivieren Sie in der Liste der Datenquellen das Kontrollkästchen neben dem, das Sie
verwenden möchten, und klicken Sie dann auf Neue Arbeitsmappe.
Weitere Informationen finden Sie unter Erstellen einer Arbeitsmappe und Erstellen einer
Ansicht Auf Seite 67.
Weitere Informationen zum Veröffentlichen von Datenquellen von Tableau Desktop finden Sie
unter Veröffentlichen von Datenquellen in der Hilfe von Tableau Desktop.
Mehrdimensionale (Cube-)Datenquellen
Mehrdimensionale (Cube-)Datenquellen verfügen über bestimmte Eigenschaften, durch die
sie in Tableau eindeutig identifizierbar sind.
Cube-Datenquellen unterstützen keine Pass-Through-Verbindungen. Das bedeutet, dass Sie
nach dem Veröffentlichen der Cube-Datenquelle von Tableau Server aus keine Verbindung
mithilfe dieser Datenquelle aufbauen können. Außerdem können Sie bei der Erstellung von
Arbeitsmappen nicht die Datenquelle in Tableau Server verwenden.
- 252 -
Durch das Veröffentlichen einer Cube-Datenquelle auf Tableau Server haben Sie die
Möglichkeit, die Datenquelle auf dem Server zu speichern. Wenn Sie die Datenquelle
allerdings verwenden möchten, müssen Sie diese auf Tableau Desktop herunterladen und
lokal nutzen. Zum Herunterladen einer veröffentlichten Datenquelle müssen folgende
Voraussetzungen erfüllt sein:
l
l
Die Berechtigung Herunterladen/Im Web speichern unter für die Datenquelle.
Weitere Informationen dazu finden Sie unter Arbeiten mit Berechtigungen Auf Seite
89 und Festlegen von Berechtigungen für eine Datenquelle Auf Seite 93.
Auf dem Computer, auf dem Tableau Desktop ausgeführt wird, sind die passenden
Treiber installiert und die richtigen Ports geöffnet.
Behandeln von Datenquellenproblemen
Für Benutzer, die mit Tableau Server-Datenquellen arbeiten, müssen drei Voraussetzungen
erfüllt sein:
l
Berechtigungen für die Datenquelle: Jeder, der eine Verbindung mit einer
Datenquelle herstellen möchte, muss über die Berechtigungen Verbinden und View
(Anzeigen) verfügen. Dies gilt auch für Benutzer, die auf Ansichten zugreifen, welche
eine Verbindung mit einer Datenquelle herstellen. Ein Benutzer, der Datenquellen
veröffentlichen und bearbeiten möchte, muss über die Berechtigung zum
Veröffentlichen und zudem über die Berechtigungen Schreiben/Speichern unter und
Herunterladen/Im Web speichern unter verfügen. Weitere Informationen hierzu
finden Sie unter Arbeiten mit Berechtigungen Auf Seite 89 und Festlegen von
Berechtigungen für eine Datenquelle Auf Seite 93.
Mehrdimensionale (Cube-)Datenquellen müssen heruntergeladen und in Tableau
Desktop verwendet werden, daher benötigen sie die Berechtigung Herunterladen/Im
Web speichern unter. Weitere Informationen zu Cubes in Tableau finden Sie unter
Mehrdimensionale (Cube-)Datenquellen Auf der vorherigen Seite.
l
l
Authentifizierungsmöglichkeit für die Datenbank: Es gibt verschiedene
Möglichkeiten für eine Datenverbindung in Tableau und die Steuerung der
Zugriffsrechte. Im Grunde muss für eine Verbindung mit der Datenbank immer eine
Authentifizierung erfolgen. Der Zugriff kann z. B. durch Tableau Server zur
Aktualisierung eines Extrakts erfolgen. Es kann sich um einen Benutzer von Tableau
Desktop handeln, der eine Verbindung zu einer Datenquelle herstellt, die wiederum eine
Verbindung zu einer Livedatenbank herstellt. Oder es handelt sich um einen Benutzer
von Tableau Server, der auf eine Ansicht zugreift, die eine Verbindung zu einer
Livedatenbank herstellt. Weitere Informationen zu den Optionen finden Sie unter
Datensicherheit Auf Seite 280.
Datenbanktreiber: Wenn für einen Benutzer, der eine Datenquelle in Tableau Desktop
erstellt und veröffentlicht hat, zusätzliche Datenbanktreiber installiert werden mussten,
müssen Sie diese Treiber möglicherweise auch auf Tableau Server installieren. Im Falle
- 253 -
einer verteilten Installation von Tableau Server, bei der beispielsweise der
Datenserverprozess auf einem Arbeitsserver ausgeführt wird, müssen alle
erforderlichen Datenbanktreiber sowohl auf diesem Server als auch auf dem primären
Server installiert werden. Auch für andere Prozesse sind Treiber erforderlich. Weitere
Informationen hierzu finden Sie unter Datenbanktreiber Auf Seite 155.
Fehlermeldungen zu Datenquellen
Im Folgenden sind einige Fehlermeldungen aufgeführt, die den Arbeitsmappenautoren und
weiteren Benutzern beim Arbeiten mit Datenquellen und Ansichten möglicherweise angezeigt
werden:
Berechtigung für den Zugriff auf diese Tableau Server-Datenquelle verweigert: Für
eine Verbindung mit einer Datenquelle ist die Berechtigung "Verbinden" erforderlich. Weitere
Informationen hierzu finden Sie unter Arbeiten mit Berechtigungen Auf Seite 89 und
Festlegen von Berechtigungen für eine Datenquelle Auf Seite 93 .
Die Datenquelle wurde nicht gefunden: Wird beim Arbeiten mit einer Ansicht diese
Fehlermeldung angezeigt, wurde die Datenquelle möglicherweise von Tableau Server
entfernt oder die Seite "Verbindung zu Daten herstellen" muss aktualisiert werden. Klicken Sie
zum Aktualisieren der Seite "Verbindung zu Daten herstellen" in Tableau Desktop auf das
Symbol "Aktualisieren":
Keine Verbindung zu dieser Tableau Server-Datenquelle: Diese Fehlermeldung wird
möglicherweise angezeigt, wenn die Verbindungsinformationen für die Datenquelle geändert
wurden. Dies kann beispielsweise der Fall sein, wenn der Name des Datenbankservers
geändert wurde. Überprüfen Sie die Informationen für die Datenquelle unter
"Datenverbindung", und stellen Sie sicher, dass die Einstellungen korrekt sind.
Fehler beim Auflisten der Tableau Server-Datenquellen: Diese Fehlermeldung wird
möglicherweise angezeigt, wenn er Benutzer versucht, auf die Tableau Server-Datenquellen
zuzugreifen, während Verbindungsprobleme zwischen Tableau Server und Tableau Desktop
vorliegen.
Verbindung zur Cubedatenquelle nicht möglich: Zur Verwendung einer veröffentlichten
mehrdimensionalen (Cube-)Datenquelle müssen Sie die Datenquelle herunterladen und in
Tableau Desktop verwenden. Stellen Sie sicher, dass Sie über die Berechtigung
Herunterladen/Im Web speichern unter für die Datenquelle verfügen. Weitere
Informationen zu Cubes in Tableau finden Sie unter Mehrdimensionale (Cube-)
Datenquellen Auf Seite 252.
- 254 -
Datenverbindungen
Jede in Tableau Server veröffentlichte Arbeitsmappe enthält mindestens eine Verbindung.
Diese Verbindungen werden auf der Registerkarte "Datenverbindungen" im
Verwaltungsbereich des Servers aufgelistet.
Der Unterschied zwischen Datenverbindungen und Datenquellen
Der Unterschied zwischen Datenverbindungen und Datenquellen besteht darin, dass jede
Verbindung einer einzigen Arbeitsmappe zugeordnet ist und die Attribute beschreibt, die zum
Herstellen einer Verbindung mit der Datenquelle erforderlich sind (z. B. Servername,
Datenbankname usw.). Wenn Sie also drei Arbeitsmappen haben, die eine Verbindung mit
der gleichen Datenquelle herstellen, dann werden auf der Datenverbindungsseite drei
Verbindungen aufgeführt.
Suchen von Datenverbindungen
Im Suchbereich oben auf der Seite "Datenverbindungen" können Sie anhand von Namen von
Datenbankservern, Ports, allgemeinen Verbindungstypen und der Tatsache, ob die
Datenbankanmeldeinformationen eingebettet sind oder nicht, nach Verbindungen suchen.
Machen Sie Eingaben in einem oder mehreren Feldern, und klicken Sie auf "Suche", um in
diesem Bereich nach einer Verbindung zu suchen.
- 255 -
Welche Verbindungen kann ich bearbeiten?
Sie können die Verbindungsdaten für Verbindungen mit Livedatenbanken und für Extrakte
bearbeiten, die mit Tableau Server aktualisiert werden müssen. Beispielsweise können Sie
über eine große Anzahl von Arbeitsmappen verfügen, die eine Verbindung mit einer
Datenbank auf einem bestimmten Datenbankserver herstellen. Wenn sich der Name des
Servers ändert, können Sie alle Arbeitsmappen gleichzeitig aktualisieren, sodass sie auf den
neuen Servernamen verweisen. Ein anderes Beispiel könnte sein, wenn eine Arbeitsmappe
über einen bestimmten Benutzernamen und ein Kennwort eine Verbindung mit einer
Datenbank herstellt. Sie können schnell alle Arbeitsmappen so aktualisieren, dass sie andere
Anmeldeinformationen verwenden.
Näheres zum Bearbeiten von Datenverbindungen finden Sie im zugehörigen Thema unten.
Bearbeiten von Datenverbindungen
Über die Seite "Datenverbindungen" können Administratoren die Verbindungsinformationen
für veröffentlichte Arbeitsmappen verwalten. Hier können Sie den Verbindungstyp ändern, um
ein anderes Benutzerkonto oder einen anderen Authentifizierungstyp mit einer Datenquelle zu
speichern oder um integrierte Kennwörter zu entfernen und von Benutzern jedes Mal erneut
die Anmeldedaten abzufragen.
So könnten Sie beispielsweise bei einigen Cloud-Datenquellen anstelle der
Datenbankanmeldeinformationen ein vorkonfiguriertes OAuth-Zugriffstoken für die
Verbindung anfordern lassen.Weitere Informationen zu OAuth finden Sie unter OAuthDatenverbindungen Auf Seite 363.
Hinweis Wenn Sie nicht Serveradministrator sind, jedoch über
Bearbeitungsberechtigungen für eine Datenquelle verfügen, können Sie auf die
Datenverbindungseinstellungen auf der Seite "Datenquellen" zugreifen.
1. Melden Sie sich an der Site an, auf der sich die Datenverbindungen befinden, die Sie
ändern möchten, und klicken Sie auf Datenverbindungen, um die
Datenverbindungsseite anzuzeigen.
- 256 -
2. Durchsuchen Sie die Verbindungsliste, oder nutzen Sie die Suchfilter oben in der Liste,
um die Ergebnisse einzugrenzen.
Sie können nach dem Namen und Port des Data Server, nach Verbindungstyp und
Benutzernamen für die Datenbank suchen.Sie können zudem Datenquellen mit
eingebetteten Kennwörtern ausschließen oder einschließen.
Die Werte, die Sie in die Felder Server und Database User Name (DatenbankBenutzername) eingeben, werden als reguläre Ausdrücke behandelt.
3. Aktivieren Sie die Kontrollkästchen zu den Verbindungen, die Sie ändern möchten, und
klicken Sie danach auf den LinkBearbeiten oben in der Liste.
- 257 -
4. Geben Sie einen neuen Wert für ein oder mehrere Verbindungsattribute ein.
Weiter Informationen zu Google- und Salesforce.com-Datenquellen finden Sie unter
Authentifizierungsoptionen für Google und Salesforce.com oben im weiteren
Verlauf dieses Themenabschnitts.
Wenn eine Datenbank oder ein Datenbanktreiber die Verbindung über eine IP-Adresse
nicht unterstützt, müssen Sie den Namen der Datenbank als Wert für Server eingeben.
Wenn Sie auf Senden klicken, werden alle Attribute in der Spalte Ändern? aktualisiert.
Wenn Sie das Kontrollkästchen für ein Attribut aktivieren und das Feld Neuer Wert leer
lassen, wird das Attribut ebenfalls leer gelassen.
5. Klicken Sie auf Absenden.
6. Aktualisieren Sie die Datenverbindungsseite (F5 oder Strg+R drücken), damit die
Änderungen wirksam werden.
Authentifizierungsoptionen für Google und Salesforce.com
Google BigQuery, Google Analytics und Salesforce.com bieten eine gesicherte
Authentifizierungsoption. Wenn Sie diese Option auswählen, wird die Verbindung durch ein
OAuth-Zugriffstoken erstellt. In Tableau müssen keine Datenbankanmeldeinformationen
gespeichert werden. Alle Benutzer verbinden sich über dieses Zugriffstoken. Dies gilt auch für
Tableau Desktop-Benutzer, die über diese Verbindung Arbeitsmappen erstellen oder
bearbeiten möchten.
Eine Übersicht über den OAuth-Vorgang finden Sie unter OAuth-Datenverbindungen Auf
Seite 363.
Google-Authentifizierungsoptionen
Zum Bearbeiten von Google BigQuery- oder Google Analytics-Verbindungen können Sie
zwischen folgenden Optionen im Dialogfeld "Datenverbindung bearbeiten" wählen:
- 258 -
l
Wählen Sie zur Authentifizierung über ein bestimmtes Konto Ständiger Zugriff… und
dann in der Liste ein vorhandenes Konto aus, oder klicken Sie auf Konto jetzt
authentifizieren..., um ein neues Konto hinzuzufügen.
Wenn Sie ein neues Konto hinzufügen, wird die Google-Anmeldeseite angezeigt.
Nachdem Sie Ihre Datenbankanmeldeinformationen eingegeben haben, werden Sie
von Google aufgefordert, den Tableau-Zugang zu den Daten zu bestätigen. Wenn Sie
auf Akzeptieren klicken, gibt Google ein Zugriffstoken aus, mit dem Sie eine
Verbindung zu den Daten herstellen können.
Wenn Sie Extrakte der Google-Datenquelle erstellen möchten, wählen Sie diese
erste Option aus, um Aktualisierungsaufgaben planen zu können.
l
Wählen Sie Benutzer auffordern aus, damit sich Benutzer über ihre eigenen
Zugriffstoken oder bei jedem Verbindungsaufbau anmelden müssen.
Salesforce.com-Authentifizierungsoptionen
Zum Bearbeiten von Salesforce.com-Verbindungen können Sie zwischen folgenden Optionen
im Dialogfeld "Datenverbindung bearbeiten" wählen:
l
Wählen Sie Geplante Extraktaktualisierungen aktivieren mit... aus, um eine
geschützte OAuth-Verbindung zu nutzen und Aktualisierungsaufgaben zu planen.
Danach wählen Sie in der Liste ein vorhandenes Konto aus, oder klicken Sie auf Konto
auf Salesforce jetzt authentifizieren, um ein neues Konto hinzuzufügen.
Wenn Sie ein neues Konto hinzufügen, wird die Salesforce.com-Anmeldeseite
angezeigt. Nachdem Sie Ihre Datenbankanmeldeinformationen eingegeben haben,
werden Sie von Salesforce.com aufgefordert, den Tableau-Zugang zu den Daten zu
bestätigen.
- 259 -
Wenn Sie den Tableau-Zugriff erlauben, erstellt Salesforce.com ein Zugriffstoken, über
das eine Verbindung zu den Daten hergestellt wird.
l
l
Wählen Sie Benutzernamen und Kennwort einbetten aus, um eine herkömmliche
Authentifizierungsmethode zu verwenden.
Wählen Sie Keine geplanten Aktualisierungen aus, damit sich Benutzer bei jeder
Verbindung zu Salesforce.com erneut anmelden müssen.
Status überwachen
Wenn Sie Ihre Änderungen im Dialogfeld "Datenverbindung" speichern, wird der Fortschritt im
Dialog angezeigt. Wenn Sie das Dialogfeld schließen, werden die Änderungen im Hintergrund
weiter ausgeführt, bis sie abgeschlossen sind. Tableau Server nimmt möglichst viele
Änderungen vor. Fehler werden übergangen; weitere Änderungen werden dadurch aber nicht
verhindert. Wenn Sie beispielsweise versuchen, den Servernamen zu ändern und mehreren
Verbindungen ein Kennwort zuweisen, dann werden die Servernamen geändert und die
Kennwörter für Arbeitsmappen geändert. Da Sie jedoch in eine Datenquelle keine Kennwörter
einfügen können, werden die Kennwörter für die Datenquellen nicht verändert.
Informationen zur Fortschrittskontrolle dieser Aufgaben finden Sie unter
Hintergrundaufgaben Auf Seite 269.
Anpassen des Servers
Sie können das Aussehen von Tableau Server ändern, um es für Ihr Unternehmen oder Ihre
Gruppe zu personalisieren. Beispielsweise können Sie den Namen ändern, der in QuickInfos
- 260 -
und Meldungen angezeigt wird, und Sie können das Logo ändern, das auf den meisten
Serverseiten erscheint.
Zudem können Sie anpassen, auf welche Weise die Benutzer mit dem Server interagieren
können. Beispielsweise können Sie es Arbeitsmappen-Publishern erlauben, ihre
Anmeldeinformationen für die Datenquelle einzubetten, sodass Benutzer, die auf eine
veröffentlichte Ansicht mit einer Verbindung zu einer Live-Datenquelle klicken, sofort Zugriff
auf diese Ansicht haben und nicht zuerst ihre Anmeldedaten für die Datenbank eingeben
müssen.
Überdies können Sie steuern, welche Sprache für die Server-Benutzeroberfläche und
welches Gebietsschema für Ansichten verwendet wird.
Weitere Informationen zum Anpassen von Tableau Server finden Sie in den folgenden
Themen:
Ändern von Name oder Logo
Sie können die folgenden Aspekte des Erscheinungsbilds von Tableau Server anpassen:
Ändern des Namens
Sie können das Erscheinungsbild von Tableau Server anpassen, indem Sie den in QuickInfos
und Meldungen angezeigten Namen anpassen. Wenn Sie beispielsweise den Namen in
MyCo ändern, so lautet der Text auf der Server-Anmeldeseite "Geben Sie Ihren MyCoBenutzernamen und das Kennwort zur Anmeldung ein.Auf der Quickinfo des StartseitenNavigationssymbols wird MyCo-Startseite anstatt Tableau Server-Startseite angezeigt:
In den Copyrightangaben unten auf jeder Serverseite wird dagegen nach wie vor Tableau
genannt (Beispiel: ©2013, Tableau Software, Incorporated und Lizenzgeber. Alle Rechte
vorbehalten.)
Wenn Sie zur Authentifizierung Active Directory verwenden, können Sie auf der Anmeldeseite
nicht den Firmenname anpassen.
So ändern Sie den in QuickInfos und Meldungen angezeigten Namen:
1. Öffnen Sie als Administrator eine Eingabeaufforderung, und geben Sie Folgendes ein:
cd "C:\Program Files\Tableau\Tableau Server\8.3\bin"
2. Ändern Sie den Namen durch folgende Eingabe:
tabadmin customize name "new_name"
Ersetzen Sie in der vorstehenden Zeile "new_name" durch den Text, der als Name auf
dem Server angezeigt werden soll. Beispiel: tabadmin customize name
"Company Server"
- 261 -
3. Starten Sie den Server mit folgendem Befehl neu, damit die Änderung wirksam wird:
tabadmin restart
Ändern des Logos
Sie können das Erscheinungsbild von Tableau Server anpassen, indem Sie das große Logo
anpassen, das auf der Tableau Server-Anmeldeseite und in der linken Spalte auf den
Hauptserverseiten (Seite Projekte, Seite Arbeitsmappe, Seite Wartung usw.) angezeigt wird.
Das große Logo darf bis zu 160 x 160 Pixel aufweisen. Implementieren Sie es mit dem Befehl
tabadmin customize logo. Sie können auch das kleine Logo anpassen, das in jeder
Arbeitsmappe und Ansicht oben links angezeigt wird. Das kleine Logo darf bis zu 32 x 32 Pixel
aufweisen. Implementieren Sie es mit dem Befehl tabadmin customize smalllogo.
Ein Bild mit mehr als 160 x 160 Pixeln (großes Logo) bzw. 32 x 32 Pixeln (kleines Logo) wird
abgeschnitten dargestellt. Verwenden Sie eine Bilddatei im GIF-, JPEG- oder PNG-Format.
Das Tableau-Logo auf der Webbrowser-Registerkarte des Servers und links neben der URLAdresse kann nicht geändert werden.
- 262 -
So ändern Sie das Logo:
1. Öffnen Sie als Administrator eine Eingabeaufforderung, und geben Sie Folgendes ein:
cd "C:\Program Files\Tableau\Tableau Server\8.3\bin"
2. Ändern Sie das Logo durch folgende Eingabe: large size" Logo (bis zu 160 x 160 px,
jedoch mindestens 32 x 32 px):
tabadmin customize logo "C:\My Pictures\logo.png"
Wenn Ihr Logo 32 x 32 Pixel groß oder kleiner ist, geben Sie folgenden Befehl ein:
tabadmin customize smalllogo "C:\My Pictures\logo.png"
3. Starten Sie den Server mit folgendem Befehl neu, damit die Änderung wirksam wird:
tabadmin restart
Wiederherstellen des Standardnamens oder -logos
Sie können das Standarderscheinungsbild von Tableau Server wie folgt wiederherstellen:
1. Öffnen Sie als Administrator eine Eingabeaufforderung, und geben Sie Folgendes ein:
cd "C:\Program Files\Tableau\Tableau Server\8.3\bin"
2. Ändern Sie das Logo durch folgende Eingabe:
tabadmin customize <parameter> -d
Ersetzen Sie in der obigen Zeile <parameter> durch das, was wiederhergestellt
werden soll, also entweder name oder logo.
3. Starten Sie den Server mit folgendem Befehl neu, damit die Änderung wirksam wird:
tabadmin restart
- 263 -
Sprache und Gebietsschema
Tableau Server wurde in verschiedene Sprachen lokalisiert und verfügt über Sprach- und
Gebietsschemaeinstellungen, die Sie für einzelne Benutzer (auf Die Seite
"Benutzerdefiniert" Auf Seite 10) und systemweit (auf der Wartungseinstellungen Auf
Seite 246) konfigurieren können. Die Einstellung Sprache steuert die
Benutzeroberflächenelemente, z. B. Menüs und Meldungen. Die Einstellung Gebietsschema
steuert Elemente in Ansichten, z. B. Zahlenformat und Währung.
Standardeinstellungen
Tableau Server bezieht die Standardspracheinstellung während des Setup. Wenn für den
Hostcomputer eine Sprache festgelegt worden ist, die Tableau Server unterstützt, dann wird
das Produkt in dieser Sprache installiert. Wenn es keine unterstützte Sprache ist, wird Tableau
Server in Englisch installiert.
Wie Sprache und Gebietsschema festgelegt werden
Auch der Webbrowser des Benutzers beeinflusst, welche Sprache und welches
Gebietsschema verwendet wird, wenn der Benutzer auf eine Ansicht klickt. Wenn ein
Serverbenutzer auf seiner Seite "Benutzerkonto" keine Einstellungen für die Sprache
festgelegt hat und sein Webbrowser auf eine von Tableau Server unterstützte Sprache
eingestellt worden ist, dann wird die Sprache des Browsers selbst dann verwendet, wenn
Tableau Server auf eine andere Sprache eingestellt worden ist.
Nachfolgend finden Sie ein Beispiel: Angenommen, in Tableau Server wurde Englisch
systemweit als Sprache für alle Benutzer festgelegt. Der Serverbenutzer Claude hat auf
seiner Seite "Benutzerkonto" in Tableau Server keine Sprache angegeben. Claudes Browser
verwendet Deutsch (Deutschland) als Sprache/Gebietsschema.
Wenn sich Claude bei Tableau Server anmeldet, wird die Benutzeroberfläche des Servers in
Deutsch angezeigt, und wenn er auf Ansicht A klickt, wird das Gebietsschema für Deutschland
zur Anzeige von Zahlen und Währung verwendet. Hätte Claude in seinem Benutzerkonto für
Sprache und Gebietsschema die Einstellung Französisch (Frankreich) gewählt, würden die
Benutzeroberfläche und die Ansicht in Französisch angezeigt. Die
Benutzerkontoeinstellungen treten an die Stelle der Webbrowsereinstellungen, und diese
beiden Einstellungen haben wiederum Vorrang vor der systemweiten Tableau ServerEinstellung.
Zudem muss die Einstellung für Gebietsschema in Tableau Desktop (Datei >
Gebietsschema der Arbeitsmappe) berücksichtigt werden. Diese Einstellung bestimmt das
Gebietsschema der Daten einer Ansicht, z. B. welche Währung angegeben wird und wie
Zahlen formatiert werden. Standardmäßig ist Gebietsschema in Tableau Desktop auf
Automatisch festgelegt. Autoren können diese Einstellung jedoch durch die Auswahl eines
bestimmten Gebietsschemas überschreiben. Wenn im obigen Beispiel der Autor von Ansicht A
für Gebietsschema die Einstellung Griechisch (Griechenland) wählt, dann werden
bestimmte Aspekte der in Ansicht A dargestellten Daten unter Verwendung des
Gebietsschemas "Griechisch (Griechenland)" angezeigt.
Die Einstellungen, die in Tableau zur Bestimmung des Gebietsschemas herangezogen
werden, sind unten ihrer Rangfolge nach aufgeführt:
- 264 -
1. Gebietsschema der Arbeitsmappe (Einstellung in Tableau Desktop)
2. Sprach-/Gebietsschemaeinstellung des Tableau Server-Benutzerkontos
3. Sprache/Gebietsschema des Webbrowsers
4. Sprach-/Gebietsschemaeinstellung auf der Wartungsseite von Tableau Server
5. Sprach-/Gebietsschemaeinstellung des Hostcomputers
Verwaltungsansichten
Tableau Server bietet für Administratoren mehrere Ansichten zur Überwachung der
Aktivitäten in Tableau Server. Die Verwaltungsansichten befinden sich in der Analysetabelle
auf der Wartungsseite:
Weitere Informationen finden Sie hier:
Server--Aktivitäten
Die Verwaltungsansicht für die Server- Aktivitäten bietet eine Momentaufnahme der Tableau
ServerAktivitäten in den letzten 30 Tagen.
Wenn Sie in Gesamtanzahl Ansichten über die Zeit mit der Maus auf einen beliebigen
Punkt auf der Linie zeigen, wird eine QuickInfo mit der Anzahl der an diesem Tag geöffneten
Ansichten sowie den folgenden Informationen angezeigt:
- 265 -
Klicken Sie auf einen Punkt auf der Linie, um die Balkendiagramme darunter zu aktualisieren.
Dann können Sie sehen, welche Arbeitsmappen an diesem Tag angezeigt wurden und wer
am häufigsten darauf zugegriffen hat:
Durch die Auswahl einer Markierung in Gesamtanzahl Ansichten über die Zeit wird 24stündiges Gesamtanzeigemuster gefiltert, und das Anzeigemuster für einen bestimmten
Tag wird angezeigt. Wenn keine Markierungen in Gesamtanzahl Ansichten über die Zeit
ausgewählt wurden, summiert 24-stündiges Gesamtanzeigemuster die Daten in
Gesamtanzahl Ansichten über die Zeit und zeigt sie in einem 24-Stunden-Zeitraum an, so
dass Sie typischen Muster im Verlauf eines Tages sehen können:
- 266 -
Benutzeraktivitäten
Mithilfe der Benutzeraktivitätenansicht können Sie abschätzen, wie stark die Tableau ServerInstallation genutzt wird und ob Sie eventuell zusätzliche Lizenzen erwerben müssen. In dieser
Ansicht sehen Sie insbesondere, wer bei Tableau Server angemeldet ist, von wo aus die
Anmeldung erfolgte und wann die letzte Interaktion mit dem Server stattgefunden hat.
Wenn ein Benutzer über mehrere Browser angemeldet ist, wird dies ebenfalls angezeigt.
Wenn sich ein Benutzer zum Beispiel einmal über Internet Explorer und einmal über Mozilla
Firefox anmeldet, wird der Benutzername zweimal angezeigt. Meldet sich ein Benutzer
dagegen zweimal über Mozilla Firefox an, wird der Name des Benutzers nur einmal angezeigt.
Currently Active (Aktuell aktiv) bedeutet, dass der Benutzer in den letzten fünf Minuten mit
dem Server interagiert hat. Kurzem aktiv gibt an, dass der Benutzer vor fünf bis fünfzehn
Minuten aktiv war. Inaktiv bedeutet, dass der Benutzer in den letzten 15 Minuten keine
Aktivitäten ausgeführt hat. Standardmäßig werden die Benutzer nach vier Stunden ohne
Aktivitäten bei Tableau Server abgemeldet. Sie können diese Einstellung mit der tabadminOption tabadmin set-Optionen Auf Seite 438 ändern.
In der Ansicht Ausführliche Benutzeraktivität geben Kreise eine Aktion an, z. B.
Anmeldung beim Server oder Filtern einer Ansicht.Balken umspannen den Zeitraum, über den
sich die Aktivität erstreckt hat. Wenn Sie nähere Informationen benötigen, halten Sie den
Mauszeiger über einen Bereich. Daraufhin wird ein QuickInfo angezeigt.
- 267 -
Performance History (Leistungsverlauf)
Anhand der Ansicht "Performance History" (Leistungsverlauf) können Sie ablesen, welche
Ansichten die Serverleistung am stärksten belasten.
Ansichten sind mit zwei verschiedenen Anforderungen verbunden:
l
Ansicht laden (erstmaliges Laden)-Anforderungen, orange
Hierzu gehört das Extrahieren von Daten aus dem Repository und das Herstellen einer
Verbindung mit der Datenquelle.
l
Ansicht berechnen-Anforderungen, blau
Hierzu gehören Metadatenprüfungen, Datenerfassungsabfragen, lokale Berechnungen
und die Darstellung von Ansichten für das erstmalige Laden einer Arbeitsmappe. Eine
anschließende Filterung und das Daten-Drilling wirken sich nicht auf diese
Anforderungen aus.
Ausreißermarkierungen stellen Anforderungen dar, die die größten Auswirkungen auf die
Serverleistung haben.
- 268 -
In dem unten stehenden Beispiel dauert die Anforderung Ansicht laden für die Ansicht "nach
Region" in der Arbeitsmappe "USSales01" 0,235 Sekunden, um die Informationen zur
Arbeitsmappe abzurufen und die erstmalige Verbindung zur Datenquelle herzustellen:
Die Anforderung Ansicht berechnen für die gleiche Ansicht dauerte 5,398 Sekunden für die
Datenabfrage, die lokale Berechnung und die Darstellung der Ansicht für die erstmalige
Anzeige:
Hintergrundaufgaben
In der Ansicht "Background Tasks" (Hintergrundaufgaben) werden Aufgaben angezeigt, die
der Server ausführt. Die häufigsten Aufgaben sind Benutzeraktionen zugeordnet. Diese
Aufgaben sind standardmäßig unter Task Type (Aufgabentyp) ausgewählt:
- 269 -
Der Aufgabenstatus gibt an, ob eine Aufgabe erfolgreich abgeschlossen, fehlerhaft, laufend
oder ausstehend ist:
Symbol Beschreibung
Error (Fehler): Der Server konnte die Aufgabe nicht vollständig
ausführen.
Success (Erfolg): Der Server hat die Aufgabe abgeschlossen.
In process (Laufend): Der Server führt die Aufgabe gerade aus.
Pending (Ausstehend): Eine Aufgabe, die vom Server noch nicht
begonnen wurde.
Um Einzelheiten zu einer Aufgabe anzuzeigen, zeigen Sie mit der Maus auf das zugehörige
Aufgabensymbol:
- 270 -
Tableau Server kann mehrere Hintergrundprozesse parallel ausführen. Die IP-Adressen unter
Hintergrund-ID in der Ansicht "Hintergrundaufgaben" zeigt, welche Computer der
Ausführung von Hintergrundprozessen zugewiesen wurden:
Ein Computer mit Multi-Core-Prozessor, auf dem mehrere Hintergrundprozesse ausgeführt
werden, wird für den ersten Prozess mit <IP address>:0, für den zweiten Prozess mit <IP
address>:1 usw. aufgeführt.
Space Usage (Speichernutzung)
Mithilfe der Speichernutzungsansicht können Sie die Arbeitsmappen und Datenquellen
ermitteln, die den meisten Festplattenspeicher auf dem Server belegen. Die
Datenträgerspeichernutzung wird pro Benutzer, Projekt und nach der Größe der
Arbeitsmappe oder Datenquelle angezeigt und auf die nächste ganze Zahl abgerundet:
- 271 -
Bewegen Sie den Mauszeiger auf einen Größenbalken, um Einzelheiten zur Nutzung
anzuzeigen:
Sie können auch einen Drilldown für die Links in der QuickInfo vornehmen. Sie können
beispielsweise die Details zu einem Benutzer oder die Arbeitsmappe anzeigen.
Angepasste Ansichten
Benutzer, die mit Ansichten arbeiten, können mithilfe der Option Remember my changes
(Meine Änderungen merken) ihre angepassten Ansichten speichern, und Publisher können
die Freigabe angepasster Ansichten zulassen oder verweigern.
- 272 -
In der Verwaltungsansicht "Customized Views" (Angepasste Ansichten) werden alle
Ansichten auf dem Server aufgelistet, die mit der Option Remember my changes (Meine
Änderungen merken) angepasst wurden. Sie kann als Indikator der Beliebtheit oder
Wichtigkeit einer Ansicht genutzt werden.
Erstellen benutzerdefinierter Verwaltungsansichten
Zusätzlich zu den integrierten Verwaltungsansichten, die auf der Wartungsseite auf dem
Server verfügbar sind, können Sie Tableau Desktop verwenden, um eigene Analysen der
Serveraktivität abzufragen und zu erstellen. Das Tableau Server-Repository enthält
verschiedene bereits eingerichtete Datenbankansichten, mit denen Sie eine Verbindung
herstellen und die Sie abfragen können. Mit der tabadmin-Option auditing.enabled wird
gesteuert, ob Tableau Server den Verlauf der Benutzeraktivitäten und andere Information im
Repository erfassen soll. Diese Option ist standardmäßig aktiviert. Mit der tabadmin-Option
wgserver.audit_history_expiration_days wird gesteuert, wie viele Tage des Ereignisverlaufs
im Repository gespeichert werden sollen. Diese Option ist standardmäßig auf 183 Tage
eingestellt. Bitte beachten Sie, dass sich das Speichern von Verlaufsereignissen auf die Größe
der Sicherungsdatei (.tsbak) von Tableau Server auswirkt.
Um auf diese Ansichten zugreifen zu können, müssen Sie mit dem Befehlszeilenprogramm
zuerst den externen Zugriff auf die Tableau Server-Datenbank aktivieren. Anschließend
müssen Sie eine Verbindung mit der Tableau Server-Datenbank herstellen und diese
abfragen.
Hinweis: Wir sind bemüht, Änderungen an Ansichten und Tabellen zu begrenzen, die
für den Benutzer "tableau" verfügbar sind. Andere Tabellen im Repository (verfügbar für
den Benutzer "mit Lesezugriff) unterstützen die Anwendung und können ohne
- 273 -
Ankündigung geändert werden. Bei Verwendung solcher Tabellen kann der Aufbau der
Ansichten gestört werden.
Aktivieren des externen Zugriffs auf die Tableau Server-Datenbank
Mit einem speziellen Benutzernamen können Sie eine Verbindung mit dem Tableau Server
herstellen und diesen abfragen. Der Benutzer "tableau", hat Zugriff auf mehrere
Datenbankansichten, die Sie im Rahmen der Erstellung eigener Analysen der Tableau
Server-Aktivität verwenden können. Ein zweiter Benutzer, "readonly", hat Zugriff auf viele
weitere Datenbanktabellen, die Sie zum Erstellen von weiteren detaillierten Analysen
verwenden können.
Für den Zugriff auf das Tableau Server-Repository müssen Sie das
Befehlszeilendienstprogramm tabadmin verwenden, um den externen Zugriff auf die
Datenbank zu aktivieren.
1. Öffnen Sie als Administrator eine Eingabeaufforderung, und geben Sie Folgendes ein:
cd "C:\Program Files\Tableau\Tableau Server\8.3\bin"
2. Aktivieren Sie als Nächstes mit einem der folgenden Befehle den externen Zugriff auf
die Datenbank:
Für den Benutzer "tableau" mit einem von Ihnen festgelegten Kennwort ersetzen Sie Ihr
eigenes Kennwort für die Option [password]:
tabadmin dbpass --username tableau [Kennwort]
Beispiel:
tabadmin dbpass P@ssw0rD!
oder
Für den Benutzer "readonly" ersetzen Sie Ihr eigenes Kennwort für die Option
[password]:
tabadmin dbpass --username readonly [password]
3. Starten Sie Tableau Server neu.
Nach der Aktivierung des externen Zugriffs auf die Datenbank kann in Tableau über jede IPAdresse auf die Datenbank zugegriffen werden, sofern das richtige Kennwort eingegeben
wird. Führen Sie zum Herstellen einer Verbindung die Schritte unter Herstellen einer
Verbindung mit der Tableau Server-Datenbank Auf der nächsten Seite aus.
Wenn Sie den externen Zugriff später deaktivieren möchten, führen Sie tabadmin dbpass
--disable --username [user] aus, und starten Sie den Server dann erneut.
Beispiel: tabadmin dbpass --disable --username readonly
- 274 -
Hinweis: Wenn kein Benutzer angegeben ist, deaktiviert die Option --disable den
Zugriff für den Benutzer "tableau".
Herstellen einer Verbindung mit der Tableau Server-Datenbank
Nach der Aktivierung des externen Zugriffs auf die Tableau Server-Datenbank, führen Sie die
folgenden Schritte aus, um eine Verbindung mit der Datenbank herzustellen und sie
abzufragen.
1. Wählen Sie in Tableau Desktop Daten > Verbindung zu Daten herstellen aus, und
wählen Sie dann PostgreSQL als Datenbank aus, mit der die Verbindung hergestellt
werden soll. Möglicherweise müssen Sie die PostgreSQL-Datenbanktreiber installieren.
Sie können die Treiber von www.tableausoftware.com/drivers herunterladen.
2. Geben Sie im Dialogfeld "PostgreSQL-Verbindung" den Namen oder die URL von
Tableau Server ein. In einer verteilten Serverinstallation, in der ein Worker-Computer
als Host des Repositorys fungiert, geben Sie stattdessen den Namen des WorkerComputers ein.
Die Verbindung sollte über den Port hergestellt werden, der für pgsql.port eingerichtet
wurde. Standardmäßig ist dies Port 8060. Weitere Informationen zu Ports finden Sie
unter TCP/IP-Ports Auf Seite 388.
3. Geben Sie workgroup als Datenbank an, mit der die Verbindung hergestellt werden
soll.
4. Stellen Sie als einer der folgenden Benutzer und dem von Ihnen angegebenen
Kennwort eine Verbindung her:
Benutzername: tableau oder readonly
Kennwort:Das Kennwort, das Sie zum Aktivieren des Zugriffs auf die Tableau ServerDatenbank für den angegebenen Benutzer festgelegt haben
5. Klicken Sie auf Verbinden.
6. Wählen Sie eine oder mehrere Tabellen aus, mit denen eine Verbindung hergestellt
werden soll.
Der Benutzer "tableau" hat Zugriff auf alle Tabellen, deren Name mit einem Unterstrich
und hist_ beginnt. Sie können beispielweise eine Verbindung mit _background_tasks
und _datasources herstellen. Tabellen, deren Name mit historical_ anfängt,
verweisen auf hist_-Tabellen. Die hist_-Tabellen enthalten Informationen über
Serverbenutzer, die in der Ansicht Benutzeraktivitäten Auf Seite 267 derzeit nicht
vorhanden sind.Der Benutzer "readonly" hat Zugriff auf weitere Tabellen, die zum
Abfragen weiterer Informationen zur Serverauslastung verwendet werden können.
- 275 -
7. Klicken Sie auf OK.
Sicherheit
In Tableau gibt es vier primäre Sicherheitskomponenten.
Authentifizierung
Die Authentifizierung dient zum Nachweis der Benutzeridentität. Dies geschieht, um
unbefugte Zugriffe auf Tableau Server zu verhindern und es den Benutzern zu erlauben,
personalisierte Einstellungen festzulegen. Tableau Server unterstützt vier
Authentifizierungstypen:
- 276 -
l
l
l
l
Active Directory: Authentifiziert Tableau Server-Benutzer anhand ihrer WindowsAnmeldeinformationen.
Lokale Authentifizierung: Verwendet das interne Authentifizierungsverfahren von
Tableau Server.
SAML: Verwendet einen externen Identitätsprovider zur Authentifizierung von Tableau
Server-Benutzern.
Vertrauenswürdige Authentifizierung: Die Authentifizierung erfolgt über eine
vertrauenswürdige Beziehung zwischen Tableau Server und einem oder mehreren
Webservern.
Ob Active Directory oder "Lokale Authentifizierung" verwendet werden soll, legen Sie während
der Installation von Tableau Server fest. Nach der Installation kann nicht zwischen diesen
beiden Vorgehensweisen gewechselt werden. Zur Änderung des Authentifizierungstyps
deinstallieren Sie Tableau Server (Ihre Daten bleiben erhalten) und führen Setup erneut aus.
Sie können SAML auch im Rahmen der Installation konfigurieren, dies ist allerdings nicht die
einzige Konfigurationsmöglichkeit. Wenn die Benutzer über SAML authentifiziert werden,
verwenden Sie Active Directory oder die lokale Authentifizierung zur Verwaltung der Tableau
Server-Benutzer und nicht zu ihrer Authentifizierung. SAML kann aktiviert oder deaktiviert
werden, ohne dass Tableau Server deinstalliert und erneut installiert werden muss.
Active Directory
Bei Verwendung der Active Directory-Authentifizierung werden alle Benutzernamen und
Kennwörter von Active Directory verwaltet. Wenn ein Benutzer seine Anmeldedaten zur
Anmeldung bei Tableau Server eingibt, leitet Tableau diese an den Active Directory-Server
weiter. Tableau ist nicht am Authentifizierungsprozess beteiligt, speichert jedoch die
Benutzernamen (aber keine Kennwörter) im Repository.
Beim Einsatz der Active Directory-Benutzerauthentifizierung können die Administratoren
Benutzer auch anhand ihrer aktuellen Windows-Anmeldeinformationen automatisch
anmelden (Automatische Anmeldung aktivieren). Die Anmeldeinformationen werden hierbei
von ihrem lokalen Computer weitergeleitet und nicht von einem anderen System oder Portal,
bei dem sie möglicherweise angemeldet sind.
Wenn sich ein Benutzer beispielsweise beim lokalen Computer als 'MSmith' und anschließend
bei einem SharePoint-Portal als 'Mary' anmeldet, werden Tableau Server die
Anmeldeinformationen für 'MSmith' übergeben. Wenn die Anmeldeinformationen für die
SharePoint-Website ('Mary') für die automatische Anmeldung verwendet werden sollen, muss
das SharePoint-Portal das Tableau-Webpart mit vertrauenswürdiger Authentifizierung
verwenden.
Administratoren können Gruppen mit Active Directory synchronisieren, indem Sie die
Synchronisierung manuell oder mit tabcmd programmgesteuert einleiten. Weitere
Informationen finden Sie unter Synchronisieren einer Active Directory-Gruppe Auf Seite
201 und syncgroup group-nameWeitere Informationen hierzu finden Sie unter tabcmdBefehle Auf Seite 399.
- 277 -
Lokale Authentifizierung
Wenn die lokale Authentifizierung zur Benutzerauthentifizierung verwendet wird, verwaltet
Tableau Server Benutzer, Gruppen, Kennwörter und den gesamten
Authentifizierungsprozess. Benutzerlisten können einfach in Tableau Server importiert
werden, und die meisten Benutzerverwaltungsfunktionen können über tabcmd Auf Seite 395
programmgesteuert ausgeführt werden. Die Benutzer können sich entweder manuell
anmelden, indem sie ihre Anmeldeinformationen eingeben, wenn sie dazu aufgefordert
werden, oder die Anmeldung kann beim Zugriff auf Inhalte in einem Portal über eine
transparente vertrauenswürdige Authentifizierung erfolgen.
SAML
Wenn SAML zur Benutzerauthentifizierung verwendet wird, erfolgt die Authentifizierung von
Tableau Server-Benutzern durch einen externen Identitätsprovider. Active Directory oder die
lokale Authentifizierung sind weiterhin erforderlich, um Tableau Server-Benutzer zu verwalten,
zu Tableau Server hinzuzufügen usw., die eigentliche Authentifizierung wird jedoch vom
Identitätsprovider übernommen. Wenn sich Benutzer mit SAML bei Tableau Server anmelden,
stammt das Anmeldefenster vom Identitätsprovider und nicht von Tableau Server.
Informationen zum Einrichten von SAML an Ihrem Standort finden Sie unter SAML Auf Seite
283.
Vertrauenswürdige Authentifizierung
Vertrauenswürdige Authentifizierung bedeutet, dass eine vertrauenswürdige Beziehung
zwischen Tableau Server und einem oder mehreren Webservern eingerichtet wurde. Sie
können beispielsweise für ein Unternehmens-Wiki die vertrauenswürdige Authentifizierung
verwenden, damit Benutzer, die bereits beim Wiki angemeldet sind, sich nicht erneut
anmelden müssen, um Dashboards anzuzeigen.
Wenn Tableau Server Anforderungen von einem vertrauenswürdigen Webserver empfängt,
wird davon ausgegangen, dass der Webserver bereits die notwendige Authentifizierung
durchgeführt hat. Tableau Server empfängt die Anforderung mit einem einlösbaren Token
oder Ticket und präsentiert dem Benutzer eine personalisierte Ansicht, die die Rolle und
Berechtigungen des Benutzers berücksichtigt.
Informationen zum Einrichten der vertrauenswürdigen Authentifizierung finden Sie unter
Vertrauenswürdige Authentifizierung Auf Seite 353.
Autorisierung
Die Autorisierung bestimmt, auf welche Inhalte ein Benutzer zugreifen und welche Aktionen er
ausführen kann, nachdem er authentifiziert worden ist. In Tableau wird die Autorisierung durch
folgende Mechanismen geregelt:
l
Rollen und Berechtigungen: Definieren bestimmte Funktionen, die Benutzer für
bestimmte Objekte in Tableau ausführen oder nicht ausführen können. Eine Rolle ist ein
Satz von Berechtigungen, der von Administratoren verwendet oder angepasst werden
- 278 -
kann. Nähere Informationen hierzu finden Sie unter Arbeiten mit Berechtigungen
Auf Seite 89.
l
Lizenz- und Benutzerrechte: Legen den maximalen Berechtigungssatz fest, der
einem Benutzer zugewiesen werden kann. Siehe Lizenzen und Benutzerrechte Auf
Seite 193 sowie Gewähren und Verweigern von Benutzerrechten Auf Seite 198.
Mit den oben genannten Elementen wird zwar gesteuert, welche Aktionen ein Benutzer an
welchen Objekten ausführen kann, sie steuern jedoch nicht, welche Daten in einer Ansicht
angezeigt werden. Welche Daten für einen Benutzer sichtbar sind, wird durch die
Datensicherheitsoptionen gesteuert.
Anfängliche Berechtigungen
Die anfänglichen Berechtigungen für ein Projekt werden aus dem Standardprojekt kopiert. Die
anfänglichen Berechtigungen für eine Arbeitsmappe werden aus den Berechtigungen des
zugehörigen Projekts kopiert. Die anfänglichen Berechtigungen für eine Ansicht werden aus
den Berechtigungen der zugehörigen Arbeitsmappe kopiert. Die Berechtigungen des
übergeordneten Elements werden nur einmal kopiert. Änderungen an den Berechtigungen
des übergeordneten Elements werden nicht automatisch auf die untergeordneten Elemente
angewendet. Sie werden nur angewendet, wenn die neuen Berechtigungen ausdrücklich den
betreffenden Inhalten zugewiesen werden.
Jedes Element kann über andere Berechtigungen als sein übergeordnetes Element verfügen.
Zum Beispiel kann eine Gruppe keine Berechtigung zum Anzeigen von Projekt X besitzen,
aber zum Anzeigen einer in Projekt X veröffentlichten Ansicht berechtigt sein. Tableau Server
unterstützt keine hierarchischen Objektberechtigungen, stellt jedoch ein Vererbungsmodell für
Benutzer und Gruppen bereit. Wenn für einen Benutzer eine Berechtigung nicht ausdrücklich
auf "Allow" (Zulassen) oder "Deny" (Verweigern) festgelegt worden ist, dann werden die
Berechtigungen der Gruppen übernommen, denen der Benutzer angehört.
Berechtigungen und das Standardprojekt
Wenn Tableau Server in einer offenen Umgebung bereitgestellt wird, in der der Wissens- und
Informationsaustausch entscheidend sind, dann sollten Sie die Berechtigungen für das
Standardprojekt so festlegen, dass sie für die Gruppe Alle Benutzer gelten und als Rolle
Interactor zugewiesen wird. Die Benutzer sind dann in der Lage, Inhalte automatisch in
neuen Projekten zu veröffentlichen und Inhalte aus neuen Projekten zu nutzen.
Wenn Tableau Server in einer restriktiven Umgebung bereitgestellt wird, in der
Datensicherheit und Zugriffssteuerung entscheidend sind, dann sollten Sie die
Berechtigungen für das Standardprojekt löschen: Löschen Sie die Berechtigungen für alle
Benutzer und Gruppen. Den Benutzern und Gruppen müssen dann explizit Berechtigungen
zugewiesen werden, damit sie Inhalte in neuen Projekten veröffentlichen und Inhalte aus
neuen Projekten nutzen können.
- 279 -
Datensicherheit
Tableau bietet verschiedene Möglichkeiten, über die gesteuert werden kann, welche Benutzer
auf welche Daten zugreifen können. Bei Datenquellen, die eine Verbindung zu
Livedatenbanken herstellen, können Sie zudem steuern, ob die Benutzer zur Eingabe der
Anmeldeinformationen für die Datenbank aufgefordert werden, sobald sie auf eine
veröffentlichte Ansicht klicken. Über die folgenden drei Optionen können verschiedene
Ergebnisse erzielt werden:
l
l
l
Anmeldekonto für die Datenbank: Wenn Sie eine Datenquelle erstellen, die eine
Verbindung zu einer Livedatenbank herstellt, können Sie zwischen einer
Authentifizierung bei der Datenbank über Windows NT oder über die integrierten
Sicherheitsfunktionen der Datenbank wählen.
Authentifizierungsmodus: Wenn Sie eine Datenquelle oder Arbeitsmappe mit einer
Verbindung zu einer Livedatenbank veröffentlichen, können Sie einen
Authentifizierungsmodus auswählen. Die verfügbaren Modi hängen von der oben
getroffenen Auswahl ab.
Benutzerfilter: Sie können Filter erstellen in einer Arbeitsmappe oder Datenquelle
einrichten, über die gesteuert wird, welche Daten ein Benutzer in einer veröffentlichten
Ansicht anzeigen kann, basierend auf dem Anmeldekonto bei Tableau Server.
In der unten dargestellten Tabelle werden einige Abhängigkeiten der oben aufgeführten
Optionen beschrieben:
Verbindungsoptionen für die Datenbank
Das Anmel- Authentifizierungsmodus
dekonto für
die Datenbank verwendet…
Window NT
Integrated
Security (Windows-Authentifizierung)
RunAs-Serverkonto
Identität per RunAs-Serverkonto annehmen
Anmeldeinformationen der
anzeigenden Person
Datensicherheitsfragen
Kann die Daten- Werden aus- Werden
banksicherheit
schließlich Webpro Benutzer von BenutCaches
Tableau Server
zerfilter ver- von den
gewährleistet
wendet, um Benutwerden?
festzern
zulegen,
gemeinwelcher
sam verBenutzer
wendet?
welche
Daten
sehen
kann?
Nein
Ja
Ja
Ja
Nein*
Nein
Ja
- 280 -
Nein*
Nein
Verbindungsoptionen für die Datenbank
Das Anmel- Authentifizierungsmodus
dekonto für
die Datenbank verwendet…
Datensicherheitsfragen
Kann die Daten- Werden aus- Werden
banksicherheit
schließlich Webpro Benutzer von BenutCaches
Tableau Server
zerfilter ver- von den
gewährleistet
wendet, um Benutwerden?
festzern
zulegen,
gemeinwelcher
sam verBenutzer
wendet?
welche
Daten
sehen
kann?
Ja
Nein
Nein
Benutzer auffordern: Beim
Klicken auf eine Ansicht werden die Benutzer zur Eingabe ihrer
Benutzername Datenund Kennwort bankanmeldeinformationen
aufgefordert. Die Anmeldeinformationen können
gespeichert werden.
Eingebettete AnmeldNein
einformationen: Publisher
von Arbeitsmappen oder
Datenquellen können ihre
Datenbankanmeldeinformationen
einbetten.
Identität per eingebettetem Ja
Kennwort annehmen:
Datenbankanmeldeinformationen
mit Identitätsberechtigung
werden eingebettet.
Ja
Ja
Nein*
Nein
* Da dies zu unerwarteten Ergebnissen führen kann, empfiehlt Tableau, dass Sie diesen
Authentifizierungsmodus nicht mit Benutzerfiltern verwenden.
Benutzerfilter, die eingebettete Anmeldeinformationen-Option und die Identitätsmodi haben
ähnliche Auswirkungen: Wenn die Benutzer auf eine Ansicht klicken, werden sie nicht zur
Eingabe von Datenbankanmeldeinformationen aufgefordert und sie sehen nur die sie
betreffenden Daten. Jedoch werden die Benutzerfilter über die Arbeitsmappe vom Autor
festgelegt, während die Authentifizierungsmodi auf Basis von Identitätsberechtigungen von
- 281 -
den Sicherheitsrichtlinien abhängen, die vom Administrator für die jeweilige Datenbank
festgelegt wurden.
Einige der oben beschriebenen Optionen erfordern Konfigurationsschritte, die während der
Installation von Tableau Server oder vor der Veröffentlichung einer Arbeitsmappe oder
Datenquelle durchgeführt werden müssen. Weitere Informationen finden Sie in den folgenden
Themen:
l
Eingebettete Anmeldeinformationen
l
Kerberos-Delegierung Auf Seite 299
l
Verwenden von OAuth für Datenverbindungen
l
Aufforderung zur Eingabe von Anmeldeinformationen/gespeicherten Kennwörtern
l
Run As User (Als Benutzer ausführen) Auf Seite 373
l
SQL Server-Identitätswechsel Auf Seite 382
l
Benutzerfilter und Datenquellenfilter
Netzwerksicherheit
In Tableau Server sind drei Netzwerkschnittstellen wichtig:
l
l
l
Schnittstelle zwischen Client und Tableau Server: Bei dem Client kann es sich um
einen Webbrowser, Tableau Desktop oder das Dienstprogramm tabcmd handeln.
Schnittstelle zwischen Tableau Server und Datenbank(en): Zum Aktualisieren von
Datenextrakten oder Verwalten von Live-Datenbankverbindungen muss Tableau
Server mit der Datenbank bzw. den Datenbanken kommunizieren können.
Kommunikation zwischen Serverkomponenten: Dies betrifft nur verteilte
Bereitstellungen.
Schnittstelle zwischen Client und Tableau Server
Bei dem Tableau Server-Client kann es sich um einen Webbrowser, Tableau Desktop oder
tabcmd handeln. In der Kommunikation zwischen Tableau Server und den Clients werden
Standard-HTTP-Anforderungen und -Antworten verwendet. Tableau Server kann auch für
HTTPS konfiguriert werden (siehe SSL Auf Seite 123). Wenn Tableau Server für SSL
konfiguriert wurde, wird der gesamte Datenverkehr zwischen den Clients mithilfe von SSL
verschlüsselt und das HTTPS-Protokoll wird für Anforderungen und Anworten verwendet.
Kennwörter werden von Browsern und tabcmd mittels Verschlüsselungsverfahren mit
öffentlichen/privaten 512-Bit-Schlüsseln an Tableau Server übermittelt. Tableau Server
sendet dem Browser einen öffentlichen Schlüssel, und der Browser verwendet diesen, um das
Kennwort für die Übertragung zu verschlüsseln. Für jede verschlüsselte Übertragung wird ein
Schlüssel einmal verwendet und danach gelöscht. Das bedeutet, dass Kennwörter immer
sicher sind, unabhängig von der Verwendung von SSL. Wenn SSL aktiviert wurde, wird SSL
zusätzlich zu der 512-Bit-Verschlüsselung mit öffentlichem Schlüssel von Kennwörtern
verwendet.
- 282 -
Schnittstelle zwischen Tableau Server und Datenbank
Tableau Server stellt während der Ausführung Verbindungen mit Datenbanken her, um
Ergebnissätze zu verarbeiten und Extrakte zu aktualisieren. Soweit möglich, werden zum
Herstellen von Datenbankenverbindungen systemeigene Treiber verwendet. Wenn keine
systemeigenen Treiber verfügbar sind, wird auf einen generischen ODBC-Adapter
zurückgegriffen. Die gesamte Kommunikation mit der Datenbank wird über diese Treiber
geleitet. Daher wird der Treiber im Rahmen der Installation der systemeigenen Treiber für die
Kommunikation über andere Ports als die Standardports oder die Transportverschlüsselung
konfiguriert. Diese Art der Konfiguration ist für Tableau transparent.
Kommunikation zwischen Serverkomponenten
Zwei Aspekte der Kommunikation zwischen Tableau Server-Komponenten sind in einer
verteilten Serverinstallation zu berücksichtigen: Vertrauensstellung und Übertragung. In einem
Tableau-Cluster verwendet jeder Server ein stringentes Vertrauensstellungsmodell, um den
Empfang gültiger Anforderungen von anderen Servern im Cluster sicherzustellen. Computer
im Cluster, auf denen ein Gateway-Prozess ausgeführt wird, akzeptieren Anforderungen von
Dritten (Clients), es sei denn, ihnen ist ein Lastenausgleich vorgeschaltet; in diesem Fall
empfängt der Lastenausgleich die Anfragen. Server, auf denen kein Gateway-Prozess
ausgeführt wird, akzeptieren nur Anforderungen von anderen vertrauenswürdigen Mitgliedern
des Clusters. Die Vertrauensstellung wird durch eine Liste von vertrauenswürdigen IPAdressen, Ports und Protokollen begründet. Wenn eine dieser Angaben ungültig ist, wird die
Anforderung ignoriert. Alle Mitglieder des Cluster können mit den anderen Clustermitgliedern
kommunizieren. Zur Übertragung aller internen Daten, mit Ausnahme der Daten zur
Lizenzüberprüfung und zum Repository-Zugriff, wird HTTP verwendet.
Wenn ein Benutzer Anmeldeinformationen für externe Datenquellen auf Tableau Server
speichert, werden diese verschlüsselt in der internen Datenbank von Tableau Server
gespeichert. Wenn ein Prozess diese Anmeldeinformationen für die Abfrage der externen
Datenquelle verwendet, ruft der Prozess die verschlüsselten Anmeldeinformationen aus der
internen Datenbank ab und entschlüsselt sie im Prozess.
SAML
SAML (Security Assertion Markup Language) ist ein XML-Standard, der sicheren
Webdomänen den Austausch von Benutzerauthentifizierungs- und Autorisierungsdaten
ermöglicht. Sie können Tableau Server so konfigurieren, dass ein externer Identitätsprovider
(IdP) zum Authentifizieren von Tableau Server-Benutzern über SAML 2.0 verwendet wird. Die
gesamte Benutzerauthentifizierung erfolgt außerhalb von Tableau, unabhängig davon, ob Sie
Active Directory oder die lokale Authentifizierung in Tableau Server zur Verwaltung Ihrer
Benutzerkonten in Tableau Server verwenden. Dadurch können Sie für alle Benutzer in Ihrem
Unternehmen eine Single Sign-On-Umgebung (einmaliges Anmelden)
anwendungsübergreifend bereitstellen.
Die SAML-Unterstützung in Tableau Server dient der Benutzerauthentifizierung. Sie
verarbeitet keine Berechtigungen und Autorisierungen für Tableau Server-Inhalte wie
Arbeitsmappen.
- 283 -
Hinweis: Die von IdP bereitgestellte Authentifizierung ist ein Einmaltoken, das für
begrenzte Zeit gültig ist.
Weitere Informationen zu SAML finden Sie unter den folgenden Links:
Funktionsweise der SAML-Authentifizierung
SAML ist ein XML-basierter offener Standard für den Austausch von
Authentifizierungsinformationen zwischen zwei Parteien: einem Dienstanbieter (in diesem Fall
Tableau Server) und einem Identitätsprovider. Wenn Sie Tableau Server für SAML
konfigurieren, wird ein externer Identitätsprovider verwendet, um die Benutzer zu
authentifizieren und Identitätsinformationen in Form eines digital signierten XML-Dokuments
an Tableau Server zu übergeben.Nur die vom Dienstanbieter initiierte Authentifizierung
funktioniert. Demnach müssen Benutzer über die Tableau Server-URL auf Tableau zugreifen,
wodurch die Authentifizierung und keine IdP-URL initiiert wird.
Der Benutzer versucht, auf eine
Tableau Server-Arbeitsmappenverknüpfung oder eine
andere Ressource zuzugreifen.
Der Identitätsprovider sendet eine
SAML-Erfolgsantwort an Tableau
Server.
Tableau Server startet den Authentifizierungsprozess und leitet den
Benutzer zum Identitätsprovider um.
Der Benutzer öffnet eine
Arbeitsmappe unter Tableau
Server.
Der Identitätsprovider authentifiziert den Benutzer.
Tableau Server-Benutzerkonto. Dieser Benutzername muss mit dem beim
Identitätsprovider gespeicherten Benutzernamen übereinstimmen.
Benutzerkonto beim Identitätsprovider.
- 284 -
SAML-Anforderungen
Zum Konfigurieren von Tableau Server für SAML benötigen Sie Folgendes:
Zertifikatdatei: Ein PEM-codiertes x509-Zertifikat mit der Dateierweiterung .crt. Diese Datei
wird von Tableau Server und nicht vom IdP verwendet. Wenn Sie ein SSL-Zertifikat besitzen,
können Sie dasselbe Zertifikat für SAML verwenden. Weitere Informationen dazu finden Sie
unter Info über die Zertifikatsdatei.
Zertifikatschlüsseldatei: Eine private RSA- oder DSA-Schlüsseldatei, die nicht
kennwortgeschützt ist und die Dateinamenerweiterung .key aufweist. Diese Datei wird nicht
vom IdP, sondern von Tableau Server verwendet. Wenn Sie eine SSLZertifikatsschlüsseldatei haben, können Sie sie auch für SAML verwenden. Weitere
Informationen dazu finden Sie unter Info über die Zertifikatsdatei.
IdP-Konto, das SAML 2.0 unterstützt: Sie benötigen ein Konto bei einem externen
Identitätsprovider. Einige Beispiele sind PingFederate, SiteMinder und Open AM. Der IdP
muss SAML 2.0 unterstützen.
Attribut namens username: Sie müssen den Identitätsprovider so konfigurieren, dass in der
SAML-Antwort ein Attribut namens username zurückgegeben wird. Verwenden Sie die
tabadmin-Einstellung wgserver.saml.idpattribute.username, um dieses Standardattribut zu
ändern.Wenn Sie eine globale ID verwenden, müssen Sie das Standardattribut ändern.
Übereinstimmende Benutzernamen: Die Tableau Server-Benutzernamen und die beim
Identitätsprovider gespeicherten Benutzernamen müssen übereinstimmen. Wenn
beispielsweise der Benutzername für Jane Smith in PingFederate als jsmith gespeichert ist,
muss er in Tableau Server ebenfalls als jsmith gespeichert sein. Falls Sie SAML im Rahmen
der Tableau Server-Installation konfigurieren, muss bei der Installation auch das Tableau
Server-Administratorkonto erstellt werden. Stellen Sie vor der Durchführung der Installation
sicher, dass das gewünschte Konto beim Identitätsprovider vorhanden ist.
HTTP POST: Tableau Server akzeptiert HTTP POSTs nur für die SAML-Kommunikation. Die
HTTP-Umleitung wird nicht unterstützt.
Vom Dienstanbieter initiiert: Tableau Server interagiert mit SAML nur als Dienstanbieter.
Keine automatische Active Directory-Anmeldung: Wenn Sie SAML verwenden und
Tableau Server außerdem zur Verwendung von Active Directory für die Benutzerverwaltung
konfiguriert ist, dürfen Sie Automatische Anmeldung aktivieren nicht gleichzeitig
verwenden.
Nur verteilte Installationen: Cluster, die für SAML konfiguriert wurden, müssen auf
jedem Tableau Server, auf dem ein Anwendungsserverprozess ausgeführt wird,
dasselbe SAML-Zertifikat, denselben SAML-Schlüssel und dieselben SAML-IdPMetadatendateien aufweisen. Weitere Informationen erhalten Sie unter So
konfigurieren Sie ein Server-Cluster für SAML.
- 285 -
Info über die Zertifikatsdatei
Wenn Sie eine PEM-codierte x509-Zertifikatsdatei für SSL verwenden, können Sie dieselbe
Datei für SAML verwenden. Bei der Verwendung für SSL wird die Zertifikatsdatei zum
Verschlüsseln des Datenverkehrs verwendet. Bei der Verwendung für SAML wird das
Zertifikat für die Authentifizierung verwendet.
SAML
Sie können Tableau Server so konfigurieren, dass ein externer Identitätsprovider zum
Authentifizieren von Tableau Server-Benutzern über SAML verwendet wird. Die gesamte
Benutzerauthentifizierung erfolgt außerhalb von Tableau, unabhängig davon, ob Sie Active
Directory oder die lokale Authentifizierung in Tableau Server zur Verwaltung Ihrer
Benutzerkonten in Tableau Server verwenden. Dies ermöglicht Ihnen, eine Single Sign-OnUmgebung (einmaliges Anmelden) für alle Anwendungen in Ihrem Unternehmen
bereitzustellen.
Bevor Sie Tableau Server für SAML konfigurieren, stellen Sie sicher, dass die SAMLAnforderungen Auf der vorherigen Seite erfüllt sind.
Konfigurieren von SAML
So konfigurieren Sie Tableau Server für die Verwendung von SAML:
1. Speichern Sie die Zertifikatsdateien in einem Ordner mit der Bezeichnung "SAML",
parallel zum Tableau Server 8.3-Ordner. Beispiel:
C:\Program Files\Tableau\Tableau Server\SAML
Dieser Speicherort gibt dem Konto, unter dem Tableau Server ausgeführt wird, die
notwendigen Berechtigungen für die Dateien.
2. Die SAML-Konfiguration wird auf der Registerkarte SAML vorgenommen, die beim
Setup von Tableau Server angezeigt wird. Wenn Sie SAML nach dem Setup
konfigurieren, greifen Sie auf die Registerkarte "SAML" zu, indem Sie das
Dienstprogramm zur Tableau Server-Konfiguration öffnen (Start > Alle Programme >
Tableau Server 8.3 > Tableau Server konfigurieren) und auf die Registerkarte
SAML klicken.
3. Wählen Sie auf der Registerkarte "SAML" die Option SAML für einmaliges
Anmelden verwenden, und geben Sie die folgenden Speicherorte an:
Tableau Server-Rückgabe-URL: Die URL, auf die Benutzer von Tableau Server
zugreifen, z. B. http://tableau_server. Es wird davon abgeraten, http://localhost zu
verwenden, und URLs mit einem nachgestellten Schrägstrich (Beispiel: http://tableau_
server/) werden nicht unterstützt.
SAML-Entitäten-ID: Die Entitäten-ID, die die Tableau Server-Installation beim IdP
eindeutig identifiziert. Sie können hier erneut die Tableau Server-URL eingeben, dies
muss jedoch nicht sein.
- 286 -
SAML-Zertifikatdatei: Ein PEM-codiertes x509-Zertifikat mit der Erweiterung .crt.
Diese Datei wird von Tableau Server und nicht vom IdP verwendet.
SAML-Zertifikatsschlüsseldatei: Ein RSA- oder DSA-Schlüssel, der nicht
kennwortgeschützt ist und die Dateinamenerweiterung .key aufweist. Diese Datei wird
von Tableau Server und nicht vom IdP verwendet.
4. Lassen Sie das Textfeld IdP-Metadatendatei zunächst leer, und klicken Sie auf
Metadatendatei exportieren.
5. Es wird ein Dialogfeld geöffnet, in dem Sie die SAML-Einstellungen für Tableau Server
als XML-Datei speichern können. An diesem Punkt sind die Metadaten des
Identitätsproviders noch nicht eingeschlossen.
Speichern Sie die XML-Datei unter einem beliebigen Namen.
6. Gehen Sie auf der Website Ihres Identitätsproviders oder der entsprechenden
Anwendung wie folgt vor:
l
l
Fügen Sie Tableau Server als Dienstanbieter hinzu. Informationen hierzu finden
Sie in der Dokumentation Ihres Identitätsproviders. Hierbei importieren Sie auch
die Datei, die Sie in Schritt 5 gespeichert haben.
Überprüfen Sie, dass der Identitätsprovider username als Attributelement für die
Verifizierung verwendet
7. Exportieren Sie die Metadaten-XML-Datei des Identitätsproviders, während Sie sich
noch in dessen Anwendung oder auf der Website befinden.
8. Kopieren Sie die Metadaten-XML-Datei des Identitätsproviders in den folgenden Ordner
auf dem Computer mit Tableau Server:
- 287 -
C:\Program Files\Tableau\Tableau Server\SAML
9. Geben Sie im Dialogfeld "Tableau Server-Konfiguration" auf der Registerkarte "SAML"
den Speicherort der Datei in das Textfeld SAML IdP-Metadatendatei ein:
10. Klicken Sie auf "OK". Tableau Server ist jetzt für die SAML-Authentifizierung
konfiguriert.
So konfigurieren Sie ein Server-Cluster für SAML
Beim Konfigurieren eines Tableau Server-Clusters für die Verwendung von SAML legen Sie
das gleiche SAML-Zertifikat und die SAML IdP-Metadatendateien auf jedem Computer ab, auf
dem der Tableau-Anwendungsserverprozess ausgeführt wird (wird auch als wgserver
bezeichnet). So konfigurieren Sie ein Tableau Server-Cluster für die Verwendung von SAML:
1. Konfigurieren Sie den primären Tableau Server, wie oben beschrieben.
2. Legen Sie dasselbe SAML-Zertifikat, dieselbe SAML-Schlüsseldatei und die SAML IdPMetadatendateien, das bzw. die Sie für den primären Server verwendet haben, auch
auf jedem TableauWorker-Rechner ab, auf dem ein Anwendungsserverprozess
ausgeführt wird. Verwenden Sie den gleichen Ordnerpfad auf den Worker-Rechnern
wie auf dem primären Server. Auf den Worker-Rechnern sind keine weiteren
Konfigurationen erforderlich.
Dies lässt sich an einem Clusterbeispiel mit einem primären Tableau Server und drei
Worker-Rechnern zeigen. Die Anwendungsserverprozesse werden auf dem primären
Server und auf Worker 2 und Worker 3 ausgeführt. In diesem Fall konfigurieren Sie den
primären Tableau Server für SAML, dann kopieren Sie dasselbe SAML-Zertifikat, die
SAML-Schlüsseldatei und die SAML IdP-Metadatendateien auf Worker 2 und Worker 3.
Da sich diese Dateien auf dem primären Server im Ordner C:\Program
- 288 -
Files\Tableau\Tableau Server\SAML befinden, müssen Sie auch auf Worker 2 und
Worker 3 an derselben Stelle abgelegt werden.
Testen der Konfiguration
Testen Sie die SAML-Konfiguration, indem Sie eine neue Browserinstanz öffnen und den
Namen von Tableau Server in das URL-Fenster eingeben:
Beachten Sie hierbei, dass die angezeigte Anmeldeaufforderung von Ihrem Identitätsprovider
und nicht von Tableau Server stammt:
Problembehebung für SAML
Die folgenden Themen enthalten Informationen zur Behebung von Problemen mit SAML.
SAML und "Automatische Anmeldung aktivieren"
Wenn Sie SAML verwenden und Tableau Server außerdem zur Verwendung von Active
Directory konfiguriert ist, dürfen Sie Automatische Anmeldung aktivieren nicht gleichzeitig
verwenden. Automatische Anmeldung aktivieren und SAML können nicht parallel
verwendet werden.
- 289 -
Anmelden über die Befehlszeile
Auch wenn Tableau Server für die Verwendung von SAML konfiguriert wurde, wird SAML
nicht zur Anmeldung bei Tableau Server über die Befehlszeilen-Tools tabcmd Auf Seite 395
oder das Befehlszeilenprogramm Tableau-Datenextraktion (im Lieferumfang von Tableau
Desktop) verwendet.
Fehler bei Anmeldung
Wenn die Meldung "Fehler bei Anmeldung: Authentifizierung durch Identitätsprovider
erfolgreich für Benutzer <Benutzername von Identitätsprovider>. Benutzer in Tableau Server
nicht gefunden" ausgegeben wird, sind die in Tableau Server und beim Identitätsprovider
gespeicherten Benutzernamen nicht identisch. Stellen Sie zur Fehlerbehebung sicher, dass
die Namen übereinstimmen. Wenn beispielsweise der Benutzername von Jane Smith beim
Identitätsprovider als jsmith gespeichert ist, muss er in Tableau Server ebenfalls als
jsmith gespeichert sein.
SAML-Fehlerprotokoll
Die SAML-Authentifizierung erfolgt außerhalb von Tableau Server, sodass die Behandlung
von Authentifizierungsproblemen kompliziert sein kann. Anmeldeversuche werden jedoch von
Tableau Server protokolliert. Sie können einen Schnappschuss der Protokolldateien erstellen
und ihn für die Behandlung von Problemen verwenden. Weitere Information dazu finden Sie
unter Archivieren von Protokolldateien Auf Seite 456.
Hinweis: Normale SAML-Ereignisse werden nur dann protokolliert, wenn
wgserver.log.level auf das Debuggen festgelegt ist. Weitere Informationen
finden Sie unter Ändern von Protokollstufen Auf Seite 466.
Suchen Sie im entpackten Schnappschuss der Protokolldatei in den folgenden Dateien nach
SAML-Fehlern.
\wgserver\wgserver-<n>.log
\wgserver\production.<nnnn>_<yyyy_mm_dd_hh_mm_ss>.log
Nachgestellter Schrägstrich
Bestätigen Sie auf der Registerkarte "SAML", dass die Tableau Server-Rückgabe-URL
nicht mit einem nachgestellten Schrägtstrich endet (richtig: http://tableau_server; falsch:
http://tableau_server/):
- 290 -
Konnektivität bestätigen
Bestätigen Sie, das der von Ihnen konfigurierte Tableau Server eine Routing-fähige IPAdresse oder ein NAT-Verfahren an der Firewall hat, das den bidirektionalen Datenverkehr
zum Server zulässt.
Sie können Ihre Konnektivität testen, indem Sie telnet in Tableau Server ausführen und
versuchen, eine Verbindung mit dem SAML-IdP herzustellen. Beispiel: C:\telnet
12.360.325.10 80
Der oben geannte Test sollte Sie mit dem HTTP-Port (80) auf dem IdP verbinden, und Sie
sollten eine HTTP-Kopfzeile erhalten.
Kerberos
Kerberos ist ein Drei-Wege-Authentifizierungsprotokoll, das auf der Nutzung einer
vertrauenswürdigen dritten Partei beruht, die als Key Distribution Center (KDC) bezeichnet
wird. Diese Partei verifiziert die Identität von Computern und stellt durch den Austausch von
"Tickets" zwischen den Clients und Diensten eine sichere Verbindung zwischen diesen her.
Diese Tickets ermöglichen eine gegenseitige Authentifizierung zwischen Computern oder
Diensten, um zu überprüfen, ob ein Computer oder Dienst berechtigt ist, auf den anderen
zuzugreifen.
Tableau Server unterstützt die Kerberos-Authentifizierung in einer Active Directory KerberosUmgebung, wobei die Authentifizierung von Tableau Server über Kerberos erfolgt.
- 291 -
Hinweis: Die Kerberos-Unterstützung in Tableau Server dient der
Benutzerauthentifizierung. Sie verarbeitet keine internen Berechtigungen und
Autorisierungen für Tableau Server-Inhalte wie Arbeitsmappen.
Einmaliges Anmelden (Single Sign-On) mit Kerberos
Tableau Server unterstützt nun Kerberos-basiertes Single Sign-on (SSO, einmaliges
Anmelden). Bei Verwendung der Kerberos-Authentifizierung können Benutzer in einer
Kerberos-fähigen Umgebung mit Active Directory über Tableau Desktop und Webbrowser
SSO-Verbindungen zu Tableau Server herstellen. Darüber hinaus kann Tableau Server
Kerberos zur Authentifizierung von Kerberos-fähigen MS SQL- und MSAS-Datenquellen
verwenden. Und wenn Tableau Server für Kerberos konfiguriert ist, können Sie SSOVerbindungen zu Cloudera Impala-Datenbanken herstellen, indem Sie die vom Server
verwalteten Anmeldeinformationen für die Impala-LDAP-Authentifizierung verwenden.
1 Konfigurieren von Tableau Server
Führen Sie nach der Installation und Konfiguration von Tableau Server das Tableau ServerKonfigurationsdienstprogramm aus. Wählen Sie auf der Registerkarte Kerberos die Option
Kerberos für Single Sign-on aktivieren.
2 Erstellen des Konfigurationsskripts
Klicken Sie auf Kerberos-Konfigurationsskript importieren, um eine Batch-Datei zum
Konfigurieren von Kerberos in Active Directory für Tableau Server zu erstellen.
- 292 -
Sie werden aufgefordert, einen Speicherort zum Speichern der Datei einzugeben. Der
Standardspeicherort ist
<Installationslaufwerk>\Programme\Tableau\Tableau Server\8.3\bin.
Es wird eine Meldung mit den nächsten Schritten angezeigt. Übermitteln Sie das
Konfigurationsskript zum Ausführen dem Administrator Ihrer Active Directory-Domäne.
3 Ausführen des Konfigurationsskripts
Der Domänenadministrator muss das Skript durch Eingabe des Skriptnamens an einer
Eingabeaufforderung eines beliebigen Computers in der Domäne ausführen. Standardmäßig
ist das Skript KerberosConfig.bat benannt.
Wenn Ihr Domänen-Administrator das Konfigurationsskript ausführt, registriert das Skript
Dienstprinzipalnamen (Service Principal Names, SPNs) für Tableau Server unter
Verwendung des Kontos "Als Benutzer ausführen", und es generiert eine .keytab-Datei für
Ihre Umgebung.
Die .keytab-Datei wird in dem \keytabs-Ordner des Ordners erstellt, in dem das Skript
ausgeführt wurde.Für den nächsten Schritt muss Ihnen Ihr Domänenadministrator eine Kopie
der Datei senden.
4 Kopieren der .keytab-Datei
Wenn Ihr Domänenadministrator das Skript ausgeführt und Ihnen eine Kopie der .keytabDatei gesendet hat, führen Sie das Tableau Server-Konfigurationsdienstprogramm erneut
aus. Geben Sie dann auf der Registerkarte Kerberos den Pfad zur .keytab-Datei im Feld in
Schritt 3 ein.
Das Dienstprogramm kopiert die Datei in jeden Gateway-Knoten in der Tableau ServerInstallation.
Klicken Sie auf Konfiguration testen, um zu überprüfen, ob die Konfiguration
ordnungsgemäß eingerichtet ist. Wenn die SPNs ordnungsgemäß eingerichtet sind, sollte
beim Test Folgendes angezeigt werden: "OK". Die Anzahl der für die Delegierung
konfigurierten Datenquelle beträgt "0" (null), sofern Sie nicht die unten genannten
Delegierungsschritte ausgeführt haben.
- 293 -
Konfigurieren der Kerberos-Delegierung in AD
Zur Verwendung der Kerberos-Authentifizierung mit der MS SQL- oder MSAS-Datenquelle
oder zum Herstellen von SSO-Verbindungen zu Cloudera Impala müssen Sie die KerberosDelegierung in Active Directory (AD) konfigurieren. Wenn Sie nur die einmalige Anmeldung
per Kerberos für die Verbindung mit Tableau Server verwenden, müssen Sie die
Delegierungsschritte nicht ausführen.
Dieser mehrteilige Prozess ist ein externer Tableau-Prozess und umfasst Folgendes:
l
l
Ermöglichen, dass das Konto "Als Benutzer ausführen" als Betriebssystem
agiert.Weitere Informationen finden Sie unter Ermöglichen, dass das Konto "Als
Benutzer ausführen" als Betriebssystem agiert.
Ermöglichen der Kerberos-Delegierung in AD. Dieser Schritt gilt nur für die
unterstützten Verbindungstypen, die Sie mit Tableau verwenden:
l
l
l
MS SQL: Siehe Ermöglichen der Kerberos-Delegierung für MS SQL in der
Knowledge Base.
MSAS: Siehe Ermöglichen der Kerberos-Delegierung für MSAS in der
Knowledge Base.
Impala: Siehe ###Ermöglichen der Kerberos-Delegierung für Impala in der
Knowledge Base.
Hinweis: Bei der einmaligen Anmeldung mit Impala wird Kerberos nicht
verwendet, jedoch muss Kerberos für Tableau Server aktiviert sein.
Funktionsweise der Kerberos-Authentifizierung
Kerberos ist ein Authentifizierungsprotokoll für Netzwerke, das mittels Austausch und
Erstellung von "Tickets"funktionert. Über diese Tickets können Netzwerkknoten miteinander
kommunizieren und die Kennung der Knoten miteinander verifizieren, wobei beide Knoten die
Identität des jeweils anderen überprüfen.
Wenn Kerberos in Tableau Server aktiviert und Ihre Umgebung korrekt konfiguriert ist, stellt
Kerberos einen Single Sign-on-Mechanismus (Mechanismus für einmaliges Anmelden)
zwischen Tableau Desktop bzw. den Webbrowsern und Tableau Server bereit.
Stellen Benutzer eine Verbindung zu Arbeitsmappen, Dashboards oder Datenquellen her, die
Verbindungen mit aktivierter Kerberos-Funktion unterstützen, werden sie automatisch
authentifiziert.
Kerberos-Authentifizierung zwischen einem Client und Tableau Server
Wenn Sie Tableau Server in einer Active Directory-Umgebung für Kerberos konfigurieren,
dient der AD-Domänencontroller auch als Kerberos Key Distribution Center (KDC). Er sendet
Tickets an andere Knoten in der Domäne. Durch das KDC authentifizierte Benutzer müssen
sich nicht weiter authentifizieren, wenn sie eine Verbindung zu Tableau Server herstellen.
- 294 -
Der Benutzer meldet sich bei seiner
Active Directory-Domäne an.
Das Kerberos KDC authentifiziert
ihn und sendet ein Ticket Granting
Ticket (TGT).
Der Benutzer stellt über Tableau
Desktop oder einen Webbrowser
eine Verbindung zu Tableau Server
her.
Tableau Server authentifiziert den
Benutzer.
Kerberos-Anforderungen
Sie benötigen Folgendes, um die Kerberos-Authentifizierung mit Tableau Server zu nutzen:
l
l
l
Windows-Server: Tableau Server muss auf einer Windows-Serverversion installiert
sein. Nicht-Server-Versionen (einschließlich Windows 7 und Windows 8) unterstützen
den zum Erzeugen einer keytab-Datei erforderlichen Befehl ktpass nicht.
Active Directory:
l Tableau Server muss Active Directory (AD) zur Authentifizierung verwenden.
l Bei der Domäne muss es sich um eine AD 2003-Domäne oder eine neuere
Domäne handeln.
Konto "Als Benutzer ausführen":
l Das Konto "Als Benutzer ausführen" (das Tableau Server-Dienstkonto) muss ein
AD-Domänenkonto sein. Lokale Konten, einschließlich
NTAUTHORITY\NetworkService, sind nicht kompatibel.
l Das Konto "Als Benutzer ausführen" (das Tableau Server-Dienstkonto) muss
sich in derselben Domäne wie die Datenbankdienste befinden, die delegiert
werden.
- 295 -
Eingeschränkte Delegierung: Das Konto "Als Benutzer ausführen" muss Zugang
zu den SPNs der Zieldatenbank gewähren.
Single-Sign On (SSO, Einmaliges Anmelden): Benutzern muss ein Kerberos TGT
von Active Directory bereitgestellt werden, wenn sie sich bei ihren Computern
anmelden. Dies ist das Standardverhalten von mit einer Domäne verbundenen
Windows-Computern und von Mac-Computern, die AD als Netzwerkkontoserver
verwenden. Weitere Informationen zur Verwendung von Mac-Computern und Active
Directory finden Sie unter http://support.apple.com/kb/PH14242.
Externes Lastausgleichsmodul/Proxyserver: Wenn Sie Tableau Server zusammen
mit Kerberos in einer Umgebung verwenden, die über externe Lastausgleichsmodule
oder einen Proxyserver verfügt, müssen Sie diese bzw. diesen vor der Konfiguration
von Kerberos im Tableau Server-Konfigurationsdienstprogramm einrichten. Weitere
Informationen dazu finden Sie in den Abschnitten Hinzufügen eines
Lastenausgleichs Auf Seite 171 und Konfigurieren von Tableau für die
Verwendung eines Proxyservers Auf Seite 352.
Smartcard-Unterstützung: Smartcards werden unterstützt, wenn sich Benutzer mit
einer Smartcard bei ihren Arbeitsstationen anmelden und diese Anmeldung dazu führt,
dass den Benutzern ein Kerberos TGT von Active Directory bereitgestellt wird.
iOS-Browser-Unterstützung: Ein iOS-Benutzer kann die Kerberos-Authentifizierung
mit Mobile Safari nutzen, wenn ein Konfigurationsprofil installiert ist, das die KerberosIdentität des Benutzers festlegt.
l
l
l
l
l
Um deligierten Zugriff zu erhalten:
l
Datenquellen:
l Die unterstützten Datenquellen (MS SQL, MSAS und Cloudera Impala) müssen
für die Kerberos-Authentifizierung konfiguriert sein.
l Die Datenquellen müssen sich in derselben Domäne wie Tableau Server
befinden (Benutzer können sich hingegen in verschiedenen Domänen befinden).
Kerberos-Verbindungen zu Tableau Server werden in den folgenden Konfigurationen
unterstützt:
l
Tableau Server erfordert "eingeschränkte Delegierung", bei der dem Konto "Als
Benutzer ausführen" spezielle Zugriffsrechte auf die SPNs der Zieldatenbank gewährt
werden. Eine uneingeschränkte Delegierung wird nicht unterstützt.
Konfigurieren von Kerberos
Sie können Tableau Server für die Verwendung von Kerberos konfigurieren. Dies ermöglicht
Ihnen, eine Single Sign-On-Umgebung (einmaliges Anmelden) für alle Anwendungen in Ihrem
Unternehmen bereitzustellen.
Bevor Sie Tableau Server für Kerberos konfigurieren:
- 296 -
l
l
l
Führen Sie vor der Konfiguration von Kerberos die Ersteinrichtung von Tableau Server
aus, einschließlich der Konfiguration für die Active Directory-Authentifizierung und eines
AD-Dienstkontos.
Dabei müssen die Kerberos-Anforderungen Auf Seite 295 erfüllt sein.
Wenn Sie Kerberos zur Authentifizierung bei MS SQL oder MSAS oder zur Delegierung
für einmaliges Anmelden bei Cloudera Impala verwenden, müssen Sie das Konto "Als
Benutzer ausführen" für die Ausführung als Teil des Betriebssystems aktivieren. Weitere Informationen finden Sie unter Ermöglichen, dass das Konto "Als Benutzer
ausführen" als Betriebssystem agiert Auf Seite 300.
Hinweis:Wenn Sie einen externen Lastenausgleich oder einen Reverse-Proxy
verwenden, müssen Sie diese Konfiguration vor der Konfiguration von Kerberos
ausführen. Andernfalls verwendet das vom Tableau ServerKonfigurationsdienstprogramm generierte Konfigurationsskript möglicherweise die
falschen Hostnamen. Weitere Informationen finden Sie unter Hinzufügen eines
Lastenausgleichs Auf Seite 171 und Konfigurieren von Tableau für die
Verwendung eines Proxyservers Auf Seite 352.
Konfigurieren von Kerberos
1. Konfigurieren Sie Kerberos auf der Registerkarte Kerberos des
Konfigurationsdienstprogramms von Tableau Server. Öffnen Sie das
Konfigurationsdienstprogramm von Tableau Server (Start > Alle Programme >
Tableau Server 8.3 > Tableau Server konfigurieren), und klicken Sie auf die
Registerkarte Kerberos.
2. Wählen Sie auf der Registerkarte Kerberos die Option Kerberos für einmaliges
Anmelden aktivieren.
3. Klicken Sie auf Kerberos-Konfigurationsskript exportieren, um das Batch-Skript zu
generieren, mit dem Sie Active Directory für die Verwendung von Kerberos mit Tableau
Server konfigurieren können.
Das Konfigurationsskript konfiguriert Ihre Active Directory-Domäne für die Verwendung
von Kerberos mit Tableau Server. Weitere Informationen finden Sie unter KerberosKonfigurationsskript Auf Seite 299.
- 297 -
Hinweis: Überprüfen Sie die Hostnamen auf den setspn-Zeilen des Skripts.
Wenn Sie einen externen Lastenausgleich oder einen Reverse-Proxy verwenden
und die Hostnamen mit dem Namen übereinstimmen sollen, den Sie bei der
Konfiguration von Tableau Server für den Lastenausgleich oder Proxy verwendet
haben. Wenn Sie Tableau Server nicht für Ihren Proxy oder einen externen
Lastenausgleich konfiguriert haben, holen Sie das nach, und exportieren Sie das
Kerberos-Konfigurationsskript erneut, um sicherzustellen, dass es die richtigen
Hostnamen enthält.
4. Bitten Sie Ihren Active Directory-Domänenadministrator, das Konfigurationsskript
auszuführen, um Service Principal Names (SPNs) und die .keytab-Datei zu erstellen.
Der Domänenadministrator muss das Skript an der Eingabeaufforderung eines
beliebigen Computers in der Domäne ausführen. Das Skript sollte gelesen werden, um
die enthaltenen Werte zu überprüfen, und durch Eingabe des Skriptnamens an einer
Eingabeaufforderung ausgeführt werden (nicht durch Doppelklicken auf das Skript in
Windows Explorer). Das Skript erstellt die Datei kerberos.keytab im Ordner
\keytabs des Verzeichnisses, in dem das Skript ausgeführt wurde.
5. Erstellen Sie eine Kopie der vom Skript erstellten .keytab-Datei, und speichern Sie diese
auf dem Computer mit Tableau Server. Geben Sie den Pfad zu der .keytab-Datei ein,
oder klicken Sie auf die Schaltfläche "Durchsuchen", um zu der Datei zu navigieren.
Wenn Sie auf OK klicken, um die Konfigurationsänderungen zu speichern, wird die
keytab-Datei in alle Gateway-Knoten der Tableau Server-Installation kopiert.
Hinweis:Benennen Sie die .keytab-Datei. Das Skript erstellt die Datei
kerberos.keytab, und Sie müssen sie unter diesem Namen speichern.
6. Sie können auch auf Konfiguration testen klicken, um zu überprüfen, ob Ihre
Umgebung ordnungsgemäß für die Verwendung von Kerberos mit Tableau Server
konfiguriert ist.
Wenn SPNs ordnungsgemäß konfiguriert sind, wird "OK"angezeigt. Die Anzahl der für
die Kerberos-Delegierung konfigurierten Datenquelle wird angegeben. Wenn Sie keine
Datenquelle für die Kerberos-Delegierung konfiguriert haben, wird "0" angezeigt.
7. Klicken Sie auf OK, um die Kerberos-Konfiguration zu speichern.
Testen der Konfiguration
Wenn Tableau Server erneut gestartet wurde, testen Sie die Kerberos-Konfiguration in einem
Webbrowser auf einem anderen Computer, indem Sie den Namen des Tableau Server im
- 298 -
URL-Fenster eingeben:
Sie sollten automatisch bei Tableau Server authentifiziert werden.
Kerberos-Konfigurationsskript
Das Skript KerberosConfig.bat, das Sie durch Klicken auf KerberosKonfigurationsskript exportieren erstellen, registriert die SPNs für Tableau Server und
erzeugt eine Kerberos-Datei mit der Endung .keytab.
l
l
SPNs - Das Skript verwendet das setspn-Dienstprogramm zum Registrieren der SPNs
für Tableau Server unter Verwendung des Kontos "Als Benutzer ausführen". Diese
SPNs werden zur Erzeugung der .keytab-Datei und zur Authentifizierung der Webbrowser-Verbindungen zu Tableau Server verwendet.
.keytab - Das Skript nutzt das ktpass-Dienstprogramm, um die kerberos.keytabDatei zu erstellen, die sich im Ordner \keytabs des Ordners befindet, in dem das Skript
ausgeführt wurde. Die .keytab-Datei enthält den gemeinsam genutzen, geheimen
Schlüssel für Tableau Server.
Hinweis: "setspn" und "ktpass" können eine Warnung oder Fehler erzeugen. Sie
können diese Fehler und Warnungen ignorieren, sofern die Hilfsprogramme vollständig
durchlaufen.
Kerberos-Delegierung
Die Kerberos-Delegierung gewährt eine Möglichkeit, Tableau Server für die Verwendung der
Kerberos-Anmeldeinformationen der Person zu aktivieren, die eine Arbeitsmappe oder
Ansicht anzeigt, um für den Anzeigenden eine Abfrage auszuführen. Dies ist in folgenden
Fällen sinnvoll:
l
Sie müssen wissen, wer auf die Daten zugreift (der Name der anzeigenden Person wird
in den Zugriffsprotokollen für die Datenquelle angegeben).
- 299 -
l
Für Ihre Datenquelle ist Sicherheit auf Zeilenebene festgelegt, das heißt, unterschiedliche Benutzer können auf unterschiedliche Zeilen zugreifen.
Tableau Server erfordert eine "eingeschränkte Delegierung", bei der dem Konto "Ausführen
als Benutzer" spezielle Delegierungsrechte für die SPNs der Zieldatenbank gewährt
werden.Die Delegierung ist in Active Directory standardmäßig nicht aktiviert. Zum
Konfigurieren der Kerberos-Delegierung müssen Sie mehrere Schritte ausführen.
In Tableau Server:
l
Konfigurieren des Kontos "Als Benutzer ausführen" in allen Tableau Server-Knoten,
sodass es als Teil des Betriebssystems fungiert
In Active Directory:
l
l
Konfigurieren der SPNs für die zu verwendende(n) Datenquelle(n)
Aktivieren der Kerberos-Delegierung für die SPNs der Datenquelle(n)
Für die Kerberos-Delegierung mit Tableau Server können Sie folgende
Datenverbindungstypen konfigurieren:
l
l
MS SQL: Siehe Knowledge Base-Artikel Aktivieren der Kerberos-Delegierung für SQLServer.
MSAS: Siehe Knowledge Base-Artikel Aktivieren der Kerberos-Delegierung für MSAS.
Sie können auch Impala-Datenverbindungen für die Delegierung mit Tableau Server
konfigurieren. In diesem Fall muss Kerberos in Tableau Server aktiviert werden, wird aber für
die Verbindung nicht verwendet:
l
Cloudera Impala: Siehe Knowledge Base-Artikel Aktivieren der Delegierung für Cloudera Impala.
Ermöglichen, dass das Konto "Als Benutzer ausführen" als Betriebssystem
agiert
Wenn Sie die Kerberos-Delegierung mit Tableau Server verwenden, muss Ihr Konto "Als
Benutzer ausführen" so konfiguriert sein, dass es als Betriebssystem auf jedem Tableau
Server-Computer agiert. Gehen Sie hierzu wie folgt vor:
1. Wählen Sie Start > Systemsteuerung > Verwaltung > Lokale
Sicherheitsrichtlinie aus.
2. Öffnen Sie im Fenster "Lokale Sicherheitseinstellungen" den Ordner "Lokale
Richtlinien", heben Sie "Zuweisen von Benutzerrechten" hervor, klicken Sie dann mit
der rechten Maustaste auf Als Teil des Betriebssystems agieren, und wählen Sie
Eigenschaften aus.
- 300 -
3. Im Fenster "Eigenschaften von Als Teil des Betriebssystems agieren" klicken Sie auf
Benutzer oder Gruppe hinzufügen.
4. Geben Sie den <domain>\<username> für das Tableau Server-Konto "Run As
User" (Als Benutzer ausführen) ein (z. B.: MYCO\tableau_server), und klicken Sie
auf Namen überprüfen.
5. Wenn das Konto richtig zugeordnet werden kann, wird es unterstrichen. Klicken Sie auf
OK.
6. Klicken Sie auf OK, um das Fenster "Lokale Sicherheitseinstellungen" zu schließen.
Problembehebung für Kerberos
Die folgenden Themen enthalten Informationen zur Behebung von Problemen mit Kerberos.
- 301 -
Einmaliges Anmelden bei Tableau Server
Automatische Verbindung mit Tableau Server ist nicht möglich
Problembehebung auf dem Client
Wenn Sie Kerberos verwenden und ein Benutzer bei der Verbindung per Webbrowser oder
Tableau Desktop dennoch aufgefordert wird, sich bei Tableau Server anzumelden, versuchen
Sie es auf der Client-(Endbenutzer-)Seite mit folgenden Schritten:
l
l
l
l
l
Kontoberechtigungen: Versuchen Sie, sich mit dem Namen und dem Kennwort des
Benutzers anzumelden. Wenn Sie sich bei Tableau Server nicht mit dem Namen und
dem Kennwort des Benutzers anmelden können, verfügt dieser Benutzer über keine
Berechtigung für den Zugriff auf Tableau Server, und Kerberos schlägt fehl.
Andere Konten: Testen Sie, ob andere Benutzer die einmalige Anmeldung bei
Tableau Server verwenden können. Wenn alle Benutzer betroffen sind, kann das
Problem an der Kerberos-Konfiguration liegen.
Standort des Computers: Kerberos funktioniert nicht bei Verbindungen von localhost.
Clients müssen die Verbindung von einem anderen Computer als dem Tableau ServerComputer aus herstellen.
URL-Adresse: Sie können keine Verbindung herstellen, wenn Sie eine IP-Adresse und
die einmalige Anmeldung per Kerberos verwenden. Zudem muss der Name, den Sie für
den Zugriff auf Tableau Server verwenden, mit dem Namen übereinstimmen, der bei
der Konfiguration von Kerberos verwendet wurde (siehe unten "Problemlösung: Kein
Schlüsseltabelleneintrag gefunden").
TGT (Ticket Granting Ticket): Überprüfen Sie, ob der Client-Computer über ein TGT
der Active Directory-Domäne verfügt. Kerberos erfordert für die Anmeldung ein TGT.
Um zu überprüfen, ob der Client-Computer über ein TGT verfügt, geben Sie Folgendes
ein:
l
klist tgt an einer Eingabeaufforderung auf einem Windows-Computer
oder
- 302 -
klist an einer Terminalaufforderung auf einem Mac-Computer
Die Ausgabe sollte ein TGT für den Benutzer/die Domäne anzeigen, der/die
versucht, sich bei Tableau Server zu authentifizieren.
Der Client-Computer benötigt in folgenden Fällen kein TGT:
l
l
l
l
l
Er verwendet eine VPN-Verbindung
Es ist nicht mit der Domäne verbunden (zum Beispiel ein anderer als der
Dienstcomputer, der vorübergehend für die Arbeit verwendet wird)
Der Benutzer hat sich am Computer mit einem lokalen (Nicht-Domänen-)
Konto angemeldet
Der Computer ist ein Mac, der nicht Active Directory als
Netzwerkkontoserver verwendet
Browser: Welcher Browser wird verwendet?
l
Internet Explorer (IE) und Chrome können "ohne Veränderungen" unter
Windows verwendet werden
l
Safari kann "unverändert" unter Mac verwendet werden
l
Firefox muss zusätzlich konfiguriert werden
Problembehebung auf dem Server
Wenn Sie das Problem auf dem Client ncht lösen können, bestehen Ihre nächsten Schritte in
der Problembehebung auf dem Tableau Server-Computer. Über die Anforderungs-ID kann
Ihr Administrator Ihren Anmeldeversuch in den Apache-Protokollen von Tableau Server
suchen. Einige häufige Probleme, die zu Authentifizierungsfehlern führen:
l
Protokolldateien: Überprüfen Sie das Apache-Protokoll error.log auf Fehler mit der
genauen Uhrzeit/dem genauen Datum des fehlgeschlagenen Anmeldeversuchs.
l
l
l
In einem ZIPLOG-Archiv befinden sich diese Protokolle im Ordner \httpd
Auf dem Tableau Server befinden sich diese Protokolle unter
\data\tabsvc\logs\httpd\
Schlüsseltabelleneintrag: Wenn der Eintrag in error.log Folgendes besagt: "Kein
Schlüsseltabelleneintrag stimmt überein mit:
HTTP/<Servername>.<Domäne>.<Org>@"
Beispiel:
[Fri Oct 24 10:58:46.087683 2014] [:error] [pid 2104:tid
4776] [client 10.10.1.62:56789] gss_acquire_cred() failed:
Unspecified GSS failure. Minor code may provide more infor-
- 303 -
mation (, No key table entry found matching HTTP/servername.domain.com@)
Solche Fehler sind Ergebnis fehlender Übereinstimmung zwischen beliebigen der
folgenden Elemente:
l
Tableau Server-URL: Die URL, die vom Client für den Serverzugriff verwendet
wurde
Diesen Namen geben Sie in Tableau Desktop oder in der Adresszeile eines
Browsers ein. Es kann ein Kurzname (http://servername) oder ein
vollständig qualifizierter Domänenname
(http://servername.domain.com) sein.
l
DNS-Reverse-Lookup für die IP-Adresse des Servers
Damit wird ein DNS-Name mithilfe einer IP-Adresse gesucht.
An einer Eingabeaufforderung:
geben Sie ein: ping servername,
führen Sie mit der vom Ping-Befehl für den Server zurückgegebenen IP-Adresse
ein DNS-Lookup aus:
geben Sie ein: nslookup <IP-Adresse>.
Die Namen müssen übereinstimmen.
l
.keytab-Datei
l
Service Principal Name (SPN) für den Server
Testkonfiguration und tabconfig.log
Verwenden Sie die Schaltfläche "Konfiguration testen" im Konfigurationsdienstprogramm von
Tableau Server:
- 304 -
Wenn die SPNs für Kerberos ordnungsgemäß auf den Tableau Server festgelegt sind, wird
unter SPNs sind ordnungsgemäß konfiguriert Folgendes angezeigt: "OK".
Wenn Dienste für die Delegierung konfiguriert sind, wird die Anzahl der konfigurierten Dienste
angezeigt. Der Wert "0" (null) gibt nur dann ein Problem an, wenn Sie die Delegierung und die
Kerberos-Authentifizierung bei MS SQL oder MSAS verwenden.
Suchen Sie in tabcmd.log nach Problemen oder Fehlern. Beispiel:
2014-10-17 10:58:16.545 -0700 ERROR root: No SPN entries found
Wenn der Test keine erfolgreichen Resultate ergibt, führen Sie das Konfigurationsskript erneut
aus.
Einmaliges Anmelden bei der Datenquelle
Fehler bei delegierten Datenquellenzugriffen
Protokolldateien: Überprüfen Sie das vizqlserver-Protokoll auf workgroup-auth-mode:
l
l
In einem ZIPLOG-Archiv befinden sich diese Protokolle im Ordner \vizqlserver
Auf dem Tableau Server befinden sich diese Protokolle unter
\data\tabsvc\vizqlserver\*.log
Suchen Sie nach "workgroup-auth-mode" in den Protokolldateien. Der Eintrag sollte lauten:
"kerberos-impersonate" und nicht "as-is".
Leistung
Jede Serverumgebung ist einzigartig und viele Variablen können sich auf die Leistung
auswirken. Zu den Variablen gehören Hardware-Details, wie z. B.
Datenträgergeschwindigkeit, Arbeitsspeicher und Kerne, die Anzahl von Servern in Ihrer
Bereitstellung, Netzwerkdatenverkehr, Nutzungsfaktore wie Arbeitsmappenkomplexität,
gleichzeitige Benutzeraktivität und Zwischenspeicherung von Daten, Tableau ServerKonfigurationseinstellungen, wie z. B. wie viele der einzelnen Serverprozesse ausgeführt
werden, und Datenaspekte, wie z. B. Datenvolume, Datenbanktyp und
Datenbankkonfigurationen. Aufgrund dieser Komplexität gibt es keine einzelne Formel zur
Verbesserung der Serverleistung. Es gibt jedoch einige grundlegende Richtlinien, die Sie
beachten können, Weitere Informationen finden Sie in den folgenden Themen:
- 305 -
Allgemeine Richtlinien zur Leistung
Hardware und Software
Verwenden Sie ein 64-Bit-Betriebssystem und das 64-Bit-Produkt: Obwohl Tableau
Server unter 32-Bit-Betriebssystemen von Microsoft problemlos ausgeführt wird, wählen Sie
zur Gewährleistung einer optimalen Leistung ein 64-Bit-Betriebssystem, und installieren Sie
die 64-Bit-Version von Tableau Server.
Fügen Sie weitere Kerne und mehr Speicher hinzu: Unabhängig davon, ob Tableau
Server auf einem oder auf mehreren Computern ausgeführt wird, gilt als allgemeine Regel,
dass sich durch mehr CPU-Kerne und mehr RAM die Leistung verbessern lässt. Stellen Sie
sicher, dass Sie die empfohlenen Hardware- und Software-Anforderungen von Tableau
Server erfüllen, und beurteilen Sie anhand von Zeitpunkt des Hinzufügens und
Neukonfigurierens von Arbeitscomputern Auf der nächsten Seite, ob weitere Computer
hinzugefügt werden sollten. Wenn Sie Tableau Server in einer virtuellen Umgebung
ausführen, nutzen Sie die bewährten Methoden der VM für die vCPU-Zuordnung in Bezug auf
die Anzahl an physischen CPU-Core-Prozessoren auf dem VM-Host.
Konfiguration
Festlegen von Zeitplänen für Nebenzeiten: Backups neigen dazu, andere
Hintergrundaufgaben zu verzögern, bis das Backup abgeschlossen ist. In der
Verwaltungsansicht Hintergrundaufgaben Auf Seite 269 können Sie den Zeitplan zum
Aktualisieren und Sichern von Aufgaben einsehen. Planen Sie Aktualisierungen nach
Möglichkeit für Nebenzeiten, so dass es zu keinen Überschreitungen mit Backups kommt.
Überprüfen Sie die Zwischenspeicherung: Mithilfe der Zwischenspeicherung kann
Tableau Server schnell auf Client-Anforderungen reagieren, insbesondere bei Ansichten, die
eine Verbindung zu Live-Datenbanken herstellen. Bestätigen Sie, dass die Option Seltener
aktualisieren auf der Registerkarte Datenverbindungen im Konfigurationsdialogfeld aktiviert
ist.
Erwägen Sie, zwei Einstellungen für das Speichern von Sitzungen zu ändern:
l
l
Zeitüberschreitungslimit der VizQL-Sitzung: Standardmäßig ist das Zeitüberschreitungslimit der VizQL-Sitzung auf 30 Minuten eingestellt. Selbst VizQL-Sitzungen, die sich im Leerlauf befinden, verbrauchen weiterhin Speicher und CPUZyklen. Wenn ein niedrigeres Limit ausreichend ist, ändern Sie mit tabadmin Auf Seite
417 die Einstellung vizqlserver.session.expiry.timeout.
VizQL-Sitzung löschen: VizQL-Sitzungen werden standardmäßig gespeichert, auch
wenn der Benutzer eine Ansicht wechselt. Dadurch wird eine Menge Sitzungsspeicherplatz verbraucht. Stattdessen können Sie Sitzungen beenden, wenn
Benutzer aus einer Ansicht wechseln, indem Sie den Wert der vizqlserver.clear_session_on_unload-Einstellung in true ändern (die Standardeinstellung ist false).
- 306 -
Beurteilen Sie die Prozesskonfiguration: Tableau Server ist in sechs verschiedene
Komponenten unterteilt, die als Serverprozesse bezeichnet werden. Obwohl deren
Standardkonfiguration entwurfsgemäß für eine breite Vielzahl von Szenarien funktioniert,
können die Prozesse neu konfiguriert werden, um andere Leistungsziele zu erreichen.
Insbesondere können Sie steuern, auf welchen Computern wie viele Prozesse ausgeführt
werden. Richtlinien zur Bereitstellung auf einem, zwei und drei Computern finden Sie unter
Verbessern der Serverleistung Auf der nächsten Seite.
Zeitpunkt des Hinzufügens und Neukonfigurierens von Arbeitscomputern
Tableau Server kann je nach Bedarf und den sich ändernden Anforderungen vergrößert und
erweitert werden. Anhand der folgenden Richtlinien können Sie bestimmen, wann es am
besten ist, weitere Knoten zu Ihrem System hinzuzufügen, den Server neu zu konfigurieren
oder beide Maßnahmen zu ergreifen.
l
l
l
l
l
Mehr als 100 gleichzeitige Benutzer: Bei einer benutzerintensiven Bereitstellung (>
100 gleichzeitige Benutzer) ist es wichtig, dass genug VizQL-Prozesse verfügbar sind,
ohne dass sie die Handhabungskapazität der Hardware überschreiten. Zudem wird
durch Aktivieren des Gastbenutzerkontos von Tableau Server die Anzahl der
potenziellen gleichzeitigen Benutzer möglicherweise über die von Ihnen veranschlagte
Benutzerliste hinaus erhöht. Sie können dies anhand der Verwaltungsansicht
Benutzeraktivitäten Auf Seite 267 besser einschätzen. Tipps zum Konfigurieren oder
Skalieren Ihrer Bereitstellung finden Sie unter Verbessern der Serverleistung Auf der
nächsten Seite.
Übermäßige Verwendung von Extrakten: Extrakte können ein großes Maß an
Speicher und CPU-Ressourcen verbrauchen. Es gibt keine Messung, durch die eine
Site als extraktintensiv eingestuft wird. Ihre Site kann aufgrund von nur wenigen, äußert
großen Extrakten dieser Kategorie genauso wie aufgrund von sehr vielen kleinen
Extrakten zugeordnet werden. Bei extraktreichen Sites ist es hilfreich, den DatenEngine-Prozess auf einem separaten Computer zu isolieren. Richtlinien finden Sie unter
Verbessern der Serverleistung Auf der nächsten Seite.
Häufige Extraktaktualisierungen: Das Aktualisieren eines Extrakts ist eine CPUintensive Aufgabe. Bei Sites, deren Extrakte häufig aktualisiert werden (z. B. mehrmals
täglich), ist es oft hilfreich, den Hintergrundprozess, durch den die
Aktualisierungsaufgaben gehandhabt werden, mehr herauszustellen. Überprüfen Sie in
der Verwaltungsansicht Hintergrundaufgaben Auf Seite 269 Ihre aktuelle
Aktualisierungsrate. Unter Verbessern der Serverleistung Auf der nächsten Seite
finden Sie dann Details zur Vorgehensweise bei der Skalierung.
Leistungsbezogene Problembehebung: Wenn Ansichten langsam geladen werden
oder die Serverleistung generell langsam ist, kann dies mehrere Ursachen haben.
Beziehen Sie sich auf Allgemeine Richtlinien zur Leistung Auf der vorherigen Seite
und Verbessern der Serverleistung Auf der nächsten Seite.
Potenzielle Ausfallzeiten: Wenn Ihr Serversystem als unternehmenskritisch
angesehen wird und ein hohes Maß an Verfügbarkeit benötigt, können Sie es so
- 307 -
konfigurieren, dass die Serverprozesse, mit denen Extrakte, das Repository und das
Gateway gehandhabt werden, redundant sind. Weitere Einzelheiten finden Sie unter
Hochverfügbarkeit Auf Seite 158.
Verbessern der Serverleistung
Die Themen unten dienen als Richtlinie bei der Verbesserung der Leistung von
Bereitstellungen, die extraktintensiv, benutzerintensiv oder beides sind:
Was ist Ihr Ziel?
Beispiel mit
einem Computer:
Extrakte
Wie viele Prozesse sollen ausgeführt werden
Beispiel mit
zwei Computern:
Extrakte
Wo sind die Prozesse zu konfigurieren
Beispiel mit
zwei Computern:
Ansicht
Optimieren der Extrakte und Arbeitsmappen
Beispiel mit
drei Computern:
Extrakte &
Ansicht
Bewerten der Reaktionsfähigkeit für Ansichten
Auf Seite 310
Was ist Ihr Ziel?
Optimieren für Extrakte
Der Daten-Engine-Prozess speichert Extrakte und beantwortet Abfragen. Der
Hintergrundprozess aktualisiert Extrakte. Da beide Prozesse die CPU-Ressourcen
beanspruchen, lässt sich die Leistung einer extraktintensiven Bereitstellung am besten
verbessern, indem diese beiden Prozesse voneinander und von den anderen
Serverprozessen isoliert werden. Dafür werden möglicherweise drei Computer benötigt.
Wenn Ihnen nicht drei Computern zur Verfügung stehen, gibt es andere Strategien, die Sie
einsetzen können (siehe die Bereitstellungsbeispiele unten).
Optimieren für Benutzer und Ansicht
- 308 -
Der VizQL-Serverprozess handhabt das Laden und Rendering der Ansichten für Tableau
Server-Benutzer. Wenn Sie versuchen, Ihre Bereitstellung für eine hohe Anzahl von
Benutzern und Ansichtinteraktionen zu optimieren, sollten Sie sich auf diesen Prozess
konzentrieren.
Wie viele Prozesse sollen ausgeführt werden
In diesem Thema wird davon ausgegangen, dass Sie die 64-Bit-Version von Tableau Server
unter einem 64-Bit-Betriebssystem ausführen. In dieser Situation sollten zwei Instanzen jedes
Prozesses Ihre Anforderungen erfüllen. Wenn Ihr Computer nur die für Tableau Server
geltenden Mindestanforderungen an den Arbeitsspeicher (8 GB) erfüllt, sollten Sie maximal
eine Instanz jedes Prozesses verwenden.
Hintergrundprozess
Ein einzelner Hintergrundprozess kann 100 % eines einzelnen CPU-Kerns verbrauchen und
manchmal bei bestimmten Aufgaben sogar noch mehr. Folglich hängt die Gesamtzahl der
auszuführenden Instanzen von den verfügbaren Kernen des Computers sowie von dem ab,
was verbessert werden soll. In den Bereitstellungsbeispielen unten wird die Gesamtzahl der
Kerne des Computers durch N dargestellt. Jede Zahl legt eine andere Strategie hinsichtlich
des Hintergrundprozesses nahe. Falls Sie Zweifel haben, beginnen Sie mit dem unteren Ende
des vorgeschlagenen Bereichs und beurteilen Sie die Leistung, bevor Sie die Zahl erhöhen.
Daten-Engine und Repository-Prozesse
Unter bestimmten Umständen sollte der Daten-Engine-Prozess auf seinen eigenen Knoten
isoliert werden. Dies ist beispielsweise der Fall, wenn eine extraktintensive Bereitstellung
verbessert oder wenn Abfragen mehr Gewicht als Extraktaktualisierungen gegeben werden
soll. Weitere Details finden Sie in den Bereitstellungsbeispielen. Da die Daten-Engine
Echtzeitdaten speichert, ist deren Übertragung ein mehrphasiges Verfahren. Die
Vorgehensweise wird unter Verschieben der Daten-Engine und Repository-Prozesse
Auf Seite 147 beschrieben.
Ein weiterer Grund, die Daten-Engine (und/oder das Repository) zu isolieren, besteht darin,
potenzielle Ausfallzeiten Ihrer Bereitstellung zu minimieren. Nähere Informationen hierzu
finden Sie unter Hochverfügbarkeit Auf Seite 158. Sofern keine Konfiguration für hohe
Verfügbarkeit vorgenommen wird, kann das Repository gewöhnlich auf dem primären
Tableau Server verbleiben.
Wo sind die Prozesse zu konfigurieren
Über das Dialogfeld "Tableau Server-Konfiguration" Sie können den Typ und die Anzahl der
Prozesse konfigurieren, die auf einem Computer ausgeführt werden. Wenn Sie im Rahmen
einer Neukonfiguration neue Computer hinzufügen, muss auf ihnen bereits die Tableau
Worker-Software installiert sein. Anweisungsschritte finden Sie unter Installieren und
Konfigurieren von Arbeitsservern Auf Seite 153.
Anweisungen zum Neukonfigurieren der Prozesse auf Ihrem primären oder eigenständigen
Tableau Server finden Sie unter Neukonfigurieren von Prozessen Auf Seite 135.
- 309 -
Optimieren der Extrakte und Arbeitsmappen
Eine schnelle Serverleistung mit Extrakten ist teilweise eine Funktion der Extrakte und
Arbeitsmappen selbst. Arbeitsmappenautoren können einen Beitrag zur Verbesserung der
Serverleistung leisten, indem Sie den Datensatz des Extrakts durch Filtern und Aggregieren
kurz und durch Ausblenden nicht verwendeter Felder eng halten. Verwenden Sie hierzu die
Tableau Desktop-Optionen Nicht verwendete Felder ausblenden und Daten für
sichtbare Dimensionen aggregieren. Anleitungsschritte finden Sie unter Erstellung eines
Extrakts (Tableau Desktop-Onlinehilfe). Suchen Sie für allgemeine Tipps zum Erstellen von
leistungsstarken Arbeitsmappen in der Tableau Desktop-Onlinehilfe nach „Leistung“. Um die
Leistung von Arbeitsmappen nach deren Veröffentlichung auf Tableau Server anzuzeigen,
können Sie eine Leistungsaufzeichnung erstellen. Weitere Informationen hierzu finden Sie
unter Erstellen einer Leistungsaufzeichnung Auf Seite 321.
Bewerten der Reaktionsfähigkeit für Ansichten
Wenn ein Benutzer eine Ansicht öffnet, werden ihre Komponenten erst abgerufen und
interpretiert und anschließend im Webbrowser des Benutzers angezeigt. Bei den meisten
Ansichten erfolgt das Rendern für die Anzeige im Webbrowser des Benutzers, was zu
schnellen Ergebnissen und besten Reaktionen bei Interaktionen führt. Durch die Verarbeitung
der meisten Interaktionen über den Client-Webbrowser wird die Bandbreite reduziert und
Wartezeiten bei Rundreisen-Anfragen ausgeschlossen. Wenn eine Ansicht sehr komplex ist,
nutzt Tableau Server den Server zum Rendern und nicht den Client-Webbrowser, um eine
optimale Leistung zu gewährleisten. Wenn die Reaktionsfähigkeit der Ansichten nicht Ihren
Vorstellungen entspricht, können Sie den Schwellenwert testen und ändern, der dafür sorgt,
dass die Ansichten auf dem Server und nicht im Client-Webbrowser gerendert werden.
Weitere Informationen finden Sie unter Informationen zum clientseitigen Rendern Auf
Seite 316.
Beispiel mit einem Computer: Extrakte
Eine 64-Bit-Installation von Tableau Server mit ausgeprägter Verwendung von Abstrakten
kann auf einem einzelnen 64-Bit-Computer ausgeführt werden, der folgendermaßen
konfiguriert ist:
- 310 -
Die obige Konfiguration würde auf der Tableau Server-Wartungsseite folgendermaßen
aussehen:
Konfigurationshinweise:
l
l
l
l
Führen Sie 2 VizQL-Serverprozesse aus.
Berechnen Sie die geringste Anzahl auszuführender Hintergrundprozesse, indem Sie
die Gesamtzahl der Computerkerne durch 4 dividieren. Um die maximale Anzahl zu
bestimmen, dividieren Sie sie durch 2.
Die Hintergrund- und Daten-Engine-Prozesse sind gleichermaßen CPU-intensiv und
werden durch die obige Konfiguration ausgewogen.
Durch Planen von Extraktaktualisierungen in Nebenzeiten kann vermieden werden,
dass die Daten-Engine- und die Hintergrundprozesse miteinander um
Systemressourcen konkurrieren.
- 311 -
Beispiel mit zwei Computern: Extrakte
Nachfolgend wird beschrieben, wie eine Tableau Server-Bereitstellung mit zwei Computern
konfiguriert wird, so dass sie für eine ausgeprägte Extraktverwendung geeignet ist. Der
wichtigste Punkt in diesem Beispiel ist, dass der Daten-Engine-Prozess von den
Hintergrundprozessen isoliert wird.
Bei der obigen Konfiguration würde die Statustabelle auf der Konfigurationsseite
folgendermaßen aussehen:
Konfigurationshinweise:
l
l
l
l
Wenn Sie von einer Bereitstellung mit einem Computer zu einer Bereitstellung mit zwei
Computern übergehen, wird der erste Server der primäre Tableau Server.
Führen Sie 2 VizQL-Serverprozesse auf jedem Computer aus.
Zur Berechnung der Mindestanzahl auszuführender Hintergrundprozesse auf dem
primären Tableau Server dividieren Sie die Gesamtzahl der Computerkerne durch 4.
Um die maximale Anzahl zu bestimmen, dividieren Sie sie durch 2.
Das Verschieben der Daten-Engine von dem primären Tableau Server auf den
- 312 -
Arbeitscomputer ist ein aus mehreren Phasen bestehendes Verfahren. Informationen
zur Vorgehensweise finden Sie unter Verschieben der Daten-Engine und
Repository-Prozesse Auf Seite 147.
Beispiel mit zwei Computern: Ansicht
Eine Bereitstellung mit zwei Computern mit leichter Extrakverwendung und ausgeprägter
Ansichtsfunktion kann folgendermaßen konfiguriert werden:
Die Statustabelle der obigen Konfiguration würde folgendermaßen aussehen:
Konfigurationshinweise:
l
l
l
Führen Sie 2 VizQL-Serverprozesse auf jedem Computer aus.
Auf dem Tableau Server sollten mindestens 2 Hintergrundprozesse ausgeführt werden.
Die maximal auszuführende Anzahl entspricht der Gesamtzahl der Computerkerne.
Bei einer Bereitstellung, bei der Extrakte selten aktualisiert werden, können sich die
Daten-Engine- und Hintergrundprozesse auf dem gleichen Computer wie die anderen
Prozesse befinden.
- 313 -
l
l
Wenn Extrakt-Aktualisierungsaufgaben nur in Nebenzeiten ausgeführt werden, können
viele Hintergrundprozesse auf jedem Computer platziert werden, um deren
Parallelismus zu maximieren.
Die Anzahl der Computer im Cluster wird alleine durch die Gesamtanzahl Kerne und
den verfügbaren Hauptspeicher bestimmt.
Beispiel mit drei Computern: Extrakte & Ansicht
Eine Konfiguration mit drei Computern ist die empfohlene Mindestanzahl von Computern, mit
der die beste Leistung erzielt wird, wenn in Extrakte großen Mengen aktualisiert und
verwendet werden und wenn eine große Menge gleichzeitiger Benutzer vorhanden ist.
- 314 -
Dies ist die Statustabelle der obigen Konfiguration:
- 315 -
Konfigurationshinweise:
l
l
l
l
l
Führen Sie 2 VizQL-Serverprozesse aus.
Da die Hintergrundprozesse auf einem eigenen Computer ablaufen, konkurriert ihr
Arbeitsablauf nicht mit dem anderer Prozesse. Da der Computer nur für
Hintergrundprozesse vorgesehen ist und diese 100 % der CPU-Ressourcen
verbrauchen können, entspricht da untere Ende des vorgeschlagenen Bereichs der
Gesamtzahl der Kerne. Je nach dem Umfang der zu aktualisierenden Daten können
bestimmte Bereitstellungen bis zu doppelt so viele Hintergrundprozesse ausführen als
Kerne vorhanden sind und dennoch eine parallele Beschleunigung erzielen.
Da der Daten-Engine-Prozess alle CPU-Ressourcen auf einem Computer verbrauchen
kann, ist er auf seinem eigenen Computer isoliert.
Die Benutzerauslastungen für die Anwendungsserver- und Datenserverprozesse kann
in der Regel durch jeweils 1 Prozess gehandhabt werden, es sind aber 2 festgelegt, um
für Redundanz zu sorgen.
Unter den meisten Bedingungen verursachen der primäre Tableau Server und die
Daten-Engine keinen Engpass im Gesamtdurchsatz des Systems, solange eine
ausreichende Menge von CPU-Zyklen für sie vorhanden ist. Zur Erhöhung der
Ansichtkapazität können Sie Computer hinzufügen, die ausschließlich für den VizQLServerprozess vorgesehen sind. Zur Erhöhung der Aktualisierungskapazität für
Extrakte können Sie Computer hinzufügen, die ausschließlich für den
Hintergrundprozess vorgesehen sind.
Informationen zum clientseitigen Rendern
Markierungen und Daten einer Ansicht werden erst abgerufen, interpretiert und gerendert und
anschließend in einem Client-Webbrowser angezeigt. Tableau Server kann diese Schritte im
Client-Webbrowser oder auf dem Server ausführen. Das clientseitige Rendern ist der
Standardmodus. Wenn Sie das Rendern und alle Interaktionen auf dem Server ausführen,
kann es zu einer erhöhten Datenübertragung im Netzwerk und zu Umlaufzeitverzögerungen
kommen. Mit dem clientseitigen Rendern lassen sich die meisten Ansichtinteraktionen
schneller ausführen, da sie direkt vom Client interpretiert und gerendert werden.
Bestimmte Ansichten lassen sich jedoch effektiver auf einem Server rendern, der über eine
größere Rechenleistung verfügt. Das serverseitige Rendern macht bei einer komplexen
Ansicht Sinn, da Bilddateien wesentlich weniger Bandbreite beanspruchen als Daten, mit
denen die Bilder erstellt wurden. Da Tablet-PCs gewöhnlich eine geringere Leistung als PCs
haben, können sie nur weniger komplexe Ansichten optimal wiedergeben. Es kann
vorkommen, dass eine Ansicht, die über den Webbrowser des PCs geöffnet wird, vom Client
gerendert wurde. Wenn die gleiche Ansicht aber über den Webbrowser des Tablet-PCs
geöffnet wird, wird sie möglicherweise auf dem Server gerendert.
- 316 -
Tableau Server wurde so konfiguriert, dass diese Situationen unter Verwendung eines
Berechnung des Schwellenwerts oben automatisch als Auslöser für das Rendern einer
Ansicht auf dem Server anstatt im Webbrowser gesehen werden. Als Administrator können
Sie diese Einstellungen für PCs als auch für Tablet-PCs testen und feinabstimmen. Weitere
Informationen finden Sie in den folgenden Themen.
Anforderungen
l
l
Unterstützte Browser: Das clientseitige Rendern wird vom Internet Explorer ab
Version 9.0, von Firefox, Chrome und Safari unterstützt. Diese Webbrowser enthalten
das HTML5-Element <canvas>, das für das clientseitige Rendern verwendet wird.
Polygone, benutzerdefinierte Formen und Seitenverlauf: Wenn in einer Ansicht
Polygone, benutzerdefinierte Formen oder der Seitenverlauf verwendet wird, erfolgt ein
serverseitiges Rendern, auch wenn das clientseitige Rendern anderweitig aktiviert ist.
Berechnung des Schwellenwerts
Wenn das clientseitige Rendern aktiviert ist, bestimmt Tableau Server die Komplexität der
Ansicht anhand einer Berechnung. Wenn der Wert der Komplexität 100 (für PC-Browser)
oder 20 (für Tablet-PC-Browser) übersteigt, wird die Ansicht auf dem Server und nicht im
Webbrowser gerendert. Die Berechnung sieht folgendermaßen aus:
(# of marks) + 3(# of headers) + 3(# of annotations) + 3(# of
reference lines) = view complexity
Wenn Ihre Ansicht z. B. 2.000 Markierungen, 150 Kopfzeilen (dies lässt sich manchmal
bestimmen, indem Sie die Anzahl der Spalten und Zeilen in einer Ansicht hinzufügen), eine
Anmerkung und eine Referenzlinie aufweist, lautet die Gleichung:
2,000 + 3(150) + 3(1) + 3(1) = 2,456
Dividieren Sie dann den aktuellen Schwellenwert durch 100, multiplizieren Sie ihn mit 5.000
(die Division des Schwellenwerts durch 100 ist ein Normierungsfaktor und die Multiplikation mit
5.000 ein Skalierungsfaktor von Tableau). Angenommen, der aktuelle Schwellenwert ist 100,
so lautet die Gleichung:
100/100 * 5,000 = 5,000
Vergleichen Sie die beiden Summen. Wenn 5.000 einer Komplexität von 100 entspricht, dann
stellen 2.456 ungefähr die halbe Komplexität (49) dar. Daher müssen Sie den Schwellenwert
auf 48 setzen, um ein serverseitiges Rendern dieser bestimmten Ansicht in einem PCBrowser zu erreichen. Bedenken Sie, dass Interaktionen, wie das Filtern, die Komplexität der
Ansicht ändern können und dass bei einer Sitzung der Rendermodus geändert werden kann,
wenn sich die Komplexität der Ansicht ändert.
Weitere Informationen zum Testen und Konfigurieren des clientseitigen Renderns finden Sie
in den folgenden Themen.
Testen mit dem URL-Parameter
Solange die Voraussetzungen gegeben sind, nutzt Tableau Server standardmäßig das
clientseitige Rendern. Um das serverseitige Rendern je nach Sitzung zu testen, geben Sie
- 317 -
?:render=false am Ende der Ansichts-URL ein. Beispiel:
http://localhost/views/Supplies/MyView?:render=false
Wenn das clientseitige Rendern in Tableau Server deaktiviert ist, geben Sie
?:render=true ein, um es für die Sitzung zu aktivieren.
http://localhost/views/Supplies/MyView?:render=true
Sie haben auch die Möglichkeit, bestimmte Komplexitätsschwellenwerte oder einzelne
Ansichten zu testen, um festzustellen, ob es angebracht ist, den serverweiten Schwellenwert
für Ihren Server und Ihre Netzwerkbedingungen anzupassen. Sie erkennen wohlmöglich,
dass Umkipppunkte von niedriger Komplexität (wie 80) oder höherer Komplexität (wie 120) zu
einer besseren Reaktion auf die Benutzerinteraktionen führen. Um einen Schwellenwert zu
testen, behalten Sie die Standardkonfiguration des Servers bei (clientseitiges Rendern
aktiviert), und geben die Schwellenwerttestzahl am Ende der Ansichts-URL ein. Beispiel:
http://localhost/views/Supplies/MyView?:render=80
Konfiguration mit den tabadmin set-Optionen
Mit den tabadmin-Optionen vizqlserver.browser.render können Sie das clientseitige
Rendern deaktivieren oder aktivieren und mit vizqlserver.browser.render_
threshold und vizqlserver.browser.render_threshold_mobile die
Schwellenwerte für das clientseitige Rendern ändern. Nähere Informationen hierzu finden Sie
unter tabadmin set-Optionen Auf Seite 438.
Tableau Server-Prozesse
Die Standardkonfiguration der sechs vorhandenen Tableau-Serverprozesse kann geändert
werden, um andere Ergebnisse zu erzielen. Die Themen Verbessern der Serverleistung
Auf Seite 308 und Hochverfügbarkeit Auf Seite 158 beschreiben einige der möglichen
Ansätze. Der oberste Status eines jeden Prozesses wird auf der Wartungsseite des Servers
angezeigt. Weitere Einzelheiten zu einigen Prozessen, wie z B. dem Hintergrundprozess, sind
unter Verwaltungsansichten Auf Seite 265 zu finden.
Im Hinblick auf die Architektur verwendet die 64-Bit-Version von Tableau Server native 64-BitProzesse; die 32-Bit-Version von Tableau Server verwendet 32-Bit-Prozesse. Die Ausnahme
ist die Daten-Engine. Wenn die 32-Bit-Version von Tableau Server unter einem 64-BitBetriebssystem installiert wird, wird die 64-Bit-Version des Daten-Engine-Prozesses
verwendet.
Informationen zu den mit diesen Prozessen erstellten Dateien finden Sie unter Speicherorte
von Server-Protokolldateien Auf Seite 461.
Prozess
Dateiname
Zweck
Anwendungsser wgserver.exe Handhabt die
ver
- 318 -
Multithreade Leistungsmerkmale
d?
Ja
Verbraucht nur während
Prozess
Dateiname
Multithreade
d?
Zweck
Webanwendung,
unterstützt
Navigation und
Suche.
Hintergrund
backgrounder. Führt
Nein
exe
Serveraufgaben
aus, darunter
Extraktaktualisierun
gen, "Jetzt
ausführen"Aufgaben und über
tabcmd gestartete
Aufgaben
Daten-Engine
tdeserver64.ex Speichert
e
Datenextrakte und
tdeserver.exe beantwortet
Abfragen.
- 319 -
Ja
Leistungsmerkmale
seltener Vorgänge, wie z. B
beim Veröffentlichen einer
Arbeitsmappe mit einem
Extrakt oder beim Erstellen
eines statischen Bildes für
eine Ansicht, eine auffällige
Menge von Ressourcen.
Seine Auslastung kann
durch browserbasierte
Interaktion oder durch
tabcmd erstellt werden.
Ein Singlethread-Prozess,
bei dem mehrere Prozesse
auf einem beliebigen oder
auf allen Computern im
Cluster ausgeführt werden
können, um die Kapazität
zu erweitern. Die
Hintergrundprozesskompo
nente verbraucht
gewöhnlich nicht viel
Prozessspeicher, kann
jedoch je nach der ihr
präsentierten
Arbeitsauslastung CPU-,
I/O- oder
Netzwerkressourcen
verbrauchen.
Beispielsweise kann beim
Durchführen großer
Extrakt-Aktualisierungen
zum Abruf von Daten
Netzwerkbandbreite
verwendet werden. CPURessourcen können durch
Datenabruf- oder komplexe
tabcmd-Aufgaben
verbraucht werden.
Die Arbeitsauslastung der
Daten-Engine wird durch
Prozess
Datenserver
Dateiname
Multithreade
d?
Zweck
dataserver.exe Handhabt
Verbindungen zu
Tableau ServerDatenquellen.
- 320 -
Ja
Leistungsmerkmale
Anforderungen von dem
VizQL-Server-Vorgang
generiert. Es handelt sich
um die Komponente, die
Extrakte in den Speicher
lädt und Abfragen an ihnen
durchführt. Der
Speicherverbrauch basiert
hauptsächlich auf der
Größe der zu ladenden
Datenextrakte. Unter 64Bit-Betriebssystemen wird
standardmäßig die 64-BitBinärdatei verwendet,
selbst wenn die 32-BitVersion von Tableau Server
installiert ist. Die DatenEngine ist multithreaded
und kann mehrere
Anforderungen gleichzeitig
handhaben. Bei hoher
Auslastung kann sie CPU-,
I/O- und
Netzwerkressourcen
verbrauchen, was zu einem
Leistungsengpass führen
kann. Bei hoher Auslastung
kann eine einzige Instanz
der Daten-Engine sämtliche
CPU-Ressourcen zur
Verarbeitung von
Anforderungen in Anspruch
nehmen.
Da es sich um einen Proxy
handelt, ist er
normalerweise nur durch
das Netzwerk gebunden,
kann bei einer gewissen
Anzahl von gleichzeitigen
Benutzersitzungen jedoch
durch die CPU gebunden
Prozess
Dateiname
Multithreade
d?
Zweck
Repository
postgres.exe
In der Datenbank
k. A.
von Tableau Server
werden
Arbeitsmappen- und
Benutzer-Metadaten
gespeichert.
VizQL Server
vizqlserver.exe Lädt und stellt
Ja
Ansichten dar,
berechnet und führt
Abfragen durch
Leistungsmerkmale
sein. Seine Auslastung wird
durch browser- und
Tableau-Desktop-basierte
Interaktion und ExtraktAktualisierungsaufgaben
für Tableau ServerDatenquellen generiert.
Verbraucht in der Regel
wenige Ressourcen. In
seltenen Fällen kann es bei
sehr großen
Bereitstellungen (mit
Tausenden von Benutzern)
zu einem Engpass
kommen, während
Vorgänge wie die Ansicht
aller Arbeitsmappen nach
Benutzer oder das Ändern
von Berechtigungen
durchgeführt werden.
Verbraucht beim Laden von
Ansichten und bei der
interaktiven Verwendung
über einen Webbrowser
eine auffällige Menge von
Ressourcen. Kann CPUgebunden, E/A-gebunden
oder netzwerkgebunden
sein. Die
Prozessauslastung kann
nur durch browserbasierte
Interaktion erstellt werden.
Es kann sein, dass der
Prozessarbeitsspeicher
nicht ausreicht.
Erstellen einer Leistungsaufzeichnung
Mit der Leistungsaufzeichnungsfunktion in Tableau können Sie während der Interaktion mit
Arbeitsmappen Leistungsinformationen über Schlüsselereignisse aufzeichnen. Die
Leistungskennzahlen werden dann in einer von Tableau automatisch erstellten
- 321 -
Leistungsarbeitsmappe angezeigt. Die Schritte, die für die Erstellung und Anzeige einer
Leistungsaufzeichnung erforderlich sind, sind für Tableau Desktop und Tableau Server
unterschiedlich. Dennoch haben die erstellten Leistungsarbeitsmappen in Tableau Desktop
und Tableau Server das gleiche Format.
Verwenden Sie Leistungsarbeitsmappen für die Auswertung und Behandlung von
Leistungsproblemen, die verschiedene leistungsbeeinflussende Ereignisse betreffen,
darunter:
l
l
l
l
l
l
l
Ausführung von Abfragen
Geokodierung
Verbindung zu Datenquellen
Layoutberechnung
Extraktgenerierung
Datenverschmelzung
Rendern auf dem Server (nur Tableau Server)
Der Tableau-Support fordert Sie möglicherweise auf, Leistungsarbeitsmappen zu erstellen, da
diese als Unterstützung bei der Diagnose von Leistungsproblemen dienen.
So erstellen Sie eine Leistungsaufzeichnung in Tableau Server
Der Serveradministrator bestimmt, ob die Leistungsaufzeichnung auf Site-Ebene aktiviert
wird. Die Leistungsaufzeichnung ist auf der Standardsite oder anderen Sites, die Sie erstellen,
standardmäßig nicht aktiviert. Befolgen Sie die nachstehenden Schritte, um die
Leistungsaufzeichnung für eine Site zu aktivieren:
1. Betätigen Sie die Schaltfläche Admin in Tableau Server.
2. Wählen Sie Sites aus.
3. Wählen Sie eine Site.
4. Wählen Sie Bearbeiten aus.
5. Wählen Sie im Site bearbeiten-Dialogfeld Leistungsaufzeichnung zulassen aus.
6. Wählen Sie OK aus.
Sie starten die Leistungsaufzeichnung für eine bestimmte Ansicht, indem Sie ?:record_
performance=yes zur URL hinzufügen. Beispiel:
http://localhost/views/Variety/BaseballStatistics?:record_performance=yes
Als visuelle Bestätigung für den Aufzeichnungsstart erscheint der Befehl
Leistungsaufzeichnung einblenden in der Symbolleiste.
- 322 -
Wählen Sie Leistungsaufzeichnung einblenden aus, um eine Leistungsarbeitsmappe zu
öffnen, die eine Momentaufnahme der Leistungsdaten darstellt. Bei der weiteren Arbeit mit
einer Ansicht können Sie weiterhin zusätzliche Momentaufnahmen machen, die
Leistungsdaten sind kumulativ. Wenn Sie die Ansicht verlassen oder ?:record_
performance=yes aus der URL entfernen, stoppt die Aufzeichnung.
Interpretieren einer Leistungsaufzeichnung
Eine Leistungsaufzeichnungs-Arbeitsmappe ist ein Tableau-Dashboard mit drei Ansichten:
Zeitachse, Ereignisse und Abfrage.
Weitere Informationen zur Erstellung einer Leistungsaufzeichnung in Tableau Server finden
Sie unter Erstellen einer Leistungsaufzeichnung Auf Seite 321.
Zeitachse
Die oberste Ansicht im Dashboard einer Leistungsaufzeichnung zeigt die Ereignisse, die
während einer Aufzeichnung aufgetreten sind, in chronologischer Reihenfolge von rechts nach
links. Die untere Achse zeigt die seit dem Start von Tableau vergangene Zeit in Sekunden.
In der Zeitachsenansicht legen die Spalten Arbeitsmappe, Dashboard und Arbeitsblatt den
Kontext der Ereignisse fest. In der Spalte Ereignis wird die Natur des Ereignisses definiert,
und die letzte Spalte zeigt die Dauer jedes Ereignisses an und wie es in Beziehung zu den
anderen aufgezeichneten Ereignissen steht:
Ereignisse
Die mittlere Ansicht in der Leistungsaufzeichnungs-Arbeitsmappe zeigt die Ereignisse nach
ihrer Dauer geordnet (längste bis kürzeste). So können Sie herausfinden, an welcher Stelle
Sie zuerst nachsehen müssen, wenn Sie Ihre Arbeitsmappe beschleunigen möchten.
Verschiedene Farben kennzeichnen verschiedene Arten von Ereignissen. Der Bereich der
Ereignisse, die aufgezeichnet werden können, umfasst:
- 323 -
l
Berechnung der Layouts.
Wenn Layouts zu viel Zeit kosten, sollten Sie in Betracht ziehen, Ihre Arbeitsmappe zu
vereinfachen.
l
Verbindungsherstellung zur Datenquelle.
Langsame Verbindungen können durch Netzwerkprobleme oder Probleme mit dem
Datenbankserver entstehen.
l
Abfrage wird ausgeführt
Wenn Abfragen zu viel Zeit in Anspruch nehmen, sehen Sie in der Dokumentation Ihres
Datenbankservers nach.
l
Generierung des Extrakts.
Um die Extraktgenerierung zu beschleunigen, sollten Sie in Betracht ziehen, nur einige
Daten aus der Originaldatenquelle zu importieren. Sie können z. B. nach bestimmten
Datenfeldern filtern oder ein Beispiel anhand einer bestimmten Anzahl von Zeilen oder
Prozentanzahl von Daten erstellen.
l
Geokodierung.
Versuchen Sie, weniger Daten zu verwenden oder Daten zu filtern, um die
Geokodierungsleistung zu beschleunigen.
l
Datenverschmelzung.
Versuchen Sie, weniger Daten zu verwenden oder Daten zu filtern, um die
Datenverschmelzung zu beschleunigen.
l
Rendern auf dem Server.
Sie können das Rendern auf dem Server beschleunigen, indem Sie zusätzliche
VizQL Serverprozesse auf zusätzlichen Computern ausführen.
Abfrage
Wenn Sie entweder im Bereich Zeitachse oder Ereignisse eines LeistungsaufzeichnungsDashboards auf ein Abfrage wird ausgeführt-Ereignis klicken, wird der Text für diese
Abfrage im Abfragebereich angezeigt. Beispiel:
Manchmal ist die Abfrage abgeschnitten und Sie müssen in das Tableau-Protokoll schauen,
um die gesamte Abfrage anzuzeigen. Die meisten Datenbankserver können Ihnen Ratschläge
zur Optimierung einer Abfrage durch Hinzufügen von Indizes oder andere Methoden geben.
Weitere Informationen finden Sie in der Dokumentation des Datenbankservers.
- 324 -
Einbetten von Ansichten in Webseiten
Sie können interaktive Ansichten aus Tableau Server in Webseiten, Blogs, Wikis,
Webanwendungen und Intranetportale einbetten. Eingebettete Ansichten werden aktualisiert,
sobald sich die zugrunde liegenden Daten ändern oder die Arbeitsmappen auf dem Server
aktualisiert werden. Für eingebettete Ansichten gelten dieselben Einschränkungen hinsichtlich
Lizenzierung und Berechtigungen wie für den Server. Benutzer, die eine Webseite mit einer
eingebetteten Ansicht laden, benötigen im Allgemeinen auch ein Konto in Tableau Server.
Wenn Sie eine Core-basierte Lizenz verwenden, können Sie stattdessen Gast aktivieren
auswählen, um es Benutzern zu ermöglichen, die Ansicht ohne Anmeldung zu laden.
Sie haben die folgenden Möglichkeiten zum Einbetten von Ansichten:
l
l
l
Share-Einbettungscode verwenden: Der Link "Freigeben" am oberen Rand der
einzelnen Ansichten enthält eingebetteten Code, den Sie kopieren und in Ihre Webseite
einfügen können.
Eigenen Einbettungscode erstellen:Sie können den von Tableau bereitgestellten
Einbettungscode erweitern oder Ihren eigenen Code erstellen. In beiden Fällen können
Sie Parameter zur Steuerung von Symbolleisten, Registerkarten usw. verwenden.
TableauJavaScript API verwenden: Sie können Tableau JavaScript-Objekte in Ihrem
eigenen Webanwendungscode verwenden. Weitere Informationen dazu finden Sie
unter JavaScript API Auf Seite 479.
Damit Benutzer beim Klicken auf eine eingebettete Ansicht erfolgreich authentifiziert
werden können, müssen ihre Browser so konfiguriert sein, dass Cookies von
Drittanbietern zulässig sind.
Schreiben von Einbettungscode
Beim Schreiben von eigenem Einbettungscode können Sie einen von zwei Ansätzen
verfolgen:
l
l
Verwendung von Tableau JavaScript: Dies ist der bevorzugte Ansatz. Sie können
den von Tableau generierten Einbettungscode als Ausgangspunkt für eigenen Code
verwenden und Objektparameter hinzufügen oder bearbeiten, um Symbolleisten,
Registerkarten usw. zu steuern. Der Standardeinbettungscode, der auf einer Tableau
JavaScript-Datei beruht, ist zudem die einzige Möglichkeit, die Reihenfolge zu steuern,
in der mehrere eingebettete Ansichten geladen werden.
Geben Sie die Ansichts-URL an: Sie können eine Ansicht mit einem Iframe- oder
Image-Tag einbetten, wobei die URL der veröffentlichten Ansicht als Quelle dient. Sie
sollten so vorgehen, wenn Sie auf Ihrer Website kein JavaScript verwenden können. Es
gibt auch Situationen, in denen Sie lediglich eine URL angeben können, z. B. beim
Einbetten einer Ansicht mit dem Seiten-Viewer-Webpart von SharePoint.
Ungeachtet des gewählten Ansatzes, müssen Sie die Breite und Höhe zum Einbetten der
Ansicht definieren.
- 325 -
Tableau JavaScript
Der folgende Code zeigt ein Beispiel für eingebetteten Code, der beim Klicken auf "Freigeben"
in einer veröffentlichten Ansicht generiert wird. Sonderzeichen im Parameter host_url sind
URL-codiert, während Sonderzeichen in den Parametern site_root und name als HTMLReferenzen für numerische Zeichen angegeben werden.
<script type='text/javascript' srcc='http://myserver/javascripts/api/viz_v1.js'></script>
<div class='tableauPlaceholder' style='width:800; height:600;'>
<object class='tableauViz' width='800' height='600' style='display:none;'>
<param name='host_url' value='http%3A%2F%2Fmyserver%2F' />
<param name='site_root' value=&#47;t&#47;Sales' />
<param name='name' value='MyCoSales&#47;SalesScoreCard&#47;'
/>
<param name='tabs' value='yes' />
<param name='toolbar' value='yes' /></object></div>
Die Quelle für das <script>-Tag ist die URL für die Tableau Server JavaScript-Datei viz_
v1.js. Die JavaScript-Datei dient zum Zusammenstellen der vollständigen URL der Ansicht,
die für Ihre Benutzer angezeigt wird. Die Objektparameter name und site_root sind die
einzigen erforderlichen Parameter, alle anderen Parameter sind optional. Beispiele finden Sie
unter Liste der Einbettungsparameter Auf der nächsten Seite und "Script-Tag-Beispiele"im
Abschnitt Beispiele Auf Seite 334.
Ansichts-URL als Quelle
Es folgt ein Beispiel für das Einbetten der gleichen Ansicht mit einem IFrame-Tag, wobei die
URL der Ansicht als Quelle dient:
<iframe src="http://myserver/t/Sales/MyCoSales/SalesScoreCard
?:embed=yes&:tabs=yes&:toolbar=yes" width="800" heightt="600"></iframe>
Sie müssen den URL-Parameter embed angeben und können optionale Parameter angeben,
um beispielsweise die Symbolleiste und Wiederherstellungsoptionen zu steuern. Zudem
können Sie der URL Filter hinzufügen, um zu steuern, welche Daten in der geladenen Ansicht
angezeigt werden. Beispiele finden Sie unter Liste der Einbettungsparameter Auf der
nächsten Seite und unter "Iframe-Tag-Beispiele" im Abschnitt Beispiele Auf Seite 334.
Wenn Sie die URL der Ansicht für das iframe-Attribut src verwenden, schließen Sie
das Rautenzeichen und die Zahl ganz am Ende der URL aus. Verwenden Sie
beispielsweise MyCoSales/SalesScoreCard anstelle von
MyCoSales/SalesScoreCard#2.
- 326 -
Liste der Einbettungsparameter
Sie können zum Einbetten von Ansichten ein Iframe-Tag mit URL-Parametern oder ein
JavaScript-Tag mit Objektparametern verwenden. In der folgenden Tabelle werden beide
Parametersätze und deren Verwendung beschrieben.
ObjektURLWertParaparae
meter
meter
customV-:cuno
iews
stomViews
-
filter
Beschreibung
Beispiele
Blendet die
Option "Änderungen speichern" aus
<param name="customViews" valuee="no"/>
http://tabserver/views/DateTime/DateCalcs?:embed=yes&:customViews=no
:embed yes Für URL-Para- http://tabserver/views/DateTime/DateCalcs?:embed=yes
meter erforderlich.
Blendet den
oberen Navigationsbereich
aus, sodass
sich die
Ansicht besser
in die Webseite
einfügt.
string Passt an, was <param name="filter" valuee="Team=Blue"/>
beim Öffnen
der Ansicht
angezeigt wird.
Das Filtern
nach URLParametern ist
ebenfalls möglich. Weitere
Informationen
finden Sie in
den IframeTag-Beispielen
unter Hinzufügen von
Filtern Auf
Seite 334 und
Filtern nach
mehreren Feldern Auf Seite
- 327 -
Objektparameter
-
-
-
host_
url
URLParameter
Wert- Beschreie
bung
Beispiele
335.
:forpdf; Zeigt eine
mat
png Ansicht als
PDF- oder
.png-Datei an.
:highd- fals- Stellt eine
pi
e
Ansicht mithilfe
von StandardDPI (Dots Per
Inch) für die
Anzeige und
Geräte mit
hoher Auflösung dar.
:oriyes Wenn der
ginal_
name-Paraview
meter auf eine
Arbeitsmappen- oder
ArbeitsblattURL verweist
(und nicht explizit auf eine
benutzerdefinierte
Ansicht), wird
als Ansicht bei
Einschluss dieses Parameters die
ursprüngliche
Ansicht angezeigt, auch
wenn andere
benutzerdefinierte
Ansichten verfügbar sind.
string Der Servername, der
in der URL
http://tabserver/views/Sales/Q2?:format=pdf
http://tableauserver/views/Sales/Q2?:highdpi=false
<param name="filter" valuee=":original_view=yes"/>
<param name="host_url" valuee="http://myserver.bigco.com/">
- 328 -
Objektparameter
URLParameter
linktarget
angezeigt wird. <param name="host_url"
value="http://localhost/">
:link- string Der Ziel<param name="linktarget"
target
value="_blank"/>
fenstername
für externe
http://tabserver/views/DateHyperlinks.
Time/DateCalcs?:embed=yes&:linkt
loadorder
-
name
-
Wert- Beschreie
bung
Beispiele
arget=_blank
num- Wenn mehrere <param name="load-order" valueber
Ansichten ein- e="2"/>
gebettet werden, entspricht
die Standardladereihenfolge
der
Reihenfolge, in
der die Ansichten aufgelistet
werden. Mit dieser Einstellung
kann diese Reihenfolge außer
Kraft gesetzt
schrieben.
Negative Zahlen sind zulässig.
<param name="name"
string Für Objektvalue="MyCoSales/Sales"/>
parameter
erforderlich.
<param name="name"
Arbeitsvalue="MyCoSales/Sales/jsmith@my
mappen- und co.com/EastCoastSales"/>
Blattname und
optional eine
benutzerdefinierte
Ansicht (Benutzername@Domäne/
[benutzerdefinierter
- 329 -
Objektparameter
path
URLParameter
-
Wert- Beschreie
bung
Beispiele
Ansichtsname]). Wenn
Sie zur Bestätigung des
name-Parameters die
Tableau Server-URL heranziehen,
müssen Sie
das Rautenzeichen (#)
und die Zahl
am Ende der
URL weglassen.
string Nur für die vertrauenswürdige
Authentifizierung;
kann nicht mit
dem Parameter "ticket"
verwendet werden.Überschreibt
den Wert des
Parameters
"name" und
wird als URL
verwendet.
Weitere Informationen finden Sie unter
Beispiele für
die vertrauenswürdige
Authentifizierung.
<param name="path"
value="trusted/Etdpsm_Ew6rJY9kRrALjauU/views/workbookQ4/Sale
sQ4"/>
http://tableauserver/trusted/Etd
psm_Ew6rJY9kRrALjauU/views/workbookQ4/Sale
sQ4?:embed=yes:tabs=yes
- 330 -
Objektparameter
-
URLParameter
:refresh
:render
Wert- Beschreie
bung
Beispiele
http://tabserver/views/DateRendert die
Time/DaSeite neu.
Nähere Infor- teCalcs?:embed=yes&:refresh
mationen
hierzu finden
Sie unter
Aktualisieren
von Daten Auf
Seite 49.
true Wenn das cli- http://tabserver/views/Date;
entseitige Ren- Time/DateCalcs?:render=false
fals- dern aktiviert
e;
ist (Stannum- darber
deinstellung),
wird durch die
Einstellung auf
false das serverseitige Rendern für die
Sitzung
erzwungen.
Wenn das clientseitige Rendern
deaktiviert ist,
wird durch die
Einstellung
true das clientseitige Rendern für die
Sitzung aktiviert. Der Komplexitätsschwellenwert
kann mithilfe
einer Zahl
getestet werden. Weitere
Informationen
finden Sie
unter Infor-
- 331 -
Objektparameter
-
site_
root
URLParameter
:revert
-
Wert- Beschreie
bung
Beispiele
mationen
zum clientseitigen
Rendern Auf
Seite 316.
all; Stellt den
http://tabserver/views/Datefil- ursprünglichen Time/DateCalcs?:embed=yes&:revert=all
ter- Zustand des
s;
Elements wiesort- der her.
s;
axes;
shelves
<param name="site_root"
string Erforderlich.
Der Name der value="/t/Sales"/>
Website. Der
<param name="site_root"
Standardwert value=""/>
für die Website
ist Null
(value="
"). Wenn es
sich bei Ihrem
Server um
einen Server
mit mehreren
Sites handelt
und Sie die vertrauenswürdige
Authentifizierung verwenden
möchten, finden Sie weitere
Informationen
hierzu unter
Beispiele für
die ver-
- 332 -
Objektparameter
URLParameter
Wert- Beschreie
bung
Beispiele
trauenswürdige
Authentifizierung.
tabs
:tabs
yes; Registerkarten <param name="tabs" value="yes"/>
no
ein- oder ausblenden.
ticket
num- Nur für die ver- <param name="ticket"
value="Etdpsm_Ew6rJYber
trau9kRrALjauU"/>
enswürdige
Authenhttp://tableauserver/trusted/Etd
tifizierung;
psm_Ew6rJYkann nicht mit 9kRrALjauU/views/workbookQ4/Sale
dem ParasQ4?:embed=yes:tabs=yes
meter "path"
verwendet werden.Muss mit
dem Objekt
"name" zum
Erstellen der
URL zum Einlösen vertrauenswürdiger
Tickets
verwendet werden. Weitere
Informationen
finden Sie
unter Beispiele
für die vertrauenswürdige
Authentifizierung.
toolbar :tool- yes; Wenn dieser
<param name="toolbar"
bar
no; Parameter
value="top"/>
top nicht angehttp://tabserver/views/Dategeben wird,
Time/DateCalcs?:embed=yes&:toolb
wird die Sym- ar=no
bolleiste stan-
- 333 -
Objektparameter
URLParameter
Wert- Beschreie
bung
Beispiele
dardmäßig
unten angezeigt. Wenn no
angegeben
wird, wird die
Symbolleiste
nicht in die eingebettete
Ansicht aufgenommen.
Wenn top
angegeben
wird, wird die
Symbolleiste
über der
Ansicht angezeigt.
Beispiele
Es folgen einige Beispiele für Möglichkeiten, wie Sie Einbettungscode anpassen und einsetzen
können.
Hinzufügen von Filtern
Sie können Filterwerte übergeben, damit beim Öffnen der Ansicht nur die gewünschten Daten
angezeigt werden. Beispielsweise können Sie einen Hyperlink aus einem anderen Teil der
Webanwendung in eine eingebettete Ansicht zur Umsatzleistung einfügen, die nur eine
bestimmte Region darstellt. Wenn Sie die unveränderte URL zur Kennzeichnung des Werts
für den name-Parameter oder zum Erstellen der Iframe-Quelle verwenden, sollten Sie das
Rautenzeichen (#) und die Zahl am Ende der URL weglassen. Verwenden Sie beispielsweise
Sales/Sales-Performance und nicht Sales/Sales-Performance#1.
Script-Tag-Beispiel
<script type="text/javascript" srcc="http://myserver/javascripts/api/viz_v1.js">
</script>
<object class="tableauViz" width="800" height="600" style="display:none;">
<param name="host_url" value="http://myserver/" />
<param name="site_root" value="" />
<param name="name" value="Sales/Sales-Performance" />
- 334 -
<param name="filter" value="Region=East" />
</object>
Zur Übergabe mehrerer Filter trennen Sie die einzelnen Werte durch ein Komma voneinander.
Beispiel:
<param name="filter" value="Region=East,West" />
Iframe-Tag-Beispiele
<iframe src="http://myserver/views/CalculatedFields?:embed=yes&Region=East"width="800"
height="600"></iframe>
<iframe src="http://myserver/views/Sales/Sales-Performance?:embed=yes&Region=East,West" width="900px" heightt="700px"></iframe>
Filtern nach mehreren Feldern
Sie können Filter auf beliebig viele Felder anwenden, einschließlich Feldern, die nicht in der
ursprünglichen Ansicht enthalten sind.
Script-Tag-Beispiel
<script type="text/javascript" srcc="http://myserver/javascripts/api/viz_v1.js">
</script>
<object class="tableauViz" width="800" height="600" style="display:none;">
<param name="host_url" value="http://myserver/" />
- 335 -
<param name="site_root" value="" />
<param name="name" value="Sales/Sales-Performance" />
<param name="filter" value="Region=East,West&Customer Segment=Consumer,HomeOffice" />
</object>
Iframe-Tag-Beispiel
<iframe src="http://myserver/views/CalculatedFields?:embed=yes&Region=East,West&Customer
Segment=Consumer,Home Office" width="800" height="600"></iframe>
Wenn ein Filterwert ein Sonderzeichen enthält, wie z. B. ein Komma, ersetzen Sie das
Sonderzeichen durch die URL-Kodierungssequenz für \ (umgekehrter Schrägstrich,
%5c) gefolgt von der URL-Kodierungssequenz für das Sonderzeichen. Der
umgekehrte Schrägstrich wird als Escapezeichen für das Komma benötigt. Die URLKodierungssequenz für \, (umgekehrter Schrägstrich, Komma) lautet beispielsweise
%5c%2c. Wenn Sie die unveränderte URL zur Kennzeichnung des Werts für den
name-Parameter oder zum Erstellen der Iframe-Quelle verwenden, sollten Sie das
Rautenzeichen (#) und die Zahl am Ende der URL weglassen. Verwenden Sie
beispielsweise Sales/Sales-Performance und nicht Sales/SalesPerformance#1.
Filtern von Datumsangaben und Uhrzeiten/views/Date-Time/DateCalcs.
Wenn Sie nach den Werten eines Datums-/Uhrzeitfeld filtern möchten, geben Sie den Wert in
dem unten gezeigten Tableau-Standardformat an:
yyyy-mm-dd hh:mm:ss
- 336 -
Der Zeitanteil wird im 24-Stundenformat angegeben. In vielen Datenbanken werden
Datumswerte als Datetime-Felder gespeichert. Daher sollten Sie einen Uhrzeitwert
zusammen mit dem Datum übergeben.
Script-Tag-Beispiel
<script type="text/javascript" srcc="http://myserver/javascripts/api/viz_v1.js"></script>
<object class="tableauViz" width="800" height="600" style="display:none;">
<param name="host_url" value="http://myserver/" />
<param name="site_root" value="" />
<param name="name" value="Sales/Sales-Performance" />
<param name="filter" value="Date=2012-12-01" />
</object>
In diesem Beispiel wird sowohl ein Datumsfeld als auch ein Datetime-Feld im Filter verwendet.
<param name="filter" value="2012-12-01%2022:18:00" />
Iframe-Tag-Beispiel
<iframe src="http://myserver/Sales/SalesPerformance?:embed=yes&Date=2008-12-01%2022:18:00" width="800"
height="600"></iframe>
Um nach mehreren Datumsangaben zu filtern, trennen Sie die einzelnen Datumsangaben
jeweils durch ein Komma voneinander.
Wenn Sie die unveränderte URL zur Kennzeichnung des Werts für den name-Parameter oder
zum Erstellen der Iframe-Quelle verwenden, sollten Sie das Rautenzeichen (#) und die Zahl
am Ende der URL weglassen. Verwenden Sie beispielsweise Sales/SalesPerformance und nicht Sales/Sales-Performance#1.
Filtern von Kennzahlen
Sie können nach Kennzahlen filtern, indem Sie einen oder mehrere Werte angeben.
Operatoren wie "größer als", "kleiner als" und Bereiche werden nicht unterstützt. Im Beispiel
unten werden die Daten so gefiltert, dass nur Umsätze in Höhe von $100 und $200 angezeigt
werden.
Script-Tag-Beispiel
<script type="text/javascript" srcc="http://myserver/javascripts/api/viz_v1.js">
</script>
<object class="tableauViz" width="800" height="600 "style="display:none;">
<param name="host_url" value="http://myserver/" />
- 337 -
<param name="site_root" value="" />
<param name="name" value="Sales/Sales-Performance" />
<param name="filter" value="Profit=100, 200" />
</object>
Iframe-Tag-Beispiel
<iframe src="http://myserver/Sales/Sales-Performance?:embed=yes&Profit=100,200" width="800" heightt="600"></iframe>
Wenn Sie die unveränderte URL zur Kennzeichnung des Werts für den name-Parameter oder
zum Erstellen der Iframe-Quelle verwenden, sollten Sie das Rautenzeichen (#) und die Zahl
am Ende der URL weglassen. Verwenden Sie beispielsweise Sales/SalesPerformance und nicht Sales/Sales-Performance#1.
Steuern der Ladereihenfolge mehrerer Ansichten
Sie können steuern, in welcher Reihenfolge mehrere Ansichten für die Personen, die mit Ihren
Ansichten arbeiten, geladen werden. Auf diese Code kann nur über Einbettungscode, der auf
der Tableau JavaScript-Datei beruht, zugegriffen werden.
Im folgenden Beispiel werden zwei Ansichten eingebettet. Die zweite Ansicht wird zuerst
geladen, danach wird die obere Ansicht geladen. Wenn Sie mehrere Ansichten einbetten und
ihnen den gleichen Ladereihenfolgenwert zuweisen oder wenn Sie keine
Ladenreihenfolgenparameter angeben, dann werden die Ansichten in der Reihenfolge
geladen, in der sie auf der Seite erscheinen.
Script-Tag-Beispiel
<script type="text/javascript" srcc="http://myserver/javascripts/api/viz_v1.js">
</script>
<object class="tableauViz" width="600" height="400" style="display:none;">
<param name="host_url" value="http://myserver/" />
<param name="site_root" value="" />
<param name ="name" value="MyCoSales/TopPerformers" />
<param name="tabs" value="yes" />
<param name="toolbar" value="yes" />
<param name="filter" value="Salesperson=Top 5" />
<param name="load-order" value="0" />
</object>
<script type="text/javascript" srcc="http://myserver/javascripts/api/viz_v1.js">
</script>
<object class="tableauViz" width="600" height="400" style="display:none;">
- 338 -
<param
<param
<param
<param
<param
<param
</object>
name="host_url" value="http://myserver/" />
name="site_root" value="" />
name="name" value="MyCoSales/SalesScoreCard" />
name="tabs" value="yes" />
name="toolbar" value="yes" />
name="load-order" value="-1" />
Einbettungscode für benutzerdefinierte Ansichten
Wenn Sie eine Ansicht einer Arbeitsmappe oder eines Arbeitsblatts mit verfügbaren
benutzerdefinierten Ansichten einbetten:
l
l
l
Wenn die URL des Einbettungscodes für die Ansicht explizit auf eine benutzerdefinierte
Ansicht verweist, wird standardmäßig diese Ansicht angezeigt.
Wenn die URL des Einbettungscodes nicht explizit auf eine benutzerdefinierte Ansicht
verweist und eine standardmäßige benutzerdefinierte Ansicht definiert wurde, wird in
der eingebetteten Ansicht standardmäßig die standardmäßige benutzerdefinierte
Ansicht angezeigt.
Wenn keine standardmäßige benutzerdefinierte Ansicht definiert wurde, wird in der eingebetteten Ansicht standardmäßig die ursprüngliche Ansicht angezeigt.
Hinweis: Um sicherzustellen, dass in einer eingebetteten Ansicht standardmäßig die
ursprüngliche Ansicht angezeigt wird, darf die Einbettungscode-URL für den nameParameter nicht explizit auf eine benutzerdefinierte Ansicht verweisen und muss im
Einbettungscode den folgenden filter-Parameter enthalten: <param
name='filter' value=':original_view=yes'/>.
Im folgenden Beispiel zeigt der Einbettungscode stets die ursprüngliche Ansicht des
Arbeitsblatts "Profit Analysis" in der Arbeitsmappe "Profit Analysis" an, da der filterParameter auf :original_yes festgelegt ist und der name-Parameter in der URL für das
Arbeitsblatt auf keine bestimmte benutzerdefinierte Ansicht verweist.
<script type='text/javascript' srcc='http://mysite.myserver.com/javascripts/api/viz_v1.js'></script>
<div class='tableauPlaceholder' style='width: 1496px; height:
749px;'>
<object class='tableauViz' width='1496' height='749' style='display:none;'>
<param name='host_url' value='mysite.myserver.com' />
<param name='site_root' value='' />
<param name='name' value='ProfitAnalysis/ProfitAnalysis' />
<param name='tabs' value='yes' />
- 339 -
<param name='toolbar' value='yes' />
<param name='filter' value=:original_view=yes' /></object></div>
In diesem Beispiel verweist die Einstellung für den name-Parameter auf die URL für die
benutzerdefinierte Ansicht "Furniture" (im Arbeitsblatt "Profit Analysis" der Arbeitsmappe
"Profit Analysis").
<script type='text/javascript' srcc='http://mysite.myserver.com/javascripts/api/viz_v1.js'></script>
<div class='tableauPlaceholder' style='width: 1496px; height:
749px;'>
<object class='tableauViz' width='1496' height='749' style='display:none;'>
<param name='host_url' value='mysite.myserver.com' />
<param name='site_root' value='' />
<param name='name' valuee='ProfitAnalysis/ProfitAnalysis/Furniture' />
<param name='tabs' value='yes' />
<param name='toolbar' value='yes' /></object></div>
In diesem Beispiel verweist der name-Parameter in der URL für das Arbeitsblatt auf keine
bestimmte benutzerdefinierte Ansicht, und der original_view-Parameter wurde nicht
angegeben.Der Einbettungscode zeigt hier die benutzerdefinierte Ansicht an, die im
Arbeitsblatt "Profit Analysis" der Arbeitsmappe "Profit Analysis" als Standard festgelegt wurde.
Wenn die ursprüngliche Ansicht jedoch noch als Standard eingestellt ist (d. h., wenn keine
andere benutzerdefinierte Ansicht als Standard eingestellt wurde), wird die ursprüngliche
Ansicht als Standardansicht angezeigt.
<script type='text/javascript' srcc='http://mysite.myserver.com/javascripts/api/viz_v1.js'></script>
<div class='tableauPlaceholder' style='width: 1496px; height:
749px;'>
<object class='tableauViz' width='1496' height='749' style='display:none;'>
<param name='host_url' value='mysite.myserver.com' />
<param name='site_root' value='' />
<param name='name' value='ProfitAnalysis/ProfitAnalysis' />
<param name='tabs' value='yes' />
<param name='toolbar' value='yes' /></object></div>
- 340 -
Einbetten von Ansichten in Wikis
Ansichten können Sie einfach in ein Wiki oder eine andere Webseite einbetten, indem Sie die
Ansicht in ein <iframe>-Tag einfügen.
1. Navigieren Sie zu dem Wiki, in das Sie eine Ansicht einbetten möchten.
2. Bearbeiten Sie die Seite, und fügen Sie ein <iframe>-Tag ein, wobei als Quelle die
URL der Ansicht, aber nicht das Rautezeichen samt der Zahl am Ende der URL
anzugeben ist. Beispiel:
<iframe src="http://tableauserver/views/Date-Time/DateCalcs?:embed=yes&:toolbar=no" width="800" heightt="600"></iframe>
3. Speichern Sie Ihre Änderungen.
Die Ansicht wird in die Wiki-Seite eingebettet.
Wenn sowohl Tableau Server als auch Wiki für die Verwendung von Microsoft SSPI
konfiguriert wurden, dann werden Benutzer, die im Wiki auf die eingebettete Ansicht
zugreifen, automatisch angemeldet, sodass sie die Ansicht sehen können.
Wenn Server und Wiki nicht die gleiche Authentifizierungsmethode verwenden, werden
die Benutzer zuerst aufgefordert, sich beim Server anzumelden, bevor sie die Ansicht
sehen können.
Einbetten von Bildern
Sie können Ansichten nicht nur in ein <script> oder <iframe>-Tag einbetten, sondern
können eine Ansicht auch als Bild einbetten. Eine als Bild eingebettete Ansicht ist nicht
interaktiv, allerdings wird sie jedes Mal aktualisiert, wenn die gesamte Seite geladen wird. Das
Bild zeigt daher auch dann die aktuellsten Daten, wenn sich die zugrunde liegenden Daten
ändern.
- 341 -
1. Navigieren zu der Seite, in die Sie das Bild einbetten möchten.
2. Bearbeiten Sie die Seite, und fügen Sie ein <img>-Tag ein, wobei als Quelle die URL
der Ansicht und die Dateinamenerweiterung ".png" (aber nicht das Rautenzeichen und
die Zahl) angegeben werden. Beispiel:
<img src="http://tableauserver/views/Date-Time/DateCalcs.png"
width="900" height="700">
Hinweis:
Aufgrund einer vorläufigen Produktbeschränkung funktioniert das oben beschriebene
Verfahren nur, wenn sich der Benutzer, der auf das eingebettete Bild zugreift, gleichzeitig in
einer aktiven Webbrowsersitzung mit Tableau Server befindet und über Microsoft SSPI bei
Tableau Server angemeldet ist.
Einbetten von Ansichten in SharePoint (Microsoft SSPI)
Sie können eine Tableau Server-Ansicht in eine SharePoint-Seite einbetten. Für die
automatische Authentifizierung von Tableau Server-Benutzern, die auf die eingebettete
Ansicht zugreifen, gibt es zwei Möglichkeiten. Beide hängen davon ab, welche
Benutzerauthentifizierungsmethode bei der Installation von Tableau Server gewählt wurde.
Sie können entweder Active Directory mit Automatische Anmeldung aktivieren (auch
bekannt als Microsoft SSPI) oder die lokale Authentifizierung verwenden, um Tableau
Server-Benutzer zu authentifizieren. Zudem können Sie Tableau Server für die
vertrauenswürdige Authentifizierung konfigurieren.
In diesem Thema wird die erste Möglichkeit behandelt, bei der Microsoft SSPI von Tableau
Server und SharePoint genutzt wird. Wenn Tableau Server mit der Option Lokale
Authentifizierung arbeitet, finden Sie Informationen zur Vorgehensweise unter Einbetten
von Ansichten in SharePoint (lokale Authentifizierung) Auf Seite 345.
Anforderungen
Lizenzierte Benutzer: Jeder, der auf eine eingebettete Ansicht zugreift, muss ein für Tableau
Server lizenzierter Benutzer sein.
SharePoint-Version: SharePoint 2013 ist erforderlich, um Tableau Server-Ansichten in
SharePoint-Seiten einzubetten. Diese Version von SharePoint verwendet Microsoft .NET
Framework Version 4.5, die die Sicherheitsanforderungen von Tableau Server erfüllt.
Einbetten einer Ansicht in SharePoint
Führen Sie die folgenden Schritte aus, um mit dem Seiten-Viewer-Webpart von SharePoint
eine Ansicht in eine SharePoint-Seite einzubetten.
1. Navigieren Sie zu der SharePoint-Seite, in die Sie eine Ansicht einbetten möchten (es
muss sich um eine Seite des Typs Webpartseite handeln).
2. Wählen Sie im Menü "Websiteaktionen" oben links auf der Seite die Option Seite
bearbeiten.
3. Klicken Sie in dem Abschnitt der Seite, in dem Sie die Ansicht einbetten möchten, auf
- 342 -
Webpart hinzufügen.
4. Wählen Sie unter "Kategorien" die Option TableauEmbeddedView im Ordner
Miscellaneous oder Custom, und klicken Sie auf Hinzufügen.
5. Zurück auf der SharePoint-Seite wählen Sie im Menü "Bearbeiten" die Option Webpart
bearbeiten für das neue Webpart.
6. Am rechten Rand der Seite können Sie die Attribute des Seiten-Viewer-Webparts
angeben. Geben Sie die URL für die Ansicht ein, die eingebettet werden soll. Lassen
Sie dabei aber das Rautenzeichen (#) und die Zahl am Ende der URL weg. Verwenden
Sie das in Einbetten von Ansichten in Webseiten Auf Seite 325 beschriebene
Format. Beispielsweise können Sie Folgendes eingeben:
http://tableauserver/views/Date-Time/DateCalcs?:embed=yes&:toolbar=no
- 343 -
7. Im Abschnitt "Darstellung" können Sie einen Titel für das Webpart sowie die Höhe und
Breite angeben. Im Allgemeinen sollten Sie eine feste Höhe angeben (z. B. 700 Pixel)
und die Breite an die Größe des Bereichs anpassen.
8. Klicken Sie auf OK, um die Änderungen zu übernehmen und den Bearbeitenmodus zu
beenden.
Die Ansicht wird in das Webpart eingebettet, das Sie gerade erstellt haben. Die
Benutzer müssen sich nicht bei Tableau Server anmelden, um die eingebettete Ansicht
- 344 -
sehen zu können. Stattdessen werden sie automatisch über Microsoft SSPI
authentifiziert.
Einbetten von Ansichten in SharePoint (lokale Authentifizierung)
Sie können eine Tableau Server-Ansicht in eine SharePoint-Seite einbetten. Wenn in Tableau
Server die lokale Authentifizierung als Benutzerauthentifizierungsmethode verwendet wird,
sind vor dem Einbetten von Ansichten einige zusätzliche Schritte erforderlich. Diese Schritte
dienen unter anderem dazu, Tableau Server-Benutzer gegenüber SharePoint zu
identifizieren. Tableau stellt diese Funktion über die Ergänzungsdateien
TableauEmbeddedView.dll und TableauEmbeddedView.wsp bereit. In diesem Thema
werden die Installation und Bereitstellung dieser Dateien, das Testen der Konfiguration und
das Einbetten einer Ansicht mit einem SharePoint-Webpart beschrieben. Wenn Sie Active
Directory als Benutzerauthentifizierungsmethode verwenden, sind diese zusätzlichen Schritte
nicht erforderlich, da Active Directory und SharePoint ja Microsoft SSPI nutzen. Sie können
also sofort mit dem Einbetten anfangen. Informationen zur Vorgehensweise finden Sie unter
Einbetten von Ansichten in SharePoint (Microsoft SSPI) Auf Seite 342.
Anforderungen
Lizenzierte Benutzer und übereinstimmende Benutzernamen: Jeder Benutzer, der auf
eine eingebettete Ansicht zugreift, muss ein lizenzierter Benutzer von Tableau Server sein,
und sein SharePoint-Benutzername muss mit seinem Tableau Server-Benutzernamen
identisch sein.
SharePoint-Version: SharePoint 2013 ist erforderlich, um Tableau Server-Ansichten in
SharePoint-Seiten einzubetten. Diese Version von SharePoint verwendet Microsoft .NET
Framework Version 4.5, die die Sicherheitsanforderungen von Tableau Server erfüllt.
Bearbeiten von Sicherheitsberechtigungen für die DLL
Im ersten Schritt müssen die Sicherheitsberechtigungen für die DLL-Datei bearbeitet werden,
damit sie von allen Benutzern des Betriebssystems verwendet werden kann.
1. Suchen Sie die zusammen mit Tableau Server installierten Dateien
TableauEmbeddedView.dll und TableauEmbeddedView.wsp:
C:\Program Files\Tableau\Tableau
Server\8.3\extras\embedding\sharepoint\
2. Kopieren Sie die Dateien in das Stammverzeichnis Ihres SharePoint-Servers. Das
Stammverzeichnis befindet sich üblicherweise unter
C:\Inetpub\wwwroot\wss\VirtualDirectories\<port>\bin. Beispiel:
C:\Inetpub\wwwroot\wss\VirtualDirectories\80\bin
Die restlichen Schritte und alle folgenden Erläuterungen beziehen sich allein auf die
DLL-Datei.
3. Bearbeiten Sie die Sicherheitsberechtigungen für TableauEmbeddedView.dll. Klicken
Sie mit der rechten Maustaste darauf, und wählen Sie Eigenschaften > Sicherheit.
4. Wählen Sie unter Gruppen- oder Benutzernamen die Option Jeder, und klicken Sie
- 345 -
dann auf Bearbeiten.
5. Wählen Sie unter Berechtigungen für alle für die Berechtigung Vollzugriff die Option
Zulassen.
6. Klicken Sie auf OK.
- 346 -
Installation und Bereitstellung der WSP-Datei
Mit den oben erläuterten Schritten haben Sie allen Benutzern des Betriebssystems die
Berechtigung zur Verwendung der DLL-Datei eingeräumt. In den folgenden Schritten geben
Sie an, wie die DLL-Datei in SharePoint verwendet wird. Dies wird mit der Datei
TableauEmbeddedView.wsp festgelegt. Diese Datei haben Sie in Schritt 2 unter Bearbeiten
von Sicherheitsberechtigungen für die DLL Auf Seite 345 kopiert. So gehen Sie zur
Installation und Bereitstellung der WSP-Datei vor:
1. Öffnen Sie als Administrator eine Eingabeaufforderung.
2. Navigieren Sie zu dem folgenden Ordner:
C:\Program Files (x86)\Common Files\Microsoft Shared\Web Server Extensions\14\BIN
3. Führen Sie zum Hinzufügen der WSP-Datei den folgenden Befehl aus:
stsadm -o addsolution -filename
"C:\Inetpub\wwwroot\wss\VirtualDirectories\80\bin\TableauEmbe
ddedView.wsp"
4. Führen Sie danach den folgenden Befehl aus, um die Datei bereitzustellen. Ersetzen
Sie in dem Befehl http://<your SharePoint site>/ durch das
Stammverzeichnis der SharePoint-Site wie http://mySharePoint/.
stsadm -o deploysolution -name TableauEmbeddedView.wsp
http://<your SharePoint Site>/ -local -force -allowgacdeployment
-url
5. Aktivieren Sie zuletzt die Webpartfunktion, indem Sie den folgenden Befehl ausführen:
stsadm -o activatefeature -name TableauEmbeddedView_Feature1
-url http://<your SharePoint Site>/
Überprüfen der Webpartbereitstellung
Nach der Installation und Bereitstellung der Datei TableauEmbeddedView.wsp überprüfen
Sie die Einstellungen folgendermaßen:
1. Öffnen Sie die SharePoint-Website in einem Webbrowser. Es dauert unter Umständen
einige Augenblicke, bis die Website angezeigt wird.
2. Wählen Sie in der Liste Websiteaktionen die Option Websiteeinstellungen.
3. Wählen Sie unter Galerien die Option Webparts.
- 347 -
4. Vergewissern Sie sich, dass TableauEmbeddedView aufgeführt ist.
5. Navigieren Sie wieder zu Websiteeinstellungen, und wählen Sie unter
Websitesammlungsverwaltung die Option Websitesammlungsfeatures.
Vergewissern Sie sich, dass TableauEmbeddedView Feature den Status Aktiv
aufweist.
Einbetten einer Ansicht mit dem Webpart
Jetzt können Sie eine Ansicht in eine SharePoint-Seite einbetten:
1. Navigieren Sie zu der SharePoint-Seite, in die Sie eine Ansicht einbetten möchten (es
muss sich um eine Seite des Typs Webpartseite handeln).
2. Wählen Sie im Menü "Websiteaktionen" oben links auf der Seite die Option Seite
- 348 -
bearbeiten.
3. Klicken Sie in dem Abschnitt der Seite, in dem Sie die Ansicht einbetten möchten, auf
Webpart hinzufügen.
4. Wählen Sie unter "Kategorien" die Option TableauEmbeddedView im Ordner
Miscellaneous oder Custom, und klicken Sie auf Hinzufügen.
5. Zurück auf der SharePoint-Seite wählen Sie im Menü "Bearbeiten" die Option Webpart
bearbeiten für das neue Webpart.
6. Am rechten Rand der Seite können Sie die Attribute des Webparts
TableauEmbeddedView angeben. Geben Sie den Namen Ihres Tableau Servers und
anschließend den Pfad der Ansicht ein, die Sie einbetten möchten. Sie können
beispielsweise /views/Date-Time/DateCalcs eingeben (ohne das
Rautenzeichen (#) und die Zahl am Ende der URL).
- 349 -
7. Legen Sie andere Attribute fest, z. B. ob die Symbolleiste angezeigt werden soll oder ob
die Ansicht als Bild statt als interaktive Ansicht eingebettet werden soll.
8. Im Abschnitt Darstellung können Sie einen Titel für das Webpart sowie die Höhe und
Breite angeben. Im Allgemeinen sollten Sie eine feste Höhe angeben (z. B. 700 Pixel)
und die Breite an die Größe des Bereichs anpassen.
9. Klicken Sie auf OK, um die Änderungen zu übernehmen und den Bearbeitenmodus zu
beenden.
Jetzt ist die Ansicht in die Seite eingebettet, und Benutzer, die darauf zugreifen, werden
automatisch mit Ihrem für SharePoint festgelegten Benutzernamen und Kennwort
angemeldet. Jeder Benutzer, der auf eine eingebettete Ansicht zugreift, muss ein
lizenzierter Benutzer von Tableau Server sein, und sein SharePoint-Benutzername
muss mit seinem Tableau Server-Benutzernamen identisch sein.
Dies ist ein Beispiel dafür, wie Ansichten mithilfe der bereitgestellten DLL-Datei in
SharePoint eingebettet werden. Sie können Ansichten auch in andere Arten von
Webanwendungen einbetten. Weitere Informationen hierzu finden Sie unter
JavaScript API Auf Seite 479.
- 350 -
Proxyserver
Tableau Server kann für die Verwendung eines Proxyservers konfiguriert werden. In dieser
Art von Umgebung fungiert der Proxyserver als Zwischenglied zwischen Tableau Server und
den Clients, die von Tableau Server Ressourcen anfordern. Proxyserver können auf
verschiedene Weise konfiguriert werden, beispielsweise als Forward-Proxy oder ReverseProxy. In diesen Themen wird vorausgesetzt, dass Sie den Proxyserver bereits konfiguriert
haben und den Proxyserver jetzt Tableau Server gegenüber identifizieren müssen.
Hinweis:Wenn Sie die Kerberos-Authentifizierung verwenden, müssen Sie Tableau
Server vor der Konfiguration von Tableau Server für Kerberos für Ihren Proxy
konfigurieren. Weitere Informationen finden Sie unter Konfigurieren von Kerberos
Auf Seite 296.
Weitere Informationen finden Sie in den folgenden Themen:
Vorbereiten der Konfiguration für eine Proxy-Umgebung
Um Tableau Server für die Zusammenarbeit mit einem Proxy konfigurieren zu können,
benötigen Sie die folgenden Daten über Ihren Proxyserver:
l
l
l
l
IP-Adresse: Die IP-Adresse des Proxyservers.Die Adresse muss im IPv4-Format
angegeben werden, beispielsweise 123.45.67.890, und es muss sich um eine statische
IP handeln.
FQDN: Der vollständig qualifizierte Domänenname des Proxyservers. Beispiel:
bigbox.myco.com.
Nicht-FQDN: Alle nicht vollständig qualifizierte Domänennamen des Proxyservers. Im
obigen Beispiel wäre der nicht vollständig qualifizierte Domänenname des Proxyservers
bigbox.
Aliase: Alle Aliasnamen des Proxyservers. Aliase werden mit CNAME-Datensätzen
(Canonical Name) zugewiesen. Ein Beispiel hierfür wäre ein Proxyserver mit dem
kanonischen Namen (CNAME) bigbox.myco.com und den Aliasnamen ftp.myco.com
und www.myco.com.
Apache-Reverse-Proxyserver werden nicht unterstützt, wenn Tableau Server SSPI
(Active Directory mit Automatische Anmeldung aktivieren) zur Authentifizierung von
Tableau Server-Benutzern verwendet. Apache-Reverse-Proxyserver werden
unterstützt, wenn Tableau Server zur Authentifizierung von Server-Benutzern nur
Active Directory (ohne Automatische Anmeldung aktivieren), lokale
Authentifizierung oder SAML verwendet.
- 351 -
Konfigurieren von Tableau für die Verwendung eines Proxyservers
Nachdem Sie die in Vorbereiten der Konfiguration für eine Proxy-Umgebung Auf der
vorherigen Seite beschriebenen Informationen erfasst haben, können Sie Tableau Server für
die Zusammenarbeit mit einem Proxy konfigurieren, indem Sie die folgenden Schritte
ausführen. Weitere Informationen zu den unten beschriebenen Einstellungen finden Sie unter
tabadmin set-Optionen Auf Seite 438.
1. Halten Sie den Server an.
2. Geben Sie noch im BIN-Verzeichnis von Tableau Server den folgenden Befehl ein,
wobei name für die URL steht, die zum Erreichen von Tableau Server über den ProxyServer dient:
tabadmin set gateway.public.host "name"
Wenn Tableau Server beispielsweise durch Eingabe von tableau.example.com in
die Adressleiste eines Browsers erreicht wird, geben Sie folgenden Befehl ein:
tabadmin set gateway.public.host "tableau.example.com"
3. Standardmäßig wird in Tableau davon ausgegangen, dass der Proxyserver Port 80 auf
externe Datenübertragungen überwacht. Wenn Sie einen anderen Port zuweisen
möchten, geben Sie folgenden Befehl ein, wobei port_number für den Port steht:
tabadmin set gateway.public.port "port_number"
4. Geben Sie nun folgenden Befehl ein, wobei server für die IPv4-Adresse oder den
Computernamen des Proxyservers steht:
tabadmin set gateway.trusted "server"
Bei dem Wert für server kann es sich um eine Liste mit Kommas als Trennzeichen
handeln, beispielsweise:
tabadmin set gateway.trusted "123.45.67.890, 123.45.67.880,
123.45.67.870"
oder
tabadmin set gateway.trusted "proxy1, proxy2, proxy3"
5. Im nächsten Befehl geben Sie alternative Namen für den Proxyserver an, zum Beispiel
seinen vollständig qualifizierten Domänennamen, alle nicht vollständig qualifizierten
Domänennamen und Aliasnamen. Dies sind die Namen, die die Benutzer in einen
Browser eingeben können. Trennen Sie die einzelnen Namen jeweils durch ein Komma
voneinander:
tabadmin set gateway.trusted_hosts "name1, name2, name3"
Beispiel:
tabadmin set gateway.trusted_hosts "proxy1.example.com,
proxy1, ftp.example.com, www.example.com"
6. Starten Sie den Server, damit die Änderungen wirksam werden.
- 352 -
Vertrauenswürdige Authentifizierung
Wenn Tableau Server-Ansichten in Webseiten eingebettet werden, muss jeder, der die Seite
besucht, ein lizenzierter Tableau Server-Benutzer sein. Wenn Benutzer die Seite aufrufen,
werden sie aufgefordert, sich bei Tableau Server anzumelden, bevor die Ansicht angezeigt
wird. Wenn Sie die Benutzer einer Webseite oder Webanwendung bereits authentifizieren,
können Sie diese Eingabeaufforderung vermeiden und den Benutzern eine zweimalige
Anmeldung ersparen, indem Sie die vertrauenswürdige Authentifizierung einrichten.
Vertrauenswürdige Authentifizierung bedeutet einfach, dass eine vertrauenswürdige
Beziehung zwischen Tableau Server und einem oder mehreren Webservern eingerichtet
wurde. Wenn Tableau Server Anforderungen von vertrauenswürdigen Webservern empfängt,
wird davon ausgegangen, dass der Webserver die notwendige Authentifizierung durchgeführt
hat.
Wenn der Webserver SSPI (Security Support Provider Interface) verwendet, müssen Sie
keine vertrauenswürdige Authentifizierung einrichten. Sie können Ansichten einbetten, und die
Benutzer können darauf sicher zugreifen, sofern Sie lizenzierte Benutzer von Tableau Server
und Mitglieder von Active Directory sind. Die gleichzeitige Verwendung von Automatische
Anmeldung aktivieren (eine während der Installation konfigurierte Option, die Microsoft SSPI
verwendet) und vertrauenswürdiger Authentifizierung wird nicht unterstützt. Wenn Sie SSPI
mit Active Directory nicht verwenden und Sie möchten, dass Ihre Benutzer sicher auf Tableau
Server-Ansichten zugreifen können, ohne Anmeldeinformationen eingeben zu müssen,
können Sie vertrauenswürdige Authentifizierung einrichten.
Damit Benutzer beim Klicken auf eine eingebettete Ansicht erfolgreich authentifiziert
werden können, müssen ihre Browser so konfiguriert sein, dass Cookies von
Drittanbietern zulässig sind.
Funktionsweise der vertrauenswürdigen Authentifizierung
Das Diagramm unten beschreibt, wie die vertrauenswürdige Authentifizierung zwischen dem
Webbrowser des Clients, dem Webserver und Tableau Server funktioniert.
- 353 -
Ein Benutzer besucht die
Webseite: Wenn ein
Benutzer die Webseite mit
der eingebetteten Tableau
Server-Ansicht besucht,
sendet er eine GETAnforderung an den
Webserver, um das HTML
dieser Seite anzufordern.
Der Webserver übergibt die URL an den
Browser: Der Webserver erstellt die URL für die
Ansicht entweder anhand der Ansichts-URL oder
ihres Objekt-Tags (wenn die Ansicht eingebettet
ist) und fügt sie in das HTML für die Seite ein. Das
Ticket ist enthalten (z. B.
http://tabserver/trusted/<ticket>/views/requested
viewname). Der Webserver übergibt das
gesamte HTML für die Seite an den Webbrowser
des Clients.
Der Webserver sendet
eine POST-Anforderung
an Tableau Server: Der
Webserver senden eine
POST-Anforderung an den
vertrauenswürdigen Tableau
Server (z. B.
http://tabaserver/tr
usted, nicht
http://tabserver).
Diese POST-Anforderung
muss einen usernameParameter enthalten. Der
Wert für username muss
dem Benutzernamen eines
lizenzierten Tableau Server-
Der Browser fordert die Ansicht von Tableau
Server an: Der Client-Webbrowser sendet
mithilfe einer GET-Anforderung, die die URL mit
dem Ticket beinhaltet, eine Anforderung an
Tableau Server.
- 354 -
Benutzers entsprechen.
Wenn der Server mehrere
Websites ausführt und sich
die Ansicht auf einer anderen
Site befindet als auf der Site
"Default" (Standard), muss
die POST-Anforderung auch
einen target_siteParameter umfassen.
Tableau Server erstellt ein
Ticket: Tableau Server
überprüft die IP-Adresse
oder den Hostnamen des
Webservers (im obigen
Diagramm 192.168.1.XXX),
der die POST-Anforderung
gesendet hat. Wenn dieser
als vertrauenswürdiger Host
eingerichtet ist, erstellt
Tableau Server ein Ticket in
Form einer eindeutigen
Zeichenfolge aus 24 Zeichen
(URL-sicher, Base64codiert). Tableau Server
beantwortet die POSTAnforderung mit diesem
Ticket. Wenn ein Fehler
vorliegt und das Ticket nicht
erstellt werden kann,
antwortet Tableau Server mit
dem Wert -1.
Tableau Server löst das Ticket ein: Tableau
Server erkennt, dass der Webbrowser eine URL
mit einem Ticket anfordert, und löst das Ticket ein.
Tickets müssen innerhalb von drei Minuten nach
ihrer Ausstellung eingelöst werden. Sobald das
Ticket eingelöst wurde, meldet Tableau Server
den Benutzer an, entfernt das Ticket aus der URL
und sendet die endgültige URL der eingebetteten
Ansicht.
Hinzufügen vertrauenswürdiger IP-Adressen oder Hostnamen zu Tableau Server
Der erste Schritt beim Einrichten der vertrauenswürdigen Authentifizierung ist, Tableau Server
so zu konfigurieren, dass Anforderungen von einem oder mehreren Webservern erkannt und
als vertrauenswürdig eingestuft werden.
1. Öffnen Sie als Administrator eine Eingabeaufforderung, und wechseln Sie zum BINVerzeichnis von Tableau Server (z. B. C:\Program Files\Tableau\Tableau
Server\8.3\bin).
2. Geben Sie folgenden Befehl ein, um Tableau Server zu beenden:
- 355 -
tabadmin stop
3. Geben Sie dann folgenden Befehl ein:
tabadmin set wgserver.trusted_hosts "<trusted IP addresses or
host names>"
Im obigen Befehl steht <trusted IP addresses> für eine Liste der IPv4-Adressen
oder Hostnamen der Webserver mit Kommas als Trennzeichen. Beispiel:
tabadmin set wgserver.trusted_hosts "192.168.1.101,
192.168.1.102, 192.168.1.103"
oder
tabadmin set wgserver.trusted_hosts "webserv1, webserv2,
webserv3"
Hinweise:
Diese durch Kommas getrennte Liste sollte in Anführungszeichen eingeschlossen
werden und nach jedem Komma ein Leerzeichen enthalten.
Die von Ihnen angegebenen Webserver müssen statische IP-Adressen
verwenden, selbst wenn Sie sie hier mithilfe von Hostnamen angeben (weitere
Informationen).
4. Wenn sich zwischen dem Computer, der das vertrauenswürdige Ticket anfordert (einer
der in 2. Schritt oben konfigurierten), und Tableau Server ein oder mehrere Proxyserver
befinden, müssen Sie diese als vertrauenswürdige Gateways hinzufügen.
Informationen zur Vorgehensweise finden Sie unter Konfigurieren von Tableau für
die Verwendung eines Proxyservers Auf Seite 352.
5. Geben Sie folgenden Befehl ein, um die Änderungen in allen ServerKonfigurationsdateien zu speichern:
tabadmin config
6. Schließlich geben Sie den folgenden Befehl ein, um den Server neu zu starten:
tabadmin start
Anschließend konfigurieren Sie Ihren Webserver zum Empfang von Tickets von Tableau
Server.
Empfang von Tickets von Tableau Server
Nachdem Sie vertrauenswürdige IP-Adressen zu Tableau Server hinzugefügt haben, können
Sie den Webserver zum Empfang von Tickets von Tableau Server per POST-Anforderungen
konfigurieren (Schritt 3 im Diagramm). Die POST-Anforderung muss an
- 356 -
http://<Servername>/trusted gesendet werden, nicht an http://tabserv.
Beispielsweise http://tabserv/trusted.
Hinweis: Wenn SSL aktiviert ist, müssen Sie https anstatt von http
verwenden.Beispielsweise: https://tabserver/trusted.
Codebeispiele zum Erstellen der POST-Anforderung in Java, Ruby und PHP finden Sie hier:
C:\Program Files\Tableau\Tableau Server\8.3\extras\embedding
Diese Daten können Sie in einer POST-Anforderung an Tableau Server verwenden:
l
l
l
username=<username> (erforderlich): Der Benutzername eines lizenzierten
Tableau Server-Benutzers. Wenn Sie die lokale Authentifizierung verwenden, kann der
Benutzername eine einfache Zeichenfolge sein (z. B. username=jsmith). Wenn Sie
Active Directory mit mehreren Domänen verwenden, müssen Sie den Domänennamen
zusammen mit dem Benutzernamen (z. B. username=MyCo\jsmith) angeben.
target_site=<site id> (erforderlich, wenn sich die Ansicht nicht auf der
Standardsite befindet): Gibt an, welche Site die Ansicht enthält, wenn Tableau Server
mehrere Websites ausführt und sich die Ansicht auf einer anderen Site befindet als auf
der Site "Default" (Standard) (z. B. target_site=Sales). Verwenden Sie als Wert
für <site id> die Site-ID, die Sie beim Erstellen der Site erhalten haben. Bei dem
Wert wird die Groß-/Kleinschreibung berücksichtigt. Falls die Site-ID SAles ist, gilt
target_site=SAles.
client_ip=<IP address> (optional): Dient zur Angabe der IP-Adresse des
Computers, dessen Webbrowser auf die Ansicht zugreift (z. B. client_
ip=123.45.67.891). Dies ist nicht die IP-Adresse des Webservers, der die POSTAnforderung an Tableau Server sendet. Wenn Sie diesen Parameter verwenden,
finden Sie weitere Informationen unter Optional: Konfigurieren des Client-IPAbgleichs Auf Seite 359.
Die Antwort von Tableau Server auf die POST-Anforderung erfolgt in Form einer eindeutigen
24-stelligen Ziffernfolge (das Ticket). Wenn Tableau Server die Anforderung nicht verarbeiten
kann, wird -1 zurückgegeben. Tipps zur Problembehebung finden Sie unter Ticketwert -1
wird von Tableau Server zurückgegeben Auf Seite 360. Damit sich Benutzer beim Klicken
auf eine eingebettete Ansicht erfolgreich authentifizieren können, müssen ihre Browser so
konfiguriert sein, dass Cookies von Drittanbietern zulässig sind.
Anschließend müssen Sie den Code hinzufügen, der dem Webserver ermöglicht, eine URL für
die Ansicht zu erstellen, die den Speicherort der Ansicht und das Ticket enthält.
Anzeigen der Ansicht mit dem Ticket
Nachdem Sie die POST-Anforderung erstellt haben, müssen Sie einen Code schreiben, der
dem Webserver den Speicherort der Ansicht und des Tickets von Tableau Server angibt.
Diese Informationen werden zum Anzeigen der Ansicht verwendet. Die Art der Angabe hängt
davon ab, ob die Ansicht eingebettet ist und ob Tableau Server mehrere Websites ausführt.
- 357 -
Beispiele für Tableau Server-Ansichten
Dies ist ein Beispiel zur Angabe einer Ansicht, auf die Benutzer nur über Tableau Server
Zugriff haben (die Ansicht ist nicht eingebettet):
http://tabserver/trusted/<ticket>/views/<workbook>/<view>
Wenn Tableau Server mehrere Websites ausführt und sich die Ansicht auf einer anderen Site
befindet als auf der Standardsite, müssen Sie t/<site ID> zum Pfad hinzufügen. Beispiel:
http://tabserver/trusted/<ticket>/t/Sales/views/<workbook>/<view>
Verwenden Sie dabei die gleiche Groß- und Kleinschreibung, die in der Tableau Server-URL
verwendet wird.
Beispiele für eingebettete Ansichten
Hier sind einige Beispiele zur Angabe von eingebetteten Ansichten. Da es zwei
Vorgehensweisen für eingebetteten Code gibt, sind unten beide Möglichkeiten aufgeführt.
Unabhängig davon, welche Sie verwenden, gibt es einige Informationen speziell für die
vertrauenswürdige Authentifizierung, die Sie angeben müssen.
Script-Tag-Beispiele
In diesem Beispiel wird der Objektparameter ticket verwendet:
<script type="text/javascript" srcc="http://myserver/javascripts/api/viz_v1.js"></script>
<object class="tableauViz" width="800" height="600" style="display:none;">
<param name="name" value="MyCoSales/SalesScoreCard" />
<param name="ticket" value="Etdpsm_Ew6rJY-9kRrALjauU" />
</object>
So würde das oben angegebene Beispiel aussehen, wenn Tableau Server mehrere Websites
ausführt und die Ansicht auf der Sales-Site veröffentlicht wird.
<script type="text/javascript" srcc="http://myserver/javascripts/api/viz_v1.js"></script>
<object class="tableauViz" width="800" height="600" style="display:none;">
<param name="site_root" value="/t/Sales" />
<param name="name" value="MyCoSales/SalesScoreCard" />
<param name="ticket" value="Etdpsm_Ew6rJY-9kRrALjauU" />
</object>
Statt ticket können Sie auch den Parameter path verwenden, um den vollständigen Pfad
der Ansicht explizit anzugeben. Bei der Verwendung von path müssen Sie außerdem den
Parameter name angeben, der normalerweise ein erforderlicher Parameter im Tableau
JavaScript-Einbettungscode ist:
- 358 -
<script type="text/javascript" srcc="http://myserver/javascripts/api/viz_v1.js"></script>
<object class="tableauViz" width="900" height="700" style="display:none;">
<param name="path" value="trusted/Etdpsm_Ew6rJY9kRrALjauU/views/MyCoSales/SalesScoreCard" />
</object>
Hier dasselbe Beispiel für einen Server mit mehreren Sites. Beachten Sie, dass hier
/t/<site ID> verwendet wird:
<script type="text/javascript" srcc="http://myserver/javascripts/api/viz_v1.js"></script>
<object class="tableauViz" width="900" height="700" style="display:none;">
<param name="path" value="trusted/Etdpsm_Ew6rJY9kRrALjauU/t/Sales/views/MyCoSales/SalesScoreCard" />
</object>
Iframe-Tag-Beispiel
<iframe src="http://tabserver/trusted/Etdpsm_Ew6rJY9kRrALjauU/views/workbookQ4/SalesQ4?:embed=yes" width="800"
height="600"></iframe>
Optional: Konfigurieren des Client-IP-Abgleichs
Standardmäßig berücksichtigt Tableau Server die IP-Adresse des Clientwebbrowsers nicht,
wenn Tickets erstellt oder eingelöst werden. Um dies zu ändern, führen Sie Folgendes aus:
Geben Sie mit dem Parameter client_ip eine IP-Adresse in der POST-Anforderung an,
die das Ticket abruft, und befolgen Sie die unten angegebenen Schritte zur Konfiguration von
Tableau Server, um den Abgleich der Client-IP-Adressen zu erzwingen.
1. Öffnen Sie ein Eingabeaufforderungsfenster, und wechseln Sie zum BIN-Ordner von
Tableau Server. Der Standardspeicherort ist C:\Program
Files\Tableau\Tableau Server\8.3\bin
2. Öffnen Sie als Administrator eine Eingabeaufforderung, und geben Sie folgenden
Befehl ein:
tabadmin set wgserver.extended_trusted_ip_checking true
3. Geben Sie dann folgenden Befehl ein:
tabadmin configure
- 359 -
4. Schließlich starten Sie den Server durch folgende Eingabe neu:
tabadmin restart
Behandeln von Problemen mit der vertrauenswürdigen Authentifizierung
Nachfolgend werden einige häufige Probleme und Fehler beschrieben, die bei der
Konfiguration der vertrauenswürdigen Authentifizierung auftreten können. Informationen für
die vertrauenswürdige Authentifizierung werden in die Datei
ProgramData\Tableau\Tableau
Server\data\tabsvc\logs\vizqlserver\vizql-*.log geschrieben. Um die
Protokollebene von info auf debug zu erhöhen, verwenden Sie die tabadmin-Einstellung
vizqlserver.trustedticket.log_level.
Tipps zum Testen der vertrauenswürdigen Authentifizierung finden Sie in der Tableau
Knowledge Base.
Ticketwert -1 wird von Tableau Server zurückgegeben
Tableau Server gibt -1 als Ticketwert zurück, wenn er das Ticket nicht im Rahmen des
vertrauenswürdigen Authentifizierungsprozesses ausstellen kann. Der genaue Grund für
diese Meldung wird in die Datei production*.log im folgenden Ordner geschrieben:
ProgramData\Tableau\Tableau Server\data\tabsvc\logs\wgserver
und in die Datei vizql*.log im folgenden Ordner:
ProgramData\Tableau\Tableau Server\data\tabsvc\logs\vizqlserver
Hier sind einige zu beachtende Punkte:
l
Alle Hostnamen oder IP-Adressen von Webservern werden den
vertrauenswürdigen Hosts hinzugefügt.
Die IP-Adresse oder der Hostname für den Computer, der die POST-Anforderung
sendet, muss in der Liste vertrauenswürdiger Hosts auf Tableau Server vorhanden sein.
Informationen dazu, wie IP-Adressen oder Hostnamen dieser Liste hinzugefügt werden,
finden Sie unter Hinzufügen vertrauenswürdiger IP-Adressen oder Hostnamen
zu Tableau Server Auf Seite 355.
l
Der Wert von wgserver.trusted_hosts ist richtig formatiert
In der Liste der vertrauenswürdigen Hosts, die Sie mit der Einstellung wgserver.trusted_
hosts angegeben haben, müssen die Einträge durch Kommas voneinander getrennt
sein, und nach jedem Komma muss ein Leerzeichen folgen. Die Liste sollte
beispielsweise so ähnlich wie folgende Liste aussehen: 192.168.1.101, 192.168.1.102,
192.168.1.103 oder bigbox1.example.lan, bixbox2.example.lan, bigbox3.example.lan.
l
IP-Adressen (IPv4)
- 360 -
Wenn Sie IP-Adressen zur Angabe vertrauenswürdiger Hosts verwenden, müssen
diese das IPv4-Format (Internet Protocol Version 4) aufweisen. Eine IPv4-Adresse
sieht folgendermaßen aus: 123.456.7.890. IPv6-Adressen (z. B.
fe12::3c4a:5eab:6789:01c%34) werden nicht zur Eingabe vertrauenswürdiger Hosts
unterstützt.
l
Der Benutzername in der POST-Anforderung ist ein gültiger Tableau ServerBenutzer
Der Benutzername, der in der POST-Anforderung gesendet wird, muss einem
lizenziertem Tableau Server-Benutzer mit der Lizenzstufe "Viewer" oder "Interactor"
zugeordnet sein. Sie können eine Liste der Benutzer und deren Lizenzstufe anzeigen,
indem Sie sich als Administrator bei Tableau Server anmelden und links auf der Seite
auf den Link "Lizenzierung" zu klicken.
l
Der Benutzername in der POST-Anforderung umfasst die Domäne
Wenn Tableau Server für die Verwendung der lokalen Authentifizierung konfiguriert
wurde, kann der in der POST-Anforderung gesendete Benutzername eine einfache
Zeichenfolge sein. Wenn der Server allerdings für Active Directory konfiguriert worden
ist, müssen Sie den Domänennamen zusammen mit dem Benutzernamen
(Domäne\Benutzername) angeben. Der username-Parameter kann z. B. so lauten:
username=dev\jsmith
l
Content-Typ wird festgelegt
Wenn Sie eine ASP.NET- oder C#-Anwendung erstellen, müssen Sie den Content-Typ
in der entsprechenden HTTP-Anforderung festlegen.Beispiel:
http.setRequestHeader("Content-Typ","application/x-www-formurlencoded;charset=UTF-8"). Wenn Sie keinen Content-Typ festlegen und
Tableau Server a -1 ausgibt, enthalten die Protokolldateien folgenden Fehler: "missing
username and/or client_ip".
HTTP 401 – Nicht Autorisiert
Wenn der Fehler "401 – Nicht autorisiert" ausgegeben wird, wurde Tableau Server
möglicherweise für die Verwendung von Active Directory mit SSPI konfiguriert (siehe
Automatische Anmeldung aktivieren). Wenn der Webserver SSPI verwendet, müssen Sie
keine vertrauenswürdige Authentifizierung einrichten. Sie können Ansichten einbetten, und die
Benutzer können darauf zugreifen, sofern Sie lizenzierte Benutzer von Tableau-Server und
Mitglieder von Active Directory sind.
Die gleichzeitige Verwendung von Automatische Anmeldung aktivieren und
vertrauenswürdiger Authentifizierung wird nicht unterstützt.
HTTP 404 – Datei nicht gefunden
Dieser Fehler kann auftreten, wenn der Programmcode auf eine nicht vorhandene Tableau
Server-URL verweist. Beispielsweise ist es möglich, dass der Webserver eine ungültige URL
erstellt, die nicht gefunden werden kann, wenn die Webseite sie abzurufen versucht.
- 361 -
Ungültiger Benutzer (SharePoint oder C#)
Dieser Fehler kann auftreten, wenn Tableau Server für die vertrauenswürdige
Authentifizierung konfiguriert worden ist.
Im Beispielcode für die SharePoint .dll wird auf die folgende GET-Anforderung Bezug
genommen:
SPContext.Current.Web.CurrentUser.Name
Die obige Anforderung gibt den Anzeigenamen des aktuellen Windows Active DirectoryBenutzers zurück. Wenn Sie die Anmelde-ID verwenden möchten, müssen Sie den Code wie
folgt abändern:
SPContext.Current.Web.CurrentUser.LoginName
Nachdem Sie die Änderung vorgenommen haben, müssen Sie die SharePoint.dll neu
kompilieren.
Versuch, das Ticket von der falschen IP-Adresse abzurufen
Dieser Fehler kann auftreten, wenn Tableau Server für die vertrauenswürdige
Authentifizierung konfiguriert worden ist.
Die IP-Adresse des Clientwebbrowsers wird beim Einlösen des Tickets standardmäßig nicht
berücksichtigt. Wenn Tableau Server so konfiguriert wurde, dass ein Abgleich der Client-IPAdressen erzwungen wird, stellen Sie sicher, dass die IP-Adresse des Clientwebbrowsers, die
in der POST-Anforderung an den Tableau Server gesendet wird, mit der IP-Adresse
übereinstimmt, die verwendet wird, wenn der Browser die eingebettete Ansicht abzurufen
versucht. Wenn beispielsweise im Diagramm "Vertrauenswürdige Authentifizierung" in der
POST-Anforderung in Schritt 3 der Parameter "client_ip=74.125.19.147" gesendet wird, dann
muss die GET-Anforderung in Schritt 5 von derselben IP-Adresse stammen.
Informationen dazu, wie Tableau Server so konfiguriert wird, dass ein Abgleich der Client-IPAdressen erzwungen wird, finden Sie unter Optional: Konfigurieren des Client-IPAbgleichs Auf Seite 359.
Fehler durch die Einschränkung von Cookies
Wenn sich ein Benutzer bei Tableau Server anmeldet, wird ein Sitzungs-Cookie in seinem
lokalen Browser gespeichert. Anhand des gespeicherten Cookies verwaltet Tableau Server
die Authentifizierung des angemeldeten Benutzers und den Zugriff auf den Server. Da der
Cookie in der gleichen Domäne oder Unterdomäne wie die Adressleiste des Browsers
angelegt wird, wird er als Erstanbieter-Cookie betrachtet. Wenn der Browser des Benutzers
so konfiguriert ist, dass Erstanbieter-Cookies blockiert werden, ist eine Anmeldung bei
Tableau Server nicht möglich.
Wenn sich der Benutzer über eine eingebettete Ansicht bei Tableau Server oder bei einer
Umgebung mit vertrauenswürdiger Authentifizierung anmeldet, geschieht dasselbe: es wird
ein Cookie gespeichert. In diesem Fall behandelt der Browser den Cookie als DrittanbieterCookie. Dies liegt daran, dass der Cookie in einer anderen Domäne angelegt wird als die, die
- 362 -
in der Adressleiste des Browsers angezeigt wird. Wenn der Browser des Benutzers so
konfiguriert ist, dass Drittanbieter-Cookies blockiert werden, ist eine Anmeldung bei Tableau
Server nicht möglich. Um diesen Fehler zu vermeiden, müssen Webbrowser so konfiguriert
werden, dass Cookies von Drittanbietern zugelassen werden.
Fehler beim Kommunizieren mit dem Server (403)
Wenn Tableau Server für vertrauenswürdige Authentifizierung konfiguriert ist, wird diese
Fehlermeldung möglicherweise angezeigt, wenn Sie eine neue Ansicht in einem Browser
öffnen und versuchen, zu vorher geöffneten Ansichten zurück zu navigieren. Tableau Server
bietet mithilfe der tabadmin set-Option vizqlserver.protect_sessions, die in der
Standardeinstellung auf true festgelegt ist, Schutz vor der nicht autorisierten
Wiederverwendung von VizQL-Sitzungen. Da Tableau Server für die vertrauenswürdige
Authentifizierung konfiguriert ist, muss möglicherweise nicht außerdem die Option
vizqlserver.protect_sessions aktiviert werden. Um die Option zu deaktivieren,
ändern Sie sie mithilfe von set Auf Seite 433 zu false.
OAuth-Datenverbindungen
Bei den Datenquellen Google BigQuery, Google Analytics und Salesforce.com bietet sich als
Alternative zum Speichern vertraulicher Datenbankanmeldeinformationen mit Tableau Server
das Herstellen von Verbindungen mit dem OAuth 2.0-Standard an.
Wenn Sie eine OAuth-Verbindung herstellen, geben Sie dem Datenanbieter Ihre
Genehmigung, dass Tableau auf Ihre Daten zugreifen darf. Der Datenanbieter sendet dann
ein Zugriffs-Token an Tableau, das die Anforderungen von Tableau eindeutig identifziert.
Weitere Informationen dazu finden Sie im nachfolgenden Abschnitt Übersicht über den
OAuth-Prozess oben.
Die Nutzung von OAuth-Verbindungen bietet folgende Vorteile:
l
l
Sicherheit Ihre vertraulichen Datenbankanmeldeinformationen werden nie
bekanntgegeben oder in Tableau Server gespeichert, und die Zugriffstoken können nur
durch Tableau genutzt werden.
Bequemere Nutzung: Anstatt Datenquellen-ID und Kennwort an verschiedenen Orten
integrieren zu müssen, können Sie das für einen bestimmten Datenanbieter
bereitgestellte Token für alle veröffentlichten Arbeitsmappen und Datenextrakte mit
Zugriff auf diesen Datenanbieter verwenden.
Neben Live-Verbindungen zu Google BigQuery-Daten kann jedem ArbeitsmappenViewer ein eigenes Zugriffstoken anstatt einzelner Benutzernamen und Kennwortdaten
zur Benutzererkennung zugewiesen werden.
Übersicht über den OAuth-Prozess
In den folgenden Schritten wird ein Workflow in der Tableau-Umgebung zum Abrufen des
OAuth-Prozesses beschrieben.
- 363 -
1. Sie können eine Aktion ausführen, für die der Zugriff auf eine Cloud-Datenquelle
erforderlich ist.
Nehmen wir einmal an, Sie öffnen eine in Tableau Server veröffentlichte Arbeitsmappe.
2. Tableau leitet Sie zur Anmeldeseite des Anbieters gehosteter Daten weiter. Die an den
Anbieter der gehosteten Daten weitergeleiteten Informationen weisen Tableau als die
anfordernde Site und Sie als Benutzer aus.
3. Wenn Sie sich bei der gehosteten Datenquelle anmelden, werden Sie aufgefordert, Ihre
Autorisierung für den Tableau Server-Zugriff auf die Daten zu bestätigen.
4. Der Datenquellenanbieter sendet bei Bestätigung an Zugriffstoken an Tableau Server
zurück.
5. Tableau Serverzeigt Ihre Arbeitsmappe und Daten an.
Folgende weitere Prozesse können auf den OAuth-Prozess zugreifen:
l
l
Arbeitsmappe erstellen und Verbindung zur Datenquelle von Tableau Desktop oder von
Tableau Server herstellen
Veröffentlichen einer Datenquelle aus Tableau Desktop
Verwalten von Anmeldeinformationen
Benutzer können ihre Zugriffstoken über die Benutzereinstellungen selbst verwalten oder die
Verwaltung von Zugriffstoken für Datenquellen und Verbindungen ausschließlich
Administratoren und Benutzern mit Datenquellen-Verbinderrollen vorbehalten.
Folgendes gilt, wenn ein Zugriffstoken als eingebettete Anmeldeinformation mit einer
veröffentlichten Datenquelle oder für Live-Verbindungen zu Google BigQuery-Daten
verwendet wird:
- 364 -
l
l
l
Wenn Tableau Server Daten über eine durch ein Zugriffstoken dargestellte Verbindung
anfordert, bestätigt der Datenquellenanbieter den autorisierten Tableau-Zugriff über
das Token und gibt danach die angeforderten Daten aus. Sie müssen nicht bei jedem
Verbindungsaufbau die Anmeldeinformationen angeben.
Wenn ein Token zu einer veröffentlichten Datenquelle verwendet wird, können Sie neue
Arbeitsmappen erstellen, welche mit diesen Daten aus Tableau Desktop oder Tableau
Server verbunden werden, ohne sich für jeden Datenzugriff erneut anmelden zu
müssen.
Zugriffstoken sind so lange gültig, bis sie von einem Benutzer oder Datenanbieter
widerrufen werden.
Hinweis Eine Überschreitung der vom Datenquellenanbieter genehmigten
Anzahl an Token ist möglich. In einem solchem Fall entscheidet der
Datenanbieter bei Erstellung eines neuen Token anhand der seit dem letzten
Zugriff verstrichenen Zeit, welches vorhandene Token für das neue Token
ungültig gemacht werden soll. Der Datenanbieter kann ein Token auch aus
anderen Gründen ungültig machen.Ein Administrator kann beispielsweise
jeglichen Anwendungszugriff widerrufen.
Konfigurieren des Servers für die OAuth-Unterstützung
Im OAuth-Prozess werden anstelle individueller Namen und Kennwörter Zugriffstoken zu
begrenzten Zwecken verwendet.Bevor Sie die Zugriffstoken zum Erstellen einer OAuthVerbindung in Tableau abrufen können, müssen Sie den Server so konfigurieren, dass der
Datenanbieter, der das Token versendet, Tableau Server als vertrauenswürdiges Ziel erkennt.
Im folgenden Abschnitt wird beschrieben, wie Sie die Einrichtung von OAuth unabhängig vom
Datenanbieter vorbereiten können.In den darunter aufgeführten Themen werden die Schritte
für die Serverkonfiguration für bestimmte Datenanbieter benannt.
Vorbereiten der OAuth-Support-Konfiguration
Bevor Sie mit den Schritten zur datenanbieterspezifischen Konfiguration beginnen, müssen
folgende Voraussetzungen erfüllt sein:
l
Vollqualifizierter Domänenname zu jedem Tableau ServerKnoten, in dem Ansichten
gehostet werden, über die eine Verbindung zu dieser Datenquelle herstellen. Beispiel:
https://sales.your_domain.com
Wenn Sie Salesforce.com nutzen, müssen Sie zudem eine https-Adresse angeben.
l
Achten Sie darauf, dass mindestens ein Datenquellenanbieter-Konto für den APIZugriff aktiviert ist.
Bei Google BigQuery und Google Analytics benötigen Sie Zugang zur DeveloperKonsole der Google Cloud Platform.
- 365 -
Bei Salesforce.com muss ein Zugriff auf die Plattform Force.com möglich sein.
l
Achten Sie darauf, dass die neuesten Treiber für die Datenquelle installiert sind.
Verwenden Sie für Google BigQuery die 32-Bit-Version.
Sie können die aktualisierten Treiber von der Seite Treiber & Aktivierung auf der
Tableau-Website herunterladen.
Konfigurieren von Einstellungen für Ihren Datenanbieter
Wenn Sie die vorbereitenden Schritte für OAuth abgeschlossen haben, können Sie die
entsprechenden Einstellungen für Ihren Datenanbieter konfigurieren.
l
l
Einrichten von OAuth für Google oben
Einrichten von OAuth für Salesforce.com Auf Seite 370
Einrichten von OAuth für Google
Dieses Thema beschreibt, wie Sie Google BigQuery- und Google Analytics-Datenquellen für
OAuth einrichten. Führen Sie diese Schritte für jede Tableau Server-Instanz aus.
Hinweis Bevor Sie diese Schritte durchführen, sollten Sie unbedingt die unter
Vorbereiten der OAuth-Support-Konfiguration Auf der vorherigen Seite
beschriebenen Schritte abgeschlossen haben.
Richten Sie OAuth mithilfe der beiden folgenden Vorgehensweisen ein:
l
l
Rufen Sie die erforderlichen Informationen aus Google ab und aktivieren Sie den APIZugriff.
Konfigurieren Sie den Server mithilfe der Daten, die Sie erhalten haben.
Rufen Sie eine Client-ID ab, und aktivieren Sie Google-APIs.
Hinweis In diesen Schritten sind die Einstellungen der Google Cloud Platform-Konsole
zum Zeitpunkt der Erstellung dieser Ausführungen wiedergegeben. Weitere
Informationen finden Sie unter Auth 2.0 für Web Server-Anwendungen verwenden in
der Google Developer-Hilfekonsole.
1. Melden Sie sich bei der Google Cloud-Plattform an, und klicken Sie auf Zu meiner
Konsole.
- 366 -
2. Wählen Sie Projekts aus, und klicken Sie auf der Projektseite auf Projekt erstellen.
3. Vervollständigen Sie im angezeigten Projektformular folgende Angaben:
l
l
Geben Sie dem Projekt einen aussagekräftigen Namen, der einen Bezug zur
Tableau Server-Instanz, für die Sie dieses Projekt nutzen, erkennen lässt.
Entscheiden Sie, ob Sie die Projekt-ID ändern möchten.
Hinweis Nach der Projekterstellung können Sie die Projekt-ID nicht mehr
ändern. Klicken Sie auf die Fragezeichen-Symbole, um weitere
Informationen zu erhalten.
4. Öffnen Sie das neue Projekt und wechseln Sie zu APIs & Auth >
Anmeldeinformationen.
5. Klicken Sie auf Neue Client-ID erstellen, und vervollständigen Sie auf der Client-IDSeite folgende Angaben:
l
Wählen Sie Webanwendung aus. .
l
Geben Sie bei autorisiertem JavaScript-Ursprung den lokalen Computernamen
- 367 -
Ihres Tableau Server ein.
l
Bei einer autorisierten Umleitungs-URI ersetzen Sie den vorhandenen Text durch
eine Internetadresse für Ihren Server, und fügen Sie am Ende folgenden Text
hinzu: auth/add_oauth_token.Beispiel:
https://data.your_server.com/auth/add_oauth_token
6. Klicken Sie auf Client-ID erstellen.
7. Kopieren Sie folgende von Google ausgegebene Werte und fügen Sie sie an einer
Stelle ein, auf die Sie von Ihrem Tableau Server Computer aus zugreifen können:
l
Client-ID
l
Client-Geheimnis
l
Umleitungs-URIs
8. Öffnen Sie Ihr neues Projekt und wählen Sie in der Google Developer Console APIs &
Auth > APIs aus und setzen dann den Status für BigQuery API oder Analytics API
auf On.
Tableau Server für Google OAuth konfigurieren
Mithilfe der Informationen, die Sie durch Ausführung dieser Schritte unter Rufen Sie eine
Client-ID ab, und aktivieren Sie Google-APIs. Auf Seite 366 erhalten haben, können Sie
jetzt Tableau Server konfigurieren:
1. Öffnen Sie auf dem Tableau Server-Computer als Administrator ein
Eingabeaufforderungsfenster, und wechseln Sie zum BIN-Verzeichnis von Tableau
Server.
cd C:\Program Files\Tableau\Tableau Server\<version>\bin
2. Geben Sie den folgenden Befehl ein, um den Server anzuhalten:
tabadmin stop
3. Geben Sie die folgenden Befehle ein, um den Server mit der Client-ID und dem ClientGeheimnis, die Sie von Google erhalten haben, sowie Ihrer Server-URI zu
konfigurieren. Drücken Sie nach jedem Befehl auf die Eingabetaste.
tabadmin set oauth.google.client_id <your_client_ID>
tabadmin set oauth.google.client_secret <your_client_secret>
tabadmin set oauth.google.redirect_uri <your_server_URI>
- 368 -
4. Geben Sie folgende Befehle ein, um die Konfiguration abzuschließen und den Server
neu zu starten.
tabadmin config
tabadmin start
Benutzern das Speichern von Zugriffstoken erlauben
Im OAuth-Prozess werden Verbindungen anstatt mit individuellen Benutzernamen und
Kennwörtern mit Zugriffstoken hergestellt.
Server-Administratoren können Benutzern über die Verwaltungsschnittstelle (A) erlauben, auf
ihrer Benutzereinstellungsseite (B) ihre eigenen Zugriffstoken zu verwalten.
So aktivieren Sie diese Einstellungen:
1. Öffnen Sie einen Webbrowser und melden Sie sich am Server an.
2. Rufen Sie auf der Registerkarte "Admin" die Seite "Wartung" auf, und wählen Sie im
Bereich "Einstellungen" folgende Optionen aus:
l
l
Kennwörter speichern: So können Benutzer ihre individuellen
Anmeldeinformationen zu Datenquellen speichern.
Zugriffstoken speichern: So können Benutzer OAuth-Token speichern.
Server-Administratoren können alternativ OAuth-Anmeldeinformationen auch zentral
verwalten, indem sie die Kontrollkästchen deaktivieren und Datenverbindungen bei
Veröffentlichung von Datenquellen bearbeiten.Wenn die Einstellungen zum Speichern von
Kennwörtern und Zugriffstoken nicht aktiviert sind, wird der Abschnitt zur Verwaltung von
Anmeldeinformationen auf der Seite "Benutzereinstellungen" nicht angezeigt.
- 369 -
Einrichten von OAuth für Salesforce.com
Dieses Thema beschreibt, wie Sie Salesforce.com-Datenquellen für OAuth einrichten. Führen
Sie diese Schritte für jede Tableau Server-Instanz aus.
Hinweis:Bevor Sie diese Schritte durchführen, sollten Sie unbedingt die unter
Vorbereiten der OAuth-Support-Konfiguration Auf Seite 365 beschriebenen
Schritte abgeschlossen haben.
Richten Sie OAuth mithilfe der beiden folgenden Vorgehensweisen ein:
l
l
App-Verbindung in Salesforce erstellen
Konfigurieren Sie den Server mithilfe der Daten, die Sie erhalten haben.
Erstellen Sie in Salesforce -App-Verbindung.
1. Melden Sie sich bei Ihrem Salesforce.com-Entwicklerkonto an, klicken Sie oben rechts
auf Ihren Benutzernamen, und wählen Sie anschließend Setup aus.
2. Wählen Sie in der linken Navigationsspalte unter "App-Einrichtung" Erstellen > Apps
aus.
3. Klicken Sie im Bereich "Verbundene Apps" auf Neu.
4. Füllen Sie die Grundlegenden Informationen aus, und wählen Sie im Bereich "API"
OAuth-Einstellungen aktivieren aus.
- 370 -
5. Geben Sie in den neu angezeigten OAuth-Einstellungen für Rückruf-URL den
vollqualifizierten Domänennamen Ihres Servers per HTTPS-Protokoll ein, und fügen
Sie folgenden Text an die URL an: auth/add_oauth_token.
Beispiel:
https://www.your_server.com/auth/add_oauth_token
6. Verschieben Sie folgende Elemente aus "Verfügbare OAuth-Bereiche" in "Ausgewählte
OAuth-Bereiche":
l
Datenzugriff und -verwaltung (API)
l
Zugreifen auf grundlegende Informationen (ID)
l
Anforderungen in Ihrem Auftrag jederzeit durchführen (refresh_token)
7. Klicken Sie auf Speichern.
Nachdem Sie die App gespeichert haben, werden von Salesforce folgende IDs in den APIBereich eingetragen, die Sie zum Konfigurieren von Tableau Server verwenden:
l
l
l
Verbraucherschlüssel
Verbrauchergeheimnis
Rückruf-URL
Konfigurieren von Tableau Server für Salesforce.com-OAuth
1. Öffnen Sie auf dem Tableau Server-Computer als Administrator eine
Eingabeaufforderung, und wechseln Sie zum bin-Verzeichnis von Tableau Server.
cd C:\Program Files\Tableau\Tableau Server\<version>\bin
2. Geben Sie den folgenden Befehl ein, um den Server anzuhalten:
tabadmin stop
3. Geben Sie folgende Befehle ein, um den Server mit der Verbraucher-ID und dem
Verbraucher-Geheimnis, die Sie von Salesforce erhalten haben, sowie der RückrufURL zu konfigurieren. Drücken Sie nach jedem Befehl auf die Eingabetaste:
tabadmin set oauth.salesforce.client_id <your_consumer_ID>
tabadmin set oauth.salesforce.client_secret <your_consumer_
secret>
- 371 -
tabadmin set oauth.salesforce.redirect_uri <your_callback_
URL_>
4. (Optional) Wenn Sie den Standard-Anmeldeserver ändern müssen, geben Sie
folgenden Befehl ein:
tabadmin set oauth.salesforce.server_base_url <URL>
Die Standardeinstellung ist https://login.salesforce.com.
5. Geben Sie folgende Befehle ein, um die Konfiguration abzuschließen und den Server
neu zu starten.
tabadmin config
tabadmin start
Benutzern das Speichern von Zugriffstoken erlauben
Im OAuth-Prozess werden Verbindungen anstatt mit individuellen Benutzernamen und
Kennwörtern mit Zugriffstoken hergestellt.
Server-Administratoren können Benutzern über die Verwaltungsschnittstelle (A) erlauben, auf
ihrer Benutzereinstellungsseite (B) ihre eigenen Zugriffstoken zu verwalten.
So aktivieren Sie diese Einstellungen:
1. Öffnen Sie einen Webbrowser, und melden Sie sich am Server an.
2. Rufen Sie auf der Registerkarte "Admin" die Seite "Wartung" auf, und wählen Sie im
Bereich "Einstellungen" folgende Optionen aus:
l
l
Kennwörter speichern: So können Benutzer ihre individuellen
Anmeldeinformationen zu Datenquellen speichern.
Zugriffstoken speichern: So können Benutzer OAuth-Token speichern.
Server-Administratoren können alternativ OAuth-Anmeldeinformationen auch zentral
verwalten, indem sie die Kontrollkästchen deaktivieren und Datenverbindungen bei
Veröffentlichung von Datenquellen bearbeiten.Wenn die Einstellungen zum Speichern von
- 372 -
Kennwörtern und Zugriffstoken nicht aktiviert sind, wird der Abschnitt zur Verwaltung von
Anmeldeinformationen auf der Seite "Benutzereinstellungen" nicht angezeigt.
Run As User (Als Benutzer ausführen)
Sie können ein dediziertes Active Directory-(AD)-Benutzerkonto zum Ausführen des Tableau
Server-Dienstes verwenden. Dieses Konto hat den Namen "Run As User" (Als Benutzer
ausführen). Einige Administratoren tun dies, wenn veröffentlichte Arbeitsmappen in Tableau
Server Verbindungen mit Live-Datenquellen herstellen. Das standardmäßige
Netzwerkdienstkonto des Servers (NT AUTHORITY\NetworkService) verfügt nicht über die
richtigen Berechtigungen, um Verbindugnen mit Datenquellen auf anderen Computern
herstellen zu können. Ein richtig konfiguriertes AD-Konto allerdings schon.
Für Datenquellen, die eine Windows (NT)-Authentifizierung erfordern, kann das AD-Konto
den Authentifizierungsprozess automatisch handbhaben, wobei die Authentifizierung zuerst
mithilfe von Kerberos und dann mithilfe von NTLM durchgeführt wird, sollte Ersteres
fehlschlagen, sodass Benutzer nicht zur Eingabe von Anmeldeinformationen aufgefordert
werden, wenn die Arbeitsmappe eine Verbindung mit der Live-Datenquelle herstellt.
Außerdem ist ein AD-Konto "Run As User" (Ausführen als Benutzer), das einer bestimmten
Ressource zugeordnet ist, häufig einfacher zu verwalten als ein AD-Konto, das einer Person
zugeordnet ist.
Um Tableau Server für die Verwendung eines Kontos "Run As User" (Ausführen als
Benutzer) zu konfigurieren, führen Sie die unten beschriebenen Schritte aus. Wenn Sie eine
verteilte Installation auf Tableau Server ausführen, sollten diese Schritte sowohl auf den
Arbeitsservern als auch auf dem primären Server durchgeführt werden.Die Schritte aus Run
As User (Als Benutzer ausführen) - Zu überprüfende Kontoeinstellungen Auf Seite
377 können sich von Site zu Site unterscheiden.
Hinweis: Wenn das Konto "Run As User" (Als Benutzer ausführen) bei der Installation
von Tableau Server bereits vorliegt, müssen Sie vor der Ausführung des
Installationsprogramm sicherstellen, dass der Windows-Dienst "Sekundäre
Anmeldung" über die richtigen Werte für "Anmelden als" und "Autostarttyp" verfügt.
Weitere Informationen hierzu finden Sie unter Überprüfen der TableauDiensteinstellungen Auf der nächsten Seite.
Identifizieren des Kontos
Als Erstes identifizieren oder erstellen Sie ein Active Directory-Konto, unter dem der Tableau
Server-Dienst ausgeführt werden soll. Hierfür wird das Konto "Run As User" (Als Benutzer
ausführen) von Tableau Server verwendet, und dieses Konto sollte über folgende Merkmale
verfügen:
l
l
Berechtigungen zum Herstellen einer Verbindung mit der Datenquelle mit Lesezugriff
oder höhere Berechtigungen.
Anmeldeinformationen, die es Tableau Server erlauben, die NT-Authentifizierung bei
- 373 -
der Datenquelle erfolgreich durchzuführen. Microsoft-Datenquellen, die eine NTAuthentifizierung durchführen, sind beispielsweise Microsoft SQL Server und Microsoft
Analytical Services (MSAS), nicht jedoch Access oder Excel.
l
Berechtigungen zum Abfragen des Active Directory-Domänencontrollers nach
Benutzer und Gruppen. Ein Benutzerkonto, das auf dem lokalen Computer erstellt wird,
auf dem auch Tableau Server ausgeführt wird, verfügt wahrscheinlich nicht über diese
Berechtigungen.
Überprüfen der bidirektionalen Vertrauensstellung zwischen Domänen
Überzeugen Sie sich davon, dass eine bidirektionale Vertrauensstellung zwischen Domänen
vorliegt, wenn eine der folgenden Aussagen zutrifft:
l
l
Die Computer, die als Host von Tableau Server fungieren, und die Datenquelle gehören
verschiedenen Domänen an.
Die Tableau Server-Benutzer gehören einer anderen Domäne an als Tableau Server
oder die Datenquelle.
Überprüfen der Tableau-Diensteinstellungen
Überprüfen Sie, ob den Tableau-Diensten die richtigen Werte für Anmeldung und Start
zugewiesen sind.Wenn Sie eine verteilte Installation auf Tableau Server ausführen, führen Sie
diese Schritte sowohl auf den Arbeitsservern als auch auf dem primären Server durch.
1. Melden Sie sich als Administrator bei dem Computer an, auf dem Tableau Server
ausgeführt wird.
2. Wählen Sie auf dem Tableau Server-Computer Start > Systemsteuerung >
Verwaltung > Computerverwaltung > Dienste und Anwendungen > Dienste.
3. Öffnen Sie "Dienste und Anwendungen", und klicken Sie dann auf Dienste.
Überzeugen Sie sich davon, dass die folgenden Dienste über die richtigen Einstellungen
verfügen:
Dienstname "Anmelden als"-Wert
AutostarttypWert
FLEXnet
Licensing
Service
Lokales System
Manuell
Sekundäre
Anmeldung
Lokales System
Automatisch
Tableau Ser- <Domäne>\<Benutzername> Dies ist das
ver (tabsvc) Konto "Als Benutzer ausführen". Siehe
unten.
- 374 -
Automatisch
Dienstname "Anmelden als"-Wert
AutostarttypWert
Tablicsrv
Automatisch
Lokales System
Ändern des Werts für "Anmelden als"
So ändern Sie den Wert unter Anmelden als für Tableau Server (tabsvc) in das Konto "Run
As User" (Als Benutzer ausführen):
1. Beenden Sie im Fenster "Dienste" den Tableau Server-Dienst, indem Sie mit der
rechten Maustaste auf Tableau Server (tabsvc) klicken und Beenden auswählen.
2. Wählen Sie Start > Alle Programme > Tableau Server > Tableau Server
konfigurieren.
3. Geben Sie auf der Registerkarte "Allgemein" die Domäne, den Benutzernamen und das
Kennwort für das Tableau Server-Konto "Run As User" (Als Benutzer ausführen) ein.
4. Klicken Sie auf OK, und starten Sie Tableau Server (tabsvc) dann neu.
Vorbereiten der lokalen Sicherheitsrichtlinie
Wenn Ihr Konto "Run as User" (Als Benutzer ausführen) kein Administrator auf dem Tableau
Server-Rechner ist (sowohl auf dem primären als auch den Arbeitsservern bei einer verteilten
Installation), müssen Sie die lokale Sicherheitsrichtlinie des Rechners so vorbereiten, dass das
Konto "Run as User" (Als Benutzer ausführen) sich als Dienst beim Rechner anmelden und
Konfigurationsänderungen vornehmen kann.Gehen Sie hierzu wie folgt vor:
1. Wählen Sie Start > Systemsteuerung > Verwaltung > Lokale
Sicherheitsrichtlinie aus.
2. Öffnen Sie im Fenster "Lokale Sicherheitseinstellungen" den Ordner "Lokale
Richtlinien", heben Sie "Zuweisen von Benutzerrechten" hervor, klicken Sie dann mit
der rechten Maustaste auf Als Dienst anmelden und wählen Sie Eigenschaften aus.
- 375 -
3. Im Fenster "Eigenschaften von Als Dienst anmelden" klicken Sie auf Benutzer oder
Gruppe hinzufügen.
4. Geben Sie den <domain>\<username> für das Tableau Server-Konto "Run As
User" (Als Benutzer ausführen) ein (z. B.: MYCO\tableau_server), und klicken Sie
auf Namen überprüfen.
5. Wenn das Konto richtig zugeordnet werden kann, wird es unterstrichen. Klicken Sie auf
OK.
6. Wiederholen Sie diese Schritte, um das "Ausführen als"-Konto der Richtlinie Lokale
Anmeldung zulassen hinzuzufügen.
7. Wiederholen Sie diese Schritte, um das "Ausführen als"-Konto aus der Richtlinie Lokale
Anmeldung verweigern zu entfernen.
8. Klicken Sie auf OK, um das Fenster "Lokale Sicherheitseinstellungen" zu schließen.
Konfigurieren der Verbindungseinstellungen von Datenquellen
Damit die Benutzer automatisch authentifiziert werden, wenn die Arbeitsmappe, auf die sie
zugreifen, eine Verbindung mit einer Live-Datenquelle herstellt, die die NT-Authentifizierung
verwendet, aktivieren Sie beim Konfigurieren der Tableau-Datenverbindung die Option
Integrierte Sicherheit von Windows NT verwenden:
- 376 -
Integrierte Sicherheit von Windows NT
Benutzername und Kennwort
Authentifizierung mit dem Konto "Run As
User" (Ausführen als Benutzer) des Servers
Jeder Tableau Server-Benutzer wird zur Eingabe von Datenbankanmeldeinformationen
aufgefordert
Run As User (Als Benutzer ausführen) - Zu überprüfende Kontoeinstellungen
Das Konto "Run As User" (Als Benutzer ausführen) muss über Berechtigungen verfügen, die
es ihm erlauben, Dateien zu lesen, auszuführen und zu ändern. Abhängig davon, welches
Konto aus Ausgangspunkt verwendet wurde, sind möglicherweise bereits die richtigen
Berechtigungen gegeben. Jedes Mal, wenn Sie das Ausführen als-Serverkonto ändern,
müssen Sie sich davon überzeugen, dass es die folgenden Anforderungen erfüllt.Wenn Sie
eine verteilte Installation ausführen, gilt dies sowohl für den primären Server als auch für die
Arbeitsserver.
Gewähren von Berechtigungen zum Lesen und Ausführen
Das Konto, unter dem Tableau Server ausgeführt wird, muss über Berechtigungen zum Lesen
und Ausführen von Dateien verfügen. Jedes Mal, wenn das Konto "Run As User" (Als
Benutzer ausführen) des Servers geändert wird, müssen Sie Folgendes überprüfen bzw.
konfigurieren:
1. Klicken Sie auf dem Host-Rechner für Tableau Server (und Tableau Worker, falls
verteilt) im Windows-Explorer mit der rechten Maustaste auf das Laufwerk, auf dem
Tableau installiert ist, wie z. B. Lokaler Datenträger (C:), und wählen Sie
Eigenschaften.
2. Wählen Sie im Fenster "Eigenschaften von Lokaler Datenträger" die Registerkarte
Sicherheit aus.
3. Klicken Sie auf Bearbeiten und dann auf Hinzufügen.
4. Geben Sie im Dialogfeld "Benutzer auswählen", "Computer", "Servicekonten" oder
"Gruppen" <domain>\<username> für das "Ausführen als"-Benutzerkonto von
- 377 -
Tableau Server ein.Verwenden Sie kein Gruppenkonto.
5. Klicken Sie auf Namen überprüfen, um das Konto zuzuordnen, und dann auf OK, um
den Vorgang zu bestätigen.
6. Vergewissern Sie sich, dass das Tableau Server-Konto "Run As User" (Als Benutzer
ausführen) hervorgehoben ist und über die Berechtigungen Lesen & Ausführen
verfügt. Bei Auswahl von Lesen & Ausführen werden automatisch Ordnerinhalt
auflisten und Lesen ausgewählt.
7. Klicken Sie auf OK, um den Vorgang zu beenden.
Gewähren von Berechtigungen zum Ändern
Das Konto muss zudem in der Lage sein, Protokolldateien zu erstellen und Ähnliches
auszuführen. Bestätigen oder konfigurieren Sie Folgendes:
1. Navigieren Sie zu den folgenden Ordnern:
C:\Program Files\Tableau
C:\ProgramData\Tableau\
Wenn Sie die 32-Bit-Version von Tableau Server unter einem 64-BitBetriebssystem ausführen, müssen Sie zu C:\Program Files (x86)
\Tableau statt zu C:\Program Files\Tableau gehen. Die vorstehenden
Angaben für Laufwerk und Pfade können sich außerdem in Abhängigkeit vom
Installationsort von Tableau Server ändern.
2. Klicken Sie mit der rechten Maustaste auf den Ordner, wählen Sie Eigenschafen aus,
und klicken Sie auf die Registerkarte Sicherheit:
l
l
l
l
Klicken Sie auf Bearbeiten und dann auf Hinzufügen.
Geben Sie den <domain>\<username> für das Tableau Server-Konto "Run
As User" (Als Benutzer ausführen) ein.
Klicken Sie auf Namen überprüfen, um das Konto zuzuordnen, und dann auf
OK, um den Vorgang zu bestätigen.
Vergewissern Sie sich, dass das Tableau Server-Konto "Run As User" (Als
Benutzer ausführen) hervorgehoben ist und über die Berechtigung Ändern
verfügt. Durch die Auswahl von Ändern werden automatisch alle
Berechtigungen mit Ausnahme von Vollzugriff und Spezielle Berechtigungen
- 378 -
gewährt:
3. Klicken Sie für jeden Ordner aus Schritt 1 oben auf der Registerkarte "Sicherheit" im
Dialogfeld "Eigenschaften von Tableau" auf Erweitert:
- 379 -
4. Klicken Sie im Fenster "Erweiterte Eigenschafteneinstellungen für Tableau" auf
Berechtigungen ändern.
5. Heben Sie im Dialogfeld "Erweiterte Eigenschafteneinstellungen für Tableau" das
Konto "Run as User" (Als Benutzer ausführen) hervor, und aktivieren Sie das
Kontrollkästchen Alle Berechtigungen für untergeordnete Objekte durch
vererbbare Berechtigungen von diesem Objekt ersetzen.
- 380 -
6. Klicken Sie auf OK, um die Änderungen auf alle Unterordner und Dateien zu
anzuwenden. Dies kann einige Minuten dauern.In der Regel werden beim Anwenden
dieser Änderungen mehrere Windows-Fehlermeldungen ausgegeben. Das Abbrechen
des Prozesses ist nicht erforderlich; klicken Sie stattdessen auf Fortfahren.
7. Klicken Sie auf OK, um die Änderungen zu bestätigen, und anschließend auf OK im
Tableau-Eigenschaftendialogfeld.
Ändern von Registrierungseinstellungen
Der nachfolgende Schritt ist optional und für die meisten Umgebungen nicht erforderlich.Wenn
die Sicherheit der Registrierung sehr hoch eingestellt ist, geben Sie dem "Ausführen als"Benutzerkonto von Tableau Server Lese- und Schreibberechtigungen für die unten
aufgeführten Registrierungspfade. Die Registrierungsschlüssel hängen davon ab, ob Sie die
32- oder 64-Bit-Version von Tableau Server installiert haben bzw. ob Sie die 32-Bit-Version
von Tableau Server auf einem 32- oder 64-Bit-Betriebssystem ausführen. Die 64-Bit-Version
von Tableau Server kann nur auf einem 64-Bit-Betriebssystem installiert werden.
Installation der 64-Bit-Version von Tableau Server
l
HKEY_CURRENT_USER\Software\Tableau
l
HKEY_LOCAL_MACHINE\Software\Tableau
Installation der 32-Bit-Version von Tableau Server
l
HKEY_CURRENT_USER\Software\Tableau
und
- 381 -
l
l
32-Bit-Betriebssysteme: HKEY_LOCAL_MACHINE\Software\Tableau
64-Bit-Betriebssysteme: HKEY_LOCAL_
MACHINE\Software\Wow6432Node\Tableau
SQL Server-Identitätswechsel
Als Identitätswechsel bezeichnet, wenn ein Benutzerkonto im Namen eines anderen
Benutzerkontos agiert. Sie können Tableau und Microsoft SQL Server so konfigurieren, dass
Identitätswechsel mit Datenbankbenutzern durchgeführt werden. Hierbei fragt das SQL
Server-Datenbankkonto, das von Tableau Server verwendet wird, im Namen von SQL
Server-Datenbankbenutzern, die auch Tableau-Benutzer sind, die Datenbank ab.
Der Hauptvorteil dieses Funktion besteht darin, dass sie es ermöglicht Administratoren, die
ihrer Datensicherheitsrichtlinie an einem zentralen Ort zu implementieren und zu steuern. in
ihren Datenbanken. Wenn Tableau-Benutzer auf eine Ansicht mit einer Liveverbindung zu
einer SQL Server-Datenbank zugreifen, wird in der Ansicht nur angezeigt, was gemäß den
Datenbankberechtigungen des jeweiligen Benutzers zulässig ist. Ein weiterer Vorteil ist, dass
die Benutzer auf keine Datenbankanmeldeaufforderung reagieren müssen, wenn sie auf die
Ansicht zugreifen. Arbeitsmappen-Publisher müssen zudem nicht auf benutzerspezifische
Filter zurückgreifen, um die Anzeige der Ansichtsdaten zu beschränken.
Die nachstehenden Themen enthalten Informationen zur Verwendung dieser Funktion.
Anforderungen für den Identitätswechsel
Der Einsatz dieser Funktion setzt Folgendes voraus:
l
l
l
Live-Verbindungen nur mit SQL Server: Der Identitätswechsel kann nur bei
Ansichten eingesetzt werden, die über eine Live-Verbindung mit einer SQL ServerDatenbank der Version 2005 oder einer neueren Version verfügen.
Einzelne Datenbankkonten: Jede Person, die auf die Ansicht zugreifen soll, muss
über ein explizites Benutzerkonto für die SQL Server-Datenbank verfügen, mit der die
Ansicht verbunden wird. Mitglieder einer Active Directory-(AD)-Gruppe können nicht
Ziel eines Identitätswechsels sein. Angenommen, Jane Smith ist Mitglied der ADGruppe Sales und ihr Datenbankadministrator fügt die AD-Gruppe Sales der SQL
Server-Datenbank hinzu, dann kann Jane Smith nicht Ziel eines Identitätswechsels
sein.
Übereinstimmung von Anmeldeinformationen und Authentifizierungstyp: Die
Anmeldeinformationen der einzelnen Tableau-Benutzerkonten und deren TableauBenutzerauthentifizierungstyp muss mit den zugehörigen Anmeldeinformationen und
dem Authentifizierungstyp in der SQL Server-Datenbank übereinstimmen. Anders
ausgedrückt, wenn für das Tableau Server-Benutzerkonto von Jane Smith der
Benutzername MyCo\jsmith und Active Directory zur Benutzerauthentifizierung
verwendet wird, dann muss ihr Benutzername für die SQL Server-Datenbank ebenfalls
MyCo\jsmith lauten und SQL Server muss die integrierte Windows-Authentifizierung
verwenden.
- 382 -
l
l
SQL Server-Voraussetzungen: In SQL Server sollten eine Datensicherheitstabelle
und eine Ansicht vorhanden sein, in der die Datensicherheit erzwungen wird, und
außerdem sollte von den Datenbankbenutzern gefordert werden, dass sie diese Ansicht
verwenden.
SQL IMPERSONATE-Konto: Es ist ein SQL Server-Datenbankkonto mit der
Berechtigung IMPERSONATE für die oben beschriebenen Datenbankbenutzer
erforderlich. Hierbei handelt es sich um ein Konto mit der sysadmin-Rolle oder ein
Konto, dem die Berechtigung IMPERSONATE für die einzelnen Benutzerkonten
gewährt wurde (siehe den MSDN-Artkel zu EXECUTE AS). Dieses SQL Server-Konto
muss auf der Tableau-Seite einem der beiden folgenden Konten entsprechen:
l
l
Das Tableau Server-Konto "RunAs-Serverbenutzer" (siehe Identitätswechsel
mit dem Konto "Run As User" (Als Benutzer ausführen) Auf der nächsten
Seite).
Das Konto der Person, welche die Arbeitsmappe veröffentlicht hat (siehe
Identitätswechsel mit eingebetteten SQL-Anmeldeinformationen Auf Seite
386).
Funktionsweise des Identitätswechsels
Nachfolgende Abbildung zeigt, wie der Identitätswechsel von Datenbankbenutzern
funktioniert:
In der obigen Abbildung ist Jane Smith (MyCo\jsmith) eine Vertriebsmitarbeiterin in der Region
West Coast, und Henry Wilson (MyCo\hwilson) ist für die Region East Coast zuständig.
Geben Sie dem Konto von Jane Smith (MyCo\jsmith) in der SQL Server-Datenbank nur
Berechtigungen zum Zugriff auf die Daten der Region West Coast. Henrys Konto
(MyCo\hwilson) kann nur auf die Daten der Region East Coast zugreifen.
Es wurde eine Ansicht erstellt, in der Daten für das gesamte Land angezeigt werden. Die
Ansicht verfügt über eine Live-Verbindung mit der SQL Server-Datenbank. Beide Benutzer
melden sich bei Tableau Server an und klicken auf die Ansicht. Tableau Server stellt eine
Verbindung mit SQL Server her und verwendet hierzu ein Datenbankkonto, das für die
- 383 -
Datenbankkonten beider Benutzer über die IMPERSONATE-Berechtigung verfügt. Dieses
Konto agiert im Namen der Datenbankkonten der beiden Benutzer.
Die Anzeige der Ansicht wird durch die Datenbankberechtigungen der einzelnen Benutzer
beschränkt. Jane sieht nur die Umsatzdaten der Region West Coast, und Henry sieht nur die
Daten der Region East Coast.
Identitätswechsel mit dem Konto "Run As User" (Als Benutzer ausführen)
Identitätswechsel mit dem Konto "Run As User" (Als Benutzer ausführen) ist die empfohlene
Methode zur Durchführung von Identitätswechseln. Das Konto "Run As User" (Als Benutzer
ausführen) ist ein AD-Konto, unter dem der Tableau Server-Dienst auf dem Computer, der als
Host von Tableau Server fungiert, ausgeführt werden kann (siehe Run As User (Als
Benutzer ausführen) Auf Seite 373). Dieses Konto müssen über die IMPERSONATEBerechtigung für die Datenbankbenutzerkonten in SQL Server verfügen. Von der
Datensicherheit her gesehen, bietet die Verwendung des Tableau Server-Kontos "Run As
User" (Als Benutzer ausführen) Administratoren die umfassendsten Kontrollmöglichkeiten.
So richten Sie Identitätswechsel mit dem Konto "Run As User" (Als Benutzer ausführen) ein:
1. Bei der Konfiguration von Tableau Server im Rahmen der Installation geben Sie unter
Server-RunAs-Konto das AD-Konto "Run As User" (Als Benutzer ausführen) an, das
über IMPERSONATE-Berechtigungen für die Benutzerkonten verfügt. Wählen Sie
unter "Benutzerauthentifizierung" die Option Use Active Directory (Active Directory
verwenden) aus:
- 384 -
2. Klicken Sie auf OK, um die Konfiguration fertig zu stellen.
3. Erstellen Sie eine Arbeitsmappe in Tableau Desktop. Wenn Sie die Datenverbindung
erstellen, wählen Sie für die Live-Verbindung der Arbeitsmappe mit der SQL ServerDatenbank die Option Integrierte Sicherheit von Windows NT verwenden aus:
4. Veröffentlichen Sie die Arbeitsmappe in Tableau Desktop unter Tableau Server (Server
> Arbeitsmappe veröffentlichen).
5. Klicken Sie im Dialogfeld "Veröffentlichen" auf "Authentifizierung", und wählen Sie im
Dialogfeld "Authentifizierung" in der Dropdown-Liste die Option Identität per RunAsServerkonto annehmen aus:
- 385 -
6. Klicken Sie auf OK.
7. Testen Sie die Verbindung, indem Sie sich als Benutzer bei Tableau Server anmelden.
Wenn Sie auf eine Ansicht klicken, sollten Sie nicht zur Eingabe der
Anmeldeinformationen für die Datenbank aufgefordert werden und Sie sollten nur die
Daten sehen, zu deren Anzeige der betreffende Benutzer berechtigt ist.
Identitätswechsel mit eingebetteten SQL-Anmeldeinformationen
Ein Identitätswechsel kann auch durchgeführt werden, wenn die Person, die eine Ansicht
veröffentlicht, die Anmeldeinformationen für ihr SQL Server-Konto in die Ansicht einbettet.
Tableau Server kann unter jedem beliebigen Kontotyp ausgeführt werden, verwendet die von
der veröffentlichenden Person (Publisher) bereitgestellten Anmeldeinformationen jedoch, um
eine Verbindung mit der Datenbank herzustellen.
Dies kann für Ihren Standort die Methode der Wahl sein, wenn das Konto, das den
Identitätswechsel handhabt, kein AD-Konto sein kann und wenn es unbedenklich ist, dass
veröffentlichende Personen von Arbeitsmappen ein Konto mit einer potenziell hohen
Berechtigungsstufe auf SQL Server haben.
Hinweis:
Dieser Ansatz setzt voraus, dass Eingebettete Anmeldeinformationen auf Tableau Server
aktiviert worden ist:
- 386 -
So führen Sie einen Identitätswechsel mit dem SQL-Konto des Publishers der Arbeitsmappe
durch:
1. Erstellen Sie eine Arbeitsmappe in Tableau Desktop. Wenn Sie die Datenverbindung
erstellen, wählen Sie für die Live-Verbindung der Arbeitsmappe mit der SQL ServerDatenbank die Option "Spezifischen Benutzernamen und spezifisches Kennwort
verwenden" aus:
2. Veröffentlichen Sie die Arbeitsmappe auf Tableau Server (Server > Arbeitsmappe
veröffentlichen).
3. Klicken Sie im Dialogfeld "Veröffentlichen" auf "Authentifizierung", und wählen Sie im
Dialogfeld "Authentifizierung" in der Dropdown-Liste die Option Identität per
eingebettetem Kennwort annehmen aus:
- 387 -
4. Klicken Sie auf OK.
5. Testen Sie die Verbindung, indem Sie sich als Benutzer bei Tableau Server anmelden.
Wenn Sie auf eine Ansicht klicken, sollten Sie nicht zur Eingabe der
Anmeldeinformationen für die Datenbank aufgefordert werden und Sie sollten nur die
Daten sehen, zu deren Anzeige der betreffende Benutzer berechtigt ist.
TCP/IP-Ports
Die folgende Tabelle listet die Ports auf, die von Tableau Server standardmäßig verwendet
werden und die zur Bindung verfügbar sein müssen. Wenn die Windows-Firewall aktiviert ist,
öffnet Tableau Server die benötigten Ports. Sie brauchen sich nicht darum zu kümmern (bei
verteilten Installationen mit einem Arbeitscomputer, auf dem Windows 7 ausgeführt wird,
beziehen Sie sich auf die Tableau Knowledge Base).
Dynamische Port-Neuzuordnung
Wenn die dynamische Port-Neuzuordnung aktiviert ist (Standardeinstellung), versucht
Tableau Server zunächst, eine Bindung mit den Standard-Ports oder, sofern definiert, mit vom
Benutzer konfigurierten Ports herzustellen. Wenn die Ports nicht verfügbar sind, versucht
Tableau Server, die Prozesse anderen Ports neu zuzuordnen (beginnend mit Port 8000). Der
Gateway- und der SSL-Port werden nicht neu zugeordnet. Beim nächsten Neustart
verwendet Tableau Server wieder die Standard-Ports oder die konfigurierten Ports.
- 388 -
Wenn die dynamische Port-Neuzuordnung deaktiviert ist, versucht Tableau Server nicht, die
Prozesse neu zuzuordnen. Beim Erkennen eines Konflikts wird Tableau Server nicht
gestartet.
Sie können die dynamische Port-Neuzuordnung deaktivieren, indem Sie den Befehl
tabadmin set service.port_remapping.enabled verwenden. Weitere
Informationen finden Sie unter tabadmin set-Optionen Auf Seite 438.
ART VON INSTALLATION
Port
Verwendet durch
Serverprozess
Alle
Verteilt
Hochverfügbarkeit
Parameter
80
Gateway.
X
gateway.public.port,
worker0.gateway.port
443
SSL. Wenn Tableau
Server für SSL konfiguriert wurde, dann
leitet der Anwendungsserver Anfragen
an diesen Port weiter.
X
--
3729
Tableau ServerSetup.
X
--
Tableau-Arbeitsserver
in verteilten und hochverfügbaren Umge3730bungen (der primäre
3731
Tableau Server überwacht diese Ports
nicht).
Anwendungsserver
(Basis-Port 8000). Es
werden die auf 8000
nachfolgenden Ports
bis zur Anzahl der Pro8000 - zesse verwendet.
8059 Tableau Server wird
standardmäßig mit
zwei Anwendungsserver-Prozessen (Ports 8000
und 8001) installiert.
8060
PostgreSQL-Datenbank
X
X
--
X
wgserver.port
X
pgsql.port
- 389 -
ART VON INSTALLATION
Port
Verwendet durch
Serverprozess
8061
Firebird.
8062
Prozess, der die Erkennung in einer verteilten
Umgebung ausführt,
die für hohe Verfügbarkeit konfiguriert
wurde.
8080
Solr und Tomcat
HTTP
X
solr.port, tomcat.http.port1
8250
Hintergrundaufgaben
X
backgrounder.port
8755
Verwaltungsvorgang
in Tableau
X
tabadminservice.port
9090
Prozess, der die Replikation in einer verteilten Umgebung
ausführt, die für hohe
Verfügbarkeit konfiguriert wurde.
Alle
Verteilt
Hochverfügbarkeit
X
Parameter
firebird.port
X
X
pgsql.initport
rsync.port
VizQL-Server
(Basisport 9100).
Zudem werden die auf
9100 nachfolgenden
Ports bis zur Anzahl
der Prozesse ver9100 wendet. Tableau Ser9199
ver wird
standardmäßig mit
zwei VizQL-Serverprozessen (Ports
9100 und 9101) installiert.
X
vizqlserver.port
Datenserver
9700 - (Basisport 9700).
9899 Zudem werden die auf
9700 nachfolgenden
X
dataserver.port
1Für diese Parameter muss der gleiche Wert festgelegt werden.
- 390 -
ART VON INSTALLATION
Verteilt
Hochverfügbarkeit
Arbeitsserver und primärer Server zur Über27000 mittlung der
Lizenzierungsdaten in
27009 verteilten und hochverfügbaren Umgebungen.
X
X
--
Zur Übermittlung von
Lizenzierungsdaten in
einer verteilten und
hochverfügbaren
Umgebungen wird für
Arbeitscomputer und
den primären Server
dynamisch ein zusätzlicher Port ausgewählt.
Sie können stattdessen einen fixierten
Port (Empfehlung ist
27010) bestimmen.
Weitere Informationen
hierzu finden Sie in der
Tableau Knowledge
Base.Für Installationen, bei denen
sich der primäre Server in einer DMZ befindet, müssen diese
Anweisungen befolgt
werden.
X
X
--
Port
Verwendet durch
Serverprozess
Alle
Parameter
Ports bis zur Anzahl
der Prozesse verwendet. Tableau Server wird
standardmäßig mit
zwei Datenserverprozessen
(Ports 9700 und 9701)
installiert.
- 391 -
ART VON INSTALLATION
Port
Verwendet durch
Serverprozess
Daten-Engine.Tableau Server
wird mit einem DatenEngine-Prozess installiert.Es können maxi27042
mal zwei DatenEngine-Prozesse pro
Knoten auf bis zu zwei
Knoten in einem Cluster vorhanden sein.
Alle
Verteilt
Hochverfügbarkeit
X
Parameter
dataengine.port
Daten-Engine-Initialisierung in einer ver27043 teilten Umgebung, die
für hohe Verfügbarkeit
konfiguriert wurde.
X
Bearbeiten der Standardports
Sie können die von den Tableau Server-Prozessen verwendeten Standardports mit dem
administrativen Befehlszeilenprogramm tabadmin Auf Seite 417 ändern. Beispielsweise ist
der Standardport für den Anwendungsserverprozess (wgserver) 8000. Sie können den
tabadmin-Parameter workerX.wgserver.port verwenden, um einen anderen Port
anzugeben. Führen Sie die unten beschriebenen Schritte aus, um die Portkonfiguration in
Tableau Server zu ändern. Weitere Informationen zur Aktivierung der JMX-Ports des Servers
finden Sie unter Aktivieren von JMX-Ports Auf der nächsten Seite
1. Öffnen Sie als Administrator eine Eingabeaufforderung, und geben Sie Folgendes ein:
cd “C:\Program Files\Tableau\Tableau Server\8.3\bin”
2. Ändern Sie durch folgende Eingabe einen Portwert:
tabadmin set <workerX>.<parameter> <new port value>
In dem oben angegebenen Befehl bezieht sich <workerX> auf den Computer, dessen
Port Sie ändern möchten, <parameter> ist einer der Werte in der unten angegebenen
Tabelle (ein Serverprozessport wie z. B. wgserver.port), und <new port
value> ist die neue Portnummer, die der Serverprozess verwenden soll. Wenn
Tableau Server auf einem Computer ausgeführt wird, ist <workerX> gleich worker0.
Wenn Sie in einem Cluster arbeiten, ist worker0 der primäre, worker1 der erste
Arbeitsserver, worker2 der zweite Arbeitsserver usw. In diesem letzten Fall müssten
- 392 -
Sie den Befehl (von der Eingabeaufforderung auf dem primären Computer) je einmal für
jeden Computer im Cluster ausführen.
In diesem Beispiel wird der Port auf dem primären oder einem eigenständigen Server
für den Anwendungsserverprozess (wgserver) auf 8020 festgelegt:
tabadmin set worker0.wgserver.port 8020
Das folgende Beispiel legt den Port für einen Cluster mit 3 Computern (ein primärer und
zwei Arbeitscomputer) für den VizQL-Serverprozess auf 9200 fest.
tabadmin set worker0.vizqlserver.port 9200
tabadmin set worker1.vizqlserver.port 9200
tabadmin set worker2.vizqlserver.port 9200
Sie können die folgenden Parameter zum Ändern der entsprechenden Ports
verwenden (eine vollständige Liste der tabadmin-Parameter finden Sie unter TCP/IPPorts Auf Seite 388):
Zu ändernder Port Parameter
80
gateway.public.port, worker0.gateway.port
8000
wgserver.port
8060
pgsql.port
8080
solr.port, tomcat.http.port1
9100
vizqlserver.port
9700
dataserver.port
3. Nachdem Sie die erforderlichen Portkonfigurationsänderungen vorgenommen haben,
starten Sie die Tableau Server mit folgendem Befehl neu:
tabadmin restart
Während der Server neu gestartet wird, ist er für keinen Benutzer verfügbar. Warnen
Sie die Benutzer unbedingt vor dem Ausfall, bevor Sie diesen Vorgang ausführen, oder
planen Sie, diese Wartung außerhalb der Geschäftszeiten durchzuführen.
Aktivieren von JMX-Ports
Um Sie bei der Behandlung von Problemen mit Tableau Server zu unterstützen, werden Sie
möglicherweise vom Tableau-Support gebeten, die JMX-Ports des Servers zu aktivieren.
Diese Ports sind nützlich für Überwachung und Fehlerbehebung, z. B. mit Tools wie JConsole.
1Diese Parameter sollten auf den gleichen Wert festgelegt werden.
- 393 -
So aktivieren Sie JMX-Ports auf Tableau Server:
1. Halten Sie den Server an.
2. Geben Sie folgenden Befehl ein:
tabadmin set service.jmx_enabled true
3. Geben Sie Konfigurationsbefehl ein:
tabadmin configure
4. Starten Sie den Server.
JMX-Port-Liste
Hier finden Sie eine Liste aller JMX-Ports. Alle sind standardmäßig deaktiviert. Wenn diese
Ports aktiviert sind, werden sie für alle Arten von Installationen verwendet: Einzelserver,
verteilte und hochverfügbare:
Port
Verwendet durch Serverprozess
Parameter
8300 8359
Anwendungsserver JMX. Wird durch den bzw. die Anwen-dungsserverport(s) + 300 bestimmt.
8550
Hintergrundüberwachungs-JMX. Wird durch den Hintergrundport 8250 + 300 bestimmt.
--
9095
Service-Monitor-JMX.
svcmonitor.jmx.port
9400 9499
VizQL-Server-JMX. Wird durch den bzw. die VizQL-Serverport(s) + 300 bestimmt.
--
10000 10299
Datenserver-JMX. Wird durch den bzw. die Datenserverport(s) + 300 bestimmt.
--
Bestimmung der JMX-Ports
Die JMX-Ports für den Anwendungsserver (8300–8359), Hintergrundprozesskomponenten
(8550), VizQL Server (9400–9599) und den Datenserver (10000–10299) werden anhand der
Formel "Basisport + 300" zugewiesen (unter TCP/IP-Ports Auf Seite 388 finden Sie eine Liste
der Standardbasisports). Falls es mehrere Instanzen eines Prozesses gibt, hat zusätzlich jeder
einen JMX-Port. Wenn Sie Tableau Server beispielsweise zum Ausführen von vier Instanzen
des Anwendungsserverprozesses konfiguriert haben, dann werden die Ports 8000
(Standardbasisport), 8001, 8002 und 8003 verwendet. Die Anwendungsserver-JMX-Ports
8300 (Basisport + 300), 8301, 8302 und 8303 sind dann an ihre jeweiligen Prozessinstanzen
gebunden.
Auch wenn sie nicht direkt von Tableau Server verwendet werden – falls ein JMX-Port von
einer anderen Anwendung verwendet wird, werden Tableau Server-Prozesse nicht
ausgeführt. Darüber hinaus können JMX-Port nicht direkt mit tabadmin bearbeitet werden. Um
einen JMX-Port zu ändern, ändern Sie den Basisport für den entsprechenden Prozess.
- 394 -
Anders gesagt, wenn Port 10000 nicht für den Datenserver-JMX-Prozess verfügbar ist,
verwenden Sie tabadmin (wie unter Bearbeiten der Standardports Auf Seite 392
beschrieben), um den Basisport des Datenservers von 9700 in 9800 zu ändern. Daraufhin
wird der Datenserver-JMX-Port auf 11000 verschoben.
Um die Sicherheitsrisiken zu verringern, sollten Sie Ihre Firewall so konfigurieren, dass
externer Datenverkehr mit den JMX-Ports blockiert wird.
Wiederherstellen des Standardwerts für einen Port
Sie können den Standardwert für einen Port mit den unten beschriebenen Schritten
wiederherstellen:
1. Öffnen Sie als Administrator eine Eingabeaufforderung, und geben Sie Folgendes ein:
cd “C:\Program Files\Tableau\Tableau Server\8.3\bin”
2. Stellen Sie durch folgende Eingabe den Standardportwert wieder her:
tabadmin set <workerX>.<parameter> --default
Wenn Tableau Server auf einem Computer ausgeführt wird, ist <workerX> gleich
worker0. Wenn Sie in einem Cluster arbeiten, ist worker0 der primäre, worker1 der
erste Arbeitsserver, worker2 der zweite Arbeitsserver usw.
Nachfolgend finden Sie ein Beispiel:
tabadmin set worker0.wgserver.port --default
3. Starten Sie Tableau Server mit folgendem Befehl neu:
tabadmin restart
tabcmd
Das tabcmd-Dienstprogramm ist eines der beiden Befehlszeilenprogramme, das zusammen
mit Tableau Server installiert wird (das andere ist tabadmin Auf Seite 417). Die über tabcmd
eingegebenen Befehle dienen der Automatisierung von häufigen Aufgaben, z. B. dem
Veröffentlichen von Arbeitsmappen in Stapeln und der Verwaltung von Benutzern und
Gruppen.Das tabcmd-Dienstprogramm wird im bin-Ordner von Tableau Server installiert
(C:\Programme\Tableau Server\8.3\bin), aber Sie können tabcmd auch auf einem anderen
Computer installieren und ausführen. Weitere Informationen finden Sie in den folgenden
Themen:
Installieren von tabcmd
Das Befehlszeilenprogramm tabcmd wird standardmäßig mit Tableau Server installiert und
kann vom Bin-Ordner des Servers (beispielsweise C:\Program
- 395 -
Files\Tableau\Tableau Server\8.3\bin) aus ausgeführt werden.Sie können es
von dort aus ausführen. Zur flexiblen Verwaltung kann das Programm auch auf einem anderen
Computer installiert werden.
Wenn Sie das Befehlszeilenprogramm tabcmd auf einem Computer installiert haben, auf dem
Tableau Server nicht ausgeführt wird und Sie führen ein Upgrade von Tableau Server auf eine
neue Hauptversion aus (beispielsweise Version 8.2 zu Version 8.3), empfiehlt Tableau, auch
ein Upgrade der eigenständigen Version von tabcmd auszuführen, um mögliche
Inkompatibilitäten zwischen den Versionen zu vermeiden.
So installieren Sie tabcmd auf einem anderen Computer:
1. Navigieren Sie zum Ordner \"extras\" von Tableau Server:
C:\Program Files\Tableau\Tableau Server\8.3\extras\TabcmdInstaller.exe
2. Kopieren Sie TabcmdInstaller.exe auf den Computer, auf dem das Programm installiert
werden soll.
3. Doppelklicken Sie auf TabcmdInstaller.exe, um die Datei auszuführen.
4. Befolgen Sie die Anweisungen zur Installation von tabcmd.
Da tabmd ein Befehlszeilentool ist und das Windows-Betriebssystem einige
Beschränkungen aufweist, empfiehlt Tableau die Installation von tabcmd in einem
eigenen Ordner \"tabcmd\" im Stammverzeichnis von Laufwerk C:\ (C:\tabcmd).
Da tabcmd bei der Ausführung des Installationsprogramms nicht automatisch zur
Windows-Variablen PATH hinzugefügt wird, müssen Sie entweder tabcmd explizit mit
dem vollständigen Pfad aufrufen oder das Verzeichnis zur PATH-Variablen hinzufügen.
Vorgehensweise: tabcmd verwenden
Der erste Schritt bei der Verwendung von tabcmd ist das Öffnen einer Eingabeaufforderung
als Administrator. Navigieren Sie dann zum Ordner \"bin\" von Tableau Server (beispielsweise
C:\Program Files\Tableau\Tableau Server\8.3\bin), oder schließen Sie diesen Speicherort in
Ihre Befehle ein.
Damit Sie Aufgaben für Tableau Server mit tabcmd ausführen können, müssen Sie eine
Sitzung mit einem authentifizierten Server starten. Die Sitzung gibt den Tableau Server, den
Tableau Server-Benutzer an, der die Sitzung ausführt.Sie können zunächst die Sitzung
starten und dann Ihren Befehl angeben oder gleichzeitig eine Sitzung starten und einen Befehl
ausführen. Wenn Sie den tabcmd-Befehl zum Ausführen mehrerer Aufgaben verwenden,
müssen die Aufgaben nacheinander (seriell) und nicht gleichzeitig ausgeführt werden.
Mit dem folgenden Befehl wird das Starten einer Sitzung mit dem Tableau
Servertabserver.myco.com demonstriert:
tabcmd login -s http://tabserver.myco.com -u admin -p p@ssw0rd!
- 396 -
Beachten Sie beim Verwenden der tabcmd-Befehle, dass bei den Befehlen (z. B.
login) und den Optionen (z. B. -s, -u usw.) die Groß- und Kleinschreibung nicht
beachtet wird. Für die von Ihnen eingegebenen Werte (z. B. p@ssw0rd oder
[email protected]) gilt jedoch die Groß- und Kleinschreibung.
Dieser Befehl, mit dem eine Arbeitsmappe mit der Bezeichnung Sales_Workbook gelöscht
werden kann, befindet sich im gleichen Verzeichnis wie tabcmd:
tabcmd delete "Sales_Workbook"
Das oben Dargestellte kann auch mit nur einem Befehl durchgeführt werden. Beachten Sie,
dass in diesem Fall kein login erforderlich ist:
tabcmd delete "Sales_Workbook" -s http://tabserver.myco.com -u
admin -p p@ssw0rd!
Ein Tableau Server kann mehrere Sites ausführen. Wenn sich eine Arbeitsmappe auf der
Standardsite eines Servers mit mehreren Sites befindet, muss diese nicht angegeben werden,
und der obige Befehl ist ausreichend. Wenn sich der Befehl jedoch auf etwas auf einer Site
bezieht, die nicht die Standardsite ist, muss die Site-ID für diese Site angegeben werden
(siehe login Auf Seite 410). So lautet derselbe Befehl für eine Arbeitsmappe auf der Site
\"West Coast Sales\" (Site-ID wsales):
tabcmd delete "Sales_Workbook" -s http://tabserver.myco.com -t
wsales -u admin -p p@ssw0rd!
Die Optionen -s, -t, -u und -p gehören zu den globalen Variablen von tabcmd. Sie können
daher mit allen Befehlen verwendet werden.
Wenn der Befehl erfolgreich ausgeführt wurde, wird von tabcmd der Statuswert Null
zurückgegeben. Für Statuswerte ungleich Null wird eine ausführliche Fehlermeldung in stderr
ausgegeben. Zudem können Informations- oder Statusmeldungen in stdout ausgegeben
werden. Ein vollständiges Protokoll namens tabcmd.log mit Debugging-, Status- und
Fehlermeldungen wird in die folgende Datei ausgegeben:
l
l
Windows Server 2012, Windows Server 2008 R2, Windows Vista, Windows 7,
Windows 8: C:\Users\<username>\AppData\Roaming\Tableau
Windows Server 2003: C:\Documents and Settings\<username>\Application
Data\Tableau
tabcmd – Globale Optionen
Die nachstehende Tabelle enthält die Optionen, die in allen Befehlen verwendet werden.Die
Optionen --server, --user und --password müssen mindestens einmal am Anfang
einer Sitzung angegeben werden. Es wird ein Authentifizierungstoken gespeichert, damit
nachfolgende Befehle ohne Angabe dieser Optionen ausgeführt werden können. Diese Token
- 397 -
sind noch fünf Minuten lang nach der Eingabe des letzten Befehls, in dem sie verwendet
wurden, gültig.
Option
(kurz)
-h
-s
Option
(lang)
--help
--server
-u
--user
-p
--password
Argument
Tableau Server URL
Tableau Server Benutzername
Tableau Server Kennwort
--passfilename.txt
word-file
-t
--site
Tableau Server Site-ID
-x
--proxy
Host:Port
--noprompt
--noproxy
--no-certcheck
--[no-]
cookie
Beschreibung
Zeigt den Hilfetext für den Befehl an.
Ist mindestens einmal am Anfang der Sitzung erforderlich.
Ist mindestens einmal am Anfang der Sitzung erforderlich.
Ist mindestens einmal am Anfang der Sitzung erforderlich. Sie können stattdessen auch die Option -P verwenden.
Lässt zu, dass das Kennwort in der angegebenen Datei statt in der Befehlszeile
gespeichert wird, und erhöht damit die
Sicherheit.
Gibt an, dass der Befehl für die durch die
Site-ID angegebene Site gilt. Wenn Sie
keine Site angeben, wird angenommen,
dass es sich um die Site "Default" (Standard) handelt. Gilt nur für Server mit
mehreren Sites.
Verwendet den angegebenen HTTPProxy.
Wenn diese Option angegeben wird, fordert der Befehl nicht zur Eingabe eines
Kennworts auf. Wenn kein gültiges
Kennwort bereitgestellt wird, dann
schlägt der Befehl fehl.
Wenn diese Option angegeben wird,
wird kein HTTP-Proxy verwendet.
Wenn diese Option festgelegt ist, überprüft tabcmd (der Client) nicht das SSLZertifikat des Servers.
Wenn diese Option angegeben wird,
wird die Sitzungs-ID beim Anmelden
gespeichert, sodass für nachfolgende
Befehle keine Anmeldung erforderlich
ist. Verwenden Sie das Präfix no-,
wenn die Sitzungs-ID nicht gespeichert
werden soll. Standardmäßig wird die Sit-
- 398 -
Option Option
(kurz) (lang)
Argument
--timeout Sekunden
Beschreibung
zung gespeichert.
Wartet die angegebene Anzahl von
Sekunden darauf, dass der Server die
Befehlsverarbeitung abschließt. Standardmäßig gilt für den Prozess ein
Timout-Wert für 30 Sekunden.
tabcmd-Befehle
Die folgenden Befehle können mit dem Befehlszeilenprogramm tabcmd verwendet werden:
addusers group-name
export
creategroup group-name
get url
createproject project-name
listsites
createsite site-name
login
createsiteusers filename.csv
logout
createusers filename.csv
publish filename.twb(x),filename.tds(x),
or filename.tde
delete workbook-name or datasource-name
refreshextracts
workbookname or datasource-name
deletegroup group-name
removeusers
group-name
deleteproject project-name
runschedule
schedule-name
deletesite site-name
set setting
deleteusers filename.csv
syncgroup
group-name
editsite site-name
version
addusers group-name
Fügt die im Argument --users angegebenen Benutzer der Gruppe mit dem in group-name
angegebenen Namen hinzu.
Beispiel
- 399 -
tabcmd addusers "Development" --users "users.csv"
Option Option (lang)
(kurz)
--users
Argument
Beschreibung
filename.csv Fügt die Benutzer in der gegebenen Datei der angegebenen
Gruppe hinzu. Die Datei sollte eine
einfache Liste mit einem Benutzernamen pro Zeile enthalten. Die
Benutzer sollten bereits auf
Tableau Server erstellt worden
sein. Siehe auch Importieren
von Benutzern aus einer CSVDatei Auf Seite 183.
--[no-]complete
Bei der Angabe von complete
müssen alle Zeilen gültig sein,
damit Änderungen erfolgreich
durchgeführt werden. Wird nichts
angegeben, dann wird --complete verwendet.
creategroup group-name
Erstellt eine Gruppe mit dem gegebenen Gruppennamen. Verwenden Sie die Befehle
addusers (für lokale Gruppen) und syncgroup (für Active Directory-Gruppen), um
Benutzer hinzuzufügen, nachdem die Gruppe erstellt worden ist.
Beispiel
tabcmd creategroup "Development"
createproject project-name
Erstellt ein Projekt mit dem angegebenen Projektnamen.
Beispiel
tabcmd createproject -n "Quarterly_Reports" -d "Workbooks showing
quarterly sales reports."
Option
(kurz)
-n
-d
Option (lang)
Argument Beschreibung
--name
Name
--description
createsite site-name
Geben Sie den Namen des Projekts
an, das erstellt werden soll.
description Geben Sie eine Beschreibung für das
Projekt ein.
Erstellt eine Site mit dem gegebenen Site-Namen.
Beispiele
- 400 -
Erstellen Sie eine Site mit dem Namen "Umsatzdaten der Region West Coast". Die Site-ID
WestCoastSales wird automatisch erstellt, es gelten für die Site keine Beschränkungen
bezüglich des Speicherkontingents und die Site-Administratoren können Benutzer hinzufügen
und entfernen.
tabcmd createsite "West Coast Sales"
Erstellen Sie eine Site mit dem Namen West Coast Sales und der Site-ID wsales:
tabcmd createsite "West Coast Sales" -r "wcoast"
Site-Administratoren dürfen der Site keine Benutzer hinzufügen:
tabcmd createsite "West Coast Sales" --no-site-mode
Legen Sie das Speicherkontingent in MB fest:
tabcmd createsite "West Coast Sales" --storage-quota 100
Option Option
(kurz) (lang)
-r
--url
--userquota
--[no-]
sitemode
-storagequota
Argument
Beschreibung
Site-ID
Verwendet in URLs zur Angabe der Site.
Unterscheidet sich vom Site-Namen.
Maximale Anzahl an Benutzern, die der Site
hinzugefügt werden können.
Gewähren oder verweigern Sie SiteAdministratoren das Recht zum Hinzufügen und
Entfernen von Benutzern.
Die Anzahl an Arbeitsmappen, Extrakten und
Datenquellen, angegeben in MB, die auf einer Site
gespeichert werden können.
Anzahl der
Benutzer
Größe in MB
createsiteusers filename.csv
Dieser Befehl erlaubt es Site-Administratoren, einer Site Benutzer hinzuzufügen. Er erstellt die
Benutzer, die in der angegebenen CSV-Datei (Kommas als Trennzeichen) aufgelistet sind,
auf der aktuellen Site. Die Datei kann die folgenden Spalten in der unten angegebenen
Reihenfolge enthalten:
1. Username
2. Password
3. Full Name
4. License Level (interactor/viewer/unlicensed)
5. Administrator (site/none)
- 401 -
6. Publisher (yes/true/1 oder no/false/0)
7. Email Address
Die Datei kann weniger Spalten enthalten. Beispielsweise kann sie eine einfache Liste mit
einem Benutzernamen pro Zeile sein. Wenn auf dem Server die Active DirectoryAuthentifizierung verwendet wird, dann wird die Spalte Password ignoriert. Wenn ein Wert
Kommas enthält, können Anführungszeichen als Trennzeichen verwendet werden. Nähere
Informationen hierzu finden Sie unter Importieren von Benutzern aus einer CSV-Datei
Auf Seite 183.
Beispiel
tabcmd createsiteusers "users.csv" --license "Interactor" -publisher
Option Option
(kurz) (lang)
--nowait
Argument
Beschreibung
Nicht warten, bis asynchrone Aufträge
abgeschlossen worden sind.
--silentFür asynchrone Aufträge keine Staprogress
tusmeldungen anzeigen.
--license Interactor Legt die StandardLizenzstufe für alle
, Viewer
Benutzer fest. Diese Einstellung kann
oder Unlidurch den Wert in der CSV-Datei übercensed
schrieben werden.
--admin- Site oder
Weist allen Benutzern in der CSV-Datei
type
None
das Site-Administratorrecht zu oder entzieht dieses Recht. Diese Einstellung
kann durch den Wert in der CSV-Datei
überschrieben werden. Die Standardeinstellung ist None für neue Benutzer und "unchanged" für vorhandene
Benutzer. Systemadministratoren können nicht mit createsiteusers
erstellt oder zurückgesetzt werden (verwenden Sie stattdessen
createusers).
--[no-]
Weist allen Benutzern in der CSV-Datei
publisher
standardmäßig das Veröffentlichungsrecht zu oder entzieht dieses Recht. Diese Einstellung kann durch
den Wert in der CSV-Datei überschrieben werden. Die Standardeinstellung ist no für neue Benutzer
und "unchanged" für vorhandene Benut-
- 402 -
Option Option
(kurz) (lang)
Argument
Beschreibung
zer.
Es müssen (nicht) alle Zeilen gültig sein,
damit Änderungen erfolgreich durchgeführt werden. Standardmäßig wird
die Option --complete verwendet.
--[no-]
complete
createusers filename.csv
Erstellt die Benutzer, die in der angegebenen CSV-Datei (Kommas als Trennzeichen)
aufgelistet sind. Dieser Befehl kann nur von Systemadministratoren verwendet werden. Die
Datei kann die folgenden Spalten in der unten angegebenen Reihenfolge enthalten:
1. Username
2. Password
3. Full Name
4. License Level (interactor/viewer/unlicensed)
5. Administrator (system/site/none)
6. Publisher (yes/true/1 oder no/false/0)
7. Email Address
Die Datei kann weniger Spalten enthalten. Beispielsweise kann sie eine einfache Liste mit
einem Benutzernamen pro Zeile sein. Wenn auf dem Server Active DirectoryAuthentifizierung verwendet wird, sollte die Spalte Password leer gelassen werden. Wenn
ein Wert Kommas enthält, können Anführungszeichen als Trennzeichen verwendet werden.
Nähere Informationen hierzu finden Sie unter Importieren von Benutzern aus einer CSVDatei Auf Seite 183.
Beispiel
tabcmd createusers "users.csv" --license "Interactor" --publisher
Option Option
(kurz) (lang)
--nowait
Argument
Beschreibung
Nicht warten, bis asynchrone Aufträge
abgeschlossen worden sind.
--silentFür asynchrone Aufträge keine Staprogress
tusmeldungen anzeigen.
--license Interactor Legt die StandardLizenzstufe für alle
, Viewer
Benutzer fest. Diese Einstellung kann
oder Unlidurch den Wert in der CSV-Datei übercensed
schrieben werden.
- 403 -
Option Option
(kurz) (lang)
--admintype
Argument
Beschreibung
Weist allen Benutzern in der CSV-Datei
standardmäßig das Admin-Recht zu
oder entzieht dieses Recht. Diese Einstellung kann durch den Wert in der
CSV-Datei überschrieben werden. Die
Standardeinstellung ist None für neue
Benutzer und "unchanged" für vorhandene Benutzer.
--[no-]
Weist allen Benutzern in der CSV-Datei
publisher
standardmäßig das Recht zum Veröffentlichen zu oder entzieht dieses
Recht. Diese Einstellung kann durch den
Wert in der CSV-Datei überschrieben
werden. Die Standardeinstellung ist no
für neue Benutzer und "unchanged" für
vorhandene Benutzer.
--[no-]
Änderungen werden nur dann erfolgcomplete
reich durchgeführt, wenn alle Zeilen gültig sind. Standardmäßig wird die Option
--complete verwendet.
delete workbook-name or datasource-name
System,
Site oder
None
Löscht die angegebene Arbeitsmappe oder Datenquelle vom Server. Diesem Befehl wird der
auf dem Server verwendete Name der Arbeitsmappe oder der Datenquelle übergeben und
nicht der Dateiname, der beim Veröffentlichen verwendet wurde.
Beispiel
tabcmd delete "Sales_Analysis"
Option Option
(kurz) (lang)
-r
--project
Argument
Beschreibung
Projektname
Der Name des Projekts, das die zu
löschende Arbeitsmappe oder
Datenquelle enthält. Sofern keine
Angabe erfolgt, wird das Projekt
"Standard" verwendet.
--workbook Arbeitsmappenname Der Name der zu löschenden
Arbeitsmappe.
--dataDatenquellenname Der Name der zu löschenden
source
Datenquelle.
deletegroup group-name
Löscht die Gruppe mit dem in group-name angegebenen Gruppennamen vom Server.
- 404 -
Beispiel
tabcmd deletegroup "Development"
deleteproject project-name
Löscht das Projekt mit dem in "project-name" angegebenen Projektnamen vom Server.
Beispiel
tabcmd deleteproject "Designs"
deletesite site-name
Löscht die Site mit dem in site-name angegebenen Site-Namen vom Server.
Beispiel
tabcmd deletesite "Development"
deleteusers filename.csv
Löscht die Benutzer, die in der angegebenen CSV-Datei (Kommas als Trennzeichen)
aufgelistet sind. Die Datei ist eine einfache Liste mit einem Benutzernamen pro Zeile.
Beispiel
tabcmd deleteusers "users.csv"
Option Option
Argument Beschreibung
(kurz) (lang)
--[no-]
Bei der Angabe von --complete müssen
complete
alle Zeilen gültig sein, damit Änderungen
erfolgreich durchgeführt werden. Wird nichts
angegeben, dann wird --complete verwendet.
editsite site-name
Ändert den Namen einer Site oder eines Webordners. Sie können diesen Befehl auch
verwenden, um Site-Administratoren das Recht zum Hinzufügen und Entfernen von
Benutzern zuzuweisen oder zu entziehen. Wenn Site-Administratoren das Recht zur
Benutzerverwaltung haben, können Sie festlegen, wie viele Benutzer sie zu einer Site
hinzufügen können.
Beispiele
tabcmd editsite wc_sales --site-name "West Coast Sales"
tabcmd editsite wc_sales --site-id "wsales"
- 405 -
tabcmd editsite wsales --status ACTIVE
tabcmd editsite wsales --user-quota 50
Option
(lang)
--sitename
--siteid
Argument
Beschreibung
Name, in den die
Site geändert werden soll
Site-ID, in den die
Site geändert werden soll
Anzahl der Benutzer
Der anzeigte Name der Site.
--userquota
--[no-]
sitemode
--status AKTIV oder
UNTERBROCHEN
--stoGröße in MB
ragequota
export
Verwendet in der URL zur eindeutigen Identifizierung der Site.
Maximale Benutzeranzahl, die Mitglieder dieser Site sein können.
Gewähren oder verweigern Sie Site-Administratoren das Recht zum Hinzufügen von
Benutzern zur Site.
Aktivieren Sie die Site, oder setzen Sie sie
außer Kraft.
Die Anzahl an Arbeitsmappen, Extrakten und
Datenquellen, angegeben in MB, die auf einer
Site gespeichert werden können.
Exportiert eine Ansicht oder Arbeitsmappe aus Tableau Server und speichert diese in einer
Datei. Beachten Sie Folgendes bei der Verwendung dieses Befehls:
l
l
Berechtigungen: Zum Exportieren benötigen Sie die Berechtigung für Bild
exportieren. Standardmäßig wird diese Berechtigung für alle Rollen zugelassen oder
vererbt, wobei Berechtigungen auch per Arbeitsmappe oder Ansicht festgelegt werden
können.
Die exportierte Ansicht, Arbeitsmappe oder Daten: Geben Sie dies anhand der
Zeichenfolge "workbook/view" an, wie sie in der URL für die Arbeitsmappe oder die
Ansicht angezeigt wird. Verwenden Sie nicht den “benutzerfreundlichen Namen”, und
geben Sie nicht das Rautenzeichen (#) und die Nummer am Ende der URL ein. Um
beispielsweise die Tableau-Beispielansicht Investment Growth aus der Arbeitsmappe
Finance anzuzeigen, müssten Sie die Zeichenfolge Finance/InvestmentGrowth
und nicht Finance/Investment Growth oder
Finance/InvestmentGrowth#1 eingeben. Verwenden Sie -t <site_id>, falls
der Server mehrere Sites ausführt und die Ansicht sich nicht auf der Standardsite
befindet.
Zum Exportieren einer Arbeitsmappe schließen Sie eine gültige Ansicht in die
verwendete Zeichenfolge ein. Um in dem oben angegebenen Beispiel die Arbeitsmappe
Finance zu exportieren, verwenden Sie die Zeichenfolge
- 406 -
Finance/InvestmentGrowth. Damit eine Arbeitsmappe exportiert werden kann,
muss sie mit Blätter als Registerkarten anzeigen im Dialogfeld "Veröffentlichen" von
Tableau Desktop veröffentlicht worden sein.
l
l
l
Das Format der gespeicherten Datei: Die Formatoptionen hängen davon ab, was
exportiert wird. Eine Arbeitsmappe kann nur mit dem Argument --fullpdf als PDF
exportiert werden. Eine Ansicht kann als PDF (--pdf), als PNG (--png) oder die
Ansichtsdaten als CSV-Datei (--csv) exportiert werden.
Name und Speicherort der gespeicherten Datei (optional): Wenn Sie keinen
Namen angeben, wird er aus der Ansicht oder dem Namen der Arbeitsmappe
abgeleitet. Wenn Sie keinen Speicherort angeben, wird die Datei im aktuellen
Arbeitsverzeichnis gespeichert. Andernfalls können Sie einen vollständigen Pfad oder
einen Pfad relativ zum aktuellen Arbeitsverzeichnis angeben.
Objekte von Dashboard-Webseiten, die nicht in PDF-Exporten enthalten sind:
Dashboards können optional Webseitenobjekte enthalten. Wenn ein Dashboard mit
einem Webseitenobjekt in eine PDF-Datei exportiert wird, ist das Webseitenobjekt nicht
im PDF enthalten.
Löschen des Cache zur Verwendung von Echtzeitdaten
Sie können optional den URL-Parameter ?:refresh=yes hinzufügen, damit eine erneute
Datenabfrage erfolgt und die Ergebnisse nicht aus dem Cache abgerufen werden. Wenn
tabcmd mit eigenen Skripten verwendet wird und der URL-Parameter refresh häufig
auftritt, kann die Leistung beeinträchtigt werden. Der Parameter refresh sollte nur
verwendet werden, wenn Echtzeitdaten erforderlich sind, beispielsweise für ein einzelnes
Dashboard, nicht jedoch für eine gesamte Arbeitsmappe.
Beispiele
Ansichten
tabcmd export "Q1Sales/Sales_Report" --csv -f "Weekly-Report"
tabcmd export -t Sales "Sales/Sales_Analysis" --pdf -f
"C:\Tableau_Workbooks\Weekly-Reports"
tabcmd export "Finance/InvestmentGrowth" --png
tabcmd export "Finance/InvestmentGrowth?:refresh=yes" --png
Arbeitsmappen
tabcmd export "Q1Sales/Sales_Report" --fullpdf
tabcmd export -t Sales "Sales/Sales_Analysis" --fullpdf -pagesize tabloid -f "C:\Tableau_Workbooks\Weekly-Reports"
- 407 -
Option Option
Argument
(kurz) (lang)
-f
--filename Der Name und die Erweiterung, die für die gespeicherte Datei verwendet
werden
--csv
--pdf
--png
--fullpdf
--pagelayout
landscape, portrait
--pagesize unspecified, letter, legal, note
folio, tabloid,
ledger, statement, executive,
a3, a4, a5, b4,
b5, quatro
--width
Anzahl der Pixel
--height
Anzahl der Pixel
Beschreibung
Speichert die Datei mit
dem angegebenen Dateinamen.
Nur Ansicht. Exportiert die
Daten der Ansicht im
CSV-Format.
Nur Ansicht. Export als
PDF-Datei.
Nur Ansicht. Export als
Bild im PNG-Format.
Nur Arbeitsmappe. Export
als PDF-Datei. Die
Arbeitsmappe muss mit
aktivierter Option Blätter
als Registerkarten
anzeigen veröffentlicht
worden sein.
Legt die Seitenausrichtung der exportierten PDF-Datei fest.
Falls nichts angegeben
ist, wird die Tableau
Desktop-Einstellung verwendet.
Legt die Seitengröße der
exportierten PDF-Datei
fest. Standard ist
letter.
Legt die Breite fest. Der
Standard ist 800 px.
Legt die Höhe fest. Der
Standardwert ist 600 px.
get url
Durch die Verwendung einer URL-Zeichenfolge als ein Parameter wird eine HTTP GETAnforderung an Tableau Server gestellt. Das Ergebnis wird als Datei zurückgegeben.
Beachten Sie Folgendes bei der Verwendung dieses Befehls:
- 408 -
l
l
Berechtigungen: Zum Abrufen einer Datei benötigen Sie die Berechtigung
Herunterladen/Im Web speichern unter. Standardmäßig wird diese Berechtigung
für alle Rollen zugelassen oder vererbt, wobei Berechtigungen auch per Arbeitsmappe
oder Ansicht festgelegt werden können.
Dateierweiterung: Die URL muss eine Dateierweiterung enthalten, beispielsweise
"/views/Finance/InvestmentGrowth.pdf". Die Erweiterung (.pdf) bestimmt,
was zurückgegeben wird. Eine Ansicht kann im Format PDF, PNG, CSV (nur Daten)
oder XML (nur Informationen) zurückgegeben werden. Eine Tableau-Arbeitsmappe
wird als TWB-Datei zurückgegeben, wenn eine Verbindung zu einer veröffentlichten
Datenquelle hergestellt wurde oder eine Direktverbindung verwendet wird oder als
TWBX-Datei, wenn eine Verbindung zu einem Datenextrakt hergestellt wurde.
Um die richtige Erweiterung zu ermitteln, können Sie mit einem Webbrowser zum
entsprechenden Element in Tableau Server navigieren und die Dateierweiterung an das
Ende der URL anhängen.
Geben Sie bei der URL für die GET-Anforderunge nicht das Rautenzeichen (#) und die
Nummer am Ende des Dateinames ein.Verwenden Sie beispielsweise
"/views/Finance/InvestmentGrowth.pdf" statt
"/views/Finance/InvestmentGrowth#3.pdf".
l
l
Name und Speicherort der gespeicherten Datei (optional): Der Name, den Sie für -filename verwenden, sollte die Dateierweiterung umfassen. Wenn Sie keinen
Namen und keine Dateierweiterung angeben, werden diese aus der URL-Zeichenfolge
abgeleitet. Wenn Sie keinen Speicherort angeben, wird die Datei im aktuellen
Arbeitsverzeichnis gespeichert. Andernfalls können Sie einen vollständigen Pfad oder
einen Pfad relativ zum aktuellen Arbeitsverzeichnis angeben.
PNG-Größe (optional): Wenn es sich bei der gespeicherten Datei um eine PNG-Datei
handelt, können Sie die Größe in Pixeln in der URL angeben.
Löschen des Cache zur Verwendung von Echtzeitdaten
Sie können optional den URL-Parameter ?:refresh=yes hinzufügen, damit eine erneute
Datenabfrage erfolgt und die Ergebnisse nicht aus dem Cache abgerufen werden. Wenn
tabcmd mit eigenen Skripts verwendet wird und der Parameter refresh häufig auftritt, kann
die Leistung beeinträchtigt werden. Der Parameter refresh sollte nur verwendet werden,
wenn Echtzeitdaten erforderlich sind, beispielsweise für ein einzelnes Dashboard, nicht jedoch
für eine gesamte Arbeitsmappe.
Beispiele
Ansichten
tabcmd get "/views/Sales_Analysis/Sales_Report.png" --filename
"Weekly-Report.png"
tabcmd get "/views/Finance/InvestmentGrowth.pdf" -f
"Q1Growth.pdf"
tabcmd get "/views/Finance/InvestmentGrowth.csv"
- 409 -
tabcmd get "/views/Finance/InvestmentGrowth.png?:size=640,480" -f
growth.png
tabcmd get "/views/Finance/InvestmentGrowth.png?:refresh=yes" -f
growth.png
Arbeitsmappen
tabcmd get "/workbooks/Sales_Analysis.twb" -f "C:\Tableau_
Workbooks\Weekly-Reports.twb"
tabcmd get "/workbooks/Sales.xml"
Andere
tabcmd get "/users.xml" --filename "UserList.xml"
Option Option
Argument
Beschreibung
(kurz) (lang)
-f
-Name, unter dem die
Speichert die Datei mit dem
filename Datei gespeichert werden angegebenen Dateinamen.
soll
listsites
Gibt eine Liste von Sites aus, bei denen der angemeldete Benutzer Mitglied ist.
Beispiel
tabcmd listsites -u corman -pw P@ssword!
login
Meldet einen Tableau Server-Benutzer an. Verwenden Sie die globalen Optionen --server,
--site, --username, --password, um eine Sitzung zu erstellen. Wenn Sie sich mit den
gleichen Daten anmelden möchten, die Sie bereits zum Erstellen einer Sitzung verwendet
haben, dann geben Sie nur die Option --password an. Der Server und der Benutzername,
die im Cookie gespeichert wurden, werden verwendet.
Wenn der Server einen anderen Port als 80 (dies ist der Standardwert) verwendet, müssen
Sie den Port angeben.
Sie benötigen die Option --site (-t) nur, wenn auf dem Server mehrere Sites ausgeführt
werden, und Sie sich bei einer anderen Site anmelden als bei der Standardsite. Wenn Sie kein
Kennwort angeben, werden Sie zur Kennworteingabe aufgefordert. Wenn die Option --noprompt angegeben und kein Kennwort bereitgestellt wird, schlägt der Befehl fehl.
Nach der Anmeldung wird die Sitzung fortgesetzt, bis sie auf dem Server abläuft oder der
Befehl logout ausgeführt wird.
Beispiel
Anmeldung bei der auf dem lokalen Computer ausgeführten Instanz von Tableau Server:
tabcmd login -s http://localhost -u jsmith -p p@ssw0rd!
- 410 -
Anmeldung bei der Site \"Sales\" auf dem Server \"sales-server\":
tabcmd login -s http://sales-server -t Sales -u administrator -p
p@ssw0rd!
tabcmd login -s http://sales-server:8000 -t Sales -u
administrator -p p@ssw0rd!
Anmeldung bei der Site \"Sales\" auf dem Server \"sales-server\" mit SSL:
tabcmd login -s https://sales-server -t Sales -u administrator -p
p@ssw0rd!
Richtet einen Forward-Proxy und einen Port für "localhost" ein:
tabcmd login --proxy myfwdproxyserver:8888 -s http://localhost -u
jsmith -p p@ssW0rd!
Meldet Sie beim Reverse-Proxy mithilfe von SSL an:
tabcmd login -s https://myreverseproxy -u jsmith -p p@ssW0rd!
Option Option
(kurz) (lang)
-s
--server
-t
-u
--site
-username
Argument
Beschreibung
Server-URL
Wenn Sie den Befehl von einem stationären
Tableau Server-Computer aus ausführen, können
Sie "http://localhost" verwenden. Geben Sie
andernfalls die URL des Computers an,
beispielsweise http://bigbox.myco.com
oder http://bigbox.
Site-ID
username
Geben Sie für Tableau Online
https://online.tableausoftware.com.
ein.
Verwenden Sie diese Option, wenn auf dem
Server mehrere Sites ausgeführt werden und Sie
sich auf einer anderen Site anmelden als auf der
Site "Standard".
Die Site-ID wird in der URL zur eindeutigen
Identifizierung der Site verwendet.Eine Site mit
dem Namen "West Coast Sales" (Umsatzdaten
der Region West Coast) kann die Site-ID "westcoast-sales" haben.
Der Benutzername des Benutzers, der sich
anmeldet. Für Tableau Online entspricht der
Benutzername der E-Mail-Adresse des
Benutzers.
- 411 -
Option Option
(kurz) (lang)
-p
-password
-x
Argument
Beschreibung
Kennwort
Das Kennwort für den mittels --username
angegebenen Benutzer. Wenn Sie kein Kennwort
angeben, werden Sie zur Kennworteingabe
aufgefordert.
-filename.txt Lässt zu, dass das Kennwort in der angegebenen
passwordDatei statt in der Befehlszeile gespeichert wird,
file
und erhöht damit die Sicherheit.
--proxy
Host:Port
Hiermit geben Sie den HTTP-Proxy-Server und
Port für die tabcmd-Abfrage an.
--noNicht nach einem Kennwort fragen. Wenn kein
prompt
gültiges Kennwort festgelegt wird, schlägt der
Befehl login fehl.
--noEs wird kein HTTP-Proxy-Server verwendet.
proxy
--[no-]
Speichert die Sitzungs-ID bei der Anmeldung. Bei
cookie
darauffolgenden Befehlen ist keine Anmeldung
erforderlich. Cookies sind standardmäßig aktiviert
(--cookie).
--timeout Anzahl von
Die Anzahl von Sekunden, die der Server vor
SECONDS
Sekunden
Verarbeitung des Befehls login abwartet.
Standard: 30 Sekunden.
logout
Führt eine Abmeldung vom Server durch.
Beispiel
tabcmd logout
publish filename.twb(x), filename.tds(x) oder filename.tde
Veröffentlicht die entsprechende Arbeitsmappe (.twb(x)) bzw. Datenquelle (.tds(x)) oder den
Datenextrakt (.tde) bei Tableau Server. Standardmäßig werden alle Blätter der Arbeitsmappe
ohne Datenbankbenutzernamen oder -kennwörter veröffentlicht.
Wenn die Arbeitsmappe Benutzerfilter enthält, muss eine der Miniaturansichtsoptionen
angegeben werden.
Beispiel
tabcmd publish "analysis.twbx" -n "Sales_Analysis" --db-username
"jsmith" --db-password "p@ssw0rd"
Wenn sich die Datei nicht im gleichen Verzeichnis wie tabcmd befindet, geben Sie den
vollständigen Pfad zur Datei ein.
Beispiel
- 412 -
tabcmd publish "C:\Tableau Workbooks\analysis.twbx" -n "Sales_
Analysis" --db-username "jsmith" --db-password "p@ssw0rd"
Option Option (lang)
(kurz)
-n
--name
-o
--overwrite
-r
--project
--db-username
--db-password
--save-dbpassword
--thumbnail-username
Argument
Beschreibung
Name der
Arbeitsmappe
oder Datenquelle auf
dem Server.
Wenn diese Option nicht angegeben wird, wird die Arbeitsmappe bzw. Datenquelle oder
der Datenextrakt nach dem
Dateinamen benannt.
Überschreibt die Arbeitsmappe
bzw. Datenquelle oder den
Datenextrakt, wenn er bereits
auf dem Server vorhanden ist.
Veröffentlicht die Arbeitsmappe
bzw. Datenquelle oder den
Datenextrakt im angegebenen
Projekt. Wenn kein Projekt angegeben wird, erfolgt die Veröffentlichung im Projekt
"Standard".
Verwenden Sie diese Option,
um einen
Datenbankbenutzernamen mit
der Arbeitsmappe bzw.
Datenquelle oder dem
Datenextrakt zu veröffentlichen.
Verwenden Sie diese Option,
um ein Datenbankkennwort mit
der Arbeitsmappe bzw. Datenquelle oder dem Datenextrakt zu
veröffentlichen.
Speichert das angegebene
Datenbankkennwort auf dem
Server.
Wenn die Arbeitsmappe Benutzerfilter enthält, wird die Miniaturansicht auf der Grundlage der
für den angegebenen Benutzer
geltenden Filterkriterien generiert. Kann nicht zusammen mit
der Option --thumbnailgroup angegeben werden.
Name eines
Projekts
- 413 -
Option Option (lang)
(kurz)
--thumbnail-group
Argument
Beschreibung
Wenn die Arbeitsmappe Benutzerfilter enthält, wird die Miniaturansicht auf der Grundlage der
für die angegebene Gruppe geltenden Filterkriterien generiert.
Kann nicht zusammen mit der
Option --thumbnail-username angegeben werden.
--tabbed
Wenn eine Arbeitsmappe mit
Ansichten mit Registerkarten veröffentlicht wird, wird jedes Blatt
zu einer Registerkarte, mit deren
Hilfe Betrachter durch die
Arbeitsmappe navigieren können. Beachten Sie, dass diese
Einstellungen alle Sicherheitseinstellungen auf Blattebene außer Kraft setzt.
--append
Die Extraktdatei wird der vorhandenen Datenquelle angehängt.
--replace
Die vorhandene Datenquelle
wird durch die Extraktdatei
ersetzt.
--disableDer inkrementelle Datei-Uploauploader
der wird deaktiviert.
--disableDie Komprimierung der Extrakttde-comdatei wird vor dem Upload angepression
halten.
--restart
Die Datei wird erneut hochgeladen.
refreshextracts workbook-name or datasource-name
Führt eine vollständige oder eine inkrementelle Aktualisierung der Extrakte durch, die der
angegebenen Arbeitsmappe oder Datenquelle zugeordnet sind. Diesem Befehl wird der auf
dem Server verwendete Name der Arbeitsmappe oder der Datenquelle übergeben und nicht
der Dateiname, der beim Veröffentlichen verwendet wurde.Dieser Vorgang darf nur von
einem Administrator oder dem Eigentümer der Arbeitsmappe oder der Datenquelle ausgeführt
werden.
Beispiele
tabcmd refreshextracts --datasource sales_ds
- 414 -
tabcmd refreshextracts --workbook "My Workbook"
tabcmd refreshextracts --url SalesAnalysis
Option Option (lang)
(kurz)
--incremental
--synchronous
Argument
Beschreibung
Führt den inkrementellen Aktualisierungsvorgang aus.
Führt den vollständigen Aktualisierungsvorgang sofort im Vordergrund aus.
--workbook Name einer
Der Name der Arbeitsmappe, die zu
Arbeitsmappe aktualisierende Extrakte enthält.
Wenn der Name der Arbeitsmappe
Leerzeichen enthält, muss er in Anführungszeichen eingeschlossen werden.
--dataName einer
Der Name der Datenquelle, die zu
source
Datenquelle aktualisierende Extrakte enthält.
--project
Name eines Verwenden Sie diesen gemeinsam
Projekts
mit --workbook oder --datasource, um eine Arbeitsmappe oder
Datenquelle in einem Projekt zu identifizieren, bei dem es sich nicht um das
Projekt Standard handelt. Sofern
keine Angabe erfolgt, wird das Projekt
"Standard" verwendet.
--url
URL-Name
Der Name der Arbeitsmappe, der in
einer Arbeits- der URL angezeigt wird. Eine als
mappe
"Sales Analysis" veröffentlichte
Arbeitsmappe hat den URL-Namen
"SalesAnalysis".
removeusers group-name
Entfernt die im Argument --users angegebenen Benutzer aus der Gruppe mit dem in groupname angegebenen Namen.
Beispiel
tabcmd removeusers "Development" --users "users.csv"
Option Option
(kurz) (lang)
--users
Argument
Beschreibung
filename.csv Entfernt die Benutzer in der gegebenen
Datei aus der angegebenen Gruppe. Die
Datei sollte eine einfache Liste mit einem
- 415 -
Option Option
(kurz) (lang)
Argument
Beschreibung
Benutzernamen pro Zeile enthalten.
Änderungen werden nur dann erfolgreich
durchgeführt, wenn alle Zeilen gültig sind.
Wird nichts angegeben, dann wird --complete verwendet.
--[no-]
complete
runschedule schedule-name
Führt den angegebenen Zeitplan aus. Diesem Befehl wird der auf dem Server verwendete
Name des Zeitplans übergeben.
Beispiel
tabcmd runschedule "5AM Sales Refresh"
set setting
Aktiviert die angegebene Einstellung auf dem Server. Nähere Informationen zu den einzelnen
Einstellungen werden auf der Wartungsseite auf dem Server angezeigt. Durch Angabe des
Einstellungsnamens mit vorangestelltem Ausrufezeichen wird die Einstellung deaktiviert. Sie
können die folgenden Einstellungen aktivieren und deaktivieren:
l
Zeitplanung_zulassen
l
embedded_credentials
l
remember_passwords_forever
Beispiel
tabcmd set embedded_credentials
syncgroup group-name
Synchronisiert die Gruppe mit dem in group-name angegebenen Gruppennamen mit Active
Directory. Dieser Befehl kann auch verwendet werden, um eine neue, auf einer vorhandenen
Active Directory-Gruppe basierende Gruppe auf dem Server zu erstellen.
Beispiel
tabcmd syncgroup "Development"
Option Option (lang)
(kurz)
--license
--administrator
Argument
Beschreibung
viewer
interactor
unlicensed
system
site none
Legt die Standard-Lizenzstufe für
alle Benutzer in der Gruppe fest.
Weist allen Benutzern in der
Gruppe das Administratorrecht zu
- 416 -
Option Option (lang)
(kurz)
--[no-]publisher
--[no-]complete
--silent-progress
Argument
Beschreibung
oder entzieht dieses Recht. Der
Administratorbenutzertyp kann
"System", "Site" oder "Keine" sein.
Die Standardeinstellung ist "none"
(neue Benutzer erhalten keine
Administratorrechte), und vorhandene Benutzer werden nicht
geändert.
Weist allen Benutzern in der
Gruppe das Veröffentlichungsrecht
zu oder entzieht dieses Recht. Fehlt
die Angabe, wird dieses Recht
neuen Benutzern nicht zugewiesen, und vorhandene Benutzer
werden nicht geändert.
Änderungen werden nur dann
erfolgreich durchgeführt, wenn alle
Zeilen gültig sind. Wird nichts angegeben, dann wird --complete
verwendet.
Unterdrückt Statusmeldungen.
version
Druckt die Versionsinformationen für die aktuelle Installation des Dienstprogramms tabcmd
aus.
Beispiel
tabcmd version
tabadmin
Mit dem Befehlszeilenprogramm tabadmin können Sie bestimmte Verwaltungsaufgaben
ausführen und Tableau Server-Konfigurationseinstellungen ändern. Es wird standardmäßig
zusammen mit Tableau Server installiert und kann nicht auf anderen Computern installiert
werden. Weitere Informationen finden Sie in den folgenden Themen:
Vorgehensweise: tabadmin verwenden
Mithilfe von tabadmin können Sie administrative Aufgaben in Tableau Server von der
Befehlszeile aus erledigen. Es wird standardmäßig zusammen mit Tableau Server installiert
und kann nicht auf anderen Computern installiert werden. Der erste Schritt bei der
Verwendung von "tabcmd" ist das Öffnen einer Eingabeaufforderung als Administrator.
- 417 -
Navigieren Sie anschließend zum BIN-Verzeichnis von Tableau Server, indem Sie Folgendes
eingeben:
cd "C:\Program Files\Tableau\Tableau Server\8.3\bin"
Sie können nun tabadmin-Befehle eingeben.
Ändern der Tableau Server-Konfiguration an der Befehlszeile
Wenn Sie einen Befehl eingeben, der die Konfiguration des Servers ändert (beispielsweise
den Befehl tabadmin set), müssen Sie folgende Befehlsfolge einhalten.
1. Halten Sie den Server an, bevor Sie den Befehl starten.
2. Geben Sie den richtigen Befehl ein, um die Konfigurationsänderung vorzunehmen.
3. Führen Sie tabadmin config aus, um die Änderung auf alle Konfigurationsdateien
des Servers zu übertragen.
4. Tableau ServerStarten Sie erneut.
Beispiel
Ändern Sie die Konfiguration des Servers mit dem Befehl tabadmin set:
tabadmin stop
tabadmin set [option-name value]
tabadmin config
tabadmin start
Anzeigen der Hilfe für die Befehlszeile
Eine schnelle Beschreibung eines Befehls finden Sie in der integrierten Hilfe von tabadmin.
- 418 -
Um die Hilfe für alle tabadmin-Befehle anzuzeigen, geben Sie Folgendes ein:
tabadmin help commands
Wenn Sie Hilfeinformationen für einen speziellen Befehl sehen möchten, geben Sie
tabadmin help <Befehl> ein. Beispiel:
tabadmin help set
tabadmin-Befehle
Die folgenden Befehle können mit dem Befehlszeilenprogramm tabadmin verwendet werden:
activate oben
licenses Auf Seite 431
administrator Auf der
nächsten Seite
passwd Auf Seite 431
assetkeys Auf Seite 421
restart Auf Seite 432
autostart Auf Seite 423
restore Auf Seite 432
backup Auf Seite 423
set Auf Seite 433
cleanup Auf Seite 424
sitestate Auf Seite 434
configure Auf Seite 424
start Auf Seite 434
customize Auf Seite 425
status Auf Seite 435
dbpass Auf Seite 426
stop Auf Seite 436
exportsite Auf Seite 427
validate Auf Seite 436
failoverprimary Auf Seite
428
warmup Auf Seite 437
importsite Auf Seite 429
ziplogs Auf Seite 437
importsite_verified Auf
Seite 430
activate
Aktiviert bzw. deaktiviert eine Lizenz für Tableau Server online oder offline.
Beispiele
Aktivieren einer Lizenz offline:
- 419 -
tabadmin activate --tlf <file.tlf>
Deaktivieren einer Lizenz offline:
tabadmin activate --tlr <file.tlr>
Aktivieren einer Lizenz online:
tabadmin activate --activate <license>
Deaktivieren einer Lizenz online:
tabadmin activate --return <license>
Option Option
(kurz) (lang)
--tlf
--tlr
--activate
--return
Argument
Beschreibung
FILE
Für die Offline-Aktivierung. Wenn Sie die Installation offline durchführen, werden Sie aufgefordert,
eine .tlq-Datei zu speichern, die Sie an Tableau
senden. Tableau sendet Ihnen daraufhin eine .tlfDatei. Mit dieser .tlf-Datei aktivieren Sie Tableau
Server.
Für die Offline-Deaktivierung. Bei der als Argument
verwendeten Datei handelt es sich um die .tlrDatei, die Sie von Tableau erhalten haben.
Aktiviert die angegebene Lizenz.
FILE
Deaktiviert die angegebene Lizenz.
Siehe auch
Offline-Aktivieren von Tableau Auf Seite 113
administrator
Gewährt dem genannten Benutzer Systemadministratorfunktionen bzw. entfernt diese
Funktionen. Dieser Befehl kann nicht für Site-Administratoren verwendet werden.
Beispiele
Entfernen der Systemadministratorfunktionen für den Benutzer hwilson:
tabadmin administrator hwilson false
Gewähren von Systemadministratorfunktionen für den Benutzer jsmith:
tabadmin administrator jsmith true
- 420 -
assetkeys
Erstellt einen neuen Schlüssel zur Verschlüsselung von vertraulichen Daten, wie
Anmeldeinformationen für externe Datenbanken, die im Tableau-Repository gespeichert sind,
das eine intern von Tableau Server verwendete PostgreSQL-Datenbank ist.Der mit diesem
Befehl erstellte Schlüssel kann eine von Ihnen angegebene Passphrase enthalten oder zufällig
generiert werden.
Wenn Sie eine Passphrase für den Schlüssel angeben, sollte diese mindesten acht Zeichen
lang sein. Außerdem sollten Sie auch Zeichensätze berücksichtigen. Eine starke Passphrase
enthält Zeichen aus mindestens drei der folgenden Zeichensätze:
l
Kleinbuchstaben a-z
l
Großbuchstaben A-Z
l
Ziffern 0-9
l
Nichtalphabetische Zeichen
Der neue Schlüssel wird verschlüsselt und in folgender Schlüsseldatei gespeichert: asset_
keys.yml (ProgramData\Tableau\Tableau Server\data\tabsvc\config). Wenn die
Schlüsseldatei nicht mehr vorhanden oder beschädigt ist, können Sie sie mit dem Befehl
assetkeys --validate neu erstellen.
Wenn Sie den assetkeys-Befehl verwenden, müssen Sie später eine Sicherungsdatei (.tsbak)
erstellen und wiederherstellen. Sie werden den Befehl tabadmin assetkeys -validate nach dem Wiederherstellen der Sicherungsdatei ausführen müssen.
Sicherungsdateien enthalten absichtlich keine benutzerspezifischen
Verschlüsselungsschlüssel, auch wenn einige Daten mit diesen verschlüsselt wurden. Auf
diese Weise werden verschlüsselte Daten geschützt, falls die Sicherungsdatei in falsche
Hände gerät. Wenn Sie tabadmin assetkeys --validate nach Wiederherstellen der
Sicherung ausführen, werden Sie zur Eingabe der Schlüssel-Passphrase aufgefordert.
Beispiele
Lassen Sie Tableau Server einen Schlüssel und eine Passphrase für Sie erstellen:
tabadmin assetkeys --auto_create
Erstellen Sie einen Schlüssel mit einer von Ihnen angegebenen Passphrase.Sie werden
aufgefordert eine Passphrase einzugeben, Ihre Eingabe wird aber nicht auf dem Bildschirm
angezeigt:
tabadmin assetkeys --create
Verwenden Sie den Inhalt einer Datei als Passphrase:
tabadmin assetkeys --create_from_file C:\test\key\password.txt
- 421 -
Bestätigen Sie die Gültigkeit und Konsistenz der Schlüsseldatei asset_keys.yml unter
ProgramData\Tableau\Tableau Server\data\tabsvc\config mit den Metadata im TableauRepository:
tabadmin assetkeys --validate
Erstellen Sie die Datei asset_keys.yml neu, die beschädigt oder nicht mehr unter
ProgramData\Tableau\Tableau Server\data\tabsvc\config vorhanden ist.
tabadmin assetkeys --validate
Sie werden aufgefordert, die Passphrase einzugeben.
Option Option (lang) Argument
(kurz)
--auto_
[Länge]
create
--create
PASSPHRASE
--create_
from_file
FILE
--validate
Beschreibung
Erstellt eine zufällige Passphrase, um den
Schlüssel zu generieren.Verwendet ein optionales Argument als Länge für die Passphrase.
Sie sollten die Passphrase aufzeichnen und an
einem sicheren Ort aufbewahren, da sie für "-validate" benötigt wird, wenn "assetkeys.yml"
nicht mehr vorhanden oder beschädigt ist.
Erstellt die gewünschte Passphrase, die als
Schlüssel verwendet werden soll.Ihre Passphrase sollte mindestens 10 Zeichen umfassen
und nicht auf Wörtern basieren, die im Wörterbuch zu finden sind.
Erstellt einen Schlüssel unter Verwendung des
Inhalts einer Datei, die Sie als Passphrase
bereitstellen.
Bestätigt, dass alle von Tableau Server intern
verwendeten Anlagenschlüssel aktuell sind.
Wenn die Datei "asset_keys.yml" verloren geht
(z. B. aufgrund einer Beschädigung), können
Sie sie mit der Option --validate neu erstellen.Um die Schlüsseldatei neu erstellen zu können, benötigen Sie die Passphrase, die zur
Generierung aller momentan verwendeten
Schlüssel verwendet wird.
Siehe auch
Sicherheit Auf Seite 276
- 422 -
autostart
Tableau Server wird standardmäßig beim Systemstart mitgestartet. Mit diesem Befehl können
Sie das Standardverhalten ändern. Wenn autostart auf off, eingestellt ist, muss Tableau
Server entweder mit dem Befehl tabadmin start oder über das Startmenü gestartet werden.
Beispiel
Anzeigen des automatischen Startmodus von Tableau Server:
tabadmin autostart
Tableau Server wird beim Starten des Betriebssystems gestartet:
tabadmin autostart on
Tableau Server wird beim Starten des Betriebssystems nicht gestartet:
tabadmin autostart off
backup
Erstellt eine Sicherungsdatei der von Tableau Server verwalteten Daten. Dazu gehören die
PostgreSQL-Datenbank von Tableau, in der Metadaten zu Arbeitsmappen und Benutzern,
Datenextraktdateien (.tde) und Konfigurationsdaten enthalten sind. Es ist nicht nötig, Tableau
Server anzuhalten, bevor Sie eine Sicherungsdatei erstellen.
Beispiele
Erstellen einer Sicherungsdatei mit der Bezeichnung tabserv.tsbak im Bin-Verzeichnis von
Tableau Server:
tabadmin backup tabserv.tsbak
Erstellen einer Sicherungsdatei mit der Bezeichnung tabserv.tsbak im Ordner
C:\backups\tableau:
tabadmin backup C:\backups\tableau\tabserv.tsbak
Anfügen des aktuellen Datums an den Namen der Sicherungsdatei und Ablegen der
temporären Dateien, die während des Sicherungsprozesses erstellt wurden, im Ordner
C:\mytemp\tableau. Die Sicherungsdatei tabserv.tsbak wird im Bin-Verzeichnis von Tableau
Server erstellt:
tabadmin backup tabserv.tsbak -d -t C:\mytemp\tableau
Option Option
(kurz) (lang)
-d
--date
Argument
Beschreibung
Hängt das aktuelle Datum an den Namen der Sicherungsdatei an.
- 423 -
Option Option
Argument
(kurz) (lang)
-u
--userdir
-t
--tempdir PATH
Beschreibung
Legt die Sicherungsdatei im Ordner ProgramData\Tableau\Tableau Server ab.
Speicherort für die temporären Dateien, die während
des Sicherungsprozesses erstellt wurden.
Siehe auch
Sichern der Tableau-Daten Auf Seite 447
cleanup
Verwenden Sie diesen Befehl, um den Speicherplatz zu reduzieren, der insgesamt von
Tableau Server belegt wird. Durch Ausführen von tabadmin cleanup werden
Protokolldateien, temporäre Dateien und ausgewählte Zeilen aus der Tableau ServerDatenbank PostgreSQL entfernt.
Beispiele
So entfernen Sie Protokolldateien, die älter als sieben Tage sind, sowie http_requestsEinträge, die älter als sieben Tage sind:
tabadmin cleanup
So entfernen Sie alle Protokolldateien und temporäre Dateien (http_requests-Einträge
bleiben erhalten):
tabadmin cleanup --restart
Option Option
Argument Beschreibung
(kurz) (lang)
-r
--restHält Tableau Server an, führt den cleanupart
Befehl aus und startet den Server wieder.
Siehe auch
Entfernen überflüssiger Dateien Auf Seite 449
configure
Aktualisiert die Konfiguration von Tableau Server durch Erzwingen der Aktualisierung aller
Dateien in ProgramData\Tableau\Tableau Server\data\tabsvc\<area>. Bei dieser
Aktualisierung wird auch die Hauptkonfigurationsdatei für den Service workgroup.yml
(ProgramData\Tableau\Tableau Server\data\tabsvc\config) aktualisiert. Wenn die
Konfiguration geändert wird, empfiehlt es sich, tabadmin configure (oder tabadmin
- 424 -
config) auszuführen, um sicherzustellen, dass alle Dateien vollständig aktualisiert werden,
die sich auf die Konfiguration des Servers auswirken.
Beispiele
tabadmin configure
tabadmin config
Siehe auch
Neukonfigurieren des Servers Auf Seite 134
set Auf Seite 433
tabadmin set-Optionen Auf Seite 438
customize
Passt den Namen und das Logo an, die von Tableau Server verwendet werden. Beachten Sie,
dass bei Verwendung dieses Befehls nach wie vor am unteren Rand jeder Serverseite die
Copyright-Informationen von Tableau angezeigt werden.
Beispiel
Ändern des Produktnamens von Tableau Server zu MyCo Server:
tabadmin customize name "MyCo Server"
Ändern Sie das Standardlogo in ein persönliches groß" Logo um (bis zu 160 x 160 px,
mindestens jedoch 32 x 32 px):
tabadmin customize logo "C:\My Pictures\example.png"
Ändern Sie das Standardlogo in ein persönliches Kleinformat-Logo (max. 32 x 32 px) um:
tabadmin customize smalllogo "C:\My Pictures\example_small.png"
Anpassen des Standardproduktnamens, der an verschiedenen Stellen wie z. B. auf der
Anmeldeseite von Tableau Server angezeigt wird:
tabadmin customize name -d
Option Option
(kurz) (lang)
-d
--default
Argument Beschreibung
Stellt den Standardwert für den Namen oder das Logo
wieder her.
Siehe auch
Ändern von Name oder Logo Auf Seite 261
- 425 -
dbpass
Ermöglicht den externen Zugriff auf die Tableau-Datenbank PostgreSQL (das Repository).
Nach der Verwendung des Befehls "dbpass", um den Zugriff auf die Datenbank zu gestatten,
können Sie mithilfe von Tableau Desktop eine Verbindung mit dieser herstellen und diese
abfragen, um eigene Verwaltungsansichten zu erstellen.
tabadmin dbpass [--disable] [--username <username>] [password]
Beispiele
Aktivieren Sie den Zugriff für den Benutzer Tableau und stellen Sie das Kennwort auf
P@ssw0rD! ein:
tabadmin dbpass P@ssw0rD!
Aktivieren Sie den Zugriff für den Benutzer Nur Lesezugriff und stellen Sie das Kennwort
auf P@ssw0rD! ein:
tabadmin dbpass --username readonly P@ssw0rD!
Externen Zugriff für den Standardbenutzer (Tableau) deaktivieren:
tabadmin dbpass --disable
oder
tabadmin dbpass --disable --username tableau
Externen Zugriff für den Benutzer Nur Lesezugriff deaktivieren:
tabadmin dbpass --disable --username readonly
Option
(lang)
--disable
--username
Kennwort
Argument Beschreibung
PostgreSQLDeaktivieren Sie den externen Zugriff auf die Datenbank von für den entfernten Standardbenutzer
(Tableau) oder, wenn ein Benutzername angegeben ist, den
Fernzugriff für diesen Benutzer.
Ändern Sie das Kennwort für den angegebenen Benutzer oder
deaktivieren Sie den Zugriff für den angegebenen Benutzer,
wenn die Option zusammen mit der Option "Deaktivieren" verwendet wird. Optionen für die Benutzer sind Tableau und
Nur Lesezugriff.
Aktivieren Sie den externen Zugriff auf die PostgreSQL-Datenbank von Tableau für den entfernten Standardbenutzer
- 426 -
Option
(lang)
Argument Beschreibung
(Tableau) oder, wenn ein Benutzername angegeben ist, den
Zugriff für diesen Benutzer mit dem vorgegebenen Kennwort.
Siehe auch
Erstellen benutzerdefinierter Verwaltungsansichten Auf Seite 273
Aktivieren des externen Zugriffs auf die Tableau Server-Datenbank Auf Seite 274
exportsite
Exportiert eine Tableau Server-Site, einschließlich der Benutzer, Arbeitsmappen, Projekte,
Extrakte und Datenverbindungen, und legt sie als zip-Datei ab.Sie können dann mit der
exportierten Sitedatei eine neue Site unter Verwendung der Befehle importsite Auf
Seite 429 und importsite_verified Auf Seite 430 bereitstellen.
Es ist nicht nötig, Tableau Server anzuhalten, bevor Sie den Befehl exportsite
ausführen.Tableau Server sperrt die zu exportierende Site während des Exportprozesses.
Beispiele
tabadmin exportsite <site ID> --file <PATH>
oder
tabadmin exportsite <site ID> --file <FILE>
Exportieren Sie die Site, deren Site-ID finance lautet, in eine Datei mit der Bezeichnung
"finance_export.zip", und legen Sie sie unter "Program Files\Tableau\Tableau Server\8.3\bin"
ab:
tabadmin exportsite finance --file finance_export
Exportieren Sie die Standardsite. Die Site-ID für die -Standard-Site lautet "" (doppelte
Anführungszeichen, kein Leerzeichen).
tabadmin exportsite "" --file finance_export
Wenn Sie zur Ausführung des Befehls Windows PowerShell verwenden, müssen Sie
die doppelten Anführungszeichen für die Standardsite in einfache Anführungszeichen
einschließen ('""'). Beispiel: tabadmin exportsite '""' --file
finance_export
Exportieren Sie die Standardsite in eine Datei mit der Bezeichnung finance_export.zip, und
legen Sie sie unter "C:\temp\exported sites" anstelle des Bin-Verzeichnisses von Tableau
Server ab.Da der Pfad ein Leerzeichen enthält, wird er durch Anführungszeichen
eingeschlossen.
tabadmin exportsite "" --file "C:\temp\exported sites\finance_
export"
- 427 -
Exportieren Sie die Site, deren Site-ID finance lautet, benennen Sie die Exportdatei der Site
mit financesite.zip, legen Sie sie unter "C:\sites\exported" ab, und schreiben Sie die
temporären Laufzeitdateien in "C:\temp_files":
tabadmin exportsite finance --file C:\sites\exported\financesite
--tempdir C:\temp_files
Option Option (lang)
(kurz)
--file
Argument
Beschreibung
DATEI oder
Der Name bzw. der Name und der Speicherort
(Pfad) der zu erstellenden Datei für den Site-Export.Wenn Sie keinen Pfad angegeben, wird das BinVerzeichnis von Tableau Server als Speicherort verwendet (Program Files\Tableau\Tableau Server\8.3\bin).
Der Speicherort der beim Export erstellten temporären Dateien.Verwenden Sie diese Option,
wenn Sie keinen Schreibzugriff auf das Installationsverzeichnis vonTableau Server besitzen.Mit
dieser Option wird nicht bestimmt, wo die Datei
zum Site-Export erstellt wird.
PATH
--tempdir
Siehe auch
Importieren oder Exportieren einer Site Auf Seite 229
failoverprimary
Kennzeichnet eine zweite Installation des primären Tableau Servers als primären
Sicherungsserver. Falls der primäre Server ausfällt, kann der primäre Sicherungsserver als
neuer primärer Server und der vorherige primäre Server als neuer Sicherungsserver
identifiziert werden.
Beispiel
tabadmin failoverprimary --primary <computer name(s) or IPv4
address(es)>
Option Option (lang) Argument
(kurz)
--primary Computername(n)
oder IPv4-Adresse(n)
Beschreibung
Der Tableau Server-Computer, der als primärer Server des Clusters genutzt wird.
Siehe auch
Grundlegendes zur Hochverfügbarkeit Auf Seite 158
- 428 -
Konfigurieren für Failover und mehrere Gateways Auf Seite 164
Konfigurieren eines primären Sicherungsservers Auf Seite 173
importsite
Der Befehl importsite ist der ersten von zwei Befehlen zum Import einer Site in Tableau
Server. Sie benötigen Folgendes, um diesen Befehl auszuführen:
l
l
Eine exportierte Sitedatei.Tableau Server-Administratoren erstellen diese Datei
unter Verwendung des Befehls exportsite Auf Seite 427.Wenn Sie auf
Tableau Online eine Site besitzen und diese in Ihrem eigenen stationären Tableau
Server importieren möchten, fordern Sie eine exportierte Sitedatei beim Support für
Kunden von Tableau an.
Die Site-ID der Zielsite.Die Zielsite ist die Tableau Server-Site, in die Sie
importieren.Die Zielsite muss bereits vorhanden sein, wenn Sie den Befehl
importsite ausführen. Sie können sie nicht als Teil des Befehls erstellen.Die Site-ID
für die -Standard-Site in Tableau Server lautet ""(doppelte Anführungszeichen, kein
Leerzeichen).
Der Inhalt der Zielsite wird durch den Inhalt der zu importierenden Site
überschrieben.Wenn auf der Zielsite beispielweise eine Arbeitsmappe mit der
Bezeichnung MyDashboard.twbx vorhanden ist, und die zu importierende Site aber
nicht über diese Arbeitsmappe verfügt, wird die Datei MyDashboard.twbx beim Import
von der Zielsite entfernt.
Mit dem Befehl importsite wird ein temporäres Verzeichnis mit CSV-Dateien erstellt, die
zeigen, wie die exportierten Site-Elemente (Benutzer, Arbeitsmappen, Projekt, Extrakte und
Datenquellen) nach Abschluss des Importvorgangs zugeordnet werden.Es ist wichtig, dass
Benutzerdetails, wie z. B. die Authentifizierung, verifiziert werden. Öffnen Sie die
Zuordnungsdateien in einem Texteditor oder in Microsoft Excel, um Änderungen
vorzunehmen.Einträge, die ???(Fragezeichen) enthalten, zeigen Zuordnungen an, die nicht
verarbeitet werden konnten und zu editieren sind.Verifizieren Sie die Zuordnungen, und
beenden Sie den Importvorgang mit dem Befehl importsite_verified Auf der
nächsten Seite.
Beispiele
tabadmin importsite <site ID> --file <PATH>
oder
tabadmin importsite <site ID> --file <FILE>
Importieren Sie die Datei sales_site.zip unter "C:\tableau\exported" in eine Site, deren SiteID wsales lautet:
tabadmin importsite wsales --file C:\tableau\exported\sales_
site.zip
- 429 -
Importieren Sie die Datei sales_site.zip, die sich unter "C:\Program Files\Tableau\Tableau
Server\8.3\bin" befindet, in die Standard-Site. Die Site-ID für die -Standard-Site lautet ""
(doppelte Anführungszeichen, kein Leerzeichen).
tabadmin importsite "" --file sales_site.zip
Die zu überprüfenden Zuordnungsdateien sind unter " ProgramData\Tableau\Tableau
Server\data\tabsvc\temp\import_<site ID>_<datetime>\mappings" abgelegt. Mit --tempdir
können Sie ein anderes Verzeichnis angeben.
Legen Sie die zu überprüfenden Dateien unter "C:\temp\site_to_import" ab:
tabadmin importsite wsales --file "C:\tableau\exported\sales_
site.zip" --tempdir "C:\temp\site_to_import"
Überprüfung überspringen (nicht empfohlen):
tabadmin importsite wsales --file "C:\tableau\exported\sales_
site.zip" -no-verify
Option Option
(kurz) (lang)
--file
Argument Beschreibung
PATH
--noverify
--tempdir
PATH
Der Name bzw. der Name und der Speicherort (Pfad)
der zu importierenden Datei für den Site-Export.Wenn
Sie keinen Pfad angegeben, wird das Bin-Verzeichnis
von Tableau Server als Speicherort verwendet (Program Files\Tableau\Tableau Server\8.3\bin).
Überspringt die Überprüfung und importiert die
exportierte Site-Datei importiert in den neuen
Speicherort der Tableau Server-Installation. Es ist nicht
notwendig, den Befehl importsite_verified zu
verwenden.
Das Verzeichnis, in dem Sie überprüfen, dass die Sitedateien richtig zugeordnet wurden.Wenn Sie diese
Option nicht angegeben, werden die Dateien in einem
Verzeichnis unter "ProgramData\Tableau\Tableau Server\data\tabsvc\temp" abgelegt.
Siehe auch
Importieren oder Exportieren einer Site Auf Seite 229
importsite_verified
Der zweite Befehl, um eine Site in Tableau Server zu importieren. Sie können den Befehl
importsite_verified erst verwenden, nachdem Sie importsite Auf der
vorherigen Seite ausgeführt haben.
Der Befehl importsite_verified liest die überprüfen CSV-Dateien in einem
- 430 -
Verzeichnis, importiert diese in die neue Site von Tableau Server und berücksichtigt dabei,
wie die Elemente der Site in den CSV-Dateien zugeordnet sind.Die Site, in die importiert
werden soll (Zielsite), muss bereits in Tableau Server vorhanden sein.
Während des Importprozesses sperrt Tableau Server die Site, die den Import erhält.
Beispiele
tabadmin importsite_verified <target site ID> --importjobdir
<PATH>
Importieren Sie die Dateien aus dem Verzeichnis "C:\temp\site_to_import" in die Site, deren
Site-ID esale lautet:
tabadmin importsite_verified esales --importjobdir C:\temp\site_
to_import
Option Option (lang)
(kurz)
--importjobdir
Argument Beschreibung
PATH
Das Verzeichnis mit den CSV-Dateien, deren
Zuordnungen Sie überprüft haben.
Siehe auch
Importieren oder Exportieren einer Site Auf Seite 229
licenses
Zeigt die Lizenzinformationen für Tableau Server an.
Beispiele
tabadmin licenses
tabadmin licenses -p
Option Option (lang)
(kurz)
-p
--processor_
cores
Argument Beschreibung
Zeigt für den aktuellen Computer die Anzahl der
Cores an.
passwd
Setzt das Kennwort für ein Tableau Server-Konto zurück. Nach der Eingabe des Befehls
werden Sie zur Eingabe eines neuen Kennworts für den Benutzer aufgefordert.
Dieser Befehl kann nur verwendet werden, wenn die Benutzerauthentifizierung für Tableau
Server auf "Lokale Authentifizierung" eingestellt ist. Wenn für die Authentifizierung Active
- 431 -
Directory festgelegt ist, werden Kennwörter von Active Directory verarbeitet, nicht von
Tableau Server.
Beispiele
tabadmin passwd <username>
Setzen Sie das Kennwort für den Serverbenutzer jsmith zurück:
tabadmin passwd jsmith
Siehe auch
Allgemein Auf Seite 115
restart
Stoppt und startet alle Tableau Server-Prozesse.
Beispiel
tabadmin restart
restore
Stellt eine Tableau Server-Sicherungsdatei (.tsbak) für eine Tableau Server-Installation
wieder her. Beim Wiederherstellen mithilfe einer .tsbak-Datei werden der Inhalt der Tableau
PostgreSQL-Datenbank, Datenextrakte und Konfigurationsdateien durch den Inhalt der
Sicherungsdatei überschrieben. Bei Verwendung der Option --no-config wird alles außer
der Serverkonfiguration wiederhergestellt.
Beispiele
Wiederherstellen einer unter "C:\mybackups" gespeicherten Datei mit dem Namen
tabserv.tsbak:
tabadmin restore C:\mybackups\tabserv.tsbak
Wiederherstellen einer im Verzeichnis "bin" von Tableau Server gespeicherten Datei mit dem
Namen tabserv.tsbak:
tabadmin restore tabserv.tsbak
Wiederherstellen einer unter "C:\mybackups" gespeicherten Datei mit dem Namen
tabserv.tsbak unter Beibehaltung von allem mit Ausnahme der Konfiguration des Servers:
tabadmin restore --no-config C:\mybackups\tabserv.tsbak
- 432 -
Option Option (lang) Argument Beschreibung
(kurz)
--no-conStellt die Tableau Server-Sicherungsdatei wieder her,
fig
einschließlich der Daten, aber unter Ausschluss der
Serverkonfiguration.
Siehe auch
Wiederherstellen von einer Sicherung Auf Seite 448
Wiederherstellen von Extrakten aus einer Sicherung Auf Seite 449
set
Ermöglicht die Änderung der Werte für die Tableau Server-Konfigurationsoptionen. Wenn der
einzustellende Parameter mit einem Bindestrich beginnt, muss der Parameterwert sowohl in
doppelte als auch einfache Anführungsstriche eingeschlossen werden.
Beispiele
tabadmin set [option-name value]
Einstellen des Abfragelimits für die Hintergrundprozesskomponente auf 2,5 Stunden
(9000 Sekunden):
tabadmin set backgrounder.querylimit 9000
Einstellen des wgserver-Parameters für virtuellen Speicher auf -Xmx512m:
tabadmin set wgserver.vmopts "'-Xmx512m'"
Einstellen des wgserver-Parameters für virtuellen Speicher auf den Bereich -Xmx512m Xss2048k:
tabadmin set wgserver.vmopts "'-Xmx512m -Xss2048k'"
Option Option
Argument Beschreibung
(kurz) (lang)
-d
-Stellt den Parameter auf den Standardwert zurück.
default
Siehe auch
tabadmin set-Optionen Auf Seite 438
- 433 -
sitestate
Verwenden Sie diesen Befehl, um eine aufgrund eines Site-Importfehlers gesperrte Site zu
aktivieren oder um eine Site außer Kraft zu setzen.Wenn eine Site außer Kraft gesetzt wurde,
kann nur der Systemadministrator auf Tableau Server zugreifen.
Beispiele
tabadmin sitestate <site ID> --status <active|suspended>
Entsperren oder aktivieren Sie eine Site, deren Site-ID wsales lautet:
tabadmin sitestate wsales --status active
Option Option Argument
(kurz) (lang)
--sta- active
tus
oder
Beschreibung
Aktiviert bzw. setzt die Site außer Kraft, die mit <site
ID> angegeben ist.
suspended
start
Starten aller Tableau Server-Prozesse. So verwenden Sie tabadmin start:
1. Öffnen Sie als Administrator eine Eingabeaufforderung:
2. Geben Sie folgenden Befehl ein:
cd "C:\Program Files\Tableau\Tableau Server\8.3\bin"
- 434 -
3. Geben Sie zum Starten des Servers Folgendes ein:
tabadmin start
Beispiele
tabadmin start
tabadmin start --wait 1200
Option
(kurz)
Option
(lang)
--wait
Argument Beschreibung
Anzahl der Anzahl der Sekunden, die nach dem Start vergehen,
Sekunden bevor Tableau Server bereit ist, Client-Anforderungen
entgegenzunehmen. Die Standardeinstellung ist
600 Sekunden.
status
Gibt an, ob Tableau Server ausgeführt wird und ob die Version --verbose verwendet wird.
Informiert über den Status einzelner Serverprozesse und lässt erkennen, ob sie ausgeführt
werden und welche Ports sie verwenden. Der Befehl tabadmin status stellt zum Abrufen
von Informationen eine Verbindung zum tabsvc.exe-Befehl des Windows-Diensts her, der
wiederum die ausführbaren tabspawn-Dateien für jeden Prozess abfragt. Aus diesem Grund
werden von diesem Befehl manchmal andere Informationen für die Serverprozesse angezeigt
als in der Statustabelle auf der Wartungsseite, die die Prozesse direkt abfragt.
Beispiele
tabadmin status
tabadmin status --verbose
Option Option
Argument Beschreibung
(kurz) (lang)
-v
--verbose
Gibt eine Liste aller Tableau Server-Prozesse, ihrer
Portnummern und Status zurück.
Siehe auch
Wartungseinstellungen Auf Seite 246
Tableau Server-Prozesse Auf Seite 453
- 435 -
stop
Stoppt alle Tableau Server-Prozesse. So verwenden Sie tabadmin stop:
1. Öffnen Sie als Administrator eine Eingabeaufforderung:
2. Geben Sie folgenden Befehl ein:
cd "C:\Program Files\Tableau\Tableau Server\8.3\bin"
3. Geben Sie zum Anhalten des Servers Folgendes ein:
tabadmin stop
validate
Bestätigt, dass die Tableau Server-Umgebung die Mindestanforderungen für das Ausführen
der 64-Bit-Version von Tableau Server erfüllt. Wenn Sie zurzeit die 32-Bit-Version von
Tableau Server ausführen, können Sie durch Ausführen dieses Befehls vor der Installation der
64-Bit-Version überprüfen, ob Ihre aktuelle Hardware, der vorhandene Speicherplatz und der
Arbeitsspeicher ausreichen.
Beispiel
tabadmin validate
- 436 -
warmup
Bewirkt, dass jeder VizQL-Serverprozess die vizql-DLL-Datei lädt, sodass schnellere
Ladezeiten erzielt werden, wenn die Serverbenutzer Ansichten zum ersten Mal laden.
Administratoren können diesen Befehl nach dem Neustart von Tableau Server ausführen oder
mithilfe eines Scripts ausführen lassen.
Beispiel
tabadmin warmup
ziplogs
Erstellt ein Archiv (.zip), das die Tableau Server-Protokolldateien enthält, ohne die
ursprünglichen Protokolldateien zu entfernen. Wird ein Tableau Server-Cluster ausgeführt,
werden die Protokolldateien von Arbeitsservern in das erstellte Archiv aufgenommen.
Beispiele
Erstellen Sie ein Archiv im Bin-Verzeichnis von Tableau Server mit der Bezeichnung logs.zip:
tabadmin ziplogs
Erstellen Sie ein Archiv im Bin-Verzeichnis von Tableau Server mit der Bezeichnung
mylogs.zip:
tabadmin ziplogs mylogs.zip
Erstellen Sie ein Archiv im Bin-Verzeichnis von Tableau Server mit der Bezeichnung
mylogs.zip, das Protokolle vom 31. Januar 2014 bis zum heutigen Datum enthält, und ältere
Protokolle ausschließt:
tabadmin ziplogs -d 01/31/2014 mylogs.zip
Option Option (lang)
(kurz)
-n
--with-netstat-info
-p
-l
-f
--with-postgresql-data
--with-latestdump
--force
Argument
Beschreibung
Schließt die Aufnahme von Informationen
über die Serverumgebung in die .zip-Datei
ein.
Schließt Daten von der Tableau Server-Datenbank PostgreSQL ein.
Beziehen Sie nur die neuesten Protokolldateien, um die Größe der Datei zu
beschränken.Standardmäßig werden die
zehn neuesten Protokolldateien aufgenommen.
Überschreibt die vorhandene Protokolldatei
- 437 -
Option Option (lang)
(kurz)
-d
--minimumdate
-a
--all
Argument
Beschreibung
mit dem gleichen Namen.
[mm/dd/yyyy] Protokolldateien mit diesem Datum und neuer
werden in die .zip-Datei aufgenommen. Protokolldateien mit älterem Datum werden ausgeschlossen. Wenn keine anderen Angaben
gemacht werden, werden Daten von bis zu sieben Tagen eingeschlossen.
Alle Protokolldateien werden in die .zip-Datei
aufgenommen. Daten von der Tableau Server-Datenbank PostgreSQL bleiben ausgeschlossen.
Siehe auch
Mit Protokolldateien arbeiten Auf Seite 451
Archivieren von Protokollen in der Befehlszeile (tabadmin) Auf Seite 460
tabadmin set-Optionen
In der nachstehenden Tabelle werden die einzelnen Tableau Server-Optionen beschrieben,
die mithilfe des Befehls set Auf Seite 433 konfiguriert werden können. Ein vollständige Liste
der Ports finden Sie unter TCP/IP-Ports Auf Seite 388.
Option
Standardwert
Beschreibung
api.server.enabled
false
Erlaubt den Zugriff auf die REST API Auf Seite
539. Diese Funktion ist standardmäßig deaktiviert.
auditing.enabled
true
Der Zugriff auf die PostgreSQL-Überwachungsverlaufstabellen (systemeigene
Datenbank von Tableau Server) ist möglich.
Weitere Informationen finden Sie unter Erstellen benutzerdefinierter Verwaltungsansichten Auf Seite 273.
backgrounder.querylimit
7200
Längster zulässiger Zeitraum zum Fertigstellen
einer Extraktaktualisierung in Sekunden (7200
- 438 -
Option
Standardwert
Beschreibung
Sekunden = 2 Stunden).
backgrounder.reset_sche- true
dules_on_startup
Steuert, wann die Hintergrundaufgaben ausgeführt werden sollen, deren Ausführung zu
dem Zeitpunkt geplant war, zu dem der Server
beendet wurde. Wenn die Einstellung true
(Standardeinstellung) ausgewählt ist, werden
die Aufgaben zum nächsten geplanten Termin
ausgeführt. Wenn die Einstellung false ausgewählt ist, werden alle Aufgaben, die geplant
waren, als der Server beendet wurde, beim Serverstart gleichzeitig ausgeführt. Dies gilt auch
dann, wenn die Tableau Server-Sicherungsdatei (.tsbak) wiederhergestellt wird.
dataengine.port
27042
Port, an dem die Daten-Engine ausgeführt wird.
dataserver.port
9700
Port, an dem der Datenserver ausgeführt wird.
gateway.public.host
Der Name
des Computers
Der Name (die URL) des Servers, der für den
externen Zugriff auf Tableau Server verwendet
wird. Wenn Tableau Server für die Verwendung
eines Proxyservers oder eines externen Lastenausgleichsmoduls konfiguriert ist, müssen
Sie diesen Namen in die Adressleiste eines
Browsers eingeben, um Tableau Server zu
erreichen.Wenn Tableau Server beispielsweise
durch Eingabe von tableau.example.com
erreicht wird, lautet der Name für gateway.public.host tableau.example.com.
gateway.public.port
80 (443, wenn Gilt nur für Proxyserver-Umgebungen. Der
SSL)
externe Port, der vom Proxyserver überwacht
wird.
gateway.timeout
1800
Längste Zeitdauer in Sekunden, die das Gateway auf bestimmte Ereignisse wartet, bevor
eine Anforderung fehlschlägt (1800 Sekunden =
30 Minuten).
gateway.trusted
IP-Adresse
des Proxyserver-Computers
Gilt nur für Proxyserver-Umgebungen. Die IPAdresse(n) oder der Hostname/die Hostnamen
des Proxyservers.
gateway.trusted_hosts
Alternative
Gilt nur für Proxyserver-Umgebungen. Alternative Hostnamen für den Proxyserver.
- 439 -
Option
Standardwert
Beschreibung
Namen des
Proxyservers
java.heap.size
128m
Heapgröße für Tomcat (Repository und solr).
Diese Angabe muss in der Regel nur dann geändert werden, wenn Tableau dies empfiehlt.
pgsql.port
8060
Port, der von PostgreSQL überwacht wird.
rsync.timeout
600
Maximal zulässige Zeit in Sekunden zum
Abschluss der Dateisynchronisierung (600
Sekunden = 10 Minuten).Die Dateisynchronisierung wird als Teil der Konfiguration
von Hochverfügbarkeit oder dem Verschieben
der Daten-Engine und des Repository durchgeführt.
server.log.level
info
Die Protokollebene für Protokolle, die in die
Datei ProgramData\Tableau\Tableau
Server\data\tabsvc\logs\vizqlserv
er\Logs\*.txt geschrieben werden.
Für weitere Informationen auf debug
einstellen.Bei debug-Einstellung wird die
Protokollierung auf den Ausführlichkeitsgrad vor
8.2 eingestellt. Die Debugging-Stufe kann sich
erheblich auf die Leistung auswirken und sollte
nur auf spezielle Anweisung vom Tableau
Support hin verwendet werden. Weitere
Informationen finden Sie unter Ändern von
Protokollstufen Auf Seite 466.
service.jmx_enabled
false
Die Einstellung auf true aktiviert JMX-Ports für
die optionale Überwachung und Fehlerbehebung. Weitere Informationen hierzu finden Sie in unter Aktivieren von JMX-Ports
Auf Seite 393.
service.max_procs
Anzahl der
Prozesse
Maximale Anzahl der Serverprozesse.
service.port_remapping.enabled
true
Legt fest, ob Tableau Server versucht, Ports
dynamisch neu zuzuordnen, wenn die standardmäßigen oder konfigurierten Ports nicht verfügbar sind.Wenn false festgelegt wird, wird
die dynamische Port-Neuzuordnung deaktiviert.Weitere Informationen hierzu finden Sie
- 440 -
Option
Standardwert
Beschreibung
unter TCP/IP-Ports Auf Seite 388.
solr.rebuild_index_timeout 3600
Wenn Tableau Server aktualisiert wird oder
wenn eine .tsbak-Datei wiederhergestellt wird,
wird der Suchindex durch die Hintergrundaufgabe neu erstellt. Diese Einstellung
steuert die Zeitüberschreitungseinstellung für
die Aufgabe (3600 Sekunden = 60 Minuten).
subscriptions.enabled
false
Es wird steuert, ob Abonnements für das
gesamte System konfigurierbar sind. Siehe Verwalten von Abonnements Auf Seite 215.
subscriptions.timeout
1800
Anzahl an Sekunden, nachdem der Hintergrundprozess zur Verarbeitung eines Abonnements abläuft.
solr.port
8080
Port, der von solr überwacht wird. Dieser Wert
muss mit dem Wert für tomcat.http.port identisch sein.
tomcat.http.port
8080
Port, an dem Tomcat ausgeführt wird.
tomcat.https.port
8443
SSL-Port for Tomcat (nicht verwendet).
tomcat.server.port
8085
Port, der von Tomcat auf Meldungen bezüglich
des Herunterfahrens überwacht wird.
vizqlserver.browser.render true
Ansichten unterhalb des durch vizqlserver.browser.render_threshold
oder vizqlserver.browser.render_
threshold_mobile festgelegten Schwellenwertes werden im Client-Webbrowser und
nicht auf dem Server gerendert. Weitere Informationen finden Sie unter Informationen zum
clientseitigen Rendern Auf Seite 316.
vizqlserver.browser.render_
threshold
100
Der Standardwert (100) steht für eine hohe
Komplexität für eine auf dem PC angezeigte
Ansicht. Komplexitätsfaktoren umfassen die
Anzahl an Markierungen, Kopfzeilen, Referenzlinien und Anmerkungen. Ansichten, die
diese Komplexität überschreiten, werden auf
dem Server und nicht vom Webbrowser des
PCs gerendert.
vizqlserver.browser.render_
20
Der Standardwert (20) steht für eine hohe Kom-
- 441 -
Option
Standardwert
threshold_mobile
vizqlserver.log.level
Beschreibung
plexität für eine auf dem Tablet-PC angezeigte
Ansicht. Komplexitätsfaktoren umfassen die
Anzahl an Markierungen, Kopfzeilen, Referenzlinien und Anmerkungen. Ansichten, die
diese Komplexität überschreiten, werden auf
dem Server und nicht vom Webbrowser des
Tablet-PCs gerendert.
info
Die Protokollstufe für vizqlserverJavakomponenten. Protokolle werden in
ProgramData\Tableau\Tableau
Server\data\tabsvc\logs\vizqlserv
er\*.log geschrieben.
Für weitere Informationen auf debug
einstellen.Die Debugging-Stufe kann sich
erheblich auf die Leistung auswirken und sollte
nur auf spezielle Anweisung vom Tableau
Support hin verwendet werden. Weitere
Informationen finden Sie unter Ändern von
Protokollstufen Auf Seite 466.
vizqlserver.port
9100
Basis-Port für VizQL-Server.
vizqlserver.protect_sessions
true
Mit der Einstellung true (Standard) wird die
Wiederverwendung von VizQL-Sitzungen vermieden, nachdem sich der ursprüngliche Benutzer abgemeldet hat.
vizqlserver.querylimit
1800
Längster zulässiger Zeitraum zum Aktualisieren
einer Ansicht in Sekunden.
vizqlserver.rserve.host
Gibt einen Rserve-Host an. Diese Einstellung
und die drei unmittelbar darauf folgenden Einstellungen unterstützen R-Funktionalität in
Arbeitsmappen. R ist eine Open-Source-Sprache zur Softwareprogrammierung und eine Softwareumgebung für statistische Berechnungen
und Grafiken. In Tableau Desktop können Sie
einen Satz von vier Funktionen verwenden, um
R-Ausdrücke an einen Rserve-Server zu übergeben und ein Ergebnis zu erhalten. Wenn Sie
eine Arbeitsmappe hochladen, die eine dieser
Funktionen verwendet, müssen Sie Tableau
Server für eine Rserve-Verbindung kon-
- 442 -
Option
Standardwert
Beschreibung
figurieren, indem Sie diese Option und die drei
folgenden konfigurieren. Andernfalls stehen
Arbeitsblätter mit R-Funktionalität nicht zur Verfügung. Weitere Informationen finden Sie unter
R-Verbindung in der Hilfe von Tableau Desktop.
vizqlserver.rserve.port
6311
Gibt einen Rserve-Port an. Diese Einstellung
unterstützt R-Funktionalität in Arbeitsmappen.
vizqlserver.rserve.username
Gibt einen Rserve-Benutzernamen an. Diese
Einstellung unterstützt R-Funktionalität in
Arbeitsmappen. Nicht alle Rserve-Hosts erfordern einen Benutzernamen und ein Kennwort.
vizqlserver.rserve.password
Gibt ein Rserve-Kennwort an. Diese Einstellung
unterstützt R-Funktionalität in Arbeitsmappen.
Nicht alle Rserve-Hosts erfordern einen Benutzernamen und ein Kennwort.
viz5
qlserver.session.expiry.minimum
Anzahl von Minuten Leerlaufzeit, nach der eine
VizQL-Sitzung verworfen wird, wenn der
VizQL-Prozess nicht mehr genügend
Arbeitsspeicher hat.
viz30
qlserver.session.expiry.timeout
Anzahl von Minuten Leerlaufzeit, nach der eine
VizQL-Sitzung verworfen wird.
vizqlserver.showdownload true
Die Anzeige der Taste "Herunterladen" über
den Ansichten wird gesteuert.
vizqlserver.showshare
true
Die Anzeige der Taste "Freigeben" über den
Ansichten wird gesteuert.
vizqlserver.trustedticket.log_
level
info
Protokollebene für vertrauenswürdige
Authentifizierung, die in die Datei
ProgramData\Tableau\Tableau
Server\data\tabsvc\logs\vizqlserv
er\vizql-*.log geschrieben wird.
Für weitere Informationen auf debug
einstellen.Die Debugging-Stufe kann sich
erheblich auf die Leistung auswirken und sollte
nur auf spezielle Anweisung vom Tableau
Support hin verwendet werden. Weitere
Informationen finden Sie unter Ändern von
Protokollstufen Auf Seite 466.
- 443 -
Option
Standardwert
Beschreibung
vizqlserver.trustedticket.token_
length
24
Legt die Anzahl der Zeichen in jedem vertrauenswürdigen Ticket fest. Die Standardeinstellung von 24 Zeichen ergibt eine
Zufälligkeit von 144 Bit. Der Wert kann auf jede
beliebige Ganzzahl zwischen 9 und 255 (einschließlich) festgelegt werden.
vizfalse
qlserver.trustedticket.use_
deprecated_9digit_token
Bei der Einstellung true bestehen Tickets aus
9 Ziffern (wie in Version 8.0 und früher), und die
Einstellung vizqlserver.trustedticket.token_
length wird ignoriert.
vizqlserver.url_scheme_
whitelist
Fügt die Protokolle der Whitelist mithilfe von
URL-Aktionen in Ansichten und Dashboards
hinzu. http, https, gopher, news, ftp und
mailto sind standardmäßig in der Whitelist enthalten.
wgserver.audit_history_
expiration_days
183
Anzahl an Tagen, nach denen Verlaufsdaten
aus der PostgreSQL-Datenbank (systemeigene
Datenbank von Tableau Server) entfernt werden. Weitere Informationen finden Sie unter
Erstellen benutzerdefinierter Verwaltungsansichten Auf Seite 273.
wgserver.change_
owner.enabled
true
Steuert, ob die Besitzrechte einer Arbeitsmappe, einer Datenquelle oder eines Projekts
geändert werden können.Zu den weiteren
Optionen zählen "false" und "adminonly". Weitere Informationen finden Sie unter Besitzrecht
verwalten Auf Seite 106.
wgserver.clickjack_defense.enabled
false
Wenn true festgelegt wird, wird "clickjacking"
eines Tableau Server-Benutzers durch eine
bösartige Person verhindert. Bei einem solchen
Angriff werden Webseitenelemente manipuliert,
sodass arglose Benutzer glauben, sie klicken
beispielsweise auf eine Schaltfläche oder einen
Link von Tableau Server, während sie
tatsächlich auf die Seite des Angreifers klicken.
Wenn diese Einstellung aktiviert ist (true),
verwenden über Iframes eingebettete
Ansichten, die zur Eingabe von
- 444 -
Option
Standardwert
Beschreibung
Anmeldeinformationen auffordern, zu diesem
Zweck ein Pop-up-Fenster anstatt des IframeFensters.
wgserver.domain.fqdn
Wert von
Der vollständig qualifizierte Domänenname, der
%USERDOM- vom Active Directory-Server verwendet werden
AIN%
soll.
wgserver.log.level
info
Die Protokollstufe für wgserverJavakomponenten. Protokolle werden in
ProgramData\Tableau\Tableau
Server\data\tabsvc\logs\wgserver\
*.log geschrieben.
Für weitere Informationen auf debug
einstellen.Die Debugging-Stufe kann sich
erheblich auf die Leistung auswirken und sollte
nur auf spezielle Anweisung vom Tableau
Support hin verwendet werden. Weitere
Informationen finden Sie unter Ändern von
Protokollstufen Auf Seite 466.
wgserver.password_auto- false
complete.enabled
Es wird steuert, ob in Webbrowsern das Kennwort gespeichert werden darf.
username
wgserver.saml.idpattribute.username
Gibt das vom Identitätsprovider für die SAMLAuthentifizierung verwendete Attribut an. Der
Standard ist username.
wgserver.saml.maxassertiontime
Gibt die maximale Anzahl der Sekunden seit
Erstellung an, bis zu denen eine Assertion verwendbar.
3000
wgs7200
erver.saml.maxauthenticationage
Gibt die Anzahl der Sekunden an, die maximal
zwischen der Benutzerauthentifizierung und der
Verarbeitung der AuthNResponse-Meldung
erlaubt sind.
wgserver.saml.responseskew
180
Legt die Anzahl der Sekunden für die maximale
Differenz zwischen Tableau Server-Zeit und
Zeitpunkt der Assertion-Erstellung (auf Basis
der IdP-Serverzeit) fest, in der die Meldung
noch verarbeitet werden darf.
wgserver.session.idle_limit 240
Die Anzahl von Minuten Leerlaufzeit, bevor eine
Anmeldung bei der Webanmeldung abläuft.
workerX.gateway.port
80 (443, wenn Externer Port, der von Apache auf workerX hin
- 445 -
Option
Standardwert
Beschreibung
SSL)
überwacht wird. worker0.gateway.port ist der
externe Port von Tableau Server. In einer verteilten Umgebung ist worker0 der primäre
Tableau Server.
workerX.vizqlserver.procs Anzahl der
Prozesse
Anzahl der VizQL-Server
workerX.vizqlserver.port
9100
Basisport für VizQL-Server auf workerX.
workerX.wgserver.port
8000
Basisport für Webanwendungsserver auf workerX.
workerX.wgserver.procs
Prozessoranzahl
Anzahl der Webanwendungsserverprozessoren
Wiederherstellen des Standardwerts für eine Einstellung
Sie können den Standardwert für eine Tableau Server-Konfigurationseinstellung mit den
folgenden Schritten wiederherstellen:
1. Halten Sie den Server an.
2. Stellen Sie im bin-Verzeichnis den Standardwert für eine bestimmte Einstellung durch
folgende Eingabe an:
tabadmin set option-name --default
Um beispielsweise die tabadmin-Option vizqlserver.session.expiry.timeout auf den
Standardwert von 30 Minuten zurückzusetzen, geben Sie Folgendes ein:
tabadmin set vizqlserver.session.expiry.timeout --default
Sie können stattdessen auch den kürzeren Befehl -d verwenden. Beispiel:
tabadmin set vizqlserver.querylimit -d
3. Führen Sie dann den Konfigurationsbefehl aus:
tabadmin configure
4. Starten Sie den Server.
Datenbankwartung
Ein Tableau Server-Administrator sollte regelmäßig Datenbankwartungsaufgaben
durchführen, die Festplattenauslastung auf dem Server überwachen und nicht benötigte
- 446 -
Dateien löschen, um Speicherplatz auf dem Server freizugeben. Wenn diese Schritte
durchgeführt werden, kann Tableau Server optimal ausgeführt werden.
Mit dem Befehlszeilenprogramm tabadmin können Sie die Tableau-Daten sichern und
wiederherstellen und nicht benötigte Protokolldateien und temporäre Dateien bereinigen. Zu
den Tableau-Daten gehört die Tableau Server-eigene PostgreSQL-Datenbank, in der
Metadaten zu Arbeitsmappen und Benutzern, Datenextraktdateien (.tde) und
Serverkonfigurationsdaten gespeichert werden. Tableau Server-Protokolldateien zeichnen
die Aktivitäten auf und unterstützen Sie bei der Diagnose von Problemen. Protokolle werden in
Ordnern auf dem Server gespeichert und können archiviert und entfernt werden, um
Speicherplatz freizugeben. Verwenden Sie die weiter unten beschriebenen Befehle
zusammen mit der integrierten Windows-Aufgabenplanung, um Daten automatisch zu sichern
und nicht benötigte Dateien zu entfernen.
Sichern der Tableau-Daten
Sichern Sie die Tableau-Daten unbedingt, damit Sie veröffentlichte Ansichten und sonstige
Informationen bei einem Systemausfall wiederherstellen können. Die mit Tableau Server
verwalteten Daten bestehen aus der Tableau-eigenen PostgreSQL-Datenbank, in der
Metadaten zu Arbeitsmappen und Benutzern, Datenextraktdateien (.tde) und
Konfigurationsdaten gespeichert werden. Beim Erstellen einer Sicherung werden alle diese
Daten in einer einzigen Datei mit der Erweiterung .tsbak gespeichert. Wenn Sie eine verteilte
Installation von Tableau Server ausführen, wird dieser Schritt auf dem primären Server
ausgeführt, auch wenn sich die Daten-Engine, welche die .tde-Dateien verarbeitet, auf einem
Arbeitscomputer befindet. Damit dies als effektive Sicherung dienen kann, speichern Sie die
.tsbak-Datei auf einem anderen Computer als dem Tableau Server-Host.
Zum Erstellen einer .tsbak-Datei gehen Sie wie unten beschrieben vor. Bei Ausführung des
Tableau-Deinstallationsprogramms, also dem ersten Schritt beim Upgrade auf eine neue
Version, wird ebenfalls automatisch eine .tsbak-Datei erstellt. Diese .tsbak-Datei wird zur
automatischen Migration Ihrer Daten in die neuere Version verwendet.
Durch das Ausführen des Befehls backup werden auch die Tableau ServerProtokolldateien entfernt, die älter als sieben Tage sind, sowie einige der Informationen,
die in bestimmten Tableau Server Verwaltungsansichten Auf Seite 265 angezeigt
werden.
1. Öffnen Sie als Administrator eine Eingabeaufforderung, und geben Sie Folgendes ein:
cd "C:\Program Files\Tableau\Tableau Server\8.3\bin"
2. Erstellen Sie die Sicherungsdatei durch die Eingabe von tabadmin backup
<filename>, wobei <filename> für den Namen oder den Ort der zu erstellenden
Sicherungsdatei steht. Ab Version 8.1 ist es nicht mehr nötig, den Server anzuhalten,
bevor Sie die Sicherung erstellen. Beispiel:
tabadmin backup tabserver
- 447 -
oder
tabadmin backup C:\backups\tableau\tabserver
Optionale können Sie auch -d verwenden, um das aktuelle Datum an den Dateinamen
anzuhängen und -t, gefolgt von einem Pfad, um einen Ort für die temporären Dateien
festzulegen, die während des Sicherungsvorgangs erstellt werden. Beispiel:
tabadmin backup tabserver -d -t C:\mytemp\tableau
Im obigen Beispiel wird die Sicherungsdatei tabserver.tsbak im BIN-Verzeichnis
von Tableau Server (C:\Program Files\Tableau\Tableau
Server\8.3\bin) und nicht in C:\mytemp\tableau erstellt.
Wiederherstellen von einer Sicherung
Bei einer Wiederherstellung werden der Inhalt der Tableau PostgreSQL-Datenbank,
Datenextrakte und Konfigurationsdateien durch den Inhalt der Sicherungsdatei (.tsbak)
überschrieben. Wenn Sie eine verteilte Installation auf Tableau Server ausführen, wird dieser
Schritt auf dem primären Server ausgeführt.
So führen Sie eine Wiederherstellung von einer Sicherungsdatei durch:
1. Halten Sie den Server durch die Eingabe des folgenden Befehls an:
tabadmin stop
2. Stellen Sie die Datenbank anhand einer Sicherungsdatei wieder her, indem Sie
folgenden Befehl eingeben:
tabadmin restore <filename>
Ersetzen Sie in der obigen Zeile <filename> durch den Namen der Sicherungsdatei,
aus der die Daten wiederhergestellt werden sollen.
Wenn Sie nur die Daten und keine Konfigurationseinstellungen wiederherstellen
möchten, geben Sie den folgenden Befehl ein:
tabadmin restore --no-config <filename>
Tableau Server wird automatisch neu gestartet.
3. Wenn Sie den Befehl tabadmin assetkeys vor dem Erstellen der Sicherungsdatei
ausgeführt haben, die Sie für die Wiederherstellung verwenden, führen Sie den
folgenden Befehl aus:
tabadmin assetkeys --validate
Sie werden zur Eingabe der Passphrase aufgefordert, die für das erneute Erstellen der
benutzerdefinierten Verschlüsselungsschlüssel in der Sicherungsdatei erforderlich ist.
Wenn Sie eine .tsbak-Datei wiederherstellen, erstellt Tableau Server automatisch eine Kopie
des aktuellen Ordners data nennt diese Kopie tabsvc.bak-* und legt sie unter
ProgramData\Tableau\Tableau Server\data ab. Dieser Ordner ist eine
- 448 -
Notfallsicherung für Tableau Server-Daten, die vom Tableau Support verwendet werden
können, falls bei der Wiederherstellung über die Sicherung Probleme auftreten.
Nach Abschluss der Wiederherstellung sollten die tabsvc.bak-*-Ordner unter
ProgramData\Tableau\Tableau Server\data entfernt werden, um zusätzlichen
Speicherplatz freizugeben. In Tableau Server-Clustern werden tabsvc.bak-*-Ordner auf
allen Computern erstellt, auf denen Tableau Server ausgeführt wird.
Entfernen Sie nicht den Ordner tabsvc, der sich ebenfalls unter
ProgramData\Tableau\Tableau Server\data befindet. Dieser Ordner enthält
Tableau Server-Daten. Entfernen Sie nur die tabsvc.bak-*-Ordner.
Wiederherstellen von Extrakten aus einer Sicherung
Die Datei uninstall-<version>.tsbak (z. B. uninstall-8.2.tsbak) wird als Teil des
Deinstallationsprozesses erstellt. Nach dem Upgrade auf Version 8.3können Sie über diese
Datei Datenextrakte wiederherstellen. Dies ist beispielsweise hilfreich, wenn Sie beim
Upgrade den Ordner "dataengine" versehentlich gelöscht haben. So verwenden Sie die Datei
uninstall-<version>.tsbak zum Wiederherstellen von Datenextrakten:
1. Halten Sie den Server an.
2. Geben Sie im BIN-Ordner von Tableau Server 8.3 Folgendes ein:
Windows Server 2012, Windows Server 2008, Windows Vista, Windows 7, Windows 8:
tabadmin restore \ProgramData\Tableau\Tableau
Server\uninstall-8.2.tsbak
32-Bit Tableau Server installiert auf 64-Bit Windows Server 2003: tabadmin
restore \Program Files (x86)\Tableau\Tableau
Server\uninstall-8.2.tsbak
32-Bit Tableau Server installiert auf 32-Bit Windows Server 2003: tabadmin
restore \Program Files\Tableau\Tableau Server\uninstall8.2.tsbak
Entfernen überflüssiger Dateien
Es wird empfohlen, den Speicherverbrauch auf Ihrem Server zu überwachen. Wenn Sie mehr
Speicher zur Verfügung stellen müssen, können Sie Protokolldateien, einige PostgreSQLDatenbankeinträge sowie Protokolldatei-Archive entfernen.
Wenn Sie die älteren Protokolleinträge möglicherweise noch zur Behebung von Problemen
benötigen, sollten Sie vor dem Bereinigen ein Protokolldatei-Archiv erstellen.Weitere
Information dazu finden Sie unter Archivieren von Protokollen in der Befehlszeile
(tabadmin) Auf Seite 460.
Sie müssen für die Bereinigung nicht den Tableau Server anhalten, allerdings verhält sich der
Befehl tabadmin cleanup unterschiedlich je nachdem, ob Tableau Server ausgeführt wird
oder angehalten wurde. Die Ziele, die Sie mit der Bereinigung von Protokolldateien und
- 449 -
temporären Dateien erreichen möchten, legen fest, wie Sie den Befehl tabadmin
cleanup ausführen.
Zustand des Servers und "tabadmin cleanup"
Um alle in Frage kommenden Dateien und Datenbankeinträge zu bereinigen, müssen Sie
tabadmin cleanup zweimal ausführen: einmal, wenn Tableau Server ausgeführt wird, und
einmal, wenn er angehalten wurde.
Die Ergebnisse von tabadmin cleanup hängen davon ab, ob Tableau Server ausgeführt
wird oder nicht.
Hier ist eine Zusammenfassung dazu, was mit tabadmin cleanup bei ausgeführtem und
bei angehaltenem Server gelöscht wird:
Wenn Sie "tabadmin cleanup" mit angehaltenem Tableau Server ausführen:
l
Alle Protokolldateien in ProgramData\Tableau\Tableau
Server\data\tabsvc\logs werden entfernt
(Protokolldateien in ProgramData\Tableau\Tableau Server\logs werden
nicht entfernt).
l
l
Die Inhalte der temporären Tableau Server-Ordner
(ProgramData\Tableau\Tableau Server\temp und
ProgramData\Tableau\Tableau Server\data\tabsvc\temp) werden
entfernt.
http_requests-Tabelleneinträge werden nicht geändert, da auf die PostgreSQLDatenbank nicht zugegriffen werden kann.
Wenn Sie "tabadmin cleanup" mit aktiviertem Tableau Server ausführen:
l
Protokolldateien, die älter als sieben Tage sind, werden aus
ProgramData\Tableau\Tableau Server\data\tabsvc\logs entfernt
(aktive Protokolle und Protokolldateien in ProgramData\Tableau\Tableau
Server\logs werden nicht entfernt).
l
http_requests-Tabelleneinträge, die älter als sieben Tage sind, werden aus der
Tableau Server PostgreSQL-Datenbank entfernt.
Die ist ein der Tabellen, die Sie beim Erstellen benutzerdefinierter
Verwaltungsansichten verwenden können. Weitere Informationen dazu finden Sie unter
Erstellen benutzerdefinierter Verwaltungsansichten Auf Seite 273.
Zeilen in der http_requests-Tabelle, die älter als sieben Tage sind, werden
ebenfalls entfernt, wenn Sie die Tableau-Daten sichern.Weitere Informationen dazu
finden Sie unter Sichern der Tableau-Daten Auf Seite 447.
l
Die Inhalte der temporären Tableau Server-Ordner werden nicht geändert.
- 450 -
Entfernen überflüssiger Dateien
So entfernen Sie Protokolldateien, die älter als sieben Tage sind, sowie http_requestsEinträge, die älter als sieben Tage sind:
l
Geben Sie bei aktiviertem Tableau Server in die Eingabeaufforderung tabadmin
cleanup ein.
So entfernen Sie alle Protokolldateien und temporäre Dateien, behalten aber http_
requests-Einträge:
l
Geben Sie bei aktiviertem Tableau Server in die Eingabeaufforderung tabadmin
cleanup --restart ein.
Mit der Option --restart wird der Tableau Server angehalten, bevor der
Bereinigungsbefehl ausgeführt wird, anschließend wird der Tableau Server wieder
gestartet.
Dies entspricht der dreimaligen Ausführung von tabadmin: tabadmin stop,
tabadmin cleanup und anschließend tabadmin start.
Tipps für die Automatisierung der Reinigungs- und Sicherungsbefehle finden Sie in folgendem
Knowledge Base-Artikel: Server Backup and Maintenance Automation (Automatisierung der
Sicherung und Wartung des Servers)
Protokolldatei-Archive bereinigen
Wenn Sie ein Protokolldatei-Archive erstellt haben und dieses nun nicht mehr benötigen,
können Sie es auf der Wartungsseite mit der Option Snapshot löschen wieder vom Server
entfernen. Weitere Informationen dazu finden Sie unter Protokolle auf Wartungsseite
archivieren (Momentaufnahme) Auf Seite 457.
Problembehebung
Die folgenden Themen enthalten Informationen zur Behebung von Problemen, die mit
Tableau Server auftreten können. Tipps zum Testen der vertrauenswürdigen
Authentifizierung finden Sie unter Behandeln von Problemen mit der
vertrauenswürdigen Authentifizierung Auf Seite 360:
Mit Protokolldateien arbeiten
Das Erstellen von Protokolldateien zählt zu den Standardaktivitäten in Tableau Server.Sie
benötigen möglicherweise die Serverprotokolldateien, wenn Sie Probleme mit Tableau Server
beheben müssen oder wenn der Tableau Support ein Protokoll anfordert, um Ihnen bei der
Behebung eines Problems zu helfen.
Sie können ein gezipptes Protokolldatei-Archiv (Momentaufnahme) über die Befehlszeile des
Servers oder über die Option zum Erzeugen von Momentaufnahmen auf der Wartungsseite
- 451 -
erstellen. Das gezippte Archiv enthält Kopien der Protokolle, die Sie kopieren oder über einen
Webbrowser herunterladen und an den Tableau-Support schicken können. Sobald Sie über
eine Kopie des Archivs verfügen, können Sie das Archiv vom Server löschen. Weitere
Informationen zum Erstellen, Herunterladen und Löschen von Protokolldatei-Archiven finden
Sie unter Protokolle auf Wartungsseite archivieren (Momentaufnahme) Auf Seite 457.
Diese Themensammlung enthält Informationen zum Erstellen von Protokolldatei-Archiven, zu
den Inhalten bestimmter Protokolldateien und Hinweise dazu, wann und wie ein Protokoll
aufgerufen werden sollte.
Untersuchen von Tableau Server-Problemen
Aufgrund der Spannbreite und Komplexität möglicher Probleme bei Tableau Server gibt es
keinen einfachen Prozess, mit dem sich alle Probleme untersuchen lassen, im Allgemeinen
sind jedoch diese Schritte zu berücksichtigen:
1. Bereinigen Sie vorhandene Protokolldateien, um ihre Größe zu reduzieren. Weitere
Informationen finden Sie unter Entfernen überflüssiger Dateien Auf Seite 449.
2. Stellen Sie die geeignete Protokollstufe ein. Der Tableau-Support gibt Ihnen entsprechende Anweisungen. Weitere Informationen finden Sie unter Ändern von Protokollstufen Auf Seite 466.
3. Stellen Sie das Problem, das Sie beheben möchten, wieder her, damit die Protokolle
die mit dem Problem verbundenen Ereignisse erfassen.
4. Erstellen Sie ein Archiv der Protokolle. Weitere Informationen finden Sie unter
Archivieren von Protokolldateien Auf Seite 456.
Wichtig: Verwenden Sie dieses Archiv beim Anzeigen der Protokolldateien. Sie
sollten Dateien nicht direkt auf dem Serve bearbeiten, verschieben oder löschen.
5. Sehen Sie sich die Serverkonfigurationsdatei an (\config\workgroup.yml),
um ein grundlegendes Verständnis von der Serverumgebung zu gewinnen.
6. Sehen Sie sich das Administratorprotokoll an (\logs\tabadmin.log), um die
Wartungsaktionen am Server nachvollziehen zu können.
Suchen Sie nach Ausführen als: <script>, um spezielle Einräge zur tabadminAktivität zu finden.
7. Lesen Sie die Apache-Protokolle (\httpd\access.####_##_##_##_##_
##.log und \httpd\error.log) zu Anfragen, die einen Bezug zu dem von Ihnen
untersuchten Problem aufweisen könnten.
Die Apache-Protokolle werden zu einem beträchtlichen TeilDaten enthalten,die mit dem
von Ihnen vorgefundenen Problem nicht in Zusammenhang stehen.
l Wenn Sie eine Anforderung vorfinden, die vermutlich mit Ihrem Problem in
Zusammenhang stehen könnte, durchsuchen Sie \wgserver und \vizqlserver nach Einträgen, welche die eindeutige Anforderungs-ID aus den
Apache-Protokollen enthalten.
- 452 -
l
l
l
l
Schauen Sie den Reaktions-Code und die mit der Anforderungs-ID verbundene
Mitteilung an.
Suchen Sie nach dem Namen der Arbeitsmappe, der Ansicht, des Dashboards
oder der Datenquelle, die im Zusammenhang mit Ihrem Problem steht. Suchen
Sie unbedingt nach einem relevanten Zeitstempel.
Wenn Sie ein Problem finden, das im Zusammenhang mit Ihrem Problem zu stehen scheint, sehen Sie sich den Antwortcode an, der der Anfrage zugeordnet ist.
(200-er Werte sind gut, 500-er Werte deuten auf Probleme hin.)
Suchen Sie die eindeutige Anfrage-ID, die der von Ihnen identifizierten Anfrage
zugeordnet ist (bei der eindeutigen Anfrage-ID handelt es sich um eine 24-stellige
alphanumerische Zeichenfolge ganz am Ende der Anfrage).
8. Prüfen Sie das Protokollarchiv weiter, um nach weiteren Meldungen und möglichen
Fehlern zu suchen.
l Verwenden Sie die Anfrage-ID aus den Apache-Protokollen, um die Ordner
\wgserver und \vizqlserver des Protokollarchivs nach Dateien zu durchsuchen, die zugehörige Protokolleinträge enthalten. Suchen Sie nach Hinweisen
auf ein Problem (beispielsweise Fehlermeldungen oder Abfragen mit langer Ausführungsdauer).
9. Support kontaktieren
Schicken Sie das gezippte Archiv an Tableau, wenn Sie das Problem nicht selbst lösen
können oder der Tableau-Support dieses anfordert.
Weitere Informationen dazu finden Sie unter folgenden Themen:
Tableau Server-Prozesse
Die Standardkonfiguration der sechs vorhandenen Tableau-Serverprozesse kann geändert
werden, um andere Ergebnisse zu erzielen. Die Themen Verbessern der Serverleistung
Auf Seite 308 und Hochverfügbarkeit Auf Seite 158 beschreiben einige der möglichen
Ansätze. Der oberste Status eines jeden Prozesses wird auf der Wartungsseite des Servers
angezeigt. Weitere Einzelheiten zu einigen Prozessen, wie z B. dem Hintergrundprozess, sind
unter Verwaltungsansichten Auf Seite 265 zu finden.
Im Hinblick auf die Architektur verwendet die 64-Bit-Version von Tableau Server native 64-BitProzesse; die 32-Bit-Version von Tableau Server verwendet 32-Bit-Prozesse. Die Ausnahme
ist die Daten-Engine. Wenn die 32-Bit-Version von Tableau Server unter einem 64-BitBetriebssystem installiert wird, wird die 64-Bit-Version des Daten-Engine-Prozesses
verwendet.
Informationen zu den mit diesen Prozessen erstellten Dateien finden Sie unter Speicherorte
von Server-Protokolldateien Auf Seite 461.
Prozess
Dateiname
Zweck
Anwendungsser wgserver.exe Handhabt die
ver
Webanwendung,
- 453 -
Multithreade Leistungsmerkmale
d?
Ja
Verbraucht nur während
Prozess
Dateiname
Multithreade
d?
Zweck
unterstützt
Navigation und
Suche.
Hintergrund
backgrounder. Führt
Nein
exe
Serveraufgaben
aus, darunter
Extraktaktualisierun
gen, "Jetzt
ausführen"Aufgaben und über
tabcmd gestartete
Aufgaben
Daten-Engine
tdeserver64.ex Speichert
e
Datenextrakte und
tdeserver.exe beantwortet
Abfragen.
- 454 -
Ja
Leistungsmerkmale
seltener Vorgänge, wie z. B
beim Veröffentlichen einer
Arbeitsmappe mit einem
Extrakt oder beim Erstellen
eines statischen Bildes für
eine Ansicht, eine auffällige
Menge von Ressourcen.
Seine Auslastung kann
durch browserbasierte
Interaktion oder durch
tabcmd erstellt werden.
Ein Singlethread-Prozess,
bei dem mehrere Prozesse
auf einem beliebigen oder
auf allen Computern im
Cluster ausgeführt werden
können, um die Kapazität
zu erweitern. Die
Hintergrundprozesskompo
nente verbraucht
gewöhnlich nicht viel
Prozessspeicher, kann
jedoch je nach der ihr
präsentierten
Arbeitsauslastung CPU-,
I/O- oder
Netzwerkressourcen
verbrauchen.
Beispielsweise kann beim
Durchführen großer
Extrakt-Aktualisierungen
zum Abruf von Daten
Netzwerkbandbreite
verwendet werden. CPURessourcen können durch
Datenabruf- oder komplexe
tabcmd-Aufgaben
verbraucht werden.
Die Arbeitsauslastung der
Daten-Engine wird durch
Prozess
Datenserver
Dateiname
Multithreade
d?
Zweck
dataserver.exe Handhabt
Verbindungen zu
Tableau ServerDatenquellen.
- 455 -
Ja
Leistungsmerkmale
Anforderungen von dem
VizQL-Server-Vorgang
generiert. Es handelt sich
um die Komponente, die
Extrakte in den Speicher
lädt und Abfragen an ihnen
durchführt. Der
Speicherverbrauch basiert
hauptsächlich auf der
Größe der zu ladenden
Datenextrakte. Unter 64Bit-Betriebssystemen wird
standardmäßig die 64-BitBinärdatei verwendet,
selbst wenn die 32-BitVersion von Tableau Server
installiert ist. Die DatenEngine ist multithreaded
und kann mehrere
Anforderungen gleichzeitig
handhaben. Bei hoher
Auslastung kann sie CPU-,
I/O- und
Netzwerkressourcen
verbrauchen, was zu einem
Leistungsengpass führen
kann. Bei hoher Auslastung
kann eine einzige Instanz
der Daten-Engine sämtliche
CPU-Ressourcen zur
Verarbeitung von
Anforderungen in Anspruch
nehmen.
Da es sich um einen Proxy
handelt, ist er
normalerweise nur durch
das Netzwerk gebunden,
kann bei einer gewissen
Anzahl von gleichzeitigen
Benutzersitzungen jedoch
durch die CPU gebunden
Prozess
Dateiname
Multithreade
d?
Zweck
Repository
postgres.exe
In der Datenbank
k. A.
von Tableau Server
werden
Arbeitsmappen- und
Benutzer-Metadaten
gespeichert.
VizQL Server
vizqlserver.exe Lädt und stellt
Ja
Ansichten dar,
berechnet und führt
Abfragen durch
Leistungsmerkmale
sein. Seine Auslastung wird
durch browser- und
Tableau-Desktop-basierte
Interaktion und ExtraktAktualisierungsaufgaben
für Tableau ServerDatenquellen generiert.
Verbraucht in der Regel
wenige Ressourcen. In
seltenen Fällen kann es bei
sehr großen
Bereitstellungen (mit
Tausenden von Benutzern)
zu einem Engpass
kommen, während
Vorgänge wie die Ansicht
aller Arbeitsmappen nach
Benutzer oder das Ändern
von Berechtigungen
durchgeführt werden.
Verbraucht beim Laden von
Ansichten und bei der
interaktiven Verwendung
über einen Webbrowser
eine auffällige Menge von
Ressourcen. Kann CPUgebunden, E/A-gebunden
oder netzwerkgebunden
sein. Die
Prozessauslastung kann
nur durch browserbasierte
Interaktion erstellt werden.
Es kann sein, dass der
Prozessarbeitsspeicher
nicht ausreicht.
Archivieren von Protokolldateien
Sie können Archive (Momentaufnahmen) von Protokolldateien auf zwei Arten erstellen: von
der Wartungsseite mithilfe eines Browsers oder über tabadmin mithilfe einer
Eingabeaufforderung in Tableau Server. Wenn Sie eine Protokolldatei erstellen, erhalten Sie
- 456 -
eine gezippte Momentaufnahme, die Sie zur Problembehebung nutzen oder zu diesem Zweck
an den Tableau-Support senden können.
Protokolle auf Wartungsseite archivieren (Momentaufnahme)
Sie haben die Möglichkeit, eine Momentaufnahme(ein Archiv) der Tableau ServerProtokolldateien aus einem Webbrowser heraus zu erstellen und herunterzuladen, ohne die
Eingabeaufforderung zu öffnen. Diese gezippte Momentaufnahme enthält eine Kopie von
Protokolldateidaten von bis zu sieben Tagen aus Tableau Server sowie sämtlichen
Arbeitsservern (in verteilten Umgebungen). Durch den Vorgang der Momentaufnahme
werden die Protokolldateien aus Tableau Server oder die mit tabadmin erstellten
Protokollarchive nicht verändert oder entfernt.
Hinweis Zur Angabe der zu erfassenden Datenmenge oder des Namens der zu
erstellenden Zip-Datei können Sie mithilfe von tabadmin ein Archiv der Serverprotokolle
erstellen. Weitere Informationen hierzu finden Sie unter Archivieren von Protokollen
in der Befehlszeile (tabadmin) Auf Seite 460.
So erstellen Sie eine Momentaufnahme von Server-Protokolldateien:
1. Klicken Sie auf der Registerkarte "Admin" auf Wartung:
2. Klicken Sie unter "Aktivitäten" auf Momentaufnahme von Protokolldateien erstellen
und herunterladen, um die Momentaufnahmeoptionen zu öffnen:
- 457 -
3. Klicken Sie auf Momentaufnahme generieren, um eine Momentaufnahme der
Tableau Server-Protokolle zu erstellen. Die Schaltfläche "Momentaufnahme
generieren" ist nur dann verfügbar, wenn noch keine Momentaufnahme vorhanden ist.
Mit tabadmin erstellte Protokollarchive wirken sich nicht auf die Verfügbarkeit
dieser Option aus.
4. Klicken Sie auf Momentaufnahme herunterladen, um die ProtokollMomentaufnahme in den Standard-Download-Ordner Ihres Webbrowsers
herunterzuladen. Diese Option ist verfügbar, sobald Sie eine Momentaufnahme erstellt
haben.
In Google Chrome wird der Download am unteren Rand des Fensters angezeigt:
- 458 -
5. Klicken Sie auf den Pfeil und danach auf Öffnen, um die Momentaufnahme zu
entzippen, oder auf In Ordner anzeigen, um zu sehen, an welcher Stelle sie
gespeichert wurde:
6. (Optional) Klicken Sie auf Momentaufnahme löschen, um die Momentaufnahme
eines Protokolls zu löschen. Diese Option ist verfügbar, sobald Sie eine
Momentaufnahme erstellt haben. Sie müssen die vorhandene Momentaufnahme
löschen, bevor Sie eine neue erstellen können.
- 459 -
Dies ist beispielsweise der Fall, wenn Sie die Momentaufnahme löschen möchten, die
Sie vor einem zu untersuchenden Ereignis erstellt haben.
Archivieren von Protokollen in der Befehlszeile (tabadmin)
Tableau Server-Protokolldateien können mit dem Befehl tabadmin ziplogs archiviert
werden. Mit diesem Befehl wird eine ZIP-Datei erstellt, die alle Protokolldateien enthält und bei
der Zusammenarbeit mit dem Tableau Support hilfreich ist. Der Befehl ziplogs entfernt die
Protokolldateien nicht, sondern kopiert sie in eine ZIP-Datei. Wenn Sie eine verteilte
Installation von Tableau Server ausführen, führen Sie diesen Schritt auf dem primären Server
aus. Alle Arbeitscomputerprotokolle werden in die ZIP-Datei einbezogen.
Hinweis: Durch den Befehl tabadmin ziplogs werden möglicherweise Meldungen
folgender Art generiert: "zip error: Nothing to do!" Diese beziehen sich im Allgemeinen
auf spezifische Schritte im Zip-Prozess und bedeuten nicht, dass das ProtokolldateiArchiv leer ist oder der gesamte Archivierungsprozess fehlgeschlagen ist.
So erstellen Sie Protokolldatei-Archive:
1. Öffnen Sie als Administrator eine Eingabeaufforderung, und wechseln Sie zum BIN-Verzeichnis von Tableau Server. Beispiel:
cd "C:\Program Files\Tableau\Tableau Server\8.3\bin"
2. Halten Sie Tableau Server mit folgendem Befehl an:
tabadmin stop
3. Erstellen Sie die ZIP-Datei durch die Eingabe von tabadmin ziplogs -l -n
<filename>, wobei <filename> für den Namen der zu erstellenden ZIP-Datei
steht. Wählen Sie einen eindeutigen Namen ohne Leerzeichen. Tableau überschreibt
vorhandene Dateien nicht. Beispiel:
tabadmin ziplogs -l -n my_logs
Wenn Sie keinen Dateinamen angeben, wird die Datei logs.zip genannt. Sie können
auch -d mm/dd/yyyy angeben, um nur die Protokolle zu erfassen, die seit dem
angegebenen Datum generiert wurden. Beispiel:
tabadmin ziplogs -l -n -d 02/14/2014
- 460 -
Mit dem obigen Befehl wird eine ZIP-Datei namens logs.zip erstellt, die Protokolle
enthält, welche seit dem 14. Februar 2014 bis heute erstellt wurden. Ältere Protokolle
werden ausgeschlossen. Die Option -n erfasst Informationen über die
Serverumgebung, einschließlich der verwendeten Ports. Um eine Liste aller ziplogsOptionen anzuzeigen, geben Sie tabadmin ziplogs -h ein.
4. Starten Sie Tableau Server mit folgendem Befehl neu:
tabadmin restart
Sie finden die gezippte Protokolldatei im BIN-Ordner von Tableau Server.
Speicherorte von Server-Protokolldateien
Protokolldatei-Archive von Tableau Server werden in einer Zip-Datei mit dem Namen
logs.zip erfasst (Sie können einen anderen Namen festlegen, wenn Sie das Archiv mit
tabadmin) erstellen. Sie können das Archiv vom Server auf einen lokalen Computer
kopieren und dort öffnen oder an den Tableau Support senden. Beim Entzippen des Archivs
wird eine Reihe an Ordnern mit entsprechenden Protokolldateien erstellt. In dieser Tabelle
sind die möglichen Inhalte des Ordners, der ursprüngliche Speicherort der Dateien auf dem
Tableau Server, der Prozess, mit dem die Protokolldateien erstellt wurden, und Details zu den
Dateien beschrieben.
Das Protokollverzeichnis von Tableau Server lautet C:\ProgramData\Tableau\Tableau
Server\data\tabsvc\logs, sofern Tableau Server auf Laufwerk C installiert wurde, sofern in
untenstehender Tabelle nichts Abweichendes angegeben ist.
Speicherorte von Protokollarchivdateien
DateiDetails
en/Ordner in
logs.zip
buildDie Build-Version von
Tableau Server.
version.txt
Dateien
Erstellt von Speicherort auf
Tableau Server
tabsvc.yml
\config
wgserver.checksum
asset-
Protokolle mit Bezug
keyencryption auf die Repository-Verschlüsselung.
backProtokolle in Bezug auf
Abonnements und
grounder
geplante Aktivitäten wie
Extraktaktualisierungen, "Jetzt
ausführen" Aufgaben
assetkeyencrypti tabadmin \logs\asassetkeys setkeyencryption
on.log
backgrounder#.log
spawn.####.log
tomcat-#.######-##.log
- 461 -
backgrounder.exe
\logs\backgrounder
config
und tabcmd-Aufgaben.
Konfigurationsdateien.
connections.yml
Ein guter
workgroup.yml
Ausgangspunkt zum
Sammeln von
Informationen bei der
Problembehebung.
Bestätigen Sie, dass die
Konfigurationseinstellu
ngen
erwartungsgemäß sind.
Kon\config
figuration
von Tableau
Server
datacollector
DatenEngine
dataserver
httpd
\logs\datacollector
Zu jedem Tag gibt es
eine tdeserver-Protokolldatei mit Informationen zu
Datenextrakten und
Abfragen und Reaktionen auf VizQL Server-Anforderungen.
Informationen über Verbindungen zu Tableau
Server-Datenquellen.
Apache-Protokolle.
Hier können Sie nach
Authentifizierungseinträ
gen suchen. Mit jeder
Anforderung im
Apache-Protokoll ist
eine Anforderungs-ID
verbunden. Diese
Anforderungs-ID wird in
allen Serverprotokollen
verwendet. Sie können
sie verwenden, um
Protokolleinträge mit
einer Anforderung zu
verknüpfen.
tdeserver_####_ tdeserver.ex \logs\dataengine
##_##_##_##_
e
##.log
tdeserver64.
exe
dataserver-#.log
\logs\dataserver
access.####-##- Apache Dae- \logs\httpd
##.##-##-##log mon
error.log
startup.log
Lizenzierung
Protokolle An dieser Stelle
dataserver.exe
\logs\licensing
tabadmin.log
- 462 -
\logs
befinden sich die
nützlichsten und
interessantesten
Protokolle. Schauen
Sie hier nach, nachdem
Sie die
Konfigurationsdateien
geprüft haben.
tabconfig.log
tablicsrv.log
tabsrvlic.log
wgserver.war.de
ploy.log
tabadmin.log wird
niemals überschrieben
oder abgekürzt und
enthält entsprechend
alle Details.
notify-tabadmin.log
enthält Fehler aus
tabadmin.log (die
Fehler sind auch in
tabadmin.log
enthalten).
pgsql
tablicsrv.log und
tabsrvlic.log beziehen
sich auf die
Lizenzierung.
PostgreSQL-Datenbankprotokolle, darunter Dateien mit
Bezug auf den Start von
Serverprozessen.
Tableau-Datenextrakte
werden in der PostgreSQL-Datenbank
gespeichert.
repository
rsync
Bezieht sich auf die Synchronisierung des
Haupt-Repository und
die Betriebsbereitschaft
in Hochverfügbarkeitsumgebungen.
Gilt nur für
Hochverfügbarkeits
tabspawn
\logs\pgsql
postgres.exe
\logs\repository
\logs\rsync
- 463 -
(HA, High Availability)Installationen.
service
notify-tabsvc.log
\logs\service
tabsvc.log
solr
Bezieht sich auf die
Indexsuche.
\logs\solr
svcmonitor
tabadminservice
\logs\svcmonitor
Bezieht sich auf Protokollarchive, die mit der
Option Momentaufnahme von ServerProtokolldateien erstellen erstellt wurden.
\logs\tabadminservice
tabadm-
\logs\tabadmwrk
wrk
vizportal
vizqlserver
\logs\vizportal
Bezieht sich auf die
Anzeige von bzw.
Interaktion mit
Ansichten.
vizql-0.log.####- viz\logs\vizqlserver
##-##
qlserver.exe
spawn.####.log
Beim Ausführen
mehrerer Instanzen von
VizQL Server werden
die Instanzen nach
Portnummer
voneinander
unterschieden.
vizqlserver\logs
notifyproductionProtokolle enthalten
außergewöhnliche
Ereignisse.
Die meisten Dateien
weisen das JSONFormat auf.
tabprotosrv.txt is wird
erstellt, wenn Sie Daten
öffnen oder
Verbindungen zu Daten
backgrounder_
####_####_##_
##_##_##_##.txt
dataserver_
####_####_##_
##_##_##_##.txt
tabadmin_####_
- 464 -
\vizqlserver\logs
herstellen.
##_##_##_##_
##.txt
tabprotosrv.txt
vizqlserver_
####_####_##_
##_##_##_##.txt
wgserver_####_
####_##_##_
##_##_##.txt
wgserver
Informationen in Bezug
auf administrative
Aufgaben,
Arbeitsmappen- und
Berechtigungsmanage
ment, Authentifizierung,
Anmeldungen,
ursprüngliche
Ansichtsanforderungen
und
Veröffentlichungsanfor
derungen.
tdserver_
vizqlserver_
####_####_##_
##_##_##_##.txt
db-migrate_
wgs####_##_##_
erver.exe
##_##_##.log
migrate.log
notifyproduction.####_
####_##_##_
##_##_##.log
production.####.l
og
production.####_
####_##_##_
Instanzen von wgserver ##_##_##.log
werden nach
spawn.####.log
Portnummer,
tomcat-#.####_
unmittelbar gefolgt
durch "production" oder ##_##.log
"notify-production"
wgserver-#.log
unterschieden..
Durchsuchen, suchen.
notify-productionProtokolle enthalten
außergewöhnliche
Ereignisse.
Für jede
Hintergrundprozessko
mponente gibt es für
jeden Tag eine
- 465 -
\logs\wgserver
separate production.n_
###-Datei.
notify-production.n_###
entspricht
production.n_###,
enthält jedoch nur
Fehler.
Tableau Server-Protokolldateien befinden sich auf dem Server in den folgenden Ordnern:
Tableau Service-Protokolle
In den folgenden Protokolldateien werden Aktivitäten bezüglich Webanwendung, Datenbank
und Index verzeichnet:
C:\ProgramData\Tableau\Tableau Server\data\tabsvc
VizQL-Protokolle
In diesen Protokolldateien werden Aktivitäten bezüglich der Anzeige von Ansichten, z. B. das
Abfragen der Datenbank oder Generieren der Bilder, verzeichnet:
C:\ProgramData\Tableau\Tableau Server\data\tabsvc\vizqlserver\Logs
Temporäre Dateien
Jede Datei, die im nachstehenden Ordner mit exe_ beginnt, ist eine Tableau Server-Datei und
kann gelöscht werden.
C:\ProgramData\Tableau\Tableau Server\temp
Ändern von Protokollstufen
Ereignisse werden in Tableau Server standardmäßig auf Info-Stufe protokolliert. Sie können
dies ändern, wenn Sie mehr Informationen erfassen müssen (z. B. beim Arbeiten mit dem
Tableau-Support). Sie sollten Protokollebenen nur erhöhen, wenn Sie ein Problem beheben
müssen.
Protokollstufen
Die im Folgenden aufgeführten Protokollstufen sind in aufsteigender Reihenfolge nach der
Menge der protokollierten Informationen aufgeführt:
l
l
l
l
l
l
l
aus
schwerwiegend
Fehler
warnen
Info (der Standard)
debuggen
Ablaufverfolgung
- 466 -
Hinweis: Durch Erhöhen der Protokollstufe für debug oder trace erhöht sich die Menge
der protokollierten Informationen, was sich erheblich auf die Leistung auswirken kann.
Für debug sollten Sie nur dann eine Protokollstufe einstellen, wenn Sie ein bestimmtes
Problem untersuchen. Stellen Sie das Problem wieder her und setzen Sie die
Protokollstufe auf info zurück.
Ändern von Protokollstufen
Stellen Sie Protokollstufen für Tableau Server mit einem von mehreren tabadmin set-Befehlen
ein. Welchen Befehl Sie verwenden, hängt davon ab, für welche Komponente von Tableau
Server Sie die Protokollstufe ändern möchten.
Befehl
Speicherort der betroffenen Protokolle
server.log.level
vizqlserver.log.level
wgserver.log.level
(path begins with \ProgramData\Tableau\Tableau
Server\data\tabsvc)
\vizqlserver\Logs\*.txt
\vizqlserver\*.log
\wgserver\*.log
Weitere Informationen finden Sie unter tabadmin set-Optionen Auf Seite 438.
Um die Protokollstufen zu ändern, müssen Sie Tableau Server anhalten und danach neu
starten. Wenn Sie eine verteilte Installation von Tableau Server durchführen, stellen Sie die
Protokollierungsstufen vom primären Server ein.
So ändern Sie die Protokollstufe:
1. Öffnen Sie als Administrator eine Eingabeaufforderung, und wechseln Sie zum BINVerzeichnis von Tableau Server.
Wenn Tableau Server auf Laufwerk C installiert ist:
C:\Program Files\Tableau\Tableau Server\8.3\bin
oder
C:\Program Files (x86)\Tableau\Tableau Server\8.3\bin
2. Halten Sie Tableau Server mit folgendem Befehl an:
tabadmin stop
3. Stellen Sie die Protokollebene ein, indem Sie tabadmin set [command]
[option] eingeben.
Hierbei entspricht [command] server.log.level, vizqlserver.log.level
oder wgserver.log.level.
[option] ist eine gültige Protokollstufe.
Beispiele:
- 467 -
l
tabadmin set server.log.level debug
l
tabadmin set vizqlserver.log.level warn
l
tabadmin set wgserver.log.level off
4. Setzen Sie Tableau Server mit folgender Eingabe zurück:
tabadmin restart
Zurücksetzen von Protokollstufen
Nachdem Sie die Informationen zu dem von Ihnen untersuchten Problem erfasst haben,
setzen Sie die Protokollebenen zurück, damit die Leistung nicht durch veraltete Elemente
beeinträchtigt wird.
Setzen Sie die Protokollebene mit dem entsprechenden Befehl mit einer Option -d zurück auf
den Standard (Info).
Beispiele:
l
tabadmin set server.log.level -d
l
tabadmin set vizqlserver.log.level -d
l
tabadmin set wgserver.log.level -d
Handhabung nicht lizenzierter Server
Tableau bietet zwei Lizenzierungsmodelle: benutzerbasierte und core-basierte Lizenzierung.
Die benutzerbasierte Lizenzierung erfordert, dass für jedes aktive Benutzerkonto eine Lizenz
vorhanden ist. Benutzerbasierte Lizenzen verfügen über eine definierte Kapazität bzw. Anzahl
zulässiger Benutzer. Jedem Benutzer wird auf dem Server ein eindeutiger Benutzername
zugewiesen, und der Benutzer muss sich identifizieren, wenn er eine Verbindung mit dem
Server herstellt. Die Software kann auf einem einzelnen Computer installiert oder in einer
verteilten Serverumgebung über eine beliebige Anzahl von Computern verteilt werden.
Bei der core-basierten Lizenzierung sind keine Beschränkungen hinsichtlich der Anzahl der
Benutzerkonten im System gegeben, allerdings wird die Anzahl der Prozessor-Cores, die
Tableau Server nutzen kann, beschränkt. Sie können den Server auf einem oder mehreren
Computern installieren, um ein Cluster zu erstellen, wobei die Einschränkung gilt, dass die
Gesamtanzahl der Cores in allen Computern nicht die Anzahl der lizenzierten Cores übersteigt
und dass jeweils alle Cores in einem Computer durch die Lizenz abgedeckt sind.
Nicht lizenzierter benutzerbasierter Server
Meist ist ein abgelaufener Product Key oder ein abgelaufener Wartungsvertrag der Grund
dafür, dass ein Server mit benutzerbasierter Lizenzierung nicht lizenziert ist. Sie können Ihre
Produktschlüssel anzeigen und neue Produktschlüssel hinzufügen, indem Sie Start > Alle
Programme > Tableau Server > Product Keys verwalten auswählen.
- 468 -
Nicht lizenzierter core-basierter Server
Ein core-basierter Server kann aus verschiedenen Gründen nicht lizenziert sein. Ein häufiges
Problem besteht darin, dass der primäre Computer oder ein Arbeitscomputer über mehr
Cores verfügt als die Lizenz zulässt. Wenn der Server nicht lizenziert ist, können Sie den
Server unter Umständen nicht starten und verwalten. Sie können die Lizenzen allerdings mit
dem Befehlszeilenprogramm tabadmin verwalten. Führen Sie die unten beschriebenen
Schritte aus, um eine Liste der Lizenzen und die Anzahl von Cores pro Computer anzuzeigen.
1. Öffnen Sie eine Eingabeaufforderung, und geben Sie Folgendes ein: cd C:\Program
Files\Tableau\Tableau Server\8.3\bin
2. Geben Sie folgenden Befehl ein: tabadmin licenses.
Verarbeiten eines nicht lizenzierten VizQL-Serverprozesses
Über verschiedene Statusindikatoren auf der Wartungsseite von Tableau Server erhalten Sie
Informationen zum Zustand der Tableau Serverprozesse. Die orangefarbene Statusmeldung
"Nicht lizenziert"weist darauf hin, dass einer der VizQL-Serverprozesse nicht in der Lage ist,
die Lizenzinformationen von Tableau Server abzurufen.
Es kann verschieden Gründe dafür geben, warum der Prozess nicht auf diese Informationen
zugreifen kann. So können beispielsweise Netzwerkprobleme die Ursache dafür sein, dass ein
VizQL-Prozess, der auf einem Arbeitscomputer ausgeführt wird, nicht mit dem primären
Computer kommunizieren kann. Möglicherweise erhält der Prozess aber auch mehr
Anforderungen als er gleichzeitig akzeptieren kann und kann die Lizenzanforderung daher
nicht verarbeiten. Dies führt unter Umständen dazu, dass einige Benutzer auf Ansichten
zugreifen können, während anderen Benutzern dies nicht möglich ist.
Sie können das Problem lösen, indem Sie Tableau Server zunächst anhalten und
anschließend wieder starten.
VizQL-Fehler: "Nicht genügend Arbeitsspeicher"
Wenn der 32-Bit-Version von Tableau Server ein VizQL-Prozess das Limit der gleichzeitigen
Anzeigesitzungen erreicht, wird möglicherweise ein "Nicht genügend Arbeitsspeicher"-Fehler
angezeigt, der auch in die vizqlserver*.txt -Protokolle geschrieben wird, die sich hier befinden:
C:\ProgramData\Tableau\Tableau
Server\data\tabsvc\vizqlserver\Logs
Der VizQL-Prozess wird beim Auftreten dieses Fehlers nicht beendet, er akzeptiert aber keine
zusätzlichen Verbindungen mehr. Bei diesem Problem können Sie folgendermaßen vorgehen:
- 469 -
l
l
l
Upgrade auf die 64-Bit-Version von Tableau Server: Weitere Informationen finden
Sie unter Upgrade auf 8.3 Auf Seite 141.
Erhöhen der Anzahl der VizQL-Prozesse: Dies kann bedeuten, dass Sie mindestens
einen Arbeitscomputer hinzufügen müssen. Informationen dazu finden Sie unter
Installieren und Konfigurieren von Arbeitsservern Auf Seite 153.
Bearbeiten von vizqlserver.session.expiry.timeout: Verwenden Sie tabadmin, um
die Einstellung vizqlserver.session.expiry.timeout vom Standard (30 Minuten) auf einen
kürzeren Zeitraum, wie z. B. 10 oder 5 Minuten, zu ändern. Auf diese Weise können
Sitzungen im Leerlauf früher ablaufen, sodass Arbeitsspeicher für neue Sitzungen
freigegeben wird.
Fehler durch die Einschränkung von Cookies
Wenn sich ein Benutzer bei Tableau Server anmeldet, wird ein Sitzungs-Cookie in seinem
lokalen Browser gespeichert. Anhand des gespeicherten Cookies verwaltet Tableau Server
die Authentifizierung des angemeldeten Benutzers und den Zugriff auf den Server. Da der
Cookie in der gleichen Domäne oder Unterdomäne wie die Adressleiste des Browsers
angelegt wird, wird er als Erstanbieter-Cookie betrachtet. Wenn der Browser des Benutzers
so konfiguriert ist, dass Erstanbieter-Cookies blockiert werden, ist eine Anmeldung bei
Tableau Server nicht möglich.
Wenn sich der Benutzer über eine eingebettete Ansicht bei Tableau Server oder bei einer
Umgebung mit vertrauenswürdiger Authentifizierung anmeldet, geschieht dasselbe: es wird
ein Cookie gespeichert. In diesem Fall behandelt der Browser den Cookie als DrittanbieterCookie. Dies liegt daran, dass der Cookie in einer anderen Domäne angelegt wird als die, die
in der Adressleiste des Browsers angezeigt wird. Wenn der Browser des Benutzers so
konfiguriert ist, dass Drittanbieter-Cookies blockiert werden, ist eine Anmeldung bei Tableau
Server nicht möglich. Um diesen Fehler zu vermeiden, müssen Webbrowser so konfiguriert
werden, dass Cookies von Drittanbietern zugelassen werden.
Behandeln von Datenquellenproblemen
Für Benutzer, die mit Tableau Server-Datenquellen arbeiten, müssen drei Voraussetzungen
erfüllt sein:
l
Berechtigungen für die Datenquelle: Jeder, der eine Verbindung mit einer
Datenquelle herstellen möchte, muss über die Berechtigungen Verbinden und View
(Anzeigen) verfügen. Dies gilt auch für Benutzer, die auf Ansichten zugreifen, welche
eine Verbindung mit einer Datenquelle herstellen. Ein Benutzer, der Datenquellen
veröffentlichen und bearbeiten möchte, muss über die Berechtigung zum
Veröffentlichen und zudem über die Berechtigungen Schreiben/Speichern unter und
Herunterladen/Im Web speichern unter verfügen. Weitere Informationen hierzu
finden Sie unter Arbeiten mit Berechtigungen Auf Seite 89 und Festlegen von
Berechtigungen für eine Datenquelle Auf Seite 93.
- 470 -
Mehrdimensionale (Cube-)Datenquellen müssen heruntergeladen und in Tableau
Desktop verwendet werden, daher benötigen sie die Berechtigung Herunterladen/Im
Web speichern unter. Weitere Informationen zu Cubes in Tableau finden Sie unter
Mehrdimensionale (Cube-)Datenquellen Auf Seite 252.
l
l
Authentifizierungsmöglichkeit für die Datenbank: Es gibt verschiedene
Möglichkeiten für eine Datenverbindung in Tableau und die Steuerung der
Zugriffsrechte. Im Grunde muss für eine Verbindung mit der Datenbank immer eine
Authentifizierung erfolgen. Der Zugriff kann z. B. durch Tableau Server zur
Aktualisierung eines Extrakts erfolgen. Es kann sich um einen Benutzer von Tableau
Desktop handeln, der eine Verbindung zu einer Datenquelle herstellt, die wiederum eine
Verbindung zu einer Livedatenbank herstellt. Oder es handelt sich um einen Benutzer
von Tableau Server, der auf eine Ansicht zugreift, die eine Verbindung zu einer
Livedatenbank herstellt. Weitere Informationen zu den Optionen finden Sie unter
Datensicherheit Auf Seite 280.
Datenbanktreiber: Wenn für einen Benutzer, der eine Datenquelle in Tableau Desktop
erstellt und veröffentlicht hat, zusätzliche Datenbanktreiber installiert werden mussten,
müssen Sie diese Treiber möglicherweise auch auf Tableau Server installieren. Im Falle
einer verteilten Installation von Tableau Server, bei der beispielsweise der
Datenserverprozess auf einem Arbeitsserver ausgeführt wird, müssen alle
erforderlichen Datenbanktreiber sowohl auf diesem Server als auch auf dem primären
Server installiert werden. Auch für andere Prozesse sind Treiber erforderlich. Weitere
Informationen hierzu finden Sie unter Datenbanktreiber Auf Seite 155.
Fehlermeldungen zu Datenquellen
Im Folgenden sind einige Fehlermeldungen aufgeführt, die den Arbeitsmappenautoren und
weiteren Benutzern beim Arbeiten mit Datenquellen und Ansichten möglicherweise angezeigt
werden:
Berechtigung für den Zugriff auf diese Tableau Server-Datenquelle verweigert: Für
eine Verbindung mit einer Datenquelle ist die Berechtigung "Verbinden" erforderlich. Weitere
Informationen hierzu finden Sie unter Arbeiten mit Berechtigungen Auf Seite 89 und
Festlegen von Berechtigungen für eine Datenquelle Auf Seite 93 .
Die Datenquelle wurde nicht gefunden: Wird beim Arbeiten mit einer Ansicht diese
Fehlermeldung angezeigt, wurde die Datenquelle möglicherweise von Tableau Server
entfernt oder die Seite "Verbindung zu Daten herstellen" muss aktualisiert werden. Klicken Sie
zum Aktualisieren der Seite "Verbindung zu Daten herstellen" in Tableau Desktop auf das
Symbol "Aktualisieren":
- 471 -
Keine Verbindung zu dieser Tableau Server-Datenquelle: Diese Fehlermeldung wird
möglicherweise angezeigt, wenn die Verbindungsinformationen für die Datenquelle geändert
wurden. Dies kann beispielsweise der Fall sein, wenn der Name des Datenbankservers
geändert wurde. Überprüfen Sie die Informationen für die Datenquelle unter
"Datenverbindung", und stellen Sie sicher, dass die Einstellungen korrekt sind.
Fehler beim Auflisten der Tableau Server-Datenquellen: Diese Fehlermeldung wird
möglicherweise angezeigt, wenn er Benutzer versucht, auf die Tableau Server-Datenquellen
zuzugreifen, während Verbindungsprobleme zwischen Tableau Server und Tableau Desktop
vorliegen.
Verbindung zur Cubedatenquelle nicht möglich: Zur Verwendung einer veröffentlichten
mehrdimensionalen (Cube-)Datenquelle müssen Sie die Datenquelle herunterladen und in
Tableau Desktop verwenden. Stellen Sie sicher, dass Sie über die Berechtigung
Herunterladen/Im Web speichern unter für die Datenquelle verfügen. Weitere
Informationen zu Cubes in Tableau finden Sie unter Mehrdimensionale (Cube-)
Datenquellen Auf Seite 252.
Behandeln von Abonnementproblemen
"Die Momentaufnahme der Ansicht in dieser E-Mail konnte nicht richtig gerendert werden.
Wenn Sie diese Fehlermeldung bei einem Abonnement erhalten, kann dies mehrere Gründe
haben:
l
l
l
Fehlende Anmeldeinformationen: Einige Ansichten werden mit eingebetteten
Anmeldeinformationen veröffentlicht. Sie erhalten die oben genannte Fehlermeldung,
wenn die eingebetteten Anmeldeinformationen veraltet sind oder die Ansicht ohne
eingebettete Anmeldeinformationen erneut veröffentlicht wurde.
Datenbank vorübergehend nicht verfügbar: Wenn die Ansicht eine Verbindung zu
einer Livedatenbank aufweist, und die Datenbank beim Generieren des Abonnements
vorübergehend nicht verfügbar war, wird unter Umständen die oben genannte
Fehlermeldung angezeigt.
Zeitüberschreitung bei Hintergrundprozess: Der Hintergrundprozess, der
Abonnements verarbeitet, läuft nach 30 Minuten ab. In der Regel ist diese Zeit
ausreichend. Wenn jedoch ein extrem großes und komplexes Dashboard vom
- 472 -
Hintergrundprozess verarbeitet wird, reicht diese Zeit möglicherweise nicht aus. In der
Admin-Ansicht Hintergrundaufgaben Auf Seite 269 können Sie nachsehen, ob dies
der Fall ist. Mit der tabadmin-Option subscriptions.timeout können Sie den
Schwellenwert für die Zeitüberschreitung erhöhen.
Abonnieren nicht möglich
Wenn Sie eine Ansicht auf Tableau Server anzeigen können und ein Abonnementsymbol (
in der oberen rechten Ecke angezeigt wird, können Sie die Ansicht abonnieren.
)
Damit Sie eine Ansicht abonnieren können, müssen zwei Voraussetzungen erfüllt sein:
Tableau Server muss richtig konfiguriert werden (siehe Verwalten von Abonnements Auf
Seite 215), und die abonnierte Ansicht muss entweder über eingebettete
Anmeldeinformationen für ihre Datenquelle verfügen, oder es dürfen keine
Anmeldeinformationen dafür erforderlich sein. Beispiele für den letzteren Typ: Arbeitsmappen,
die eine Verbindung mit einem Extrakt herstellen, der nicht aktualisiert wird, oder
Arbeitsmappen, deren Daten sich in einer Datei befinden, die zum Zeitpunkt der
Veröffentlichung zur Arbeitsmappe gehörte.Das Einbetten von Anmeldeinformationen
geschieht in Tableau Desktop (siehe die Hilfe zu Tableau Desktop).
Kein Abonnementsymbol
Es ist möglich, dass Sie eine Ansicht auf Tableau Server anzeigen lassen, aber nicht
abonnieren können.Dies ist der Fall bei Ansichten mit Livedatenbankverbindungen, bei denen
Sie zur Eingabe Ihrer Anmeldeinformationen aufgefordert werden, wenn Sie das erste Mal auf
die Ansicht klicken.Ein Abonnement enthält eine Ansicht (oder Arbeitsmappe), Daten und
einen Zeitplan.Um das Datensegment zu liefern, benötigt Tableau Server entweder
eingebettete Datenbank-Anmeldeinformationen oder Daten, für die keine
Anmeldeinformationen erforderlich sind.Bei Livedatenbankverbindungen verfügen nur die
einzelnen Benutzer über die Anmeldeinformationen, nicht aber Tableau Server.Daher können
Sie nur Ansichten abonnieren, für die entweder keine Anmeldeinformationen erforderlich sind
oder in die sie eingebettet sind.
Es ist auch möglich, dass Sie eine Ansicht anzeigen lassen, aber nicht abonnieren können
(kein Abonnementsymbol), wenn Tableau Server für vertrauenswürdige Authentifizierung
konfiguriert ist.Weitere Informationen hierzu finden Sie unter Abonnementanforderungen.
Eingehende Daten ungültig oder "unterbrochen" Abonnements
Wenn Sie Abonnements nicht nur in Ihrer aktuell verwendeten Instanz sondern auch in Testoder Entwicklungsinstanzen von Tableau Server konfiguriert haben, deaktivieren Sie die
Abonnements in Ihren nicht zu Produktionszwecken dienenden Instanzen. Wenn die
Abonnements auf allen Instanzen aktiviert bleiben, erhalten Benutzer anscheinend gültige
Abonnements, die nicht funktionieren, oder Abonnements, obwohl sie die Ansicht oder
Arbeitsmappe nicht abonniert haben.
- 473 -
Abonnements werden nicht empfangen ("Fehler beim Senden der E-Mail.Der Befehl an
den SMTP-Host kann nicht gesendet werden.")
Der obige Fehler wird möglicherweise in der Windows Ereignisanzeige angezeigt, wenn
Abonnements scheinbar gesendet werden (laut der Admin-Ansicht für
Hintergrundaufgaben Auf Seite 269), jedoch nicht ankommen und der SMTP-Server
verschlüsselte Sitzungen (SSL) verwendet. Abonnements werden nur bei unverschlüsselten
SMTP-Verbindungen unterstützt. Zur Lösung des Problems sollte ein unverschlüsselter
SMTP-Server verwendet werden.
Benutzerdefinierte Skripts können nach einem Upgrade auf 8.1 nicht mehr ausgeführt
werden
Ab Version 8.1 wird die Sitzungsverwaltung besser unterstützt, indem ein Rautenzeichen (#)
am Ende der Ansichts-URLs eingefügt wurde. Wenn Sie über benutzerdefinierte
Abonnement-Skripts verfügen, die die Ansichten als PDFs oder PNGs generieren, müssen
Sie Ihre Skripte möglicherweise aktualisieren, damit das Rautenzeichen unterstützt wird.
Bis Version 8.1 sahen Ansichts-URLs folgendermaßen aus:
http://tableauserver/views/SuperStore/sheet1, und Sie konnten eine Ansicht
als PNG-Datei generieren, indem Sie .png an das Ende der URL angehängt haben,
beispielsweise http://tableauserver/views/SuperStore/sheet1.png. Ab
Version 8.1 sehen Ansichts-URLs folgendermaßen aus:
http://tableauserver/views/SuperStore/sheet1#1. Um eine PNG-Datei zu
genieren, müssen Sie .png vor dem Rautenzeichen einfügen. Beispiel:
http://tableauserver/views/SuperStore/sheet1.png#1
Problembehebung für SAML
Die folgenden Themen enthalten Informationen zur Behebung von Problemen mit SAML.
SAML und "Automatische Anmeldung aktivieren"
Wenn Sie SAML verwenden und Tableau Server außerdem zur Verwendung von Active
Directory konfiguriert ist, dürfen Sie Automatische Anmeldung aktivieren nicht gleichzeitig
verwenden. Automatische Anmeldung aktivieren und SAML können nicht parallel
verwendet werden.
Anmelden über die Befehlszeile
Auch wenn Tableau Server für die Verwendung von SAML konfiguriert wurde, wird SAML
nicht zur Anmeldung bei Tableau Server über die Befehlszeilen-Tools tabcmd Auf Seite 395
oder das Befehlszeilenprogramm Tableau-Datenextraktion (im Lieferumfang von Tableau
Desktop) verwendet.
Fehler bei Anmeldung
Wenn die Meldung "Fehler bei Anmeldung: Authentifizierung durch Identitätsprovider
erfolgreich für Benutzer <Benutzername von Identitätsprovider>. Benutzer in Tableau Server
- 474 -
nicht gefunden" ausgegeben wird, sind die in Tableau Server und beim Identitätsprovider
gespeicherten Benutzernamen nicht identisch. Stellen Sie zur Fehlerbehebung sicher, dass
die Namen übereinstimmen. Wenn beispielsweise der Benutzername von Jane Smith beim
Identitätsprovider als jsmith gespeichert ist, muss er in Tableau Server ebenfalls als
jsmith gespeichert sein.
SAML-Fehlerprotokoll
Die SAML-Authentifizierung erfolgt außerhalb von Tableau Server, sodass die Behandlung
von Authentifizierungsproblemen kompliziert sein kann. Anmeldeversuche werden jedoch von
Tableau Server protokolliert. Sie können einen Schnappschuss der Protokolldateien erstellen
und ihn für die Behandlung von Problemen verwenden. Weitere Information dazu finden Sie
unter Archivieren von Protokolldateien Auf Seite 456.
Hinweis: Normale SAML-Ereignisse werden nur dann protokolliert, wenn
wgserver.log.level auf das Debuggen festgelegt ist. Weitere Informationen
finden Sie unter Ändern von Protokollstufen Auf Seite 466.
Suchen Sie im entpackten Schnappschuss der Protokolldatei in den folgenden Dateien nach
SAML-Fehlern.
\wgserver\wgserver-<n>.log
\wgserver\production.<nnnn>_<yyyy_mm_dd_hh_mm_ss>.log
Nachgestellter Schrägstrich
Bestätigen Sie auf der Registerkarte "SAML", dass die Tableau Server-Rückgabe-URL
nicht mit einem nachgestellten Schrägtstrich endet (richtig: http://tableau_server; falsch:
http://tableau_server/):
- 475 -
Konnektivität bestätigen
Bestätigen Sie, das der von Ihnen konfigurierte Tableau Server eine Routing-fähige IPAdresse oder ein NAT-Verfahren an der Firewall hat, das den bidirektionalen Datenverkehr
zum Server zulässt.
Sie können Ihre Konnektivität testen, indem Sie telnet in Tableau Server ausführen und
versuchen, eine Verbindung mit dem SAML-IdP herzustellen. Beispiel: C:\telnet
12.360.325.10 80
Der oben geannte Test sollte Sie mit dem HTTP-Port (80) auf dem IdP verbinden, und Sie
sollten eine HTTP-Kopfzeile erhalten.
Handhaben von Warnungen zu Extraktaktualisierungen
Wenn geplante Extraktaktualisierungen nicht erfolgreich sind, zeigt Tableau oben rechts das
Menü "Warnungen" an:
Dieses Menü wird nur angezeigt, wenn eine Extraktaktualisierung fehlgeschlagen ist und Sie
folgende Funktion haben:
l
Systemadministrator oder Site-Administrator
l
Autor einer Arbeitsmappe oder Datenquelle, die nicht aktualisiert werden konnte
l
Autor einer Arbeitsmappe, die mit einer nicht aktualisierbaren Datenquelle verbunden ist
- 476 -
Wenn Sie das Menü "Warnungen" öffnen, können Sie weitere Informationen zu
Aktualisierungsfehlern anzeigen:
Wenn eine Datenquelle als Eingebettet aufgelistet ist, ist die Datenquellendefinition (mit
Anmeldeinformationen für die Datenquelle, Datenbankname usw.) eingebettet oder befindet
sich in der Arbeitsmappe selbst, die ursprünglich in Tableau Desktop erstellt wurde.
Wenn ein Datenquellen- oder Arbeitsmappenname als Datenquelle aufgelistet ist (z. B.
Datenquelle: sales_data), handelt es sich bei der Datenquelle um eine Tableau ServerDatenquelle. Die Datenquellendefinition befindet sich in Tableau Server.
Im Datenfenster können Sie Arbeitsmappen oder Datenquellen erkennen, die ursprünglich in
Tableau Desktop erstellt wurden. Anstelle eines Datenbanksymbols ist neben dem Namen der
Datenquelle ein Tableau-Symbol zu sehen:
- 477 -
Lösen von Problemen bei der Extraktaktualisierung
Sie können manche Extraktaktualisierungsprobleme beheben, indem Sie in der Warnmeldung
auf den Link Verbindungsinformationen bearbeiten klicken, die fehlenden Informationen
eingeben und dann auf Speichern klicken:
Wenn das Problem durch das Bearbeiten der Datenverbindung nicht korrigiert werden kann,
müssen Sie es in Tableau Desktop lösen und die Arbeitsmappe dann erneut veröffentlichen.
Tipp: Administratoren können auf der Seite Datenverbindungen, die über die Registerkarte
Admin aufgerufen wird, jederzeit Datenverbindungen bearbeiten.
- 478 -
JavaScript API
Mit der JavaScript-API von Tableau können Sie Tableau-Visualisierungen in Ihre eigenen
Webanwendungen integrieren. Die API ermöglicht Ihnen die genaue Kontrolle der
Interaktionen Ihrer Benutzer und das Kombinieren von Funktionen, die anderenfalls nicht
kombiniert werden könnten. Sie können beispielsweise ein einzelnes Steuerelement so
codieren, dass eine Gruppe von Markierungen gefiltert wird, einige dieser Markierungen
ausgewählt und deren Daten zum Herunterladen präsentiert werden. Weitere Informationen
hierzu finden Sie unter den folgenden Themen:
l
Anforderungen
l
Concepts
l
Lernprogramm
l
API-Referenz
Anforderungen
Die Anforderungen für die Tableau JavaScript API lauten wie folgt:
Zugriff auf einen Tableau-Server: Für die Programmierung mit dem Tableau JavaScript
API benötigen Sie Zugriff auf Tableau Online oder Tableau Public sowie eine veröffentlichte
Arbeitsmappe auf diesem Server. Ihre Webanwendung sollte sich nicht auf demselben
Computer wie der Server befinden, aber sie muss auf den Server zugreifen
können.Informationen zur API und zum Zugriff darauf finden Sie unter Concepts oben.
Einen unterstützten Browser: Ihre Endbenutzer können die von Ihnen erstellte
Webanwendung über die meisten unterstützten Webbrowser aufrufen. Dazu gehören
insbesondere Chrome, Firefox, Safari 3.2.1 und höher sowie Internet Explorer 8.0 und höher.
Wenn Sie mit Internet Explorer 8.0 arbeiten, muss der Kompatibilitätsmodus deaktiviert
werden. Zudem muss Ihr Browser so konfiguriert sein, dass die Verwendung der Methode
"window.postMessage" im JavaScript-Code möglich ist. Diese Funktion wird von einigen
Sicherheitspaketen deaktiviert.
Concepts
Dieses Thema ist für Benutzer bestimmt, die mit JavaScript und objektorientierten
Programmierkonzepten vertraut sind. Sie sollten auch bereits Erfahrungen mit TableauVisualisierungen aus der Sicht eines Benutzers gesammelt haben. Wenn Sie bisher nur
wenige Erfahrungen gesammelt haben, sollten Sie mit dem Lernprogramm beginnen.
Programmieransatz
Die JavaScript-API von Tableau beruht auf einem Objektmodell. Der Einstiegspunkt für dieses
Objektmodell ist die Instanziierung eines neuen Viz-Objekts. Gehen Sie dabei
folgendermaßen vor:
var viz = new tableauSoftware.Viz(/* params omitted */);
- 479 -
Bei nahezu jedem Tableau-Objekt ist es möglich, zum übergeordneten Viz-Objekt mithilfe von
"parent" zu den Eigenschaften des Objekts zurückzukehren.
Zugriff auf die API
Bei der API geht es darum, die in Tableau Server vor Ort oder auf einem gehosteten Tableau
Server veröffentlichten, integrierten Ansichten programmatisch zu steuern. Dazu benötigen
Sie Zugriff zu einem Server, auf dem Version 8.0 oder höher ausgeführt wird. Auf dem Server
muss sich außerdem eine veröffentlichte Arbeitsmappe befinden.
Die API wird mit der Datei tableau_v8.js (minimiert) oder tableau_v8.debug.js bereitgestellt.
Auf Webseiten, die Ihren JavScript-Code zur Wiedergabe von Tableau-Ansichten enthalten,
können Sie mit folgender Adresse auf die API-Dateien verweisen:
http://<your_server_name>/javascripts/api/
So können Sie beispielsweise mit dem Servernamen localhost folgenden Code in die SeitenKopfzeile einfügen:
<script type="text/javascript"
src="http://localhost/javascripts/api/tableau_
v8.js"></script>
Diese Dateien befinden sich im Dateisystem unter Program
Files\Tableau\Tableau Server\8.3\wgserver\public\javascripts\api.
Arbeiten mit gehosteten Tableau-Servern
Wenn Sie in Tableau Online oder Tableau Public veröffentlichen, haben Sie Zugriff auf die API
zum verwendeten Serverprodukt.
l
Verwenden Sie für Tableau Online den folgenden Speicherort:
https://online.tableausoftware.com/javascripts/api/
l
Verwenden Sie für Tableau Public den folgenden Speicherort:
https://public.tableausoftware.com/javascripts/api/
Fügen Sie der URL den Dateinamen für die zu verwendene API (tableau_v8.js oder
tableau_v8.debug.js) wie zuvor im Beispielcode im Abschnitt Zugriff auf die API unten
gezeigt hinzu.
Wichtig: Um eine bestmögliche Codestabilität zu erzielen, verwenden Sie den APISpeicherort für das Serverprodukt, mit dem Sie arbeiten. Wenn Sie beispielsweise
Arbeitsmappen für einen Tableau Server vor Ort veröffentlichen, verwenden Sie die
lokal auf Ihrem Server vorhandene JavaScript API.
- 480 -
Bootstrapping
Für die API gibt es nur einen einzigen Einstiegspunkt: das Instanziieren eines neuen VizObjekts, mit dem der zum Einbinden einer Tableau-Visualisierung erforderliche HTML-Code
erstellt wird. Zum Einrichten einer Instanz eines neuen Viz-Objekts können Sie einfach den
Viz-Konstruktor mithilfe von new aufrufen und dann das erforderliche parentElement
sowie URL-Parameter und einen optionalen Satz von Optionen übergeben. Im URLParameter geben Sie den Namen des Tableau Servers an:
var placeholderDiv = document.getElementById("tableauViz");
var url = "http://tabserver/views/workbookname/viewname";
var options = {
hideTabs: true,
width: "800px",
height: "700px"
};
var viz = new tableauSoftware.Viz(placeholderDiv, url, options);
Vertrauenswürdige Authentifizierung
Wenn in Tableau Server eine vertrauenswürdige Authentifizierung verwendet wird, geben Sie
das Ticket in der URL an, indem Sie zuerst trusted nach dem Namen des Servers
hinzufügen, bevor Sie das Ticket angeben. Beispiel:
var placeholderDiv = document.getElementById("tableauViz");
var url = "http://tabserver/trusted/Etdpsm_Ew6rJY-9kRrALjauU/views/workbookname/viewname";
var options = {
hideTabs: true,
width: "800px",
height: "700px"
};
var viz = new tableauSoftware.Viz(placeholderDiv, url, options);
Getter und Setter für Eigenschaften
Getter- und Setter-Funktionen beginnen immer mit get oder set. Sie können ohne große
Leistungseinbußen mehrfach aufgerufen werden (sie sollten also lediglich
zwischengespeicherte Felder zurückgeben oder nur sehr einfache Berechnungen abwickeln).
Eigenschaften sind immer synchron und geben den Wert sofort zurück (anstatt eine
Rückruffunktion zu verwenden).
Aufrufverhalten - Asynchron
Aufrufe sind standardmäßig asynchron, da in vielen Fällen Roundtrip-Aktionen notwendig
sind. Für die Methoden gelten die folgenden Namenskonventionen:
- 481 -
l
l
Asynchrone Aufrufe sind an dem Suffix Async am Ende des Methodennamens zu
erkennen, z. B. Worksheet.applyFilterAsync().
Asynchrone Aufrufe geben ein Promise-Objekt zurück, sodass eine Verkettung
möglich ist.
Die JavaScript-API von Tableau beruht auf dem CommonJS Promises/A-Standard. Der
Implementierung von Tableau liegt die Ausgangsüberlegung zugrunde, dass asynchrone
Methoden ein Objekt mit einer then-Methode der folgenden Art zurückgeben:
then(fulfilledHandler, errorHandler)
Der fulfilledHandler wird aufgerufen, wenn die Promise-Zusagen erfüllt sind (bei
Erfolg). Der errorHandler wird aufgerufen, wenn ein Promise fehlschlägt. Alle Argumente
sind optional und nichtfunktionale Werte werden ignoriert.
Verketten von Promises
Das "zugesagte" Ergebnis der asynchronen Methode wird als Parameter an die nächste then
()-Methode übergeben. Beispiel:
var activeSheet;
viz.getWorkbook().activateSheetAsync("Sheet 1")
.then(selectLemon).then(filterToLemonAndMint);
function selectLemon(sheet) {
activeSheet = sheet;
return sheet.selectMarksAsync("Product", "Lemon", "replace");
}
function filterToLemonAndMint() {
return activeSheet.applyFilterAsync("Product", ["Lemon",
"Mint"], "replace");
}
Das Ergebnis von activateSheetAsync() ist eine "Zusage" (Promise), dass das
aktivierte Blattobjekt schließlich zurückgegeben wird, woraufhin es als erster Parameter an die
selectLemon()-Methode weitergegeben wird. Beachten Sie, dass die selectLemon()Methode ein Promise-Objekt (den zurückgegebenen Wert der selectMarksAsync()Methode) und nicht das Ergebnis nach Auswahl der Markierungen zurückgibt. Da es sich
jedoch um ein Promise-Objekt handelt, wird die nächste then()-Methode nicht aufgerufen,
bis die Zusage erfüllt ist.
Wenn der Kette ein Glied hinzugefügt wird, nachdem die Zusage erfüllt wurde, wird die
Rückruffunktion sofort mit dem zuvor zurückgegebenen Wert aufgerufen. Für Programmierer
bedeutet dies, dass nicht ermittelt werden muss, ob die Antwort vom Server bereits
eingegangen ist. Die asynchronen Methoden werden immer aufgerufen, und zwar egal, ob
jetzt oder später.
- 482 -
var promise = viz.getWorkbook().activateSheetAsync("Sheet 1");
// Pretend that activatSheeteAsync() has already returned from
the server.
promise.then(callback);
// callback will be called immediately using the Sheet object
// returned from activateSheetAsync()
Zurückgegebene Werte der Then()-Methoden
Der Wert, der für die then()-Methode zurückgegeben wird, wir als erster Parameter an die
nächste then()-Methode übergeben. Es kann sich um einen skalaren Wert (Number,
Boolean, String usw.), ein Objekt oder ein weiteres Promise handeln. Die Infrastruktur
schließt automatisch Nicht-Promise-Werte in einen Promise-Wert ein, sodass sie verkettet
werden können.
viz.getWorkbook().activateSheetAsync("Sheet 1")
.then(function (sheet) {
return "First link";
})
.then(function (message) {
if (message === "First link") { alert("Expected"); }
// no return value here means nothing is passed to the next
link
})
.then(function () {
});
Ausbrechen aus einer Kette
Streng genommen gibt es keine Möglichkeit, aus einer Kette auszubrechen, da dadurch die
Garantie hinfällig wird, dass die nachfolgenden Kettenglieder aufgerufen werden. Wenn in
einem Teil der Kette eine Ausnahme ausgelöst wird, wird der Rest der Kette ausgeführt, aber
es wird der errorHandler anstatt des fulfilledHandler aufgerufen.
Wenn ein Kettenglied von den Ergebnissen früherer Glieder abhängig ist, sollten Sie eine ifAnweisung festlegen, um die Bedingung zu überprüfen. Hier ist ein Beispiel:
viz.getWorkbook().activateSheetAsync("Sheet 1")
.then(function (sheet) {
// I’m returning a Promise
- 483 -
return sheet.selectMarksAsync("Product", "NoProduct",
"replace");
})
.then(function () {
return viz.getWorkbook().getActiveSheet().getSelectedMarksAsync
();
})
.then(function (marks) {
// The getSelectedMarksAsync call succeeded, but no marks were
selected
// because there are not any marks corresponding to "NoProduct".
if (marks.length === 0) { throw new Error("No marks selected");
}
var firstMarkValue = marks[0].getPairs().get("Product").value;
return sheet.applyFilterAsync("Product", firstMarkValue,
"replace");
})
.then(function (filterName) {
// applyFilterAsync succeeded
}, function(err) {
if (err.message === "No marks selected") {
alert("This was caused by the first link above");
}
})
.otherwise(function (err) {
alert("We handled the error above, so it’s not propagated to
this handler.");
});
Wenn kein Rückruf bereitgestellt wird (bzw. wenn der Rückruf null bzw. nicht definiert ist),
werden die Ergebnisse an das nächste Kettenobjekt übergeben:
viz.getWorkbook().activateSheetAsync("Sheet 1")
.then()
.then(function (sheet) {
// this is called
});
- 484 -
Auf diese Weise können Sie eine einzige otherwise-Funktion festlegen, die alle Fehler in
der Kette verarbeitet. Die Funktion always hat denselben Effekt, aber sie wird unabhängig
davon aufgerufen, ob der Vorgang erfolgreich war oder ein Fehler aufgetreten ist. Die
Funktionen then/otherwise/always haben Ähnlichkeit mit einem
try/catch/finally-Block.
viz.getWorkbook().activateSheetAsync("Sheet 1")
.then(function () {
return sheet.selectMarksAsync(...);
})
.then(function (marks) {
// Do something with the marks.
})
.otherwise(function (err) {
// I’m handling all errors in one place.
console.log(err.message);
})
.always(function () {
// Do some cleanup or logging
});
Collections
Viele Klassen enthalten Collections (Auflistungen) von Elementen, wobei jedes Element über
einen Schlüssel verfügt (in der Regel eine ID oder ein Name). Eine Collection kann z. B. eine
Auflistung von Blättern mit Namen als Schlüssel oder die Liste der Parameter auf einem mit
Namensschlüssel versehenen Blatt sein. Collections sind öffentlich unveränderlich und
schreibgeschützt. Jedes Collection-Array ist aufgrund der Identifikatoren seiner Elemente
aufgeschlüsselt. Das Ergebnis von Workbook.getPublishedSheetsInfo() ist
beispielsweise ein Array, bei dem der Index mit der Position des Blattes in der Arbeitsmappe
korrespondiert. Es wird außerdem nach dem Blattnamen aufgeschlüsselt, sodass der Zugriff
darauf folgendermaßen möglich ist:
var sheet = workbook.getPublishedSheetsInfo()[0];
var sameSheet = workbook.getPublishedSheetsInfo().get("Sheet 1");
Collection-Schnittstelle
Name
get
(key :
string)
has
(key :
string)
Rückgabetyp Beschreibung
CollectionRuft das Element in der Auflistung ab, das mit dem
Elementtyp
Schlüssel assoziiert ist, oder nicht definiert, wenn nichts
damit assoziiert ist.
Bool
Gibt "true" zurück, wenn in der Collection ein Element
vorhanden ist, das mit dem Schlüssel assoziiert ist;
anderenfalls "false".
- 485 -
Ereignisse
Die Viz-Klasse wirkt als der zentrale Ereignis-Hub. Alle Ereignisse werden also an einer
Stelle zusammengefasst. Dies bedeutet außerdem, dass Ereignisse auch für ein Objekt
ausgelöst werden können, das noch nicht erstellt wurde. So kann beispielsweise das
marksselection-Ereignis für ein bestimmtes Blatt ausgelöst werden, obwohl das SheetObjekt noch nicht erstellt wurde. Jedes Ereignis enthält ein anonymes Objekt mit Informationen
zum Ereignis, wie z. B. das Blatt, auf dem das Ereignis aufgetreten ist.
Das Überwachen eines Ereignisses wird durch Aufrufen von Viz.addEventListener
(type, callback) und Übergeben eines Funktionsrückrufs durchgeführt. Hier ist ein
Beispiel für das Überwachen eines Ereignisses:
viz.addEventListener("marksSelection", function (marks) {
changeMySelectionUI(marks);
});
Ein Listener wird durch Aufrufen von Viz.removeEventListener(type, listener)
und Übergeben derselben Rückruffunktion entfernt, die an Viz.addEventListener()
übergeben wurde. Beispiel:
function changeMySelectionUI(marks) {
viz.removeEventListener("marksSelection", changeMySelectionUI);
}
viz.addEventListener("marksSelection", changeMySelectionUI);
Ereignisse sind Multicastdelegate, d. h., es werden mehrere Listener unterstützt. Die
Reihenfolge, in der Benachrichtigungen aufgerufen werden, ist nicht festgelegt. Jeder
Ereignisrückruf erfasst ein einzelnes Objekt mit einem Zeiger für die Viz , die das Ereignis
ausgelöst hat. Jedes Ereignis fügt zusätzliche Felder zum Ereignis hinzu, entsprechend den
Angaben in der API-Referenz Auf Seite 502.
Filtern
Beim Programmieren des Filterns imitieren Sie den Vorgang, der beim Klicken auf einen Filter
in einer Ansicht ausgelöst wird, um die angezeigten Daten einzugrenzen. Hier ist ein Beispiel
für das Filtern für einen einzelnen Wert:
worksheet.applyFilterAsync("Container", "Jumbo Box",
tableauSoftware.FilterUpdateType.REPLACE);
Es besteht ein Unterschied zwischen dem Abfragen des vorhandenen Filterstatus und dem
Einstellen von neuen oder vorhandenen Filtern. Das Abfragen von Filtern erfolgt mittels
Worksheet.getFiltersAsync(), wodurch eine Auflistung der Filter-Klassen
zurückgegeben wird. Das Einstellen von Filtern erfolgt mittels
Worksheet.applyFilterAsync (und seiner Varianten) und ist ein Funktionsaufruf, der
nicht das Instanziieren einer Filter-Klasse erfordert.
- 486 -
Wenn Sie Felder in einem Filter angeben, sollten Sie dieselbe Überschrift wie in der
Benutzeroberfläche und nicht den Datenbankfeldnamen verwenden. So sollte beispielsweise
Container (die Überschrift) anstelle von Product Container (der eigentliche Feldname)
verwendet werden. In manchen Fällen benennt Tableau Desktop Felder um, nachdem sie auf
einen Container gezogen wurden. So kann beispielsweise das Feld Date zu YEAR(Date)
umbenannt werden, wenn es auf den Zeilencontainer gezogen wird. In diesem Fall sollten Sie
YEAR(Date) als Parameter verwenden. Hierarchische Filter sind eine Ausnahme, da sie den
vollständigen hierarchischen Namen verwenden (z. B. [Product].[All Product].
[Espresso]). Überschriften können die optionalen Trennzeichen [] um Namen enthalten.
Es folgen Beispiele für viele Arten von Filtern:
var worksheet;
viz.getWorkbook().activateSheetAsync("Sheet 4").then(function
(sheet) {
worksheet = sheet;
})
// Single value
.then(function () {
return worksheet.applyFilterAsync("Product Type", "Coffee",
tableauSoftware.FilterUpdateType.REPLACE);
})
// Multiple values
.then(function () {
return worksheet.applyFilterAsync(
"Product Type", ["Coffee", "Tea"],
tableauSoftware.FilterUpdateType.REPLACE);
})
// Multiple Values - adding and removing
.then(function () {
return worksheet.applyFilterAsync("Product", ["Lemon", "Mint"],
tableauSoftware.FilterUpdateType.ADD);
})
.then(function () {
return worksheet.applyFilterAsync("Product", ["Caffe Latte",
"Green Tea"],
tableauSoftware.FilterUpdateType.REMOVE);
})
// All values
.then(function () {
return worksheet.applyFilterAsync("Product Type", "",
- 487 -
tableauSoftware.FilterUpdateType.ALL);
})
// Date Range
.then(function () {
return; worksheet.applyRangeFilterAsync("Date", {
min: new Date(Date.UTC(2010, 3, 1)),
max: new Date(Date.UTC(2010, 12, 31))
});
})
// Clearing a Filter
.then(function () {
return worksheet.clearFilterAsync("Date");
})
// Relative Date
.then(function () {
return worksheet.applyRelativeDateFilterAsync("Date", {
anchorDate: new Date(Date.UTC(2011, 5, 1)),
periodType: tableauSoftware.PeriodType.YEAR,
rangeType: tableauSoftware.DateRangeType.LASTN,
rangeN: 1
});
})
// Quantitative Filters
// SUM(Sales) > 2000 and SUM(Sales) < 4000
.then(function () {
return worksheet.applyRangeFilterAsync("SUM(Sales)", {
min: 2000,
max: 4000
});
})
// SUM(Sales) > 1000
.then(function () {
return worksheet.applyRangeFilterAsync("SUM(Sales)", {
min: 1000
});
})
// Hierarchical Filters - selecting all on a level
- 488 -
.then(function () {
return worksheet.applyHierarchicalFilterAsync("[Product].[Product Categories]", {
levels: [0, 1]
}, tableauSoftware.FilterUpdateType.ADD);
}, function (err) { /* ignore errors */ })
// Hierarchical Filters - adding one item
.then(function () {
return worksheet.applyHierarchicalFilterAsync(
"[Product].[Product Categories].[Product Name]",
"Accessories.Bike Racks.Hitch Rack - 4-Bike",
tableauSoftware.FilterUpdateType.REPLACE);
}, function (err) { /* ignore errors */ })
// Hierarchical Filters - adding multiple items
.then(function () {
return worksheet.applyHierarchicalFilterAsync(
"[Product].[Product Categories].[Product Name]",
[
"Accessories.Bike Racks.Hitch Rack - 4-Bike",
"Accessories.Bike Stands.All-Purpose Bike Stand"
],
tableauSoftware.FilterUpdateType.REPLACE);
}, function (err) { /* ignore errors */ })
.otherwise(function (err) {
console.log(err);
});
Auswählen von Markierungen
Das Auswählen von Markierungen ist nahezu identisch mit dem Filtern. Zum Filtern
verwenden Sie eine der Worksheet.applyFilterAsync()-Methoden. Zum Auswählen
von Markierungen verwenden Sie Worksheet.selectMarksAsync(). Die Parameter für
das Auswählen von Markierungen sind nahezu identisch mit den zum Filtern verwendeten
Parametern.
worksheet.selectMarksAsync("Product", "Caffe Latte",
tableauSoftware.SelectionUpdateType.REPLACE);
Es folgen Beispiele für andere Auswahlmöglichkeiten, die Sie verwenden können:
var worksheet;
viz.getWorkbook().activateSheetAsync("Sheet 4").then(function
(sheet) {
- 489 -
worksheet = sheet;
})
// Single dimensions work just like filtering
// Single dimension - single value
.then(function () {
return worksheet.selectMarksAsync("Product", "Mint",
tableauSoftware.SelectionUpdateType.REPLACE);
})
// Single dimension - Multiple values
.then(function () {
return worksheet.selectMarksAsync(
"Product", ["Chamomile", "Mint"],
tableauSoftware.SelectionUpdateType.REPLACE);
})
// Single dimension - Multiple values (delta)
.then(function () {
return worksheet.selectMarksAsync("Product", ["Lemon", "Earl
Grey"],
tableauSoftware.SelectionUpdateType.ADD);
})
.then(function () {
return worksheet.selectMarksAsync(
"Product", ["Chamomile", "Earl Grey"],
tableauSoftware.SelectionUpdateType.REMOVE);
})
// Quantitative selection
.then(function () {
return worksheet.selectMarksAsync({
"State": ["Florida", "Missouri"],
"SUM(Sales)": { min: 3000, max: 4000 }
}, tableauSoftware.SelectionUpdateType.REPLACE);
})
// Hierarchical dimensions
.then(function () {
return worksheet.selectMarksAsync(
"[Product].[Product Categories].[Category]",
"Bikes",
tableauSoftware.SelectionUpdateType.REPLACE);
- 490 -
}, function (err) { /* ignore errors */ })
// Multiple dimensions - multiple values
// ((State = Washington OR Oregon) AND Product = Lemon)
// OR
// (State = Oregon AND Product = Chamomile)
.then(function () {
return worksheet.selectMarksAsync({
"State": ["Washington", "Oregon"],
"Product": "Lemon"
}, tableauSoftware.SelectionUpdateType.REPLACE);
})
.then(function () {
return worksheet.selectMarksAsync({
"State": "Oregon",
"Product": "Chamomile"
}, tableauSoftware.SelectionUpdateType.ADD);
})
// Round-tripping selection
.then(function () {
return worksheet.selectMarksAsync(
"Product",
"Lemon",
tableauSoftware.SelectionUpdateType.REPLACE);
})
.then(function () {
return worksheet.getSelectedMarksAsync();
}).then(function (marks) {
// filter out only the Washington and Oregon marks
var onlyWashingtonAndOregon = [];
for (var i = 0, len = marks.length; i < len; i++) {
var m = marks[i];
var pair = m.getPairs().get("State");
if (pair &&
(pair.value === "Washington" || pair.value === "Oregon")) {
onlyWashingtonAndOregon.push(m);
}
}
return worksheet.selectMarksAsync(
onlyWashingtonAndOregon,
tableauSoftware.SelectionUpdateType.REPLACE);
})
- 491 -
.otherwise(function (err) {
console.log(err);
});
JavaScript API Tutorial
This tutorial is a sample web application, created with Tableau's JavaScript API. It's designed
to help you explore and learn about the API using a series of steps that guide you through the
basics. To get started, click the button below.
Start the tutorial
The view will load here after you click Run this code, below.
Show .js file
l
l
l
l
l
l
l
l
1. Create
2. Filter
3. Tabs
4. Select
5. Chain Calls
6. Sheets
7. Toolbar
8. Events
Create the Viz
As you build your web application, the first step is to create, or instantiate the view. To do this,
you create a new Viz object, passing the required parentElement
(document.getElementByID) and url parameters, along with any options, such as
hideTabs and hideToolbar. Here's the code:
function initializeViz() {
var placeholderDiv = document.getElementById("tableauViz");
var url = "http://public.tableausoftware.com/views/WorldIndicators/GDPpercapita";
var options = {
width: placeholderDiv.offsetWidth,
height: placeholderDiv.offsetHeight,
hideTabs: true,
hideToolbar: true,
onFirstInteractive: function () {
workbook = viz.getWorkbook();
activeSheet = workbook.getActiveSheet();
}
};
- 492 -
viz = new tableauSoftware.Viz(placeholderDiv, url, options);
}
Run this code
You should now see a view with which you can interact, just like you can with views on Tableau
Server. If you don't see a view above, it may need a few more moments to load, or you may
need to use a different web browser.
In the code above, the constructor for the Viz object handles loading the view. Specifying a
function in the onFirstInteractive option allows you to perform actions once the view
has finished loading. In this case, the function caches the workbook and activeSheet
variables so they can be used later on. These two variables were declared as global variables
in the actual script. Typically you'll want to create the view when the page has finished loading
and the browser is ready. If you're using jQuery, this can be done using jQuery's ready handler:
$(initializeViz);
Next
Filter Values
Filtering is a core capability of Tableau Server. In the view above, there are already Region and
Year quick filter controls, but you can use the API to more tightly control what gets filtered. This
is done using the applyFilterAsync method on a Worksheet object, which was cached
in the activeSheet variable in step 1.
The following code filters the "Region" field to show only "The Americas":
function filterSingleValue() {
activeSheet.applyFilterAsync(
"Region",
"The Americas",
tableauSoftware.FilterUpdateType.REPLACE);
}
Run this code
You should now see that the view is filtered and only "The Americas" check box is selected
under the Region quick filter.
The next code sample shows you how to add two more values to the filter, using the same
syntax but instead specifying an array of values instead of a single value. Also note that ADD is
used instead of REPLACE, which instructs the view to add additional criteria to the filter instead
of replacing the values that are currently filtered:
function addValuesToFilter() {
activeSheet.applyFilterAsync(
- 493 -
"Region",
["Europe", "Middle East"],
tableauSoftware.FilterUpdateType.ADD);
}
Run this code
Similarly, you can remove values from the filter by using REMOVE:
function removeValuesFromFilter() {
activeSheet.applyFilterAsync(
"Region",
"Europe",
tableauSoftware.FilterUpdateType.REMOVE);
}
Run this code
You can also include all values in the filter by using ALL.
The filters you've seen so far have all had associated quick filters in the view. However, you can
also create new filters. For example, you can create a filter for the x-axis, the "F: GDP per
capita (curr $)" field, and specify that you only want to see countries where the GDP is greater
than $40K, but less than $60K. To do this, you use the applyRangeFilter method, using a
range of values as the criteria:
function filterRangeOfValues() {
activeSheet.applyRangeFilterAsync(
"F: GDP per capita (curr $)",
{
min: 40000,
max: 60000
},
tableauSoftware.FilterUpdateType.REPLACE);
}
Run this code
Finally, you can clear the filters. For example:
function clearFilters() {
activeSheet.clearFilterAsync("Region");
activeSheet.clearFilterAsync("F: GDP per capita (curr $)");
}
Run this code
BackNext
- 494 -
Switch Tabs
Sometimes a single sheet in a workbook doesn't convey all of the information that you'd like
your user to see. You can use the API to switch from the current sheet to another published
sheet within the same workbook (note that the workbook must have been published to the
server with Show Sheets as Tabs enabled). To switch sheets, you use the
activateSheetAsync method on a Workbook object, which was cached in a global
workbook variable in step 1. Here's how you switch the sheet to a map worksheet named
"GDP per capita map".
function switchToMapTab() {
workbook.activateSheetAsync("GDP per capita map");
}
Run this code
BackNext
Select Values
Filtering a view is useful when you want to focus the user's attention on a specific set of values
by removing all other values not matching the filter criteria. However, sometimes it's useful to
select values instead. This still focuses the user's attention on specific values, but the context of
other values remains in the view. To do this, you use the selectMarksAsync method. The
syntax is very similar to the applyFilterAsync method that you used previously. For
example, the following code selects all of the marks in the "Asia" region:
function selectSingleValue() {
workbook.getActiveSheet().selectMarksAsync(
"Region",
"Asia",
tableauSoftware.SelectionUpdateType.REPLACE);
}
Run this code
The only change between the code above and the filter code you used earlier is that
tableauSoftware.SelectionUpdateType was specified instead of
tableauSoftware.FilterUpdateType. Also, notice that
workbook.getActiveSheet() is used instead of the activeSheet global variable
because the sheets were switched in step 3 and the global variable wasn't updated to point to
the new active sheet.
In the following code sample, Africa and Oceania are added to the previous selection:
function addValuesToSelection() {
workbook.getActiveSheet().selectMarksAsync(
"Region",
- 495 -
["Africa", "Oceania"],
tableauSoftware.SelectionUpdateType.ADD);
}
Run this code
Again, the code should look familiar since the syntax is almost identical to filtering. At this point,
you've selected Asia, Africa, and Oceania. The next code sample will demonstrate how to
remove. In this case, you will remove countries that have a GDP less than $5,000. To do this,
you use a range just like you did for filtering, except you'll only specify a max value:
function removeFromSelection() {
workbook.getActiveSheet().selectMarksAsync(
"AVG(F: GDP per capita (curr $))",
{
max: 5000
},
tableauSoftware.SelectionUpdateType.REMOVE);
}
Run this code
Clearing the selection is just as easy as clearing a filter, using the
clearSelectedMarksAsync method:
function clearSelection() {
workbook.getActiveSheet().clearSelectedMarksAsync();
}
Run this code
BackNext
Chain Method Calls
You may have noticed a naming pattern with the methods used thus far. They all end with the
Async suffix, which stands for asynchronous. Programming on the web involves
communicating with servers, which usually take time to compute and return a value. To avoid
locking up the user's browser while you're waiting for a response from the server, you instruct
the user's browser to notify your code when the server has sent a response to your original
request.
The Tableau JavaScript API uses Promises (specifically the Promises/A specification) to notify
your code when an operation is complete. This allows you to chain method calls using an easy
syntax. Each method that ends with Async returns a Promise object, containing three
methods:
l
then(successCallback, errorCallback) - the successCallback function
is called when the operation is successful, and likewise the errorCallback function is
- 496 -
l
l
called when there is an error. Both parameters are optional.
otherwise(errorCallback) - called when an error occurs
always(callback) - always called, whether the operation was successful or not
The following code sample demonstrates how you can use some of the methods you've
learned thus far to chain a series of commands. First you switch to the "GDP per capita by
region" sheet. After that has finished, you apply a range filter. Once Tableau Server has
applied the filter, you select some marks.
function switchTabsThenFilterThenSelectMarks() {
workbook.activateSheetAsync("GDP per capita by region")
.then(function (newSheet) {
activeSheet = newSheet;
// It's important to return the promise so the next link in
the chain
// won't be called until the filter completes.
return activeSheet.applyRangeFilterAsync(
"Date (year)",
{
min: new Date(Date.UTC(2002, 1, 1)),
max: new Date(Date.UTC(2008, 12, 31))
},
tableauSoftware.FilterUpdateType.REPLACE);
})
.then(function (filterFieldName) {
return activeSheet.selectMarksAsync(
"AGG(GDP per capita (weighted))",
{
min: 20000
},
tableauSoftware.SelectionUpdateType.REPLACE);
});
}
Run this code
There are several important things to point out with the above code:
l
l
Inside of a then function it does a return of another Promise object. This ensures
that the next link in the chain will not get run until the current link finishes.
Notice how the result of an operation is handled. The function inside the first then callback takes a single newSheet parameter, since that's the promised return value from
the activateSheetAsync method. Similarly, the second then function gets a filterFieldName parameter, which is the name of the field for the filter that was just applied. A full explanation of the promised return values for each Async method is in the
JavaScript API Reference.
- 497 -
Before moving on to the next step, let's take a look at how errors are handled inside a chain.
The code below intentionally causes an error to happen by leaving out some required
parameters to the applyFilterAsync method:
function triggerError() {
workbook.activateSheetAsync("GDP per capita by region")
.then(function (newSheet) {
// Do something that will cause an error: leave out required parameters.
return activeSheet.applyFilterAsync("Date (year)");
})
.otherwise(function (err) {
alert("We purposely triggered this error to show how error
handling happens with chained calls.\n\n " + err);
});
}
Run this code
BackNext
Work with Sheets
Workbooks created in Tableau Desktop contain worksheets and, sometimes, one or more
dashboards. The dashboards themselves typically contain one or more worksheets. This is
why, in the API, the concept of "sheet" encompasses both worksheets and dashboards.
Worksheet and dashboard objects do not have the same set of actions, however. Worksheets
are the only entry point for acting on both worksheet and dashboard objects. You can't act
directly on a dashboard object.
The code samples below illustrate how this works. The first code sample demonstrates how
you would query all of a workbook's sheets. After you click Run this code the dialog that
appears lists workbook's sheets:
function querySheets() {
var sheets = workbook.getPublishedSheetsInfo();
var text = getSheetsAlertText(sheets);
text = "Sheets in the workbook:\n" + text;
alert(text);
}
Run this code
Here's how you would query worksheets in a dashboard. Notice that the filter is still applied to
the "GDP per region" worksheet in the dashboard, but the marks are not selected:
function queryDashboard() {
workbook.activateSheetAsync("GDP per Capita Dashboard")
- 498 -
.then(function (dashboard) {
var worksheets = dashboard.getWorksheets();
var text = getSheetsAlertText(worksheets);
text = "Worksheets in the dashboard:\n" + text;
alert(text);
});
}
Run this code
You'll notice that there are scrollbars on the viz. This is because the fixed size specified in the
Viz constructor (step 1) is different than the fixed size specified for this dashboard by the
workbook author. To see the entire dashboard, you can change the size behavior to
AUTOMATIC, which tells the viz to fit the available space. This removes the scrollbars at the
expense of making each Worksheet in the dashboard slightly smaller.
function changeDashboardSize() {
workbook.activateSheetAsync("GDP per Capita Dashboard")
.then(function (dashboard) {
dashboard.changeSizeAsync({
behavior: tableauSoftware.SheetSizeBehavior.AUTOMATIC
});
});
}
Run this code
Now, here's how you select filters and change settings on multiple sheets within a dashboard.
The code sample applies to a dashboard with two worksheets:
var dashboard, mapSheet, graphSheet;
workbook.activateSheetAsync("GDP per Capita Dashboard")
.then(function (sheet) {
dashboard = sheet;
mapSheet = dashboard.getWorksheets().get("Map of GDP per
capita");
graphSheet = dashboard.getWorksheets().get("GDP per capita
by region");
return mapSheet.applyFilterAsync("Region", "Middle East",
tableauSoftware.FilterUpdateType.REPLACE);
})
.then(function () {
// Do these two steps in parallel since they work on different sheets.
mapSheet.applyFilterAsync("YEAR(Date (year))", 2010,
tableauSoftware.FilterUpdateType.REPLACE);
- 499 -
return graphSheet.clearFilterAsync("Date (year)");
})
.then(function () {
return graphSheet.selectMarksAsync("YEAR(Date (year))",
2010, tableauSoftware.SelectionUpdateType.REPLACE);
});
}
Run this code
BackNext
Control Toolbar Commands
Tableau Server toolbar commands are available from the Viz object, which is the highest level
object. Some commands act on the entire worksheet or dashboard, and some act on only the
selected zone. Export PDF and Export Image act on the entire worksheet or dashboard.
Here's the code for Export PDF:
function exportPDF() {
viz.showExportPDFDialog();
}
Run this code
And here's the code for Export Image:
function exportImage() {
viz.showExportImageDialog();
}
Run this code
Unlike the Export PDF and Export Image commands, which apply to the entire worksheet or
dashboard, the commands Export as Crosstab and Export Data apply to the currently selected
zone. If you select a mark or marks in the above view and then run the code, you'll see that just
the data for the selected marks is presented for export. The code for Export as CSV is as
follows:
function exportCrossTab() {
viz.showExportCrossTabDialog();
}
Run this code
When there aren't parameters specified for Export as Crosstab or Export Data, the currently
selected zone is exported. You can also specify a sheet name or you can pass in a sheet
object. Here's the code for Export Data:
- 500 -
function exportData() {
viz.showExportDataDialog();
}
Run this code
Finally, the Revert All command restores the workbook to its original, published state:
function revertAll() {
workbook.revertAllAsync();
}
Run this code
BackNext
Listen for Events
The operations you've done thus far controlled the viz from the outside in. One of the powerful
abilities of the Tableau JavaScript API is that it also gives you the ability to respond to
interactions that your user performs on the view. In other words, it lets you respond to events
that occur from the inside out.
Listening to events is done similarly to how you listen to events in the browser. The
addEventListener method on the Viz class lets you register a callback function when a
specific event occurs in the view. For example, you can listen to the marksselection event,
which gets raised whenever new marks become selected:
function listenToMarksSelection() {
viz.addEventListener(tableauSoftware.TableauEventName.MARKS_
SELECTION, onMarksSelection);
}
function onMarksSelection(marksEvent) {
return marksEvent.getMarksAsync().then(reportSelectedMarks);
}
function reportSelectedMarks(marks) {
var html = [];
for (var markIndex = 0; markIndex < marks.length; markIndex++)
{
var pairs = marks[markIndex].getPairs();
html.push("<b>Mark " + markIndex + ":</b><ul>");
for (var pairIndex = 0; pairIndex < pairs.length; pairIndex++) {
var pair = pairs[pairIndex];
html.push("<li><b>fieldName:</b> " + pair.fieldName);
html.push("<br/><b>formattedValue:</b> " +
- 501 -
pair.formattedValue + "</li>");
}
html.push("</ul>");
}
var dialog = $("#dialog");
dialog.html(html.join(""));
dialog.dialog("open");
}
Run this code
Click Run this code above, then manually select some marks in the view. A dialog will appear
that describes each of the marks you selected.
To stop listening to the event, you call the removeEventListener method, passing the
same function that you specified in addEventListener:
function removeMarksSelectionEventListener() {
viz.removeEventListener(tableauSoftware.TableauEventName.MARKS_
SELECTION, onMarksSelection);
}
Run this code
Click Run this code again, then select some marks. Because removeEventListener was
called you are not notified, and the dialog doesn't appear.
This tutorial has covered the basics on how to integrate Tableau Server views into your own
web applications. For more in-depth explanations, see the Concepts topic, as well as the API
Reference.
Back
API-Referenz
Stil und Konventionen
In der JavaScript API von Tableau werden folgende JavaScript-Standards eingehalten:
l
l
l
l
Klassen werden in PascalCase angezeigt (erster Buchstabe und alle folgenden Wörter
großgeschrieben)
Namespaces, Methoden, Parameter und Variablen werden in CamelCase
angezeigt (erster Buchstabe kleingeschrieben, alle folgenden Wörter großgeschrieben)
Konstanten und Nummerierungswerte werden GROSSBUCHSTABE_
UNTERSTRICH_GETRENNT angezeigt.
Geschützte Variablen oder Methoden beginnen mit eine Unterstrich "_". Das
bedeutet, dass diese vom Programmierer nicht referenziert werden sollten.
- 502 -
Klassendigramm der obersten Ebene
Im folgenden Klassendiagramm werden die Verhältnisse zwischen den Klassen der obersten
Ebene und die Vererbungshierarchie für Sheet-, Dashboard-, Story- und WorksheetKlassen dargestellt. Beachten Sie, dass mit Ausnahme von VizManager (hier handelt es sich
um eine statische und immer zugängliche Klasse) immer eine Möglichkeit zum Durchsuchen
der Einschlusshierarchie in umgekehrter Richtung mithilfe übergeordneter Zeiger gibt.
Asynchrone und Fehlerklassen
Promise-Klasse
Stellt eine Zusage, einen Wert aus einer asynchronen Methode in Zukunft auszugeben. Die
JavaScript-API von Tableau beruht auf dem Promises/A-Standard.
Methoden
Name
then
(callback:
Function,
errback:
Function)
always
(callback:
Function)
otherwise
Rückgabetyp Beschreibung
Promise
Erstellt eine Verknüpfung in der asynchronen
abrufbaren Kette. Bei Erfolg wird die Rückruffunktion
abgerufen. Wenn ein Fehler vorliegt, wird die
Funktion "Fehler zurück" aufgerufen. Beide
Parameter sind optional.
Promise
Registriert einen Rückruf, der bei Einhaltung oder
Ablehnung einer Zusage abgerufen wird.
Verknüpfung für then(callback, callback).
Promise
Registriert einen Ablehnungs-Handler. Verknüpfung
- 503 -
(errback:
Function)
für then(null, errback).
Tableau-Ausnahmeklasse
Bei der Klasse TableauException handelt es sich nicht um eine echte Klasse. Vielmehr
wird ein ID-Feld in das Standard-JavaScript-Erroreingefügt, wenn eine Ausnahme von
innerhalb der API ausgegeben wird. Ihnen als Programmierer ist es damit möglich, den Fehler
eindeutig zu ermitteln, ohne den Fehlerstrang analysieren zu müssen. Hiermit können Sie
auch lokalisierte Meldungen hinzufügen.
Konstruktor
Es gibt keinen öffentlichen Konstruktor. Die einzige Möglichkeit, eine Referenz zu einer
TableauException zu erhalten, besteht innerhalb eines catch-Blocks.
Felder
Name
Typ
Beschreibung
tableauSoftwareErrorCode ErrorCode Stellt den numerischen Wert eines
ErrorCode dar.
message
string
Dies ist bereits im Standard-ErrorObjekt definiert; die Meldung enthält
jedoch eine Beschreibung der
Ausnahme, die durch den API-Code
angegeben wird.
ErrorCode Enum
Hier finden Sie eine Liste der Ausnahmen, die durch eine API ausgegeben werden können.
Name
BROWSER_
NOT_
CAPABLE
DOWNLOAD_
WORKBOOK_
NOT_
ALLOWED
Wert
browserNotCapable
downloadWorkbookNotAllowed
FILTER_
filterCannotBePerformed
CANNOT_BE_
PERFORMED
INDEX_OUT_ indexOutOfRange
OF_RANGE
INTERNAL_
ERROR
internalError
- 504 -
Beschreibung
Die Tableau JavaScript
API.wird vom Browser nicht
unterstützt.
Die Berechtigungen zu einer
Arbeitsmappe oder Ansicht
beinhalten nicht das
Herunterladen der
Arbeitsmappe.
Beim Versuch, einen
Filtervorgang durchzuführen, ist
ein Fehler aufgetreten.
Es wurde versucht, nach Index
zu einem Blatt zu wechseln, das
in der Arbeitsmappe nicht
vorhanden ist.
In der Tableau JavaScript API
ist ein Fehler aufgetreten.
Wenden Sie sich an den
INVALID_
invalidAggregationFieldName
AGGREGATION_FIELD_
NAME
INVALID_
CUSTOM_
VIEW_NAME
invalidCustomViewName
INVALID_
DATE_
PARAMETER
invalidDateParameter
INVALID_
FILTER_
FIELDNAME
invalidFilterFieldName
INVALID_
FILTER_
FIELDNAME_
OR_VALUE
invalidFilterFieldNameOrValue
INVALID_
FILTER_
FIELDVALUE
invalidFilterFieldValue
INVALID_
PARAMETER
invalidParameter
INVALID_
SELECTION_
DATE
invalidSelectionDate
INVALID_
SELECTION_
FIELDNAME
invalidSelectionFieldName
- 505 -
Tableau-Support.
Für den Filter wurde eine ungültige Aggregation angegeben,
etwa das Festlegen eines
Bereichsfilters auf "SUM(Sales)
" statt "Sales".
Es wurde versucht, einen
Vorgang auf einer nicht
vorhandenen
benutzerdefinierten Ansicht
durchzuführen.
Bei einer Methode, die einen
Datenparameter erfordert,
wurde ein ungültiges Datum
angegeben.
Es wurde versucht, einen
Filtervorgang zu einem in der
Datenquelle nicht vorhandenen
Feld durchzuführen.
Entweder wurde ein
Filtervorgang zu einem in der
Datenquelle nicht vorhandenen
Feld versucht, oder der im
Filtervorgang angegebene Wert
weist den falschen Datentyp
bzw. das falsche Format auf.
Es wurde versucht, einen
Filtervorgang mit einem Wert
des falschen Datentyps oder
Formats durchzuführen.
Ein Parameter liegt nicht im
korrekten Datentyp oder Format
vor. Der Name des Parameters
ist im Feld Error.message
angegeben.
In einem
Sheet.selectMarksAsync
()-Abruf zu einem Datenfeld
wurde ein ungültiger
Datumswert angegeben.
In einem
Sheet.selectMarksAsync
()-Abruf wurde ein Feld
angegeben, das in der
Datenquelle nicht vorhanden ist.
INVALID_
SELECTION_
VALUE
invalidSelectionValue
INVALID_SIZE invalidSize
INVALID_
SIZE_
BEHAVIOR_
ON_
WORKSHEET
invalidSizeBehaviorOnWorkshe
et
INVALID_URL
invalidUrl
MISSING_
MAX_SIZE
missingMaxSize
MISSING_
MIN_SIZE
missingMinSize
MISSING_
missingMinMaxSize
MINMAX_SIZE
MISSING_
RANGEN_
FOR_
RELATIVE_
DATE_
FILTERS
NO_URL_
FOR_
HIDDEN_
missingRangeNForRelativeDat
eFilters
noUrlForHiddenWorksheet
- 506 -
In einem
Sheet.selectMarksAsync
()-Abruf zu einem Datenfeld
wurde ein ungültiger Wert
angegeben.
Es wurde eine negative Größe
angegeben oder der Wert
maxSize ist in
Sheet.changeSizeAsync
() geringer als minSize.
In
Sheet.changeSizeAsync
() wurde ein von
SheetSizeBehavior.AUTO
MATIC abweichendes
Verhalten angegeben, wenn
sich das Blatt in der ArbeitsblattInstanz befindet.
Die im Klassenkonstruktor Viz
angegebene URL ist ungültig.
Das FeldmaxSize fehlt in
Sheet.changeSizeAsync
() bei Angabe von
SheetSizeBehavior.ATMO
ST.
Das FelminSize fehlt in
Sheet.changeSizeAsync
() bei Angabe von
SheetSizeBehavior.ATLE
AST.
Entweder fehlt das Feld
minSize oder maxSize in
Sheet.changeSizeAsync
() bei der Angabe von
SheetSizeBehavior.RANG
E.
Das Feld rangeN zu einem
relativen Datenfilter des Typs
LASTN oder NEXTN fehlt.
Es wurde ein Zugriffsversuch
auf Sheet.getUrl() auf
einem ausgeblendeten Blatt
WORKSHEET
NO_URL_OR_
PARENT_
ELEMENT_
NOT_FOUND
NOT_
ACTIVE_
SHEET
noUrlOrParentElementNotFoun
d
NULL_OR_
EMPTY_
PARAMETER
nullOrEmptyParameter
SERVER_
ERROR
serverError
SHEET_NOT_
IN_
WORKBOOK
sheetNotInWorkbook
STALE_
DATA_
REFERENCE
staleDataReference
UNSUPPORT
ED_EVENT_
NAME
unsupportedEventName
VIZ_
ALREADY_
IN_MANAGER
vizAlreadyInManager
notActiveSheet
Viz-Klassen
- 507 -
unternommen. Ausgeblendete
Blätter haben keine URLs.
Mindestens ein
parentElement oder URLParameter ist im Konstruktor
Viz nicht angegeben.
Es wurde versucht, einen
Vorgang auf einem nicht aktiven
oder nicht in das aktive
Dashboard integrierten Blatt
auszuführen.
Ein erforderlicher Parameter
wurde nicht angegeben oder
war null oder eine leere
Zeichenfolge bzw. ein leeres
Array.
Ein ist ein allgemeiner
Serverfehler aufgetreten. Die
Fehler sind im Error objekt
enthalten.
Es wurde versucht, einen
Vorgang auf einem in der
Arbeitsmappe nicht
vorhandenen Blatt
durchzuführen.
Es wird ein Vorgang an einem
nicht mehr gültigen (bzw.
entfernten) CustomViewObjekt ausgeführt.
Im Abruf zu
Viz.addEventListener
oder
Viz.removeEventListene
r wurde ein unbekannter
Ereignisname angegeben.
Es wurde bereits ein VizObjekt als untergeordnetes
Element zu dem im Konstruktor
Viz angegebenen
parentElement erstellt.
VizManager-Klasse
Verwaltet alle Viz-Instanzen auf der Seite, jedoch keine Visualisierungen (Ansichten) vor
Version 8.0. Dies ist eine statische Klasse, das heißt alle Eigenschaften und Methoden sind
statisch und es gibt nur eine einzige Instanz der Klasse.
Eigenschaften
Name
getVizs()
Typ
Viz[]
Beschreibung
Auflistung der Ansichten auf der Hostingseite.
Viz-Klasse
Umschließt einen <iframe> mit mindestens einem Blatt in einer Tableau-Arbeitsmappe.
Enthält sämtliches die Ansicht umgebendes Chrom.
Konstruktor
Signatur
Viz
(parentElement:
domNode, url:
string, options:
VizCreateOptions)
Beschreibung
Erstellt eine neue Tableau-Viz in einem vorgegebenen HTMLContainer; meist handelt es sich hierbei um ein <div>Element. Alle Optionen und Optionsparameter sind optional.
Wenn bereits eine Viz dem parentElement zugeordnet ist,
wird eine Ausnahme ausgegeben. Bevor Sie das
parentElement erneut verwenden, müssen Sie dispose
() aufrufen.
Eigenschaften
Name
getAreTabsHidden()
Typ
Bool
Beschreibung
Zeigt an, ob die
Registerkarten in der
Benutzeroberfläche angezeigt
werden. Blendet nicht die
einzelnen Registerkarten aus.
getIsToolbarHidden()
Bool
Gibt an, ob die Symbolleiste
angezeigt wird.
getIsHidden()
Bool
Gibt an, ob die Ansicht auf der
Hostingseite angezeigt wird.
getParentElement()
domNode
Gibt des Knoten aus, der im
Konstruktor angegeben
wurde.
getUrl()
string
Die URL der Ansicht wie im
Konstruktor angegeben.
getWorkbook()
Arbeitsmappe Pro Ansicht wird eine
Workbook unterstützt.
getAreAutomaticUpdatesPaused Bool
Zeigt an, ob automatische
()
Aktualisierungen aktuell
angehalten werden.
- 508 -
Ereignisse
Ereignisse werden mithilfe der folgenden beiden Abrufe hinzugefügt oder entfernt.
Name
Rückgabetyp Beschreibung
addEventListener(
Keine
Fügt zum angegebenen Ereignis einen
type:
Ereignislistener hinzu.
TableauEventName,
listener: Function)
removeEventListener Keine
Entfernt einen Ereignislistener aus dem
(
angegebenen Ereignis.
type:
TableauEventName,
listener: Function)
Methoden
Name
show()
hide()
Typ
Keine
Beschreibung
Zeigt den <iframe>, der die
Ansicht hostet, an oder blendet
diesen aus.
dispose()
Keine
Bereinigt sämtliche mit der Ansicht
verbundenen Ressourcen, entfernt
die Ansicht aus dem VizManager
und entfernt sämtliche DOMElemente vom parentElement.
Im Wesentlichen wird die Seite in
den Zustand vor der Instanziierung
des Viz-Objekts zurückversetzt.
pauseAutomaticUpdatesAsync() Keine
Hält Layout-Aktualisierungen an
resumeAutomaticUpdatesAsync
oder nimmt diese wieder auf. Dies
()
kann dann hilfreich sein, wenn Sie
toggleAutomaticUpdatesAsync
die Größe der Visualisierung ändern
()
oder mehrere Abrufe durchführen,
die sich auf das Layout auswirken
können.
revertAllAsync()
Promise Dies entspricht den der Funktion der
Schaltfläche "Alles
wiederherstellen", durch die die
Arbeitsmappe in den ursprünglichen
Zustand zurückversetzt wird.
refreshDataAsync ()
Keine
Dies entspricht der Funktion der
Schaltfläche "Daten aktualisieren".
showDownloadWorkbookDialog Keine
Dies entspricht der Funktion der
()
Schaltfläche "Herunterladen", über
die eine Kopie der ursprünglichen
Arbeitsmappe heruntergeladen wird.
showExportImageDialog()
Keine
Dies entspricht der Funktion der
- 509 -
showExportPDFDialog()
Keine
showExportDataDialog( worksheetInDashboard: Sheet or
SheetInfo or string)
Keine
showExportCrossTabDialog( worksheetInDashboard: Sheet
or SheetInfo or string)
Keine
showShareDialog()
Keine
setFrameSize(width: int, height:
int)
Keine
Symbolleiten-Schaltfläche
"Exportieren eines Bilds", mit der
eine PNG-Datei der aktuellen
Visualisierung erstellt wird.
Dies entspricht der Funktion der
Symbolleisten-Schaltfläche PDF
exportieren, welche es dem
Benutzer ermöglicht, Optionen für
den Export auszuwählen.
Zeigt das Dialogfeld "Daten exportieren" an, das derzeit als PopupFenster vorliegt. Der Parameter
worksheetInDashboard ist
optional. Wurde nichts angegeben,
wird das aktive Worksheet verwendet.
Zeigt den Kreuztabellen-Dialog an.
Der Parameter worksheetInDashboard ist optional.
Wurde nichts angegeben, wird das
aktive Worksheet verwendet.
Dies entspricht der Funktion der
Symbolleisten-Schaltfläche, über die
ein Dialog angezeigt wird, über den
der Benutzer die Visualisierung per
E-Mail oder durch Integration deren
HTML-Codes in eine Webseite
freigeben kann.
Legt die Größe des iFrame fest.
Hierdurch wird die Visualisierung auf
die Größe des iFrame erweitert bzw.
reduziert, wenn die Blattgröße der
aktuellen Visualisierung auf
AUTOMATIC eingestellt ist.
VizCreateOptions-Datensatz
Hierbei handelt es sich um die im Viz-Konstruktor festgelegten Optionen.
Felder
Name
hideTabs
hideToolbar
toolbarPosition
Typ
Bool
Beschreibung
Gibt an, ob Registerkarten eingeblendet oder
angezeigt werden.
Bool
Gibt an, ob die Symbolleiste eingeblendet
oder angezeigt wird.
ToolbarPosition Gibt an, ob die Symbolleiste angezeigt wer-
- 510 -
height
string
width
string
onFirstInteractive callback(e:
TableauEvent)
den soll, wennhideToolbar falsch ist.
Es kann sich um jeden CSSGrößenspezifizierer handeln. Wird nichts
angegeben, so wird die Standardeinstellung
600 Px verwendet.
Es kann sich um jeden CSSGrößenspezifizierer handeln. Wird nichts
angegeben, so wird die Standardeinstellung
800 Px verwendet.
Rückruf, wenn erst die Visualisierung
interaktiv wird. Diese wird immer genau
einmal abgerufen. Wenn die Visualisierung
bereits interaktiv ist, wird sie sofort, jedoch auf
einem separaten "Thread" abgerufen.
ToolbarPosition Enum
Aufzählung
Name
TOP
BOTTOM
Beschreibung
Positioniert die Symbolleiste am oberen Rand der Visualisierung.
Positioniert die Symbolleiste am unteren Rand der Visualisierung.
Visualisierungs-Ereignisklassen
TableauEventName Enum
Diese Zeichenfolgen werden an Viz.addEventListener/removeEventListener weitergeleitet.
Beachten Sie, dass der Wert der Aufzählungen alle Zeichenfolgen in Kleinbuchstaben ohne
Unterstrich umfasst. CUSTOM_VIEW_LOAD ist beispielsweise customviewload. Es werden
die vollständig qualifizierte Aufzählung
(tableauSoftware.TableauEventName.FILTER_CHANGE) oder die Rohzeichenfolge
(filterchange) akzeptiert.
Name
CUSTOM_
VIEW_LOAD
In den Rückruf
geleitete
Ereignisklasse
CustomViewEvent
CUSTOM_
VIEW_
REMOVE
CUSTOM_
VIEW_SAVE
CustomViewEvent
CUSTOM_
CustomViewEvent
CustomViewEvent
Beschreibung
Höhergestellt, wenn eine
benutzerdefinierte Ansicht vollständig
geladen wurde.
Höhergestellt, wenn der Benutzer eine
benutzerdefinierte Ansicht entfernt.
Höhergestellt, wenn der Benutzer eine
neue oder vorhandene
benutzerdefinierte Ansicht speichert.
Höhergestellt, wenn eine
- 511 -
VIEW_SET_
DEFAULT
FILTER_
CHANGE
FilterEvent
MARKS_
SELECTION
MarksEvent
benutzerdefinierte Ansicht zur
Standardansicht für diese Visualisierung
wurde.
Höhergestellt bei Änderung des Status
eines beliebigen Filters. Die
Visualisierung ist u. U. noch nicht
interaktiv.
Höhergestellt, wenn Markierungen
ausgewählt wurden oder deren Auswahl
aufgehoben wurde.
Höhergestellt bei Änderung des Status
eines beliebigen Parameters.
PARAMETER_ ParameterEvent
VALUE_
CHANGE
STORY_
StoryPointSwitchEvent Höhergestellt, nachdem ein Storypoint
POINT_
aktiv geworden ist.
SWITCH
TAB_SWITCH TabSwitchEvent
Höhergestellt, nachdem eine
Registerkarte gewechselt wurde; die
Visualisierung ist möglicherweise noch
nicht interaktiv.
TableauEvent Class
Eigenschaften
Name
getViz()
Typ
Visualisierung
Beschreibung
Ruft das mit diesem Ereignis verbundene
Visualisierungsobjekt ab.
getEventName TableauEventName Ruft den Namen des Ereignisses ab, das
()
eine Zeichenfolge und gleichzeitig eines der
Elemente in der Aufzählung
TableauEventName ist.
CustomViewEvent-Klasse
Eigenschaften
Name
getViz()
Typ
Visualisierung
Beschreibung
Ruft das mit diesem Ereignis verbundene
Visualisierungsobjekt ab.
getEventName TableauEventName Ruft den Namen des Ereignisses ab, das
()
eine Zeichenfolge und gleichzeitig eines der
Elemente in der Aufzählung
TableauEventName ist.
Methoden
Name
Rückgabetyp
Beschreibung
getCustomViewAsync Promise<CustomView> Ruft das mit diesem Ereignis
- 512 -
()
verbundene benutzerdefinierte
Ansichtsobjekt ab.
FilterEvent-Klasse
Eigenschaften
Name
getViz()
Typ
Visualisierung
Beschreibung
Ruft das mit diesem Ereignis verbundene
Vizobjekt ab.
getWorksheet Arbeitsblatt
Ruft das mit diesem Ereignis verbundene
()
Worksheetobjekt ab.
getEventName TableauEventName Ruft den Namen des Ereignisses ab, das
()
eine Zeichenfolge und gleichzeitig eines der
Elemente in der Aufzählung
TableauEventName ist.
getFieldName string
Ruft den Namen des Felds ab.
()
Methoden
Name
Rückgabetyp
Beschreibung
getFilterAsync Promise<Filter> Ruft das mit dem Ereignis verbundene Filter()
Objekt ab.
MarksEvent-Klasse
Eigenschaften
Name
getViz()
Typ
Visualisierung
Beschreibung
Ruft das mit diesem Ereignis verbundene
Vizsobjekt ab.
getWorksheet Arbeitsblatt
Ruft das mit diesem Ereignis verbundene
()
Worksheetobjekt ab.
getEventName TableauEventName Ruft den Namen des Ereignisses ab, das
()
eine Zeichenfolge und gleichzeitig eines der
Elemente in der Aufzählung
TableauEventName ist.
Methoden
Name
Rückgabetyp Beschreibung
getMarksAsync Promise<Mark Ruft die ausgewählten Markierungen auf dem
()
[]>
Worksheet ab, die das Ereignis ausgelöst
haben.
ParameterEvent-Klasse
Eigenschaften
Name
getViz()
Typ
Visualisierung
Beschreibung
Ruft das mit diesem Ereignis
- 513 -
verbundene Vizsobjekt ab.
getEventName()
TableauEventName Ruft den Namen des Ereignisses ab,
das eine Zeichenfolge und gleichzeitig
eines der Elemente in der Aufzählung
TableauEventName ist.
getParameterName string
Ruft den Namen des geänderten
()
Parameters ab.
Methoden
Name
Rückgabetyp
Beschreibung
getParameterAsync Promise<Parameter> Ruft das Parameter-Objekt ab, das
()
das Ereignis ausgelöst hat.
StoryPointSwitchEvent-Klasse
Beim Rückruf für das Ereignis "STORY_POINT_SWITCH" zurückgegeben.
Eigenschaften
Name
getViz()
Typ
Visualisierung
Beschreibung
Ruft das mit dem Ereignis verbundene Visualisierungsobjekt ab.
getEventName()
TableauEventName Ruft den Namen des Ereignisses ab,
das eine Zeichenfolge und gleichzeitig eines der Elemente in der Aufzählung TableauEventName ist. In
diesem Fall handelt es sich um
STORY_POINT_SWITCH.
getOldStoryPointInfo StoryPointInfo
Ruft die StoryPointInfo ab, die
()
vor Eintreten des Storypoint-Wechselereignisses aktiv war. Das zurückgegebene Objekt stellt den Status
des Storypoints vor Eintreten des
Wechsels dar. Das zurückgegebene
Objekt stellt den Status des Storypoints nach Eintreten des Wechsels dar.
getNewStoryPoint()
Storypoint
Ruft den derzeit aktiven StoryPoint ab.
TabSwitchEvent -Klasse
Eigenschaften
Name
getViz()
getEventName()
Typ
Visualisierung
Beschreibung
Ruft das mit diesem Ereignis
verbundene Vizsobjekt ab.
TableauEventName Ruft den Namen des Ereignisses ab,
das eine Zeichenfolge und gleichzeitig
- 514 -
getOldSheetName
()
eines der Elemente in der Aufzählung
TableauEventName ist.
Ruft den Namen des Blatts ab, das vor
Eintreten des
Registerkartenwechselereignisses aktiv
war.
Ruft den Namen des derzeit aktiven
Blatts ab.
string
getNewSheetName string
()
Arbeitsmappen-Klassen
Klassendigramm
Arbeitsmappen-Klasse
Eine Arbeitsmappe enthält eine Auflistung an Blättern, die als Registerkarten dargestellt
werden. Sie verfügt zudem über verbundene Objekte wie DataSources und
CustomViews.
Eigenschaften
Name
getViz()
getActiveSheet()
getActiveCustomView()
Typ
Visualisierung
Beschreibung
Ruft das Vizsobjekt ab, das die
Arbeitsmappe enthält.
Blatt
Ruft das derzeit aktive Blatt (die
aktive Registerkarte) ab.
Benutzerdefinierte Ruft die derzeit aktive
Ansicht
benutzerdefinierte Ansicht oder
nichts ab, wenn keine
benutzerdefinierte Ansicht aktiv ist.
- 515 -
getPublishedSheetsInfo SheetInfo[]
()
getName()
Beachten Sie, dass dies synchron
erfolgt und beim Laden
entsprechend alle Blätter erwartet
werden.
Ruft den Namen der auf dem
Server gespeicherten
Arbeitsmappe ab. Beachten Sie,
dass es sich hierbei nicht unbedingt
um den Dateinamen handelt.
string
Methoden
Name
activateSheetAsync(sheetNameOrIndex: object)
Rückgabetyp
Promise<Sheet>
revertAllAsync()
Promise
getParametersAsync()
Promise<Paramete
r[]>
Promise<Paramete
r>
changeParameterValueAsync(
name: string,
value: object)
getCustomViewsAsync()
Promise<CustomVi
ew[]>
- 516 -
Beschreibung
Aktiviert das Blatt nach
Name oder Index und
gibt eine Zusage zu dem
aktivierten Blatt aus.
Setzt die Arbeitsmappe
auf den letzten
gespeicherten Status
zurück.
Ruft die Parameter zu
dieser Arbeitsmappe ab.
Ändert den Wert des
Parameters durch den
angegebenen Namen
und gibt den neuen
Parameter aus. Der
Wert sollten denselben
Datentyp wie der
Parameter aufweisen
und innerhalb des
zulässigen
Wertebereichs liegen. Er
muss zudem der
Aliaswert und nicht der
Rohwert sein. Weitere
Informationen und
Beispiele finden Sie
unter Zusätzliche
Informationen zu
changeParameterValue
Async()
Ruft die mit der Arbeitsmappe verbundene Auflistung an
CustomViewobjekten
showCustomViewAsync(
customViewName: string)
Promise<CustomVi
ew>
removeCustomViewAsync(
customViewName: string)
Promise<CustomVi
ew>
rememberCustomViewAsync(
customViewName: string)
Promise<CustomView>
setActiveCustomViewAsDefault
Async()
Keine
ab.
Ändert die
Visualisierung, sodass
darin der benannte
gespeicherte Status
angezeigt wird.
Entfernt die benannte
benutzerdefinierte
Ansicht.
Speichert den aktuellen
Status der Arbeitsmappe
durch Zuweisen eines
neuen Namens für die
benutzerdefinierte
Ansicht.
Richtet die aktive
benutzerdefinierte
Ansicht als
Standardansicht ein.
Zusätzliche Informationen zu changeParameterValueAsync()
Der Wertparameter muss die folgenden Bedingungen erfüllen:
1. Der Datentyp muss derselbe zugrundliegende JavaScript-Typ sein, der in Parameter.getCurrentValue() zurückgegeben wird. Ist Parameter.getDataType() beispielsweise FLOAT oder INTEGER, muss es sich bei
dem Wertparameter um eine native JavaScript-Nummer handeln. In der folgenden
Tabelle werden die ParameterDataType-Werte nativen JavaScript-Typen zugeordnet.
ParameterDataType
FLOAT
INTEGER
STRING
BOOLEAN
DATE
DATETIME
Nativer JavaScript-Typ
Zahl
Zahl
Zeichenfolge
Boolesch
Datum
Datum
2. Wenn der Parameter auf eine Liste zulässiger Werte beschränkt ist, sollte der Wert
einem dieser Werte entsprechen. Eine Abfrage von Parameter.getAllowableValuesType() zeigt an, ob die Parameterwerte beschränkt
sind, indem tableauSoftware.ParameterAllowableValuesType.LIST
zurückgegeben wird.
3. Ist der Parameter auf einen Wertebereich beschränkt, sollte der Wert zwischen dem Mindest- und Höchstwert liegen. Eine Abfrage von Parameter.getAllowableValuesType() zeigt an, ob die Parameterwerte beschränkt
sind, indem tableauSoftware.ParameterAllowableValuesType.RANGE
- 517 -
zurückgegeben wird. Die Mindest- und Höchstwerte werden über Parameter.getMinValue() und Parameter.getMaxValue() wiedergegeben.
4. Bei dem Wert muss es sich um den Aliaswert und nicht um den Rohwert handeln. Um
die Roh- und Aliaswerte anzuzeigen, rufen Sie das Dialogfeld Parameter bearbeiten
in Tableau Desktop auf. Verwenden Sie in diesem Dialog wie im Beispiel unten die
Werte in der Spalte Anzeigen als und nicht in der Spalte Wert.
Beispiele
Die folgenden Beispiele veranschaulichen diese Konzepte.
// Change a parameter called "Prouct Type" to "Coffee" when the
parameter is
// restricted to the following allowable values:
// "Coffee", "Espresso", "Tea"
workbook.changeParameterValueAsync("Product Type", "Coffee");
// Change a parameter called "Measure" to a value that is
aliased, "Sale". This
// example corresponds to the screen shot above.
workbook.changeParameterValueAsync("Measure", "Sale");
// Change a date parameter named "DateParam" to January 1, 2014
- 518 -
(UTC):
workbook.changeParameterValueAsync("DateParam", new Date
(Date.UTC(2014, 0, 1)));
Datenquellen-Klasse
Die Workbook enthält mindestens eine Datenquelle. Jedes Worksheet verfügt über eine
primäre Datenquelle und kann mehrere sekundäre Datenquellen enthalten.
Eigenschaften
Name
getName()
Typ
Beschreibung
string Der Name der DataSource wie in der Benutzeroberfläche
angezeigt.
getIsPrimary Bool Gibt an, ob es sich bei dieser DataSource um eine primäre
()
oder sekundäre Datenquelle handelt.
getFields()
Feld Ruft eine Reihe an Fields ab, die mit der DataSource
[]
verbunden sind.
Feldklasse
Ein Feld enthält Angaben zu der zugehörigen Datenquelle, der Rolle und der Möglichkeit zum
Abruf von Domänenwerten.
Eigenschaften
Name
getName()
Typ
string
Beschreibung
Ruft den Feldnamen (d. h. die
Überschrift) ab.
getAggregation FieldAggregationType Ruft den Aggregationstyp ab, welcher
()
einen der folgenden Werte annehmen
kann: SUM, AVG, MIN, MAX, STDEV,
STDEVP, VAR, VARP, COUNT,
COUNTD, MEDIAN, ATTR, NONE, YEAR,
QTR, MONTH, DAY, HOUR, MINUTE,
SECOND, WEEK, WEEKDAY,
MONTHYEAR, MDY, END, TRUNC_
YEAR, TRUNC_QTR, TRUNC_MONTH,
TRUNC_WEEK, TRUNC_DAY, TRUNC_
HOUR, TRUNC_MINUTE, TRUNC_
SECOND, QUART1, QUART3, SKEWNESS,
KURTOSIS, INOUT, USER
getDataSource DataSource
Ruft die Datenquelle ab, zu der dieses
()
Feld gehört.
getRole()
FieldRoleType
Einer der folgenden Werte: DIMENSION,
MEASURE, UKNOWN
- 519 -
CustomView Class
Stellt eine bestimmte Momentaufnahme der Arbeitsmappe dar.
Eigenschaften
Name
getName()
setName()
getAdvertised
()
setAdvertised()
getDefault()
Typ
string
Bool
Beschreibung
Benutzerfreundlicher Name der
benutzerdefinierten Ansicht
Gibt an, ob die benutzerdefinierte Ansicht
öffentlich oder privat ist.
Bool
Lässt erkennt bzw. legt fest, ob dies die
benutzerdefinierte Ansicht ist.
getOwnerName string
Ruft den Benutzer ab, der die benutzerdefinierte
()
Ansicht erstellt hat.
getUrl()
string
Eindeutige URL zum erneuten Laden dieser
Ansicht.
getWorkbook() Arbeitsmappe Ruft die Workbook ab, zu der diese
CustomView gehört.
Methoden
Name
Rückgabetyp
Beschreibung
saveAsync Promise<CustomView> Nachdem saveAsync() abgerufen wurde,
()
ist das Ergebnis der Methode des getUrl
nicht mehr leer.
Blattklassen
Klassendigramm
Blattinfo-Klasse
Enthält Informationen zu WORKSHEET, einem DASHBOARD oder einer STORY und keine
Methoden. Wird als Teil von Workbook.getPublishedSheetsInfo() ausgegeben.
- 520 -
Konstruktor
Es gibt keinen öffentlichen Konstruktor. Instanzen dieser Klasse sind nur von
Workbook.getPublishedSheetsInfo() abrufbar.
Eigenschaften
Name
getName()
getIndex()
Typ
string
Ganzzahl
Beschreibung
Ruft den Namen des Blatts ab.
Ruft den Index des Blatts unter den veröffentlichten
Registerkarten ab. Beachten Sie, dass
ausgeblendete Registerkarten, solange sie
veröffentlicht sind, weiter in der Sortierung gezählt
werden.
getIsActive()
Bool
Ruft einen Wert ab, der erkennen lässt, ob es sich
bei dem Blatt um das derzeit aktive Blatt handelt.
Aufgrund technischer Einschränkungen gibt es
immer eine falsche Ausgabe, wenn es sich beim
Objekt um eine Worksheet-Instanz handelt,
welche Teil eines Dashboard ist.
getIsHidden() Bool
Ruft einen Wert ab, welcher anzeigt, ob das Blatt in
der Benutzeroberfläche ausgeblendet ist. Beachten
Sie, dass das Ausblenden der gesamten
Registerkartensteuerung keine Auswirkungen auf
den Status dieser Flag hat. Diese Blatt kann auch
dann noch als sichtbar gemeldet werden, wenn die
Registerkartensteuerung ausgeblendet ist.
getSheetType SheetType
Ruft den Typ des Blatts ab.SheetType ist eine
()
Aufzählung mit folgenden Werten: WORKSHEET,
DASHBOARD und STORY.
getSize()
SheetSize
Ruft die Größenangaben ab, die der Autor beim
Veröffentlichen der Arbeitsmappe festgelegt hat.
getUrl()
string
Ruft die URL für dieses Blatt ab.
getWorkbook Arbeitsmappe Ruft die Workbook ab, zu der dieses Sheet
()
gehört.
Blattklasse
Konstruktor
Es gibt keinen öffentlichen Konstruktor. Instanzen dieser Klasse können nur aus
Workbook.getActiveSheet()oder Dashboard.getObjects() abgerufen werden.
Eigenschaften
Name
getName()
getIndex()
Typ
string
Ganzzahl
Beschreibung
Ruft den Namen des Blatts ab.
Ruft den Index des Blatts unter den veröffentlichten
Registerkarten ab. Beachten Sie, dass
ausgeblendete Registerkarten, solange sie
- 521 -
veröffentlicht sind, weiter in der Sortierung gezählt
werden.
getIsActive()
Bool
Ruft einen Wert ab, welcher erkennen lässt, ob es
sich beim Blatt um das derzeit aktive Blatt handelt.
getIsHidden() Bool
Ruft einen Wert ab, welcher anzeigt, ob das Blatt in
der Benutzeroberfläche ausgeblendet ist. Beachten
Sie, dass das Ausblenden der gesamten
Registerkartensteuerung keine Auswirkungen auf
den Status dieser Flag hat. Diese Blatt kann auch
dann noch als sichtbar gemeldet werden, wenn die
Registerkartensteuerung ausgeblendet ist.
getSheetType SheetType
Ruft den Typ des Blatts ab. SheetType ist eine
()
Aufzählung mit folgenden Werten: WORKSHEET ,
DASHBOARD und STORY.
getSize()
SheetSize
Ruft die Größenangaben ab, die der Autor beim
Veröffentlichen der Arbeitsmappe festgelegt hat.
getUrl()
string
Ruft die URL für dieses Blatt ab.
getWorkbook Arbeitsmappe Ruft die Workbook ab, zu der dieses Sheet
()
gehört.
Methoden
Name
Rückgabetyp
Beschreibung
changeSizeAsync Promise<SheetSize> Legt die Größenangaben zu einem
(size: SheetSize)
Blatt fest. Beachten Sie: Wenn es sich
beim Blatt um ein Worksheet handelt,
ist nur
SheetSizeBehavior.AUTOMATIC
zulässig, da ein Worksheet nicht auf
eine feste Größe eingestellt werden
kann.
Blattgrößen-Datensatz
Beschreibt, welche Größen ein Blatt annehmen sollte.
Felder
Name
Typ
Beschreibung
behavior SheetSizeBehavior Enthält einen der folgenden Aufzählungswerte:
AUTOMATIC, EXACTLY, RANGE, ATLEAST oder
ATMOST.
maxSize SheetSize
Dieser wird nur beim Verhalten EXACTLY, RANGE
oder ATMOST definiert.
SheetSize
Dieser wird nur beim Verhalten EXACTLY, RANGE
minSize
oder ATLEAST definiert.
- 522 -
Arbeitsblatt-Klasse
Stellt eine Arbeitsblatt-Registerkarte im Arbeitsblatt oder einem Dashboard-Objekt dar.
Hierbei handelt es sich um zwei voneinander getrennte Konzepte: ein Arbeitsblatt und eine
Arbeitsblatt-Instanz. Der Einfachheit halber werden diese in der API jedoch in der
Worksheet-Klasse zusammengefasst.
Konstruktor
Es gibt keinen öffentlichen Konstruktor. Instanzen dieser Klasse können nur aus
Workbook.getPublishedSheets()oder Dashboard.getObjects() abgerufen
werden.
Eigenschaften
Name
Typ
Beschreibung
getParentDashboard Dashboard Gibt das Dashboard-Objekt aus, zu dem
()
dieses Worksheet gehört (sofern es sich auf
einem Dashboard befindet). Andernfalls wird
null zurückgegeben.
getParentStoryPoint Storypoint Gibt das StoryPoint-Objekt aus, zu dem die()
ses Worksheet gehört (sofern es sich auf
einem Story-Blatt befindet). Andernfalls wird
null zurückgegeben.Wenn die WorksheetInstanz nicht aus einem Aufruf von StoryPoint.getContainedSheet()
stammt, wird ebenfalls null zurückgegeben.
Methoden
Name
Rückgabetyp
Beschreibung
getDataSourcesAsync Promise<DataSource Ruft die primäre sowie alle
()
[]>
sekundären Datenquellen zu
diesem Arbeitsblatt ab. Beachten
Sie, dass die primäre Datenquelle
der Konvention entsprechend
immer das erste Element sein
sollte.
Die Filtermethoden sind unter API-Referenz Auf Seite 502 beschrieben. Die Methoden zur
Markierungsauswahl sind unter Arbeitsblatt-Klasse (Auswählen von Markierungen)
beschrieben.
Dashboard-Klasse
Enthält eine Auflistung an DashboardObjectinstanzen und die Angabe des aktiven Objekts.
Konstruktor
Es gibt keinen Konstruktor. Eine Instanz hierzu ist von Workbook.getPublishedSheets
() abrufbar.
- 523 -
Eigenschaften
Name
getObjects()
getWorksheets
()
getParentStoryPoint
()
Typ
DashboardO
bject[]
Arbeitsblatt[]
Storypoint
Beschreibung
Ruft die Auflistung an Objekten ab.
Ruft die Auflistung der im Dashboard enthaltenen
Arbeitsblätter ab. Beachten Sie, dass es sich
hierbei um eine Hilfsmethode handelt, die dem
Durchlaufen der Schleife getObjects() und
der Auflistung der
DashboardObject.Worksheet-Zeiger
entspricht, wenn DashboardObject.getType
() ===
tableauSoftware.DashboardObjectType
.WORKSHEET.
Gibt das StoryPoint-Objekt aus, zu dem dieses
Dashboard gehört (sofern es sich auf einem
Story-Blatt befindet). Andernfalls wird null zurückgegeben.Wenn die Dashboard-Instanz nicht aus
einem Aufruf von StoryPoint.getContainedSheet() stammt,
wird ebenfalls null zurückgegeben.
Dashboard-Objektklasse
Stellte eine Serie unterschiedlicher Bereiche des Dashboard dar.
Konstruktor
Es gibt keinen Konstruktor. Eine Instanz hierzu ist von Dashboard.getObjects()
abrufbar.
Eigenschaften
Name
Typ
Beschreibung
getObjectType DashboardObjectType Ruft das durch das Objekt Dargestellte ab,
()
d. h. eine enum mit folgenden Werten:
BLANK, WORKSHEET, QUICK_FILTER,
PARAMETER_CONTROL, PAGE_
FILTER, LEGEND, TITLE, TEXT,
IMAGE, WEB_PAGE.
getDashboard Dashboard
Ruft das Dashboard-Objekt ab, das
()
dieses Objekt enthält.
getWorksheet Arbeitsblatt
Wenn getType() WORKSHEET
()
ausgibt, so ist darin ein Zeiger auf das
Worksheet-Objekt enthalten.
getPosition()
Punkt
Ruft die Koordinaten zur oberen linken
Ecke des Dashboard des Objekts ab.
getSize()
Größe
Ruft die Größe des Objekts ab.
- 524 -
Story-Klasse
Umfasst eine Auflistung von StoryPoint-Instanzen und die Möglichkeit, zwischen ihnen zu
wechseln. Wird von der Blatt-Klasse abgeleitet.
Konstruktor
Es gibt keinen Konstruktor. Eine Instanz hierzu ist von Workbook.getActiveSheet()
abrufbar.
Eigenschaften (Vom Blatt abgeleitet)
Name
getName()
getIndex()
Typ
string
int
Beschreibung
Ruft den Namen des Blatts ab.
Ruft den Index des Blatts unter den veröffentlichten
Registerkarten ab. Beachten Sie, dass
ausgeblendete Registerkarten, solange sie
veröffentlicht sind, weiter in der Sortierung gezählt
werden.
getIsActive()
Bool
Ruft einen Wert ab, welcher erkennen lässt, ob es
sich beim Blatt um das derzeit aktive Blatt handelt.
getIsHidden() Bool
Ruft einen Wert ab, welcher anzeigt, ob das Blatt in
der Benutzeroberfläche ausgeblendet ist. Beachten
Sie, dass das Ausblenden der gesamten
Registerkartensteuerung keine Auswirkungen auf
den Status dieser Flag hat. Dieses Blatt kann auch
dann noch als sichtbar gemeldet werden, wenn die
Registerkartensteuerung ausgeblendet ist.
getSheetType SheetType
Ruft den Typ des Blatts ab, der stets
()
tableauSoftware.SheetType.STORY lauten
sollte.
getSize()
SheetSize
Ruft die Größenangaben ab, die der Autor beim Veröffentlichen der Arbeitsmappe festgelegt hat.
getUrl()
string
Ruft die URL für dieses Blatt ab.
getWorkbook Arbeitsmappe Ruft die Arbeitsmappe ab, zu der dieses Blatt
()
gehört.
Eigenschaften
Name
getStoryPointsInfo
()
Typ
Beschreibung
StoryPointInfo Ruft ein Array (keine Auflistung) von
[]
StoryPointInfo-Objekten ab. Beachten
Sie, dass dies keine Auflistung ist, da es
keinen eindeutigen Zeichenfolgenschlüssel
für einen Storypoint gibt. Wir benötigen
lediglich ordinalen Zugriff auf die Storypoints
(nach Index).
getActiveStoryPoint Storypoint
Ruft den derzeit aktiven Storypoint ab.
()
- 525 -
Methoden (Vom Blatt abgeleitet)
Name
changeSizeAsync(size:
SheetSize)
Typ
Beschreibung
Promise<SheetSize> Legt die Größeninformationen
auf einem Blatt fest.
Methoden
Name
activateStoryPointAsync
(index: int)
Typ
Promise<Story
Point>
activateNextStoryPointAsync
()
activatePreviousStoryPointAsync()
revertStoryPointAsync
(index: int)
Promise<StoryPoint>
Promise<StoryPoint>
Promise<StoryPoint>
Beschreibung
Aktiviert den Storypoint am
angegebenen Index und gibt eine
Promise des aktivierten StoryPoint
zurück. Gibt den Fehler
tableauSoftware.ErrorCod
e.INDEX_OUT_OF_RANGE aus,
wenn der Index kleiner als Null oder
größer als oder gleich der Anzahl
an Storypoints im Array ist.
Aktiviert den nächsten Storypoint,
sofern es einen gibt. Ist der aktuelle
Storypoint der letzte, bleibt er aktiv.
Aktiviert den vorherigen Storypoint,
sofern es einen gibt. Ist der aktuelle
Storypoint der erste, bleibt er aktiv.
Stellt den Storypoint am angegebenen Index wieder her und gibt
eine Promise des wiederhergestellten StoryPoint zurück.
Gibt den Fehler tableauSoftware.ErrorCode.INDEX_
OUT_OF_RANGE aus, wenn der
Index kleiner als Null oder größer
als oder gleich der Anzahl an Storypoints im Array ist.
StoryPointInfoClass
Enthält Informationen zu einem Storypoint ohne Methoden. Als Teil von
Story.getStoryPointsInfo() zurückgegeben.
Eigenschaften
Name
getIndex()
getCaption()
getIsActive()
Typ
int
Beschreibung
Ruft den nullbasierten Index dieses Storypoints im StoryBlatt ab.
string Ruft den Inhalt der Textbeschreibung für diesen Storypoint
ab.
Bool Ruft einen Wert ab, welcher erkennen lässt, ob es sich
beim Storypoint um den derzeit aktiven Point in der Story
- 526 -
handelt.
getIsUpdated() Bool Ruft einen Wert ab, der erkennen lässt, ob der Storypoint
aktualisiert wurde, was bedeutet, dass seit der letzten
Erfassung des Storypoints keine Änderungen vorgenommen wurden.
getParentStory Story Ruft das Story-Objekt ab, das den Storypoint enthält.
()
Storypoint-Klasse
Ein Storypoint ist eine eindeutige Momentaufnahme in einem Story -Blatt.
Eigenschaften
Name
getIndex()
Typ
int
Beschreibung
Ruft den nullbasierten Index dieses Storypoints im
Story-Blatt ab.
getCaption()
string Ruft den Inhalt der Textbeschreibung für diesen Storypoint ab.
getIsActive()
Bool Ruft einen Wert ab, welcher erkennen lässt, ob es sich
beim Storypoint um den derzeit aktiven Point in der
Story handelt.
getIsUpdated()
Bool Ruft einen Wert ab, der erkennen lässt, ob der Storypoint aktualisiert wurde, was bedeutet, dass seit der
letzten Erfassung des Storypoints keine Änderungen
vorgenommen wurden.
getContainedSheet Blatt Ruft das Blatt ab, das dieser Storypoint enthält. Dieser
()
Wert ist gleich Null, wenn der Storypoint kein Blatt enthält.
getParentStory()
Story Ruft das Story-Objekt ab, das diesen Storypoint enthält.
Parameter-Klassen
Parameter-Klasse
Enthält Informationen zu einem Arbeitsmappen-Parameter. Um einen Parameterwert
tatsächlich einzustellen, rufen Sie workbook.changeParameterValueAsync() auf.
Eigenschaften
Name
getName()
Typ
string
getCurrentValue()
Datenwert
Beschreibung
Ein eindeutiger, vom
Benutzer angegebener
Bezeichner.
Der aktuelle Wert des
Parameters.
- 527 -
getDataType()
ParameterDataType
getAllowableValuesT
ype()
ParameterAllowableValues
Type
getAllowableValues()
DataValue[]
getMinValue()
Datenwert
getMaxValue()
Datenwert
getStepSize()
Zahl
- 528 -
Der Parameter kann zu
einem der folgenden
Datentypen gehören:
FLOAT, INTEGER,
STRING, BOOLEAN, DATE,
DATETIME.
Die Typen zulässiger
Werte, die der Parameter
annehmen kann. Es kann
sich um eines der folgenden
Aufzählungselemente
handeln: ALL, LIST,
RANGE.
Wenn der Parameter auf
eine Liste zulässiger Werte
beschränkt ist, so enthält
diese Eigenschaft den
Array solcher Werte.
Beachten Sie, dass dies
keine Standard-Auflistung,
sondern ein JavaScriptArray ist.
Wenn
getAllowableValuesT
ype RANGE ist, wird
hierdurch der zulässige
Mindestwert (einschließlich)
definiert. Anderenfalls ist
dieser undefiniert bzw. null.
Wenn
getAllowableValuesT
ype RANGE ist, wird
hierdurch der zulässige
Höchstwert (einschließlich)
definiert. Anderenfalls ist
dieser undefiniert bzw. null.
Wenn
getAllowableValuesT
ype RANGE ist, wird
hierdurch die Schrittgröße
des Schiebereglers der
ParameterBenutzeroberfläche
definiert. Anderenfalls ist
diese undefiniert bzw. null.
getDateStepPeriod()
PeriodType
Wenn
getAllowableValuesT
ype RANGE und
getDataType DATE oder
DATETIME ist, wird
hierdurch die im
Schieberegler der
ParameterBenutzeroberfläche
verwendete schrittweise
Datumsperiode definiert.
Anderenfalls ist diese
undefiniert bzw. null.
Filtern
Es besteht ein Unterschied zwischen dem Abfragen des vorhandenen Filterstatus und dem
Einstellen von neuen oder vorhandenen Filtern. Das Abfragen von Filtern erfolgt mittels
Worksheet.getFiltersAsync(), wodurch eine Auflistung der Filter-Klassen
zurückgegeben wird. Das Einstellen von Filtern erfolgt mittels
Worksheet.applyFilterAsync (und seiner Varianten) und ist ein Funktionsaufruf, der
nicht das Instanziieren einer Filter-Klasse erfordert.
Wenn Sie Felder in einem Filter angeben, sollten Sie dieselbe Überschrift wie in der
Benutzeroberfläche und nicht den Datenbankfeldnamen verwenden. So sollte beispielsweise
Container (die Überschrift) anstelle von Product Container (der eigentliche Feldname)
verwendet werden. Hierarchische Filter sind eine Ausnahme, da sie den vollständigen
hierarchischen Namen verwenden (z. B. [Product].[All Product].[Espresso]).
Überschriften können die optionalen Trennzeichen [] um Namen enthalten.
- 529 -
Klassendigramm
Arbeitsblatt-Klasse (Filtern)
Diese Methoden gehören zur Worksheet-Klasse und sind hier nur zur Information
aufgeführt.
Methoden
Name
getFiltersAsync()
applyFilterAsync(
fieldName: string,
values: object[] or object,
updateType:
FilterUpdateType,
options?: FilterOptions)
applyRangeFilterAsync(
fieldName: string,
range: RangeFilterOptions)
Rückgabetyp
Promise<Filter[]
>
Promise<strin
g>
Promise<strin
g>
- 530 -
Beschreibung
Ruft die Auflistung der am Blatt
angewendeten Filter auf.
Wendet einen einfachen
Kategoriefilter (ohne Datum) an.
Weitere Details zu diesen
Funktionen siehe Filterbeispiele.
Gibt den gefilterten fieldName
aus.
Wendet einen quantitativen
Filter an.Wenn ein Bereich
außerhalb der Mindest- oder
Höchstwerte der Domäne
angegeben wird, wird kein
Fehler ausgegeben und der
Befehl ist zulässig. Bei
nachfolgenden Aufrufen zu
getFiltersAsync[]
werden diese Werte
applyRelativeDateFilterAsync(
fieldName: string,
options: RelativeDateFilterOptions)
applyHierarchicalFilterAsync
(
fieldName: string,
values: object,
options: HierarchicalFilterOptions)
clearFilterAsync(fieldName:
string)
Promise<string>
Promise<string>
Promise<string>
ausgegeben, auch wenn sich
diese außerhalb der Grenzen
der Domäne befinden. Dies
entspricht dem Verhalten in
Tableau Desktop.
Wendet einen relativen Datumsfilter an.
Wendet eine hierarchischen Filter an. Beim Werteparameter
handelt es sich entweder um
einen einzelnen Wert, ein
Werte-Array oder ein Objekt
{Ebenen: ["1", "2"] }.
Bereinigt den Filter unabhängig
vom Filtertyp. Beachten Sie,
dass der Filter entfernt wird,
solange kein zugehöriger
Schnellfilter zu dem Feld angezeigt wird. Wird ein Schnellfilter
angezeigt, so wird dieser Filter
beibehalten, jedoch doch auf
den Status "Alle" zurückgesetzt
(was einer Entfernung des Filters entspricht). Bei relativen
Datenfilter wird jedoch ein Fehler angezeigt, da es den Status
"Alle" für relative Datenfilter
nicht gibt. Um einen relativen
Datenfilter mit einem angezeigten Schnellfilter aufzuheben, können Sie
applyRelativeDateFilter()
aufrufen, anstatt eines ausschließlich auf das spezielle
Feld bezogenen Bereich zu verwenden.
FilterOptions-Datensatz
Wird zur Steuerung erweiterter Filteroptionen in die Methode applyFilter übertragen.
- 531 -
Felder
Name
isExcludeMode
Typ
Bool
Beschreibung
Legt fest, ob der Filter im
ausschließenden oder
einschließenden Modus
angewandt wird.
Standardmäßig ist der
einschließende Modus
eingestellt, sodass Sie die
Felder als Teil des Filters
verwenden. Der
ausschließende Modus,
beinhaltet, dass alles außer
den angegebenen Feldern
einbezogen ist.
RangeFilterOptions-Datensatz
Wird zur Steuerung erweiterter Filteroptionen in die Methode applyRangeFilterAsync
übertragen.
Felder
Name
min
Typ
Ganzzahl
max
int
nullOption
NullOption
Beschreibung
Mindestwert für den Bereich
(einschließlich).
Optional.Lassen Sie diese
Option leer, wenn Sie einen
Filter des Typs <=
wünschen.
Höchstwert für den Bereich
(einschließlich). Optional.
Lassen Sie diese Option
leer, wenn Sie einen Filter
des Typs >= wünschen.
Die einzubeziehenden
Nullwerte.
RelativeDateFilterOptions-Datensatz
Wird zur Steuerung erweiterter Filteroptionen in die Methode
applyRelativeDateFilterAsync übertragen.
Felder
Name
anchorDate
periodType
rangeType
Typ
Datum
PeriodType
DateRangeType
Beschreibung
Das UTC-Datum, ab dem gefiltert werden soll.
Jahr, Quartal, Monat usw.
LAST, LASTN, NEXT usw.
- 532 -
rangeN
int
Die Zahl, die beim rangeType LASTN oder
NEXTN verwendet wird.
Filterklasse
Eine abstrakte Basisklasse aller verschiedenen Filtertypen.
Eigenschaften
Name
getWorksheet
()
getFilterType
()
getFieldName
()
Typ
Beschreibung
Arbeitsblatt Ruft das übergeordnete Arbeitsblatt ab
FilterType
string
Ruft den Filtertyp ab. Die Werte in der Aufzählung
finden Sie unter Filtertyp Aufzählung.
Ruft den Namen des aktuell gefilterten Felds ab.
Beachten Sie, dass es sich hierbei um die in der
Benutzoberfläche angezeigte Überschrift und nicht um
den tatsächlichen Datenbank-Feldnamen handelt.
Methoden
Name
getFieldAsync()
Rückgabetyp
Promise<Field>
Beschreibung
Ruft das derzeit gefilterte Feld ab.
NullOption Enum
Eine Aufzählung, aus der der Umgang mit Nullwerten für den Aufruf eines bestimmten Filters
oder einer Markierungsauswahl hervorgeht.
Aufzählung
Name
NULL_VALUES
NON_NULL_VALUES
ALL_VALUES
Beschreibung
Es werden nur Nullwerte in den Filter einbezogen.
Es werden nur Nullwerte in den Filter einbezogen.
Nullwerte und Nicht-Nullwerte in den Filter einbeziehen.
Kategoriefilter-Klasse
Eigenschaften
Name
Typ
getIsExcludeMode Bool
()
getAppliedValues
()
Beschreibung
Ruft einen Wert ab, der erkennen lässt, ob der
Filter ausschließend oder einschließend
(Standard) ist.
DataValue Ruft die Aufzählung der gegenwärtig für den Filter
[]
eingestellten Werte auf. Beachten Sie, dass dies
ein natives JavaScript-Array und keine
aufgeschlüsselte Auflistung ist.
- 533 -
Quantitative Filterklasse
Eigenschaften
Name
getDomainMin()
Typ
Beschreibung
Datenwert Ruft den Mindestwert wie in der Domäne
angegeben ab.
getDomainMax()
Datenwert Ruft den Höchstwert wie in der Domäne
angegeben ab.
getMin()
Datenwert Ruft den einschließlichen, auf den Filter
angewandten Mindestwert ab.
getMax()
Datenwert Ruft den einschließlichen, auf den Filter
angewandten Höchstwert ab.
getIncludeNullValues Bool
Zeigt an, ob Nullwerte im Filter enthalten sind.
()
RelativeDateFilter-Klasse
Eigenschaften
Name
Typ
getPeriod() PeriodType
Beschreibung
Der Datumszeitraum des Filters. PeriodTypeDie
Werte in der Aufzählung finden Sie unter Filtertyp
Aufzählung.
getRange() DateRangeType Der Bereich des Datumsfilters (Jahre, Monate usw.)
Die Werte in der Aufzählung finden Sie unter
DateRangeType Aufzählung.
getRangeN Ganzzahl
Wenn getRange LASTN oder NEXTN ausgibt, ist
()
dies der N-Wert (Anzahl Jahre, Monate usw.).
DataValue-Datensatz
Ein Datenwert enthält sowohl den Rohwert als auch den formatierten Wert eines Filters oder
Parameters. Datenwerte werden immer als UTC-Daten ausgegeben.
Felder
Name
value
Typ
Beschreibung
Objekt Enthält den nativen Rohwert als JavaScript-Typ, der Zeichenfolge, Anzahl, Boolescher Wert oder Datum sein
kann.
formattedValue string Der entsprechend dem Gebietsschema formatierte Wert,
dessen Formatierung auf das Feld oder den Parameter
übertragen wurde.
Filtertyp Aufzählung
Eine Aufzählung der gültigen, anwendbaren Filtertypen.
- 534 -
Aufzählung
Name
CATEGORICAL
Beschreibung
Kategoriefilter werden zum Filtern eines Wertesatzes innerhalb
der Domäne eingesetzt.
QUANTITATIVE Quantitative Filter werden zum Filtern eines Wertebereichs aus
einer fortlaufenden Domäne eingesetzt.
HIERARCHICAL Hierarchische Filter werden zum Filtern eines in einer Hierarchie
angeordneten Wertesatzes innerhalb der Domäne eingesetzt.
RELATIVE_
Relative Datenfilter werden zum Filtern eine DatumsDATE
/Zeitdomäne auf einen Wertebereich in Bezug auf einen festen
Zeitpunkt verwendet.
FilterUpdateType Aufzählung
Eine Aufzählung der gültigen, anwendbaren Filtertypen.
Aufzählung
Name
ALL
Beschreibung
Fügt alle Werte zum Filter hinzu.Entspricht der Auswahl des Werts (Alle)
bei einem Schnellfilter.
REPLACE Ersetzt die aktuellen Filterwerte durch neue, im Abruf festgelegte
Filterwerte.
ADD
Fügt die Filterwerte wie im Abruf festgelegt zum Abruf der aktuellen
Filterwerte hinzu. Entspricht der Auswahl eines Werts bei einem
Schnellfilter.
REMOVE
Entfernt die Filterwerte wie im Abruf festgelegt aus dem Abruf der
aktuellen Filterwerte. Entspricht der Aufhebung der Auswahl eines
Werts bei einem Schnellfilter.
PeriodType Auszählung
Eine Aufzählung eines in Filtern und Parametern verwendeten Datumszeitraums.
Aufzählung
Name
YEARS
QUARTER
S
MONTHS
WEEKS
DAYS
HOURS
MINUTES
SECONDS
- 535 -
DateRangeType Aufzählung
Eine Aufzählung der gültigen Datumsbereiche für einen relativen Datumsfilter.
Aufzählung
Name
LAST
Beschreibung
Bezieht sich auf den letzten Tag, die letzte Woche, den letzten Monat
usw. des Datumszeitraums.
LASTN
Bezieht sich auf die letzten N Tage, Wochen, Monate usw. des
Datumszeitraums.
NEXT
Bezieht sich auf den Folgetag, die Folgewoche, den Folgemonat usw.
des Datumszeitraums.
NEXTN
Bezieht sich auf die nächsten N Tage, Wochen, Monate usw. des
Datumszeitraums.
CURRENT Bezieht sich auf den aktuellen Tag, die aktuelle Woche, den aktuellen
Monat usw. des Datumszeitraums.
TODATE
Bezieht sich auf alles bis einschließlich dem aktuellen Tag, der aktuellen
Woche, dem aktuellen Monat usw. des Datumszeitraums.
Markierungsauswahl
Das Auswählen von Markierungen ist nahezu identisch mit dem Filtern. Zum Filtern
verwenden Sie eine der Worksheet.applyFilterAsync()-Methoden. Zum Auswählen
von Markierungen verwenden Sie Worksheet.selectMarksAsync(). Die Parameter zur
Markierungsauswahl sind mit denen zur Filterung fast identisch. Hierdurch ergibt sich eine
sehr überschaubare, einfach zu erlernende und konsistente Methode zur Umsetzung der
beiden gängigsten Anwendungsfälle für die API: Filtern und Auswahl.
Arbeitsblatt-Klasse (Auswählen von Markierungen)
Diese Methoden gehören zur Worksheet class und sind hier nur zur Information
aufgeführt.
Methoden
Name
Rückgabetyp
clearSelectedMarksAsync ungültig
()
getSelectedMarksAsync() Promise<Mark
[]>
selectMarksAsync(
ungültig
fieldName: string,
value: object or object[],
updateType:
SelectionUpdateType)
selectMarksAsync(
ungültig
fieldValuesMap: object,
updateType:
Beschreibung
Löscht die Auswahl zu diesem
Arbeitsblatt.
Ruft die Aufzählung der gegenwärtig
ausgewählten Markierungen auf.
Wählt die Markierungen aus und gibt
diese aus.
Ermöglicht die Auswahl auf
Grundlage dieser Syntax für den
ersten Parameter.
- 536 -
SelectionUpdateType)
selectMarksAsync(
marks: Mark[],
updateType:
SelectionUpdateType)
{
"Field1": value,
"Field2"[1, 2, 3]
}
ungültig
Markierungsklasse
Eine Markierung stellt einen einzelnen Datenpunkt auf der Visualisierung dar. Dies gilt
unabhängig vom Typ der Visualisierung (Balken, Linie, Kreisdiagramm usw.).
Konstruktor
Signatur
Beschreibung
Mark(pairs: Pair[]) Erstellt einen neuen Markscode mit den angegebenen Paaren.
Eigenschaften
Name
Typ Beschreibung
getPairs Pair Ruft eine Aufzählung des mit der Markierung verbundenen
()
[]
Feldnamens bzw. der Wertepaare auf.
Paarklasse
Ein Paar enthält einen Feldnamen und einen Wert (Rohwerte und formatierte Werte).
Konstruktor
Signatur
Pair(fieldName: string,
value: object)
Beschreibung
Erstellt ein neues Pair mit dem angegebenen
Feldnamen/der Wertepaarung.
Felder
Name
fieldName
value
Typ
Beschreibung
string Der Feldname, auf den der Wert angewendet wird.
Objekt Enthält den nativen Rohwert für das Feld als JavaScriptTyp, der Zeichenfolge, Anzahl, Boolescher Wert oder
Datum sein kann.
formattedValue string Der entsprechend dem Gebietsschema formatierte Wert,
dessen Formatierung auf das Feld übertragen wurde.
SelectionUpdateType Auszählung
Eine Aufzählung der gültigen, durchführbaren Markierungsauswahltypen.
Aufzählung
Name
Beschreibung
REPLACE Ersetzt die aktuellen Markierungswerte durch neue, im Abruf festgelegte
Markierungswerte.
- 537 -
ADD
REMOVE
Fügt die Werte wie im Abruf festgelegt zur aktuellen Auswahl hinzu.
Entspricht der Kombination Strg+Mausklick in Desktop.
Entfernt die Werte wie im Abruf festgelegt aus der aktuellen
Auswahl.Entspricht der Kombination Strg+Mausklick auf eine bereits
ausgewählte Markierung in Desktop.
Weitere Klassen
Größen-Datensatz
Stellt die Breite und Höhe in Pixeln dar Dies wird als ein reines JavaScript-Objekt
implementiert (es handelt sich nicht um eine Klasse).
Felder
Name
width
height
Typ
int
int
Beschreibung
Wird in Pixeleinheiten ausgedrückt.
Wird in Pixeleinheiten ausgedrückt.
Punktdatensatz
Stellt eine X/Y-Koordinate in Pixeln dar.Dies wird als ein reines JavaScript-Objekt
implementiert (es handelt sich nicht um eine Klasse).
Felder
Name
x
y
Typ
Ganzzahl
Ganzzahl
Beschreibung
Wird in Pixeleinheiten ausgedrückt.
Wird in Pixeleinheiten ausgedrückt.
- 538 -
REST API
Mit der Tableau Server REST API können Sie Tableau Server-Ressourcen
programmgesteuert via HTTP verwalten und ändern. Mit der API haben Sie bequemen Zugriff
auf die Funktionalität hinter den Datenquellen, auf Projekte, Arbeitsmappen, Site-Benutzer
und Sites auf einem Tableau-Server. Über diesen Zugriff können Sie Ihre eigenen
benutzerdefinierten Anwendungen oder Skripts für Interaktionen mit Tableau ServerRessourcen erstellen. Weitere Informationen finden Sie in den folgenden Themen:
Anforderungen
Die Anforderungen für die Verwendung der Tableau Server REST API lauten wie folgt:
Tableau Server: Für die Programmierung mit der REST API benötigen Sie Tableau ServerVersion 8.3 oder höher.
API aktiviert: Tableau Server wird standardmäßig mit deaktivierter REST API installiert.
Bevor Sie die API verwenden können, aktivieren Sie sie anhand des folgenden Verfahrens.
Aktivieren der REST API
Nachdem Sie Tableau Server installiert haben, aktivieren Sie die REST API, indem Sie die
folgenden Schritte ausführen:
1. Öffnen Sie auf dem Computer, auf dem Tableau Server installiert ist, eine
Eingabeaufforderung als Administrator, und navigieren Sie zum Bin-Verzeichnis von
Tableau Server. Beispiel:
Program Files\Tableau\Tableau Server\8.3\bin
2. Beenden Sie Tableau Server.
tabadmin stop
3. Geben Sie den folgenden Befehl ein, um die API zu aktivieren:
tabadmin set api.server.enabled true
4. Propagieren Sie die Änderung:
tabadmin configure
5. Starten Sie Tableau Server.
tabadmin start
Der von Ihnen erstellte Anwendungscode kann sich auf einem beliebigen Computer
befinden, solange er HTTP-Anfragen an einen Computer stellen kann, auf dem Tableau
Server installiert ist.
- 539 -
Concepts
Dieses Thema ist für Benutzer bestimmt, die sich mit REST APIs und der Nutzung von
Tableau Server auskennen.
Komponenten eines Aufrufs
Ein Tableau Server REST API-Aufruf umfasst Folgendes:
l
HTTP-Methode: Es gibt vier Methoden: GET, POST, PUT und DELETE.
l
Tableau Server-URI: Die URI ist die Serverressource, für die eine Aktion erfolgt.
l
Parameter: Die URI kann einen oder mehrere Parameter enthalten.
l
Nachrichtennutzlast: Für POST- und PUT-Aufrufe ist normalerweise eine XMLNachrichtennutzlast erforderlich, die Eingaben oder Hinzufügungen für den Server
enthält. Für GET- und DELETE-Aufrufe ist keine Nachrichtennutzlast erforderlich.
Nimmt man den Aufruf zum Abfragen von Datenquellen als Beispiel (GET
/api/2.0/sites/site-id/datasources), lauten die Komponenten wie folgt:
l
HTTP-Methode: GET
l
Tableau Server-URI: /api/2.0/sites/site-id/datasources
l
Parameter: site-id. Dient der eindeutigen Site-Identifikation für Tableau Server.
l
Nachrichtennutzlast: Keine. Da Sie keine Eingabe oder Hinzufügung für Tableau
Server-Ressourcen bereitstellen, existiert für diesen Aufruf keine Nachrichtennutzlast.
In Reaktion auf den oben genannten Aufruf gibt Tableau Server zweierlei zurück: einen
Statuscode und eine Antwortnutzlast.
Bei dem Statuscode, beispielsweise 200 (Erfolg), handelt es sich um einen standardmäßigen
HTTP-Rückgabewert. Für jeden Aufruf in der REST API-Referenz werden alle möglichen
Fehlercodes aufgelistet. Die Antwortnutzlast gibt Ihre Anfrage als XML-Nachricht zurück. Für
den oben genannten Aufruf würde es sich bei der Antwortnutzlast um eine Liste mit
Datenquellen für die Site handeln. In der Referenz wird die Antwortnutzlast von jedem Aufruf
aufgelistet. Weitere Informationen finden Sie unter XML-Schema.
Anmelden
Für die Tableau Server REST API muss bei jedem API-Aufruf ein Authentifizierungstoken
gesendet werden. Das Token sollte mit allen Anfragen gesendet und X-Tableau-Auth
sollte als Kopfzeile verwendet werden. Beispiel:
Content-Typ: text/xml
X-Tableau-Auth: d14a028c2a3a2bc9476102bb288234c4
Sie können ein Token abrufen, indem Sie einen Anmeldungsaufruf abschließen und das
Token aus der Antwortnutzlast analysieren.Das Token sollte in der Anwendungslogik
gespeichert und bis zum Ende der Sitzung wiederverwendet werden. Ein Beispielcode ist in
- 540 -
der Datei example.py enthalten. Er veranschaulicht einen Aufruf zur Anmeldung und das
Analysieren des zurückgegebenen Tokens.
Mit einem Aufruf zum Abmelden wird die Sitzung beendet, und das Token wird ungültig.
XML-Schema
Einige API-Aufrufe geben eine Antwortnutzlast für die angeforderte Ressource im XMLFormat zurück. Die Antwortnutzlast kann analysiert und in der Anwendungslogik Ihres Codes
verwendet werden.
Ein XML-Schema für die gesamte API befindet sich in der Datei ts-rest-api.xsd. Für APIAufrufe mit erforderlicher XML-Antwortnutzlast muss der XML-Code ordnungsgemäß
formatiert sein und dem Schema in ts-rest-api.xsd entsprechen.
LUIDs
LUIDs (Locally Unique Identifiers) werden in der gesamten REST API zum Identifizieren von
Ressourcen für Tableau Server verwendet. LUIDs sind aus 32 Zeichen bestehende, durch
Bindestriche getrennte Zeichenfolgen im Format 'XXXXXXXX-XXXX-XXXX-XXXXXXXXXXXXXXXX'. Die IDs werde von bestimmten Abfragemethoden zurückgegeben und
können mit zusätzlichen Aufrufen für die Ressource verkettet werden. Beispielsweise kann die
Benutzr-ID durch Ausstellen des Aufrufs zum Abrufen der Site-Benutzer und Analysieren des
Benutzers und der Benutzer-ID abgerufen werden. Die Benutzer-ID und die Site-ID
entsprechen nicht dem Benutzernamen und der ID, die auf der Tableau ServerBenutzeroberfläche verwendet werden.
Beispiel und Schema
In Tableau werden zwei Dateien bereitgestellt, die Sie bei der Verwendung der REST API
unterstützen.
Beispielcode-Datei: Der Code in der Datei example.py veranschaulicht die Verwendung der
REST API zum Ausführen eines Anmeldungsaufrufs und Analysieren des zurückgegebenen
Tokens.
XML-Schemadatei: Das XML-Schema für die gesamte REST API befindet sich in der Datei
ts-rest-api.xsd.
API-Referenz
Mit der Tableau Server REST API können Sie Tableau Server-Ressourcen
programmgesteuert via HTTP verwalten und ändern. Mit der API haben Sie bequemen Zugriff
auf die Funktionalität hinter den Datenquellen, auf Projekte, Arbeitsmappen, Site-Benutzer
und Sites auf einem Tableau-Server. Über diesen Zugriff können Sie Ihre eigenen
benutzerdefinierten Anwendungen oder Skripts für Interaktionen mit Tableau ServerRessourcen erstellen.
- 541 -
Bevor Sie die Tableau Server REST API verwenden können, müssen Sie sie aktivieren.
Informationen zu den entsprechenden Schritten finden Sie unter Aktivieren der API.
Anmelden
Als Tableau Server-Administrator anmelden
Beschreibung
Meldet Sie als Tableau Server-Systemadministrator an. Für
Produktionsumgebungen wird eine Anmeldung via HTTPS empfohlen.
Methode und
URI
POST /api/2.0/auth/signin
Nachrichtennutzlast:
<tsRequest>
<credentials name="admin-username" password="adminpassword" >
<site contentUrl="target-site-content-URL" />
</credentials>
</tsRequest>
Antwortcode
200
Antwortnutzlast
<tsResponse>
<credentials token="admin-user-authenticity-token"
>
<site contentUrl="target-site-content-URL" />
</credentials>
</tsResponse>
Als Tableau Server-Benutzer anmelden
Beschreibung
Methode und
URI
Meldet Sie als Tableau Server-Benutzer an. Für Produktionsumgebungen
wird eine Anmeldung via HTTPS empfohlen.
POST /api/2.0/auth/signin
Nachrichtennutzlast
<tsRequest>
<credentials name="admin-username" password="adminpassword" >
<site contentUrl="target-site-content-URL" />
<user id="user-to-run-as" />
</credentials>
</tsRequest>
Antwortcode
200
Antwortnutzlast
<tsResponse>
<credentials token="run-as-user-token" >
- 542 -
<site contentUrl="target-site-content-URL" />
</credentials>
</tsResponse>
Datendetails
Das <site>-Element in der Anfrage ist erforderlich, um die Site anzugeben, bei der der
Benutzer angemeldet wird. Wenn das <site>-Element in der Anfrage leer ist, wird die
Standard-Site verwendet:
<site />
Die Standard-Site kann auch mit leeren Anführungszeichen angegeben werden:
<site contentUrl="" />
Das <site>-Element wird in der Antwort immer ausgefüllt.
Fehlerbedingungen
HTTP-Reaktions-Code
401
Bedingung
Anmeldefehler
403
Nicht-Administratoranmeldung verboten
404
Benutzer wurde nicht gefunden
- 543 -
Details
Der Name oder das
Passwort ist für die
angegebene Site
ungültig, oder die URL
für den Site-Inhalt ist
ungültig.
Es wurde versucht,
einen Benutzer (keinen Administrator)
direkt mithilfe der
Anmeldeinformationen
des Benutzers anzumelden. Tableau Server-Benutzer können
nur indirekt über die
Anmeldeinformationen
eines Administrators
angemeldet werden.
Die in der Nutzlast für
eine Benutzeranmeldung angegebene Benutzer-ID
entspricht keinem vorhandenen Benutzer in
der Site.
405
Ungültige Anforderungsmethode
Der Abfragetyp war
nicht POST.
Abmelden
Beschreibung
Meldet Sie von der aktuellen Sitzung ab und macht das
Token ungültig.
Methode und URI
POST /api/2.0/auth/signout
Nachrichtennutzlast
Keine
Antwortcode
204
Antwortnutzlast
Keine
Fehlerbedingungen
HTTP-Reaktions-Code
405
Bedingung
Ungültige Anforderungsmethode
Details
Der Abfragetyp
war nicht POST.
Datenquellen abfragen
Beschreibung
Methode und URI
Gibt eine Liste mit Datenquellen an der angegebenen Site zurück und
umfasst optionale Parameter zur Angabe der Auslagerung für
umfangreiche Ergebnisse.
GET /api/2.0/sites/site-id/datasources
GET /api/2.0/sites/siteid/datasources?pageSize=pagesize&pageNumber=page-number
Nachrichtennutzlast
Keine
- 544 -
Antwortcode
200
Antwortnutzlast
<tsResponse>
<pagination pageNumber="pageNumber"
pageSize="page-size"
totalAvailable="total-available" />
<datasources>
<datasource id="datasource1-id"
name="datasource1-name"
type="datasource1-type" >
<project id="project-id" name="project-name"
/>
<tags>
<tag label="tag1"/>
<tag label="tag2"/>
... more tags ...
</tags>
</datasource>
<datasource id="datasource2-id"
name="datasource2-name"
type="datasource2-type" >
<project id="project-id" name="project-name"
/>
<tags>
<tag label="tag3"/>
... more tags ...
</tags>
</datasource>
... more datasources ...
</datasources>
</tsResponse>
Geschäftslogik und Fehlerbedingungen
Benutzerzugriff durch Nicht-Administrator
Tableau Server-Benutzer, bei denen es sich nicht um Administratoren handelt, können auf
diese API-Methode zugreifen, sie können jedoch lediglich Datenquellen anzeigen, für die die
Funktion Verbinden zulässig ist (explizit oder implizit).
Standardwerte für die Paginierungsparameter
Standardmäßig ist die Seitengröße 100 und Seite 1 wird bereitgestellt.Einer oder beide
Parameter können explizit überschrieben werden.
Fehlerbedingungen
HTTP-Reaktions-Code
400
Bedingung
Ungültige Seitengröße
- 545 -
Details
Der Seitengrößenparameter
ist keine ganze Zahl oder
400
Ungültige Seitennummer
404
Site wurde nicht gefunden
405
Ungültige Anforderungsmethode
kleiner als eins.
Der Seitennummernparameter
ist keine ganze Zahl, kleiner als
eins oder größer als die finale
Seitennummer für
Datenquellen mit der
angeforderten Seitengröße.
Die in der URI angegebene
Site-ID entspricht keiner
vorhandenen Site.
Der Abfragetyp war nicht GET.
Datenquelle abfragen
Beschreibung
Methode und URI
Gibt Metadaten zu einer speziellen Datequelle zurück.
GET /api/2.0/sites/siteid/datasources/datasource-id
Nachrichtennutzlast
Keine
Antwortcode
200
Antwortnutzlast
<tsResponse>
<datasource id="datasource-id"
name="some-name"
type="some-type" >
<project id="project-id" name="project-name" />
<tags>
<tag label="tag1"/>
<tag label="tag2"/>
... more tags ...
</tags>
</datasource>
</tsResponse>
Geschäftslogik und Fehlerbedingungen
Benutzerzugriff durch Nicht-Administrator
Tableau Server-Benutzer, bei denen es sich nicht um Administratoren handelt, können auf
diese API-Methode zugreifen, sie können jedoch lediglich Datenquellen anzeigen, für die die
- 546 -
Funktion Verbinden zulässig ist (explizit oder implizit).
Fehlerbedingungen
Bedingung
403
HTTP-Reaktions-Code
Lesen nicht zulässig
404
Site wurde nicht gefunden
404
Datenquelle nicht gefunden
405
Ungültige Anforderungsmethode
Details
Ein Nicht-Administratorbenutzer hat die
API-Methode aufgerufen und
versucht, eine Datenquelle
abzufragen, für die er keine
Berechtigung zum Verbinden hatte.
Die in der URI angegebene
Site-ID entspricht keiner
vorhandenen Site.
Die in der URI angegebene
Datenquellen-ID entspricht
keiner vorhandenen
Datenquelle.
Der Abfragetyp war nicht
GET.
Projekt erstellen
Beschreibung
Methode und URI
Erstellt ein Projekt an der angegebenen Site.
POST /api/2.0/sites/site-id/projects
Nachrichtennutzlast
<tsRequest>
<project name="project-name"
description="project-description" />
</tsRequest>
Antwortcode
201
Antwortnutzlast
<tsResponse>
<project id="new-project-id"
name="project-name”
description="project-description"
</tsResponse>
Antwortkopfzeilen
/>
Location: /api/2.0/sites/site-id/projects/new-project-id
- 547 -
Datendetails
Für diesen Vorgag ist das project-name-Attribut erforderlich; das projectdescription-Attribut ist optional.
Fehlerbedingungen
HTTP-Reaktions-Code
404
Bedingung
Site wurde nicht gefunden
405
Ungültige Anforderungsmethode
Projektnamenkonflikt
409
Details
Die in der URI angegebene
Site-ID entspricht keiner
vorhandenen Site.
Der Abfragetyp war nicht
POST.
Der Projektname in der
Anforderung gehört bereits
zu der entsprechenden Site
im System.Bei
Überprüfungen der
Eindeutigkeit wird bei
Projektnamen die Groß/Kleinschreibung nicht
unterschieden.
Porjekt löschen
Beschreibung
Methode und URI
Löscht das angegebene Projekt an einer spezifischen Site.
DELETE/api/2.0/sites/siteid/projects/project-id
Nachrichtennutzlast
Keine
Antwortcode
204
Antwortnutzlast
Keine
Geschäftslogik und Fehlerbedingungen
Beim Löschen eines Projekts im System werden auch alle zugehörigen Objekte gelöscht:
verknüpfte Arbeitsmappen, Datenquellen, Projektansichtsoptionen und Rechte. Seien Sie
- 548 -
vorsichtig, wenn Sie diese Methode anwenden.
Fehlerbedingungen
HTTP-Reaktions-Code
403
Bedingung
Löschen nicht zulässig
404
Site wurde nicht gefunden
404
Projekt wurde nicht gefunden
405
Ungültige Anforderungsmethode
Details
Versuchen Sie, das nicht
löschbare Standardprojekt
zu löschen.
Die in der URI angegebene
Site-ID oder der
angegebene URLNamespace entspricht
keiner vorhandenen Site.
Entweder entspricht die in
der URI angegebene
Projekt-ID keinem
vorhandenen Projekt, oder
das Projekt kann in dieser
Site nicht gefunden
werden.
Der Abfragetyp war nicht
DELETE.
Projekt aktualisieren
Beschreibung
Methode und URI
Aktualisiert den Namen oder die Beschreibung des
angegebenen Projekts.
PUT /api/2.0/sites/siteid/projects/project-id
Nachrichtennutzlast
<tsRequest>
<project name="some-new-name"
description="some-new-description" />
</tsRequest>
Antwortcode
200
Antwortnutzlast
<tsResponse>
<project name="some-name"
description=”some-description” />
</tsResponse>
- 549 -
Geschäftslogik und Fehlerbedingungen
Datenabweichungen
Eine beliebige Kombination der Attribute im <project>-Element ist gültig. Nur vorhandene
Attribute führen zu Aktualisierungen der zugehörigen Werte im Projekt. Wenn keine Attribute
vorhanden sind, hat die Aktualisierung keinen Effekt.
HTTP-Reaktions-Code
403
Bedingung
Aktualisierung verboten
404
Site wurde nicht gefunden
404
Projekt wurde nicht gefunden
404
Falsche Zuordnung der Projekt-ID
405
Ungültige Anforderungsmethode
Projektnamenkonflikt
409
Details
Versuchen Sie, das
Standardprojekt
umzubenennen.
Die in der URI angegebene
Site-ID entspricht keiner
vorhandenen Site.
Die in der URI angegebene
Projekt-ID entspricht keinem vorhandenen Projekt.
Die Nutzlast enthält eine
Projekt-ID (optional), und
sie stimmt nicht mit der ID in
der URI überein.
Der Abfragetyp war nicht
PUT.
Der Projektname in der
Anforderung gehört bereits
zu der entsprechenden Site
im System.Bei Überprüfungen der Eindeutigkeit
wird bei Projektnamen die
Groß-/Kleinschreibung
nicht unterschieden.
Tags zur Arbeitsmappe hinzufügen
Beschreibung
Methode und URI
Fügt der angegebenen Arbeitsmappe ein oder mehrere
Tags hinzu.
PUT /api/2.0/sites/siteid/workbooks/workbook-id
- 550 -
Nachrichtennutzlast
<tsRequest>
<workbook id="workbook-id">
<tags>
<tag label="tag1" />
<tag label="tag2" />
... more tags ...
</tags>
</workbook>
</tsRequest>
Antwortcode
200
Antwortnutzlast
<tsResponse>
<workbook id="workbook-id"
name="workbook-name"
>
<project id="project-id"
name="project-name" />
<tags>
<tag label="tag1"/>
<tag label="tag2"/>
... more tags ...
</tags>
<views>
<view id="view1-id" />
<view id="view2-id" />
... more views ...
</views>
</workbook>
</tsResponse>
Datendetails
Wenn die Arbeitsmappe bereits mit Tags in der Nutzlast gekenzeichnet ist, werden diese Tags
ignoriert, und die Arbeitsmappe behält sie bei. Wenn das Tag-Element leer ist, werden der
Arbeitsmappe keine neuen Tags hinzugefügt.
Geschäftslogik und Fehlerbedingungen
Nicht-Administratorzugriff
Tableau Server-Benutzer, die keine Administratoren sind, können diese Methode zwar
anwenden, sie können Tags jedoch nur Arbeitsmappen hinzufügen, für die sie über die
Berechtigung Tag hinzufügen verfügen (explizit oder implizit).
HTTP-Reaktions-Code
403
Bedingung
Details
Hinzufügen von Tags verboten Ein Tableau ServerBenutzer, der kein
- 551 -
404
Site wurde nicht gefunden
404
Arbeitsmappe wurde nicht
gefunden
404
Falsche Arbeitsmappen-IDZuordnung
405
Ungültige Anforderungsmethode
Administrator ist, hat die
API-Methode aufgerufen
und versucht, ein Tag für
eine Arbeitsmappe
hinzuzufügen, für die er die
Berechtigung Tag
hinzufügen nicht hatte.
Dieser Fehler wird
ausgelöst, wenn das tagsElement leer ist.
Die in der URI angegebene
Site-ID entspricht keiner
vorhandenen Site.
Die in der URI angegebene
Arbeitsmappen-ID entspricht keiner vorhandenen
Arbeitsmappe.
Die Nutzlast umfasst eine
Arbeitsmappen-ID (optional) und stimmt nicht mit der
ID in der URI überein.
Der Abfragetyp war nicht
PUT.
Tag aus Arbeitsmappe löschen
Beschreibung
Methode und URI
Löscht ein Tag aus der angegebenen Arbeitsmappe.
DELETE /api/2.0/sites/siteid/workbooks/workbook-id/tags/tagname
Nachrichtennutzlast
Keine
Antwortcode
204
Antwortnutzlast
Keine
- 552 -
Geschäftslogik und Fehlerbedingungen
Nicht-Admin-Benutzerzugriff
Tableau Server-Benutzer, die keine Administratoren sind, können zwar auf diese APIMethode zugreifen, sie können Tags jedoch nur aus Arbeitsmappen löschen, für die sie implizit
über die Funktionsberechtigung verfügen (d. h. als Eigentümer der Arbeitsmappe).
HTTP-Reaktions-Code
403
Bedingung
Löschen von Tags verboten
404
Site wurde nicht gefunden
404
Arbeitsmappe wurde nicht
gefunden
404
Tag nicht gefunden
405
Ungültige Anforderungsmethode
Details
Ein Tableau ServerBenutzer, der kein
Administrator ist, hat die
API-Methode aufgerufen
und versucht, ein Tag aus
einer Arbeitsmappe zu
löschen, für die er keine
implizite
Funktionsberechtigung
hatte.
Die in der URI angegebene
Site-ID oder der
angegebene URLNamespace entspricht
keiner vorhandenen Site.
Die in der URI angegebene
Arbeitsmappen-ID entspricht keiner vorhandenen
Arbeitsmappe.
Das in der URI angegebene Tag ist für die angegebene Arbeitsmappe nicht
vorhanden.
Der Abfragetyp war nicht
DELETE.
Arbeitsmappe abfragen
Beschreibung
Gibt Metadaten zu der angegebenen Arbeitsmappe zurück,
optional inklusive Miniaturansicht.
- 553 -
Methode und URI
GET /api/2.0/sites/siteid/workbooks/workbook-id
GET /api/2.0/sites/siteid/workbooks/workbookid?previewImage=false
Nachrichtennutzlast
Keine
Antwortcode
200
Antwortnutzlast
<tsResponse>
<workbook id="workbook-id"
name="some-name"
description="some-description" >
<project id="project-id"
name="project-name" />
<tags>
<tag label="tag1"/>
<tag label="tag2"/>
... more tags ...
</tags>
<views>
<view id="view1-id"/>
<view id="view2-id"/>
... more views ...
</views>
</workbook>
</tsResponse>
Arbeitsmappe mit Vorschaubild abfragen
Beschreibung
Methode und URI
Gibt Metadaten zu der angegebenen Arbeitsmappe zurück,
inklusive Miniaturansicht.
GET /api/2.0/sites/siteid/workbooks/workbookid?previewImage=true
Nachrichtennutzlast
Keine
Antwortcode
200
Antwortnutzlast
Identisch mit oben, eingbettet in eine mehrteilige MIMENachricht in folgendem Format:
- 554 -
MIME-Kopfzeile
XML-Nuzlast (im Format aus der vorherigen Tabelle)
Das binäre Vorschaubild.
Datendetails
Es folgt ein Beispiel des vollständigen Antwortformats. Die mehrteilige MIME-Nachricht wird in
Teilen über eine Tabelle angezeigt, und der Text der "Teilebegrenzung" wird weggelassen, da
die Tabellenzeilen angeben, wo dieses Trennzeichen erscheinen würde.
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary=interpartBoundary
Content-Type: text/xml
<tsResponse>
<workbook>
<!-- see markup example from previous section -->
</workbook>
</tsResponse>
Content-Disposition: name="myPreviewImage"; filename="foo"
Content-Transfer-Encoding: binary
Content-Type: application/octet-stream
...das Vorschaubild für die Tableau-Arbeitsmappe gehört hier hin...
Geschäftslogik und Fehlerbedingungen
Benutzerzugriff durch Nicht-Administrator
Tableau Server-Benutzer können zwar auf diese API-Methode zugreifen, sie können jedoch
nur Arbeitsmappen abfragen, für die sie über die Funktionsberechtigung Lesen verfügen
(explizit oder implizit).
HTTP-Reaktions-Code
400
Bedingung
Ungültige URI-Parameter
403
Lesen nicht zulässig
- 555 -
Details
Der previewImageParameter ist angegeben,
er hat jedoch einen anderen
Wert als true oder false.
Ein Benutzer, der kein
Administrator ist, hat die
API-Methode aufgerufen
404
Arbeitsmappe wurde nicht
gefunden
404
Site wurde nicht gefunden
405
Ungültige Anforderungsmethode
und versucht,
Arbeitsmappen
abzufragen, für die er die
Funktionsberechtigung
Lesen nicht hatte.
Die in der URI angegebene
Arbeitsmappen-ID entspricht keiner vorhandenen
Arbeitsmappe.
Die in der URI angegebene
Site-ID entspricht keiner vorhandenen Site.
Der Abfragetyp war nicht
GET.
Arbeitsmappe zu Favoriten hinzufügen
Beschreibung
Methode und URI
Fügt die angegebene Arbeitsmappe den Favoriten eines
Benutzers hinzu,
PUT /api/2.0/sites/siteid/favorites/user-id
Nachrichtennutzlast
<tsRequest>
<favorite label="favorite-label">
<workbook id="workbook-id" />
</favorite>
</tsRequest>
Antwortcode
200
Antwortnutzlast
<tsResponse>
<favorites>
<favorite label="favorite-label">
<workbook id="workbook-id" />
</favorite>
<favorite label="favorite2">
<view id="view-id" />
</favorite>
... more favorites ...
</favorites>
- 556 -
</tsResponse>
Wenn die Arbeitsmappe bereits mit derselben Kennzeichnung in den Favoriten des Benutzers
vorhanden ist, hat der Vorgang keine Auswirkung. Wenn sich die Kennzeichnung
unterscheidet, wird der ursprüngliche Favorit überschrieben.
Geschäftslogik und Fehlerbedingungen
Benutzerzugriff durch Nicht-Administrator
Tableau Server-Benutzer können zwar auf diese API-Methode zugreifen, sie können einer
Favoritenliste jedoch nur Arbeitsmappen hinzufügen, wenn sie für die Arbeitsmappe über die
Funktionsberechtigung Favorit hinzufügen verfügen (explizit oder implizit).
HTTP-Reaktions-Code
400
403
404
404
404
405
Bedingung
Ungültige Kennzeichnung
Details
Die
Favoritenkennzeichnung ist
leer oder besteht nur aus
Leerzeichen.
Zugriff auf die Favoriten nicht
Ein Tableau Serverzulässig
Benutzer hat die APIMethode aufgerufen und
versucht, ohne die
Funktionsberechtigung
Favorit hinzufügen seiner
Favoritenliste eine
Arbeitsmappe
hinzuzufügen. Dies ist
immer dann der Fall, wenn
die Benutzer-ID in der URI
einen anderen Benutzer als
den identifiziert, der die
Methode aufruft.
Benutzer wurde nicht gefunden Die in der URI angegebene
Benutzer-ID entspricht keinem vorhandenen Benutzer.
Site wurde nicht gefunden
Die in der URI angegebene
Site-ID entspricht keiner vorhandenen Site.
Arbeitsmappe wurde nicht
Die in den Daten angegefunden
gebene Arbeitsmappen-ID
entspricht keiner vorhandenen Arbeitsmappe.
Ungültige AnforDer Abfragetyp war nicht
derungsmethode
PUT.
- 557 -
409
Kennzeichnungskonflikt
Die Favoriten des angegebenen Benutzers enthalten bereits einen
Favoriten mit derselben
Kennzeichnung für eine
andere Arbeitsmappe.
Arbeitsmappe aus Favoriten löschen
Beschreibung
Löscht eine Arbeitsmappe aus den Favoriten eines
Benutzers.
Methode und URI
DELETE/api/2.0/sites/siteid/favorites/userid/workbooks/workbook-id
Nachrichtennutzlast
Keine
Antwortcode
204
Antwortnutzlast
Keine
Geschäftslogik und Fehlerbedingungen
Wenn die von Ihnen angegebene Arbeitsmappe kein Favorit ist, ist dieser Aufruf wirkungslos.
Benutzerzugriff durch Nicht-Administrator
Tableau Server-Benutzer können zwar auf diese API-Methode zugreifen, sie können eine
Arbeitsmappe jedoch nur aus ihrer eigenen Favoritenliste löschen.
Fehlerbedingungen
HTTP-Reaktions-Code
403
404
Bedingung
Zugriff auf die Favoriten nicht
zulässig
Details
Ein Tableau Server-Benutzer hat die API-Methode
aufgerufen und versucht,
eine Arbeitsmappe aus den
Favoriten eines anderen
Benutzers zu löschen.
Benutzer wurde nicht gefunden Die in der URI angegebene
Benutzer-ID entspricht keinem vorhandenen Benutzer.
- 558 -
404
Site wurde nicht gefunden
404
Arbeitsmappe wurde nicht
gefunden
404
Arbeitsmappe kein Favorit
405
Ungültige Anforderungsmethode
Die in der URI angegebene
Site-ID entspricht keiner vorhandenen Site.
Die in den Daten angegebene Arbeitsmappen-ID
entspricht keiner vorhandenen Arbeitsmappe.
Die in der URI angegebene
Arbeitsmappen-ID ist zwar
vorhanden, sie ist jedoch
kein Favorit des angegebenen Benutzers.
Der Abfragetyp war nicht
DELETE.
Ansicht mit Vorschaubild abfragen
Beschreibung
Gibt die Miniaturansicht für eine spezielle Ansicht zurück.
Methode und URI
GET /api/2.0/sites/siteid/workbooks/workbook-id/views/viewid/previewImage
Nachrichtennutzlast
Keine
Antwortcode
200
Antwortnutzlast
Das Vorschaubild der Ansicht im PNG-Format (Bild-/PNGDatei des MIME-Medientyps).
Geschäftslogik und Fehlerbedingungen
Benutzerzugriff durch Nicht-Administrator
Tableau Server-Benutzer können zwar auf diese API-Methode zugreifen, sie können jedoch
nur Arbeitsmappenansichten abfragen, für die sie über die Funktionsberechtigung Lesen
verfügen (explizit oder implizit).
Fehlerbedingungen
HTTP-Reaktions-Code
403
Bedingung
Lesen nicht zulässig
- 559 -
Details
Ein Tableau Server-Benutzer hat die API-Methode
404
Ansicht nicht gefunden
404
Site wurde nicht gefunden
404
Arbeitsmappe wurde nicht
gefunden
405
Ungültige Anforderungsmethode
aufgerufen und versucht,
eine Arbeitsmappenansicht
abzufragen, für die er die
Funktionsberechtigung
"Lesen" nicht hatte.
Die in der URI angegebene
Ansichts-ID entspricht keiner vorhandenen Ansicht in
der angegebenen Arbeitsmappe.
Die in der URI angegebene
Site-ID entspricht keiner vorhandenen Site.
Die in den Daten angegebene Arbeitsmappen-ID
entspricht keiner vorhandenen Arbeitsmappe.
Der Abfragetyp war nicht
DELETE.
Ansichten für Arbeitsmappe abfragen
Beschreibung
Methode und URI
Geben Sie alle Ansichten für die angegebene Arbeitsmappe
zurück, optional einschließlich Nutzungsstatistiken.
GET /api/2.0/sites/siteid/workbooks/workbook-id/views
GET /api/2.0/sites/siteid/workbooks/workbookid/views?includeUsageStatistics=false
Nachrichtennutzlast
Keine
Antwortcode
200
Antwortnutzlast
<tsResponse>
<views>
<view id="view1-id" name="view1-name" />
<view id="view2-id" name="view2-name" />
... more views ...
- 560 -
</views>
</tsResponse>
Ansichten mit Nutzungsstatistiken abfragen
Methode und URI
GET /api/2.0/sites/siteid/workbooks/workbookid/views?includeUsageStatistics=true
Nachrichtennutzlast
Keine
Antwortcode
200
Antwortnutzlast
<tsResponse>
<views>
<view id="view1-id" name="view1-name" >
<usage totalViewCount="total-count1" />
</view>
<view id="view2-id" name="view2-name" >
<usage totalViewCount="total-count2" />
</view>
... more views ...
</views>
</tsResponse>
Geschäftslogik und Fehlerbedingungen
Benutzerzugriff durch Nicht-Administrator
Tableau Server-Benutzer können zwar auf diese API-Methode zugreifen, sie können jedoch
nur Arbeitsmappenansichten abfragen, für die sie über die Funktionsberechtigung Lesen
verfügen (explizit oder implizit).
Fehlerbedingungen
HTTP-Reaktions-Code
400
Bedingung
Ungültiger Parameterwert
403
Lesen nicht zulässig
- 561 -
Details
includeUsageStatistics
wurde mit einem anderen Wert
als true oder false bereitgestellt
Ein Tableau Server-Benutzer
hat die API-Methode aufgerufen und versucht, Arbeitsmappen-Ansichten
abzufragen, für die er nicht
über die erforderlichen Leseberechtigungen verfügt.
404
Site wurde nicht gefunden
404
Arbeitsmappe wurde nicht
gefunden
405
Ungültige Anforderungsmethode
Die in der URI angegebene
Site-ID entspricht keiner vorhandenen Site.
Die in den Daten angegebene
Arbeitsmappen-ID entspricht
keiner vorhandenen Arbeitsmappe.
Der Abfragetyp war nicht GET.
Vorschaubild der Arbeitsmappe abfragen
Beschreibung
Gibt die Miniaturansicht für eine angegebene Arbeitsmappe
zurück.Normalerweise gehört das zurückgegebene Bild zum
ersten Blatt in der Arbeitsmappe.
Methode und URI
GET /api/2.0/sites/siteid/workbooks/workbook-id/previewImage
Nachrichtennutzlast
Keine
Antwortcode
200
Antwortnutzlast
Das Vorschaubild der Arbeitsmappe im PNG-Format (Bild/PNG-Datei des MIME-Medientyps).
Geschäftslogik und Fehlerbedingungen
Für Vor-Ort-Bereitstellungen von Tableau Server und für Tableau Public gibt das System das
Vorschaubild zurück, das dem niedrigsten Index in der Arbeitsmappe zugeordnet ist.
Benutzerzugriff durch Nicht-Administrator
Tableau Server-Benutzer können diese API-Methode zwar verwenden, sie können jedoch nur
Vorschaubilder für Arbeitsmappen abrufen, für die sie über die Funktionsberechtigung Lesen
verfügen (explizit oder implizit).
Fehlerbedingungen
HTTP-Reaktions-Code
403
Bedingung
Lesen nicht zulässig
- 562 -
Details
Ein Tableau Server-Benutzer hat die API-Methode
aufgerufen und versucht,
Arbeitsmappen-Ansichten
404
Site wurde nicht gefunden
404
Arbeitsmappe wurde nicht
gefunden
405
Ungültige Anforderungsmethode
abzufragen, für die er nicht
über die erforderlichen Leseberechtigungen verfügt.
Die in der URI angegebene
Site-ID entspricht keiner vorhandenen Site.
Die in den Daten angegebene Arbeitsmappen-ID
entspricht keiner vorhandenen Arbeitsmappe.
Der Abfragetyp war nicht
GET.
Arbeitsmappen für Benutzer abfragen
Beschreibung
Methode
und URI
Geben Sie die einem speziellen Benutzer zugeordneten Arbeitsmappen zurück,
optional einschließlich Auslagerungsparametern.
GET /api/2.0/sites/site-id/users/user-id/workbooks
GET /api/2.0/sites/site-id/users/userid/workbooks?pageSize=page-size&pageNumber=pagenumber
Nachrichtennutzlast
Antwortcode
Antwortnutzlast
Keine
200
<tsResponse>
<pagination pageNumber="pageNumber" pageSize="pagesize" totalAvailable="total-available" />
<workbooks>
<workbook id="workbook1-id"
name=”some-name” >
<project id="project-id" name="project-name" />
<tags>
<tag label="tag1"/>
<tag label="tag2"/>
- 563 -
... more tags ...
</tags>
<views>
<view id="view1-id"/>
<view id="view2-id"/>
... more views ...
</views>
</workbook>
<workbook id="workbook2-id"
name="some-name" >
<project id="project-id" name="project-name" />
<tags>
<tag label="tag1"/>
<tag label="tag2"/>
... more tags ...
</tags>
<views>
<view id="view1-id"/>
<view id="view2-id"/>
... more views ...
</views>
</workbook>
</workbooks>
... more workbooks ...
</tsResponse>
Geschäftslogik und Fehlerbedingungen
Benutzerzugriff durch Nicht-Administrator
Tableau Server-Benutzer können diese API-Methode zwar verwenden, sie können jedoch nur
Arbeitsmappen abfragen, für die sie über die Funktionsberechtigung Lesen verfügen (explizit
oder implizit).
Standardwerte für die Paginierungsparameter
Standardmäßig ist die Seitengröße 100 und Seite 1 wird bereitgestellt.Einer oder beide
Parameter können explizit überschrieben werden.
Fehlerbedingungen
HTTP-Reaktions-Code
403
Bedingung
Lesen nicht zulässig
- 564 -
Details
Ein Tableau Server-Benutzer hat die API-Methode
aufgerufen und versucht,
Arbeitsmappen-Ansichten
abzufragen, für die er nicht
über die erforderlichen Leseberechtigungen verfügt.
404
Site wurde nicht gefunden
Die in der URI angegebene
Site-ID entspricht keiner vorhandenen Site.
Benutzer wurde nicht gefunden Die in der URI angegebene
Benutzer-ID entspricht keinem vorhandenen Benutzer.
Ungültige AnforDer Abfragetyp war nicht
derungsmethode
GET.
404
405
Benutzer der Seite hinzufügen
Beschreibung
Methode und URI
Fügt der angegebenen Site einen Benutzer hinzu.
POST /api/2.0/sites/site-id/users/
Nachrichtennutzlast
<tsRequest>
<user name="user-name"
role="some-role"
publish="true-or-false"
contentAdmin="true-or-false*"
suppressGettingStarted="true-or-false" />
</tsRequest>
Antwortcode
201
Antwortnutzlast
<tsResponse>
<user id="user-id"
name="user-name"
role="some-role"
publish="true-or-false"
contentAdmin="true-or-false"
suppressGettingStarted="true-or-false" />
</tsResponse>
Antwortkopfzeilen
Location: /api/2.0/sites/site-id/users/new-user-id
+++Datendetails
Es sind drei gültige Rollen verfügbar: Interactor, Viewer und Unlicensed.
- 565 -
Der Parameter contentAdmin kann nur "true" sein, wenn die Rolle "Interactor" lautet. Für
andere Rollen wird der Wert contentAdmin in der Anfragenutzlast ignoriert, und es wird der
Wert false verwendet und anschließend in der Antwortnutzlast zurückgegeben.
Der Parameter suppressGettingStarted kann ausgelassen werden. In diesem Fall
behält der Benutzer seine vorhandene Einstellung, wenn er bereits Mitglied einer anderen Site
ist. Wenn der Benutzer neu im System ist, wird die Einstellung je nach Benutzertyp auf die
Standardeinstellung festgelegt: Sie wird für Site-Administratoren aktiviert und für andere
Benutzer unterdrückt.
Fehlerbedingungen
HTTP-Reaktions-Code
404
Bedingung
Site wurde nicht gefunden
404
Benutzername wurde nicht
gefunden
405
409
Ungültige Anforderungsmethode
Benutzerkonflikt
409
Gastbenutzerkonflikt
Details
Die in der URI angegebene
Site-ID entspricht keiner vorhandenen Site.
Der in den Daten angegebene Benutzername entspricht keinem
vorhandenen Benutzer im
System.
Der Abfragetyp war nicht
POST oder GET.
Der angegebene Benutzer
ist bereits auf der Site registriert.
Die Tableau Online API
lässt das Hinzufügen eines
Benutzers mit der Gastrolle
zu einer Site nicht zu.
Benutzer der Site abrufen
Beschreibung
Methode und
URI
Nachrichtennutzlast
Antwortcode
Gibt die Benutzer zurück, die der angegebenen Site zugeordnet sind.
GET /api/2.0/sites/site-id/users/
Keine
200
- 566 -
Antwortnutzlast
<tsResponse>
<users>
<user id="user1-id"
name="user1-name"
role="some-role"
publish="true-or-false"
contentAdmin="true-or-false"
lastLogin="YYYY-MM-DDTHH:MM:SSZ"
externalAuthUserId="authentication-id-from-external-provider"/>
<user id="user2-id"
name="user2-name"
role="some-role"
publish="true-or-false"
contentAdmin="true-or-false"
lastLogin="YYYY-MM-DDTHH:MM:SSZ"
externalAuthUserId="authentication-id-from-external-provider" />
...
</users>
</tsResponse>
Fehlerbedingungen
HTTP-Reaktions-Code
404
Bedingung
Site wurde nicht gefunden
405
Ungültige Anforderungsmethode
Details
Die in der URI angegebene
Site-ID entspricht keiner vorhandenen Site.
Der Abfragetyp war nicht
POST oder GET.
Benutzer von Site entfernen
Beschreibung
Methode und URI
Entfernt einen Benutzer von der angegebenen Site.
DELETE /api/2.0/sites/siteid/users/user-id
Nachrichtennutzlast
Keine
Antwortcode
204
- 567 -
Antwortnutzlast
Keine
Geschäftslogik und Fehlerbedingungen
Wenn ein Benutzer Eigentümer von Inhalten in Tableau Server ist, kann der Benutzer nicht
gelöscht werden. Das Eigentum der Inhalte des Benutzers muss zunächst auf einen anderen
Benutzer übetragen werden.
Fehlerbedingungen
HTTP-Reaktions-Code
400
404
404
405
409
Bedingung
Löschen fehlgeschlagen
Details
Es ist ein anderes Problem
aufgetreten, durch das das
Entfernen des Benutzers
von der Site verhindert
wurde.
Site wurde nicht gefunden
Die in der URI angegebene
Site-ID entspricht keiner vorhandenen Site.
Benutzer wurde nicht gefunden Die in der URI angegebene
Benutzer-ID entspricht keinem vorhandenen Benutzer.
Ungültige AnforDer Anfragetyp war kein
derungsmethode
DELETE-, POST- oder GETVorgang.
Benutzerobjektkonflikt
Der angegebene Benutzer
besitzt noch Inhalte in
Tableau Server.
Site erstellen
Beschreibung
Methode und URI
Nachrichtennutzlast
Erstellt mit den angegebenen Metadaten eine Site in
Tableau Server.
POST /api/2.0/sites/
<tsRequest>
<site name="site-name"
contentUrl="some-content-url"
adminMode="some-admin-mode"
- 568 -
userQuota="num-users"
storageQuota="limit-in-megabytes"
disableSubscriptions="false" />
</tsRequest>
Antwortcode
201
Antwortnutzlast
<tsResponse>
<site id="new-site-id"
name="site-name"
contentUrl="the-content-url"
adminMode="the-admin-mode"
userQuota="num-users"
storageQuota="limit-in-megabytes"
disableSubscriptions="false" />
</tsResponse>
Antwortkopfzeilen
Location: /api/2.0/sites/new-site-id
Datendetails
Zu dem Zeitpunkt, zu dem dieser Abschnitt bearbeitet wurde, standen zwei gültige
Administratormodi zur Verfügung:ContentOnly und ContentAndUsers. Beachten Sie,
dass adminMode, userQuota und storageQuota optionale Parameter sind.
Geschäftslogik und Fehlerbedingungen
Das gleichzeitige Festlegen von "adminMode" auf "ContentOnly" und von "userQuota" ist nicht
möglich.
Fehlerbedingungen
HTTP-Reaktions-Code
405
409
Bedingung
Ungültige Anforderungsmethode
Site-Namenskonflikt
409
Site-URL-Konflikt
409
Admin-Modus-/Benutzerkontingent-Konflikt
- 569 -
Details
Der Abfragetyp war nicht
POST oder GET.
Der Site-Name in der
Anfrage gehört bereits zu
einer vorhandenen Site im
System.
Die Inhalts-URL in der
Anfrage gehört bereits zu
einer vorhandenen Site im
System.
Das Festlegen von
"adminMode" auf "ContentOnly" und Angeben von
"userQuota" in der Anfrage
ist nicht möglich.
Site aktualisieren
Beschreibung
Methode und URI
Ändert die Metadaten der angegebenen Site.
PUT /api/2.0/sites/site-id
Nachrichtennutzlast
<tsResponse>
<site name="some-name"
contentUrl="some-content-url"
adminMode="some-admin-mode"
userQuota="num-users"
state="active-or-suspended"
statusReason="reason-for-state"
storageQuota="limit-in-megabytes"
disableSubscriptions="true-or-false" />
</tsResponse>
Antwortcode
200
Antwortnutzlast
<tsResponse>
<site name="some-name"
contentUrl="some-content-url"
adminMode="some-admin-mode"
userQuota="num-users"
state="active-or-suspended"
statusReason="reason-for-state"
storageQuota="limit-in-megabytes"
disableSubscriptions="true-or-false" />
</tsResponse>
Datendetails
Zu dem Zeitpunkt, zu dem dieser Abschnitt bearbeitet wurde, standen zwei gültige
Administratormodi zur Verfügung:ContentOnly und ContentAndUsers.
Geschäftslogik und Fehlerbedingungen
Datenabweichungen
Eine beliebige Kombination der Attribute im <site>-Element ist gültig. Nur vorhandene
Attribute führen zu Aktualisierungen der zugehörigen Werte in der Site. Wenn keine Attribute
vorhanden sind, wird die Aktualisierung nicht wirksam.
- 570 -
Fehlerbedingungen
HTTP-Reaktions-Code
400
Bedingung
Ungültiger Admin-Modus
400
Ungültiger Status
404
Site wurde nicht gefunden
404
Benutzername wurde nicht
gefunden
405
Ungültige Anforderungsmethode
409
Site-Namenskonflikt
409
Site-URL-Konflikt
Sites abfragen
Beschreibung
Methode
und URI
Gibt eine Liste aller Sites auf dem Server zurück.
GET/api/2.0/sites/
- 571 -
Details
In der Anfrage wurde ein
Admin-Modus-Parameter
mit einem ungültigen Wert
bereitgestellt.
In der Anfrage wurde ein
Statusparameter mit einem
ungültigen Wert bereitgestellt.
Die in der URI angegebene
Site-ID entspricht keiner vorhandenen Site.
BenutzernameDer in den
Daten angegebene Benutzername entspricht keinem
vorhandenen Benutzer im
System.
Der Anfragetyp war kein
PUT-, DELETE- oder GETVorgang.
Der neue Site-Name in der
Anfrage gehört bereits zu
einer vorhandenen Site im
System.
Die neue Inhalts-URL in der
Anfrage gehört bereits zu
einer vorhandenen Site im
System.
GET/api/2.0/sites/?includeProjects=false
Nachrichtennutzlast
Antwortcode
Antwortnutzlast
Keine
200
<tsResponse>
<sites>
<site id="site-id"
name="site1-name"
contentUrl="site1-content-url"
adminMode="some-admin-mode"
userQuota="num-users"
storageQuota="limit-in-megabytes"
state="active-or-suspended"
statusReason="reason-for-state" />
<projects>
<project id="project1-id" name="project1-name"/>
<project id="project2-id" name="project2-name"/>
... more projects ...
</projects>
</site>
<site id="site2-id"
name="site2-name"
contentUrl="site2-content-url"
adminMode="some-admin-mode"
userQuota="num-users"
storageQuota="limit-in-megabytes"
state="active-or-suspended"
statusReason="reason-for-state" />
<projects>
<project id="project3-id" name="project3-name"/>
<project id="project4-id" name="project4-name"/>
... more projects ...
</projects>
</site>
</sites>
</tsResponse>
Fehlerbedingungen
HTTP-Reaktions-Code
405
Bedingung
Ungültige Anfor-
- 572 -
Details
Der Anfragetyp war kein
derungsmethode
POST- oder GET-Vorgang.
Site abfragen
Beschreibung
Methode
und URI
Nachrichtennutzlast
Antwortcode
Antwortnutzlast
Gibt Metadaten auf der angegebenen Site zurück, die nach Name, Site-ID oder
Site-URL abgefragt werden kann.
Abfrage nach Site-ID
GET/api/2.0/sites/site-id
Abfrage nach Site-Name
GET/api/2.0/sites/sitename?key=name
Abfrage nach URL-Namespace
GET/api/2.0/sites/site-urlnamespace?key=contentUrl
Keine
200
<tsResponse>
<site id="site-id"
name="some-name"
contentUrl="some-content-url"
adminMode="some-admin-mode"
userQuota="num-users"
storageQuota="limit-in-megabytes"
state="active-or-suspended"
statusReason="reason-for-state" />
</tsResponse>
Site-Informationen einschließlich Speichernutzung
Methode
und URI
Abfrage nach Site-ID
GET/api/2.0/sites/siteid?includeUsage=true
Abfrage nach Name
GET/api/2.0/sites/site-
- 573 -
name
?key=name&includeUsage=true
Abfrage nach URL-Namespace
Nachrichtennutzlast
Antwortcode
Antwortnutzlast
GET/api/2.0/sites/site-urlnamespace
?key=contentUrl&includeUsage=t
rue
Keine
200
<tsResponse>
<site id="site-id"
name="some-name"
contentUrl="some-content-url"
adminMode="some-admin-mode"
userQuota="num-users"
storageQuota="limit-in-megabytes"
state="active-or-suspended"
statusReason="reason-for-state" >
<usage numUsers="the-number-of-users"
storage="the-storage-in-megabytes"
</usage>
</site>
</tsResponse>
Fehlerbedingungen
HTTP-Reaktions-Code
404
Bedingung
Site wurde nicht gefunden
405
Ungültige Anforderungsmethode
- 574 -
Details
Die in der URI angegebene
Site-ID oder der angegebene URL-Namespace
entspricht keiner vorhandenen Site.
Der Abfragetyp war nicht
GET, DELETE oder PUT.
Site löschen
Beschreibung
Methode
und URI
Nachrichtennutzlast
Antwortcode
Antwortnutzlast
Löscht die angegebene Site.
Nach Site-ID löschen
DELETE/api/2.0/sites/site-id
Nach Site-Name löschen
DELETE/api/2.0/sites/sitename?key=name
Nach URL-Namensraum
löschen
DELETE/api/2.0/sites/siteurl-namespace?key=contentUrl
Keine
204
Keine
Fehlerbedingungen
HTTP-Reaktions-Code
403
Bedingung
Löschen nicht zulässig
404
Site wurde nicht gefunden
405
Ungültige Anforderungsmethode
- 575 -
Details
Versuchen Sie, die Tableau
Server-Standard-Site zu
löschen.
Die in der URI angegebene
Site-ID oder der angegebene URL-Namespace
entspricht keiner vorhandenen Site.
Der Abfragetyp war nicht
GET, DELETE oder PUT.
Kontaktinformationen
Verzeichnis der weltweiten Büros
Umsatz
Kontakt
+1 888 365 0853
Support
1. Durchsuchen Sie unsere Support-Ressourcen.
2. Lesen Sie die Suchergebnisse, um festzustellen, ob Ihre Frage beantwortet wurde.
3. Wenn Sie die gewünschte Antwort nicht finden, scrollen Sie an das Ende der
Ergebnisliste und klicken Sie auf Weiter und Fall erstellen.
Weitere Anfragen
E-Mail: [email protected]
+1 206 633 3400
- 576 -
Copyright
©2014 Tableau Software, Incorporated und seine Lizenzgeber. Alle Rechte vorbehalten.
Patent www.tableausoftware.com/ip.
Teile des Codes: copyright ©2002 The Board of Trustees of the Leland Stanford Junior
University. Alle Rechte vorbehalten.
Die -Installation umfasst eine unveränderte Version der Firebird-Datenbank als ausführbare
Datei. Sie finden den Quellcode dieser Datenbank unter http://www.firebirdsql.org
Eine Liste mit Copyright-Hinweisen zu Drittanbietern finden Sie in der folgenden Datei, die im
Installationsumfang von Tableau Server enthalten ist:
C:\Program Files\Tableau\Tableau Server\8.3\COPYRIGHTS.rtf
Hinweis: Wenn Sie eine 32-Bit-Version von Tableau Server auf einem 64-BitBetriebssystem installiert haben, befindet sie sich an folgender Stelle: C:\Program
Files (x86)\Tableau\Tableau Server\8.3\COPYRIGHTS.rtf.
Dieses Produkt enthält von Andy Clark entwickelte Software.
Dieses Produkt enthält von der Apache Software Foundation (http://www.apache.org/)
entwickelte Software.
Dieses Produkt ist Clientsoftware gemäß der entsprechenden Definition im
Endbenutzersoftware-Lizenzvertrag von Tableau Software.
- 577 -