概念:报告即服务 (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 变更:
您可以使用简单的 XML 文件与其他报告工具(例如 Microsoft Excel、Crystal Reports)进行基本的桌面集成。 “简单的 XML 输出”选项可提供以下 URL:
|
Workday XML | Workday XML 选项会从 Workday 输出文本 XML 代码。此选项在基于 REST 或 SOAP 的集成中可能很有用。对于某些集成需求,Workday XML 可能过于复杂。示例:使用 Microsoft Excel 快速创建可刷新的报告。在这些情况下,“简单 XML”可能更合适。
Workday XML 输出选项提供了 3 个 URL:
|