Concept : RaaS (Reports as a Service)
Introduction to RaaS
You can enable advanced and search reports as web services. Workday Web Services
enable access to report results through URLs, which you can use in:
- Custom Workday Extend applications.
- Integrations between Workday and external business services. Example: Payroll or benefits providers.
- External reporting tools to access Workday data. Example: Microsoft Excel.
Output options for web services include:
- CSV
- GData
- JSON
- RSS
- Simple XML
- Workday XML
Before enabling a standard report as a web service, consider copying the standard
report to a custom report. To avoid any disruption to your integration processes if
Workday updates a standard report, enable the custom report as a web service
instead.
GET RaaS requests fail if you enable a custom report as a web service and the
username of the report owner contains a backslash (\) character.
RaaS Namespaces
When you enable a custom report as a web service, Workday generates a unique RaaS
namespace for the report, using this format:
urn:com.workday.report/
Report_Name
To minimize disruptions to integrations that use the report output, the RaaS
namespace doesn’t change when the report name or report owner changes.
You can edit the namespace for a custom report. However, consider:
- Workday doesn’t verify that a RaaS namespace is unique.
- If an integration uses the report as a web service, you must update it with the new namespace.
Types de sortie de service web
Type de sortie | Description |
|---|---|
CSV | Vous pouvez utiliser l'option de sortie CSV lorsque vous souhaitez importer des données dans une feuille de calcul aussi simplement et rapidement que possible. Vous n'avez pas besoin de connaître XML ou schémas.
Si vous exportez des données dans un fichier CSV qui utilise le codage UTF-8, ajoutez le paramètre de requête suivant à l'URL de votre service web : &bom=true Ce paramètre garantit que les autres applications, telles que Microsoft Excel, peuvent interpréter correctement le codage et afficher les caractères dans le fichier CSV. Pour les rapports avancés dont les en-têtes de colonne de groupe sont inclus, la sortie CSV ne conserve pas les regroupements de colonnes ou les en-têtes de groupe de colonnes.L'ordre des colonnes dans la sortie CSV peut ne pas correspondre à l'ordre des colonnes dans la définition du rapport. |
GData | Vous pouvez utiliser la sortie GData pour les intégrations des widgets Google. |
JSON | Vous pouvez utiliser l'option de sortie JSON dans les intégrations de système à système qui nécessitent le format JSON. |
RSS | Vous pouvez activer n'importe quel rapport personnalisé avancé en tant que service web RSS, auquel les utilisateurs peuvent s'abonner via un flux RSS. Les utilisateurs peuvent suivre les mises à jour dans un environnement client via un flux RSS sans se connecter à Workday. |
XML simple | Simple XML simplifie Workday XML afin que d'autres applications de bureau puissent le traiter. Modifications XML simples :
Vous pouvez utiliser un format XML simple pour les intégrations de bureau de base avec d'autres outils de reporting, tels que Microsoft Excel ou Customer Reports. L'option de sortie XML simple fournit les URL suivantes :
|
Workday XML | L'option Workday XML génère le code XML littéral de Workday. Cette option peut être utile dans les intégrations basées sur REST ou SOAP. Workday XML peut être trop complexe pour certains besoins d'intégration. Exemple : création rapide d'un rapport pouvant être actualisé avec Microsoft Excel. Dans ces cas-là, XML simple sera peut-être plus approprié.
L'option de sortie XML de Workday fournit trois URL :
|