http://MY-SERVER/users.xml) mehr verfügbar. Benutzer, die auf diese Endpunkte angewiesen waren, mussten ihren Code portieren, um die REST API zu verwenden.
In Tableau Server 9.3 ist der wgserver-Prozess standardmäßig deaktiviert. (REST API-Aufrufe werden von einem anderen Prozess durchgeführt.) Wenn Sie in Tableau Server 9.3 weiterhin XML-Endpunkte verwenden möchten, müssen Sie den Prozess explizit anhand der folgenden Befehle aktivieren:
tabadmin stop
tabadmin set wgserver.enabled true
tabadmin set wgserver.xmlapi.enabled true
tabadmin set worker0.wgserver.procs 1
tabadmin configure
tabadmin start
Wichtig: Mit Version 10.0 von Tableau Server wurde der wgserver-Prozess vollständig entfernt, d. h. beginnend mit dieser Version können XML-Endpunkte nicht mehr genutzt werden.
Die REST API wurde im Lauf der Zeit mit immer mehr Funktionen ausgestattet, und daher ging der Bedarf für XML-Endpunkte auch immer weiter zurück. Die Informationen, die von XML-Endpunkten zurückgegeben wurden, sind nun entweder über die REST API verfügbar bzw. wurden als Funktion klassifiziert, für die derzeit kein API-Endpunkt erforderlich ist.
Es besteht keine Eins-zu-Eins-Zuordnung zwischen einem XML-Endpunkt und einer REST API. Ein XML-Endpunkt gab Informationen beispielsweise in einem anderen Format zurück als die REST API-Methode.
In der folgenden Tabelle werden die Übereinstimmungen zwischen XML-Endpunkten und den REST API-Methoden dargestellt.
| XML-Endpunkt | REST API-Methode(n) |
|---|---|
auth.xml | Sign In |
data_connections.xml | Query Workbook Connections |
datasources.xml | Query Datasources |
groups.xml | Query Groups |
projects.xml | Query Projects |
schedules.xml | Query Schedules |
site_tasks.xml | Query Extract Refresh Tasks |
sites.xml | Sites abfragen |
tags.xml | Datenquelle abfragen |
tasks.xml | Query Extract Refresh Tasks |
users.xml | Benutzer in Gruppe abrufen |
views.xml | Ansichten für Site abfragen |
workbooks.xml | Arbeitsmappe abfragen |
Mit einer Ausnahme (siehe nächster Abschnitt) gilt: Wenn ein Endpunkt in der vorstehenden Tabelle nicht aufgeführt ist, dann gibt es dafür in der REST API keine Entsprechung.
Der Endpunkt systeminfo.xml ist weiterhin verfügbar. Dieser Endpunkt bietet Informationen zum aktuellen Status der Serverprozesse. Weitere Informationen finden Sie in der Tableau Server-Dokumentation unter Abrufen des Prozessstatus als XML.
Die Komponenten von Tableau Server werden gelegentlich überarbeitet, unter anderem, um Verbesserungen im Hinblick auf Leistung und Skalierbarkeit zu erzielen. Im Rahmen dieser Bemühungen wurde der API-Serverprozess (wgserver) für Tableau Server obsolet. Die ursprünglich über diese Komponente gebotene Funktion wurde nun in andere Komponenten integriert.
In mehreren Versionen von Tableau Server ist der wgserver-Prozess integriert, der die Inhaltsverwaltung vereinfachen soll. Als Begleiterscheinung der Implementierung dieses Prozesses wurde es für Benutzer von Tableau Server möglich, XML-Endpunkte abzufragen. Benutzer konnten Anfragen wie z. B. die Folgende stellen, die Informationen zu den Benutzern zurückgibt, die auf dem Server definiert sind:
http://MY-SERVER/users.xml
Bis dato wurden XML-Endpunkte weder dokumentiert noch unterstützt. Wenn Ihre Anwendungsfunktionalität von diesen Endpunkten abhängig ist, müssen Sie Ihren Code aktualisieren, damit die REST APIverwendet wird.
Wie bereits erwähnt, wurden XML-Endpunkte nicht unterstützt. Sie haben sich praktisch als Nebeneffekt ergeben, und zwar aus der Art und Weise, wie wgserver implementiert wurde. Da keine Unterstützung für Endpunkte bestand, wurden auch keine Aktualisierungen daran vorgenommen, um neue Serverfunktionen zu integrieren oder Fehler zu beheben. Vielmehr waren die XML-Endpunkte zeitweise sogar instabil. Die Abfrage sehr großer Datensätze unter Verwendung eines XML-Endpunkts konnte z. B. zu Fehlern oder Unterbrechungen führen.