跳至主要内容
Administrator Guide
上次更新时间 :2023-06-23
概念:报告即服务 (RaaS)

概念:报告即服务 (RaaS)

RaaS 简介

您可以将高级报告和搜索报告启用为 Web 服务。Workday Web 服务支持通过 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 Web 服务,用户可以将其作为 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 结合使用。