Konzept: Reports-as-a-Service (RaaS)
Einführung in RaaS
Sie können erweiterte Berichte und Suchberichte als Webservices aktivieren. Workday-Webservices ermöglichen den Zugriff auf Berichtsergebnisse über URLs, die Sie in folgenden Bereichen verwenden können:
- Benutzerdefinierte Workday Extend-Anwendungen.
- Integrationen zwischen Workday und externen Geschäftsservices. Beispiel: Anbieter von Entgeltabrechnungs- oder Zusatzleistungsanbietern.
- Externe Reporting-Tools für den Zugriff auf Workday-Daten. Beispiel: Microsoft Excel.
Ausgabeoptionen für Webservices umfassen:
- CSV
- GData
- JSON
- RSS
- Einfaches XML
- Workday XML
Bevor Sie einen Standardbericht als Webservice aktivieren, sollten Sie den Standardbericht in einen benutzerdefinierten Bericht kopieren. Um Unterbrechungen Ihrer Integrationsprozesse zu vermeiden, wenn Workday einen Standardbericht aktualisiert, aktivieren Sie stattdessen den benutzerdefinierten Bericht als Webservice.
GET-RaaS-Anforderungen schlagen fehl, wenn Sie einen benutzerdefinierten Bericht als Webservice aktivieren und der Benutzername des Berichtseigentümers einen umgekehrten Schrägstrich (\) enthält.
RaaS Namespaces
Wenn Sie einen benutzerdefinierten Bericht als Webservice aktivieren, generiert Workday einen eindeutigen RaaS-Namespace für den Bericht in folgendem Format:
urn:com.workday.report/
Report_Name
Um Unterbrechungen bei Integrationen zu minimieren, die die Berichtsausgabe verwenden, ändert sich der RaaS-Namespace nicht, wenn sich der Berichtsname oder der Berichtseigentümer ändert.
Sie können den Namespace für einen benutzerdefinierten Bericht bearbeiten. Beachten Sie jedoch Folgendes:
- Workday verifiziert nicht, ob ein RaaS-Namespace eindeutig ist.
- Wenn eine Integration den Bericht als Webservice verwendet, müssen Sie ihn mit dem neuen Namespace aktualisieren.
Ausgabearten für Webservice
Ausgabeart | Beschreibung |
|---|---|
CSV | Sie können die CSV-Ausgabeoption verwenden, wenn Sie Daten so einfach und schnell wie möglich in eine Tabelle importieren möchten. Sie müssen keine XML- oder Schema-Kenntnisse haben.
Wenn Sie Daten in eine CSV-Datei ausgeben, die UTF-8-Codierung verwendet, hängen Sie folgenden Abfrageparameter an Ihre Webservice-URL an: &bom=true Dieser Parameter stellt sicher, dass andere Anwendungen wie Microsoft Excel die Codierung korrekt interpretieren und die Zeichen in der CSV-Datei anzeigen können. Bei erweiterten Berichten mit Gruppenspaltenüberschriften behält die CSV-Ausgabe die Spaltengruppierungen oder Spaltengruppenüberschriften nicht bei.Die Spalten in der CSV-Ausgabe stimmen möglicherweise nicht mit der Reihenfolge der Spalten in der Berichtsdefinition überein. |
GData | Sie können die GData-Ausgabe für Integrationen mit Google Geräte verwenden. |
JSON | Sie können die Ausgabeoption JSON in System-zu-System-Integrationen verwenden, die das JSON-Format erfordern. |
RSS | Sie können jeden erweiterten benutzerdefinierten Bericht als RSS-Webservice aktivieren, den Benutzer als RSS-Feed abonnieren können. Benutzer können Aktualisierungen in einem Mandanten über einen RSS-Feed überwachen, ohne sich bei Workday anmelden zu müssen. |
Einfaches XML | Simple XML vereinfacht Workday XML, sodass andere Desktop-Anwendungen es verarbeiten können. Einfache XML-Änderungen:
Sie können einfaches XML für grundlegende Desktop-Integrationen mit anderen Reporting-Tools wie Microsoft Excel oder CRFs verwenden. Die Ausgabeoption „Einfaches XML“ bietet folgende URLs:
|
Workday-XML | Bei der Option Workday XML wird der exakte XML-Code von Workday ausgegeben. Diese Option kann bei REST- oder SOAP-basierten Integrationen hilfreich sein. Workday XML ist für einige Integrationsanforderungen möglicherweise zu komplex. Beispiel: Schnelles Erstellen eines aktualisierbaren Berichts mit Microsoft Excel. In diesen Fällen ist einfacher XML-Code möglicherweise besser geeignet.
Die Workday-XML-Ausgabeoption bietet drei URLs:
|