Concept: Reports as a Service (RaaS)
Inleiding tot RaaS
U kunt geavanceerde rapporten en zoekrapporten inschakelen als webservices. Workday-webservices bieden toegang tot rapportresultaten via URL's, die u kunt gebruiken in:
- Aangepaste Workday Extend-toepassingen.
- Integraties tussen Workday en externe bedrijfsservices. Voorbeeld: aanbieders van salarisadministratie of voorzieningen.
- Externe rapportagehulpmiddelen voor toegang tot Workday-gegevens. Voorbeeld: Microsoft Excel.
Uitvoeropties voor webservices omvatten:
- CSV
- GData
- JSON
- RSS
- Eenvoudige XML
- Workday-XML
Voordat u een standaardrapport als webservice inschakelt, kunt u overwegen het standaardrapport naar een aangepast rapport te kopiëren. Om onderbreking van uw integratieprocessen te voorkomen als een standaardrapport wordt bijgewerkt, schakelt u het aangepaste rapport in als webservice.
GET RaaS-aanvragen mislukken als u een aangepast rapport inschakelt als webservice en de gebruikersnaam van de rapporteigenaar een backslash (\) bevat.
RaaS-naamruimten
Wanneer u een aangepast rapport inschakelt als webservice, genereert Workday een unieke RaaS-naamruimte voor het rapport, met deze indeling:
urn:com.workday.report/
Report_Name
Om onderbrekingen voor integraties die gebruikmaken van de rapportuitvoer tot een minimum te beperken, verandert de RaaS-naamruimte niet wanneer de rapportnaam of de rapporteigenaar verandert.
U kunt de naamruimte voor een aangepast rapport bewerken. Houd echter rekening met het volgende:
- Er wordt niet geverifieerd of een RaaS-naamruimte uniek is.
- Als een integratie het rapport als een webservice gebruikt, moet u dit bijwerken met de nieuwe naamruimte.
Uitvoertypen webservice
Uitvoertype | Omschrijving |
|---|---|
CSV | U kunt de CSV-uitvoeroptie gebruiken als u gegevens zo eenvoudig en snel mogelijk in een spreadsheet wilt importeren. U hoeft geen kennis te hebben van XML of schema's.
Als u gegevens uitvoert naar een CSV-bestand met UTF-8-codering, voegt u deze queryparameter toe aan uw webservice-URL: &bom=true Deze parameter zorgt ervoor dat andere toepassingen, zoals Microsoft Excel, de codering correct kunnen interpreteren en de tekens in het CSV-bestand kunnen weergeven. Voor geavanceerde rapporten met groepskolomkoppen worden de kolomgroeperingen of kolomgroepskoppen niet behouden in de CSV-uitvoer.De kolommen in de CSV-uitvoer komen mogelijk niet overeen met de volgorde van de kolommen in de rapportdefinitie. |
GData | U kunt GData-uitvoer gebruiken voor integraties met Google-gadgets. |
JSON | U kunt de JSON-uitvoeroptie gebruiken in systeem-naar-systeemintegraties waarvoor de JSON-indeling is vereist. |
RSS | U kunt elk geavanceerd aangepast rapport inschakelen als een RSS-webservice, waarop gebruikers zich kunnen abonneren als een RSS-feed. Gebruikers kunnen updates in een tenant volgen via een RSS-feed zonder zich aan te melden bij Workday. |
Eenvoudige XML | Eenvoudige XML vereenvoudigt Workday XML, zodat andere desktoptoepassingen de XML kunnen verwerken. Eenvoudige XML-wijzigingen:
U kunt eenvoudige XML gebruiken voor eenvoudige desktopintegraties met andere rapportagehulpmiddelen, zoals Microsoft Excel of Crystal Reports. De uitvoeroptie Eenvoudige XML biedt de volgende URL's:
|
Workday-XML | Met de optie Workday XML wordt de letterlijke XML-code uit Workday uitgevoerd. Deze optie kan handig zijn in op REST of SOAP gebaseerde integraties. Workday XML is mogelijk te complex voor bepaalde integratiebehoeften. Voorbeeld: snel een vernieuwbaar rapport maken met Microsoft Excel. In deze gevallen is Eenvoudige XML misschien meer geschikt.
De XML-uitvoeroptie van Workday biedt drie URL's:
|