跳至主要內容
Administrator Guide
上次更新時間 :2023-06-23
概念︰報告即服務 (RaaS)

概念︰報告即服務 (RaaS)

RaaS 簡介

您可以將進階和搜尋報告啟用為 Web 服務。Workday 網路服務可讓您透過 URL 存取報告結果,這些 URL 可用於︰
  • 自訂 Workday Extend 應用程式
  • Workday 與外部企業服務的整合範例︰薪資或福利提供業者。
  • 用於存取 Workday 資料的外部報告工具。範例︰Microsoft Excel。
Web 服務的輸出選項包括︰
  • CSV
  • GData
  • JSON
  • RSS
  • 簡單 XML
  • Workday XML
在將標準報告啟用為 Web 服務之前,請考慮將標準報告複製到自訂報告。為避免在 Workday 更新標準報告時中斷整合流程,請改為將自訂報告啟用為 Web 服務。
如果您將自訂報告啟用為 Web 服務,且報告擁有者的使用者名稱包含反斜線 (\) 字元,則 GET RaaS 要求會失敗。

RaaS 名稱空間

當您將自訂報告啟用為 Web 服務時,Workday 會使用以下格式為報告產生唯一的 RaaS 名稱空間︰
urn:com.workday.report/
Report_Name
為盡可能減少對使用報告輸出的整合造成的中斷,報告名稱或報告擁有者變更時,RaaS 名稱空間不會變更。
您可以編輯自訂報告的名稱空間。但是,請考慮︰
  • Workday 不會驗證 RaaS 名稱空間是否是唯一的。
  • 如果某個整合使用報告做為 Web 服務,您必須使用新的名稱空間來更新報告。

Web 服務輸出類型

輸出類型
說明
CSV
如果您想要盡可能簡單快速地將資料匯入試算表,可以使用 CSV 輸出選項。您不需要了解 XML 或結構描述。
如果您將資料輸出至使用 UTF-8 編碼的 CSV 檔案,請將此查詢參數附加至您的 Web 服務 URL︰
&bom=true
此參數可確保其他應用程式 (例如 Microsoft Excel) 可以正確解釋編碼並顯示 CSV 檔案中的字元。
對於具有
「群組欄標題」
的進階報告,CSV 輸出不會保留欄分組或欄群組標題。
CSV 輸出中的欄與報告定義中欄的順序可能不相符。
GData
您可以使用 GData 輸出來整合 Google 小工具。
JSON
您可以在需要 JSON 格式的系統間整合中使用 JSON 輸出選項。
RSS
您可以將任何進階自訂報告啟用為 RSS 網頁服務,供使用者以 RSS 摘要的形式進行訂閱。使用者無須登入 Workday,即可透過 RSS 提要監控用戶中的更新。
簡單 XML
簡單 XML 可簡化 Workday XML,以便其他桌面應用程式可以處理。簡單的 XML 變更︰
  • 將單實例欄位轉換為簡單字串類型元素
  • 多重實例欄位轉換為簡單字串類型元素
  • 將主要業務物件內的多實例欄位轉換為簡單字串類型元素,並以分號分隔每個值。
  • 日期欄位,其中不包含僅到日期的時間,且不包含與 GMT 的時間或偏移。
您可以將簡單的 XML 用於與其他報告工具 (例如 Microsoft Excel 或Crystal Reports) 的基本桌面整合。
簡單 XML 輸出選項提供以下 URL︰
  • 簡單 XML
    ︰報告的簡化 XML 輸出。
  • XSD
    ︰與簡化 XML 相關聯的結構描述定義。
Workday XML
Workday XML 選項會從 Workday 輸出文字 XML 代碼。此選項在基於 REST 或 SOAP 的整合中可能很有用。對於某些整合需求,Workday XML 可能過於復雜。範例︰使用 Microsoft Excel 快速建立可重新整理的報告。在這些情況下,簡單 XML 可能更合適。
Workday XML 輸出選項提供 3 個 URL︰
  • Workday XML
    ︰報告中的純 XML 輸出,可能對 REST 型整合有用。
  • XSD
    ︰與 Workday XML 相關聯的結構描述定義。
  • WSDL︰Web
    服務定義語言,通常與 SOAP 搭配使用。