問題
自從 2016 年 8 月發布 Tableau Server 版本 10.0 以來,由於 Tableau Server 流程發生變化,因此 XML 端點(例如http://MY-SERVER/users.xml
)尚無法使用。依賴這些端點的使用者應移植代碼,以使用 REST API。
http://MY-SERVER/users.xml
)尚無法使用。依賴這些端點的使用者應移植代碼,以使用 REST API。
在 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 端點。
由於我們使用新功能擴充 REST API,因此對 XML 端點的需求越來越少。XML 端點傳回的資訊現在可以使用 REST API 取得,或者已確定為不是目前必要 API 端點的功能。
XML 端點和 REST API 之間不一定是一對一對應;例如,XML 端點可能已經傳回資訊,但資訊格式與 REST API 方法傳回的資訊格式不同。
下表顯示 XML 端點和 REST API 方法之間的等效方式。
XML 端點 | REST API 方法 |
---|---|
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 | 查詢站台 |
tags.xml | 查詢資料來源 |
tasks.xml | Query Extract Refresh Tasks |
users.xml | 取得群組中的使用者 |
views.xml | 查詢站台視圖 |
workbooks.xml | 查詢活頁簿 |
如果上表中没有列出端點,則 REST API 中不存在等效項目,但有一項例外(見下一節)。
systeminfo.xml
端點繼續可用。此端點提供有關伺服器流程的目前狀態的資訊。有關詳細資訊,請參閱 Tableau Server 文件中的以 XML 形式取得流程狀態。
由於其他原因,Tableau Server 元件有時會進行重新設計,以達到更好的效能和可擴充性。在這項工作中,Tableau Server 上不再需要 API 伺服器流程 (wgserver
)。該元件最初提供的功能現在已經內建到其他元件中。
對於多個版本,Tableau Server 已經包含 wgserver
流程,方便内容管理。此流程的實作方法的副作用是 Tableau Server 允許使用者向 XML 端點發出請求。例如,使用者已經可發出如下的請求,這些請求傳回有關伺服器上定義的使用者的資訊:
http://MY-SERVER/users.xml
XML 端點從未記錄且不支援。 如果您的應用程式功能依賴這些端點,則必須更新代碼才可改用 REST API。
如前所述,XML 端點不是支援的功能;是 wgserver
實作方式的副作用。因為不支援,所以我們未更新端點以適應伺服器上的新功能或修復錯誤。此外,XML 端點有時不穩定 - 例如,使用 XML 端點請求非常大的資料集合,可能會導致錯誤或當機。