Passa al contenuto principale
Administrator Guide
Ultimo aggiornamento: 2023-06-23
Concetto: Report come servizio (RaaS)

Concetto: Report come servizio (RaaS)

Introduzione a RaaS

È possibile abilitare i report avanzati e di ricerca come servizi Web. I servizi Web di Workday consentono l'accesso ai risultati dei report tramite URL, che è possibile utilizzare in:
  • Applicazioni personalizzate di Workday Extend.
  • Integrazioni tra Workday e servizi aziendali esterni. Esempio: fornitori di gestione paghe o benefit.
  • Strumenti di creazione di report esterni per accedere ai dati di Workday. Esempio: Microsoft Excel.
Le opzioni di output per i servizi Web includono:
  • CSV
  • GData
  • JSON
  • RSS
  • XML semplice
  • Workday XML
Prima di abilitare un report standard come servizio Web, è consigliabile copiare il report standard in un report personalizzato. Per evitare interruzioni dei processi di integrazione se il sistema aggiorna un report standard, abilitare invece il report personalizzato come servizio Web.
Le richieste GET RaaS non riescono se si abilita un report personalizzato come servizio Web e il nome utente del proprietario del report contiene una barra rovesciata (\).

Spazi dei nomi RaaS

Quando si abilita un report personalizzato come servizio Web, il sistema genera uno spazio dei nomi RaaS univoco per il report, utilizzando il seguente formato:
urn:com.workday.report/
Report_Name
Per ridurre al minimo le interruzioni delle integrazioni che utilizzano l'output del report, lo spazio dei nomi RaaS non cambia quando il nome del report o il proprietario del report cambiano.
È possibile modificare lo spazio dei nomi per un report personalizzato. Tuttavia, considerare:
  • Il sistema non verifica che uno spazio dei nomi RaaS sia univoco.
  • Se un'integrazione utilizza il report come servizio Web, è necessario aggiornarlo con il nuovo spazio dei nomi.

Tipi di output del servizio Web

Tipo di output
Descrizione
CSV
È possibile utilizzare l'opzione di output CSV quando si desidera importare i dati in un foglio di calcolo nel modo più semplice e rapido possibile. Non è necessario conoscere XML o schemi.
Se si generano dati in un file CSV che utilizza la codifica UTF-8, aggiungere il seguente parametro di query all'URL del servizio Web:
&bom=true
Questo parametro garantisce che altre applicazioni, come Microsoft Excel, possano interpretare correttamente la codifica e visualizzare i caratteri nel file CSV.
Per i report avanzati che includono
Raggruppa intestazioni di colonna
, l'output CSV non mantiene i raggruppamenti di colonne o le intestazioni dei gruppi di colonne.
Le colonne nell'output CSV potrebbero non corrispondere all'ordine delle colonne nella definizione del report.
GData
È possibile utilizzare l'output di GData per le integrazioni con i gadget Google.
JSON
È possibile utilizzare l'opzione di output JSON nelle integrazioni da sistema a sistema che richiedono il formato JSON.
RSS
È possibile abilitare qualsiasi report personalizzato avanzato come servizio Web RSS, a cui gli utenti possono iscriversi come feed RSS. Gli utenti possono monitorare gli aggiornamenti in un tenant tramite un feed RSS senza accedere a Workday.
XML semplice
Simple XML semplifica Workday XML in modo che altre applicazioni desktop possano elaborarlo. Modifiche XML semplici:
  • Campi di istanza singola a semplici elementi di tipo stringa.
  • Campi con istanze multiple a semplici elementi di tipo stringa.
  • Campi a istanze multiple all'interno dell'oggetto business principale a elementi di tipo stringa semplice, con un punto e virgola che separa ogni valore.
  • Campi data che non contengono solo le ore e le date, senza ore o scostamento da GMT.
È possibile utilizzare il formato XML semplice per le integrazioni desktop di base con altri strumenti di report, come Microsoft Excel o Crystal Reports.
L'opzione di output XML semplice fornisce i seguenti URL:
  • Simple XML
    : l'output XML semplificato di un report.
  • XSD
    : la definizione dello schema associata all'XML semplificato.
Workday XML
L'opzione Workday XML restituisce il codice XML letterale da Workday. Questa opzione potrebbe essere utile nelle integrazioni basate su REST o SOAP. Workday XML potrebbe essere troppo complesso per alcune esigenze di integrazione. Esempio: creare rapidamente un report aggiornabile con Microsoft Excel. In questi casi, Simple XML potrebbe essere più appropriato.
L'opzione di output XML di Workday fornisce tre URL:
  • Workday XML
    : l'output XML puro di un report che potrebbe essere utile per le integrazioni basate su REST.
  • XSD
    : la definizione dello schema associata all'XML di Workday.
  • WSDL
    : Web Services Definition Language, spesso utilizzato con SOAP.