知識庫

Tableau Server 中的 XML 端點不再可用


發佈時間 : 15 Mar 2017
上次修改日期 : 20 Jul 2023

問題

自從 2016 年 8 月發布 Tableau Server 版本 10.0 以來,由於 Tableau Server 流程發生變化,因此 XML 端點(例如 http://MY-SERVER/users.xml)尚無法使用。依賴這些端點的使用者應移植代碼,以使用 REST API

環境

  • Tableau Server 10.0 和更高版本
  • XML 端點

答案

目前和未來版本的 Tableau Server 中的狀態

在 Tableau Server 9.3 中,預設情况下停用 wgserver 流程。(REST API 呼叫由不同的流程處理。)如果要在 Tableau Server 9.3 中繼續使用 XML 端點,則必須使用以下指令明示啟用該流程:

tabadmin stop 
tabadmin set wgserver.enabled true 
tabadmin set wgserver.xmlapi.enabled true 
tabadmin set worker0.wgserver.procs 1 
tabadmin configure 
tabadmin start 


重要資訊:從 Tableau Server 10.0 開始,wgserver 流程已被完全删除,您將完全無法使用 XML 端點。

XML 端點奇偶校驗

由於我們使用新功能擴充 REST API,因此對 XML 端點的需求越來越少。XML 端點傳回的資訊現在可以使用 REST API 取得,或者已確定為不是目前必要 API 端點的功能。

XML 端點和 REST API 之間不一定是一對一對應;例如,XML 端點可能已經傳回資訊,但資訊格式與 REST API 方法傳回的資訊格式不同。

下表顯示 XML 端點和 REST API 方法之間的等效方式。

XML 端點REST API 方法
auth.xmlSign In
data_connections.xmlQuery Workbook Connections
datasources.xmlQuery Datasources
groups.xmlQuery Groups
projects.xmlQuery Projects
schedules.xmlQuery Schedules
site_tasks.xmlQuery Extract Refresh Tasks
sites.xml查詢站台
查詢站台
tags.xml查詢資料來源
查詢活頁簿
查詢使用者的活頁簿
tasks.xmlQuery Extract Refresh Tasks
users.xml取得群組中的使用者
取得站台中的使用者
views.xml查詢站台視圖
查詢活頁簿視圖
workbooks.xml查詢活頁簿
查詢使用者的活頁簿

如果上表中没有列出端點,則 REST API 中不存在等效項目,但有一項例外(見下一節)。

systeminfo.xml

systeminfo.xml 端點繼續可用。此端點提供有關伺服器流程的目前狀態的資訊。有關詳細資訊,請參閱 Tableau Server 文件中的以 XML 形式取得流程狀態

其他資訊

後臺

由於其他原因,Tableau Server 元件有時會進行重新設計,以達到更好的效能和可擴充性。在這項工作中,Tableau Server 上不再需要 API 伺服器流程 (wgserver)。該元件最初提供的功能現在已經內建到其他元件中。

XML 端點

對於多個版本,Tableau Server 已經包含 wgserver 流程,方便内容管理。此流程的實作方法的副作用是 Tableau Server 允許使用者向 XML 端點發出請求。例如,使用者已經可發出如下的請求,這些請求傳回有關伺服器上定義的使用者的資訊:

http://MY-SERVER/users.xml

XML 端點從未記錄且不支援。 如果您的應用程式功能依賴這些端點,則必須更新代碼才可改用 REST API

變更的原因

如前所述,XML 端點不是支援的功能;是 wgserver 實作方式的副作用。因為不支援,所以我們未更新端點以適應伺服器上的新功能或修復錯誤。此外,XML 端點有時不穩定 - 例如,使用 XML 端點請求非常大的資料集合,可能會導致錯誤或當機。

這篇文章是否解決了問題?