Concept : rapports en tant que service (RaaS)
Présentation du RaaS
Vous pouvez activer les rapports avancés et de recherche en tant que services web. Les services web Workday permettent d'accéder aux résultats des rapports via des URL, que vous pouvez utiliser dans :
- Applications Workday Extend personnalisées.
- Intégrations entre Workday et des services métier externes. Exemple : organismes de paie ou organismes d'avantages sociaux.
- Des outils de reporting externe pour accéder aux données Workday. Exemple : Microsoft Excel.
Les options de sortie pour les services web incluent :
- CSV
- GData
- JSON
- RSS
- XML simple
- XML Workday
Avant d'activer un rapport standard en tant que service web, pensez à le copier dans un rapport personnalisé. Pour éviter toute interruption de vos processus d'intégration si Workday met à jour un rapport standard, activez plutôt le rapport personnalisé en tant que service web.
Les demandes GET RaaS échouent si vous activez un rapport personnalisé en tant que service web et que le nom d'utilisateur du propriétaire du rapport contient une barre oblique (\).
Espaces de noms RaaS
Lorsque vous activez un rapport personnalisé en tant que service web, Workday génère un espace de nom RaaS unique pour le rapport, en utilisant le format suivant :
urn:com.workday.report/
Report_Name
Pour perturber le moins possible les intégrations qui utilisent la sortie du rapport, l'espace de noms RaaS ne change pas lorsque le nom du rapport ou son propriétaire change.
Vous pouvez modifier l'espace de nom d'un rapport personnalisé. Toutefois, tenez compte des éléments suivants :
- Workday ne vérifie pas qu'un espace de noms RaaS est unique.
- Si une intégration utilise le rapport en tant que service web, vous devez le mettre à jour avec le nouvel espace de nom.
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 les schémas.
Si vous générez des données dans un fichier CSV qui utilise l’encodage UFT-8, ajoutez ce paramètre d’interrogation à l’adresse URL de votre service Web : &bom=true Ce paramètre fait en sorte que les autres applications, comme Microsoft Excel, peuvent interpréter correctement l’encodage et afficher les caractères dans le fichier CSV. Pour les rapports avancés ayant des en-têtes de colonnes de groupes , la sortie CSV ne conserve pas les regroupements de colonnes ni les en-têtes de groupes de colonnes.L’ordre des colonnes de la sortie CSV peut ne pas correspondre à l’ordre des colonnes de la définition du rapport. |
GData | Vous pouvez utiliser la sortie GData pour les intégrations avec les 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 tout rapport personnalisé avancé en tant que service Web RSS, auquel les utilisateurs peuvent s’abonner à partir du flux URL. Les utilisateurs peuvent suivre les mises à jour dans un locataire via un flux RSS sans avoir à ouvrir une session Workday. |
Version XML simple | Version XML simple simplifie Workday Version XML afin que d’autres applications de bureau puissent la traiter. Changements XML simples :
Vous pouvez utiliser un code XML simple pour les intégrations de bureau de base avec d’autres outils de production de rapports, comme Microsoft Excel ou Sert à produire des rapports. L’option de sortie Version XML simple fournit les adresses URL suivantes :
|
Version XML de Workday | L’option Workday XML génère le code XML littéral de Workday. Cette option peut être utile dans les intégrations fondées sur REST ouSOAP. Workday XML peut être trop complexe pour certains besoins d’intégration. Exemple : création rapide d’un rapport actualisé avec Microsoft Excel. Dans ce cas, l’option XML simple peut être plus appropriée.
L’option de sortie XML de Workday fournit trois URL :
|