Technische Referenzen

Dieser Abschnitt enthält nützliche Informationen, die Sie möglicherweise für die Interaktion mit Workday REST-Aktivitäten benötigen.

Verwenden der Aktivität Execute WQL Query

Wichtig:

Um die Aktivität Execute WQL Query zu verwenden, müssen Sie den Scope System – Workday Query Language konfigurieren. Weitere Informationen finden Sie unter Workday-Authentifizierung.

Workday Query Language oder WQL ist eine SQL-ähnliche Abfragesprache, die erweiterte Funktionen zum Abfragen von Workday-Daten bietet. Da es SQL ähnelt, können Sie innerhalb von Workday manuell Abfragen erstellen oder einen vorhandenen Bericht mithilfe der Aktivität WQL Query ausführen in WQL konvertieren.

Sie können erweiterte und Matrix-Berichte in Workday Query Language (WQL) konvertieren und die resultierende Abfrage in der Aktivität Execute WQL Query verwenden, um Daten aus Workday zu extrahieren.

Verwenden Sie das folgende Beispiel als Referenz:

1. Suchen Sie in Workday nach der Aufgabe Bericht in WQL konvertieren .

   

2. Wählen Sie den Bericht aus, den Sie konvertieren möchten, und wählen Sie die Konvertierte WQL-Abfragezeichenfolge aus.

   

   

3. Geben Sie als Nächstes die kopierte Abfrage in die Aktivität WQL Query ausführen ein und wählen Sie die Schaltfläche Ausgabeschema generieren aus.

   

4. Diese Aktion generiert eine Liste von Ausgabefeldern.

   

Sie können auch Workday-Tabellen mithilfe des Objekts Datenquellen erkunden und eigene Abfragen erstellen. Sie können über das Objekt Datenquellenfelder auf Tabellenspalten zugreifen, und filterbare Felder sind im Objekt Datenquellenfilter verfügbar. Weitere Informationen finden Sie in der Workday-REST-Dokumentation zu dataSources.

Wichtige Punkte, die zu beachten sind

1. Sie müssen zuerst das Ausgabeschema Ihrer Abfrageergebnisse generieren und anschließend zur Entwurfszeit alle Spaltenwerte durch Variablen ersetzen.
2. Sie können die Parameter LIMIT und OFFSET verwenden, um große Datensätze zu paginieren.
3. Die folgende Fehlermeldung kann auftreten, wenn:

   1. Der System- Scope fehlt im API-Client. Überprüfen Sie die Scopes (Funktionsbereich) Ihres API-Clients.

   2. Ihre Abfrage ist falsch oder enthält Variablen. Stellen Sie sicher, dass Sie die Aufgabe WQL-Abfrageergebnis anzeigen in Workday erfolgreich ausgeführt haben und die richtige Abfrage in der Aktivität Execute WQL Query verwenden.

      

Referenz für WQL-Datenquellen

In den folgenden Tabellen sind die kuratierten Alias der WQL-Datenquelle, die in der Aktivität List Records verfügbar sind, geordnet nach primärem Geschäftsobjekt aufgeführt. Alle aufgeführten Datenquellen sind von Workday bereitgestellte Standardobjekte, die in allen Mandanten vorhanden sind und ohne zusätzliche Parameter abgefragt werden können.

Um alle in Ihrem spezifischen Mandanten verfügbaren Datenquellen zu ermitteln, rufen Sie Folgendes auf:

GET /api/wql/v1/dataSources

Arbeitskraft

Alias der Datenquelle	Beschreibung	Häufiger Anwendungsfall
allWorkers	Alle Mitarbeiter (Mitarbeiter und Kontingente)	Vollständige Mitarbeitersynchronisierung, Identitätsbereitstellung
allActiveEmployees	Derzeit aktive Mitarbeiter	Aktive Mitarbeiterberichte, Gehaltsabrechnungsfeeds
allContingentWorkers	Dauer- und Vertragsarbeitskräfte	Anbieterverwaltung, Zugriffsbereitstellung
allTerminatedWorkers	Beendete Mitarbeiter	Offboarding, Compliance-Prüfungen
allPreHires	Datensätze vor der Einstellung	Onboarding von Workflows
allLeaveOfAbsenceWorkers	Mitarbeiter, die sich derzeit im Urlaub befinden	Nachverfolgung verlassen, Nutzenkontinuität
allRetiredWorkers	Ausgemusterte Mitarbeiter	Feeds
workerHistory	Historische Datensätze zur Änderung der Arbeitskraft	Auditpfade, Änderungsnachverfolgung
workerCompensation	Vergütungsdaten pro Arbeitskraft	Gehaltsabrechnungsintegrationen, Gesamtbelohnungen
workerBenefitElections	Details der Nutzenanmeldung	Anbieterfeeds, Nutzenberichte
workerTimeOff	Ausfallzeitsalden und -einträge	Guthabenberichte verlassen
workerPersonalData	Persönliche Daten (Adresse, Geburtsdatum usw.)	HR-Datensynchronisierung, Compliance
workerDocuments	Angehängte Dokumente der Arbeitskraft	Dokumentverwaltungsintegrationen
workerAccountProvisioning	Daten zur Konto- und Identitätsbereitstellung	IAM-Synchronisierung (z. B. Okta, Azure AD)

Organisation

Alias der Datenquelle	Beschreibung	Häufiger Anwendungsfall
allOrganizations	Alle Organisationstypen	Organisationsstruktur synchronisiert
allSupervisoryOrganizations	Hierarchie der Aufsichtsorganisation	Managerhierarchie, Organisationsdiagramme
allCostCenters	Liste der Kostenstellen	Finanzberichterstattung, Kostenzuweisung
allCompanies	Liste der juristischen Person und des Unternehmens	Berichterstellung für mehrere Entitäten
allRegions	Regionale Strukturen	Geographienbasierte Berichterstattung
allCustomOrganizations	Benutzerdefinierte Organisationstypen	Kundenspezifische Organisationsstrukturen
organizationHierarchies	Vollständige Organisationsstruktur	Hierarchiefeeds zu nachgelagerten Systemen
allBusinessUnits	Struktur der Geschäftseinheit	Berichterstellung auf Segmentebene

Position

Alias der Datenquelle	Beschreibung	Häufiger Anwendungsfall
allPositions	Alle Positionen	Positionskatalogsynchronisierung
allOpenPositions	Unbefüllte und offene Stellen	Personalbeschaffungspipeline, Personalplanung
allFilledPositions	Derzeit vergebene Stellen	Mitarbeiterberichte
positionBudget	Positionieren Sie Budgetierungsdaten	Integration der Finanzplanung
positionRestrictions	Einschränkungen für Positionen	Compliance und Governance
allHeadcountGroups	Nachverfolgungsgruppen für Mitarbeiteranzahl	Personalanalyse

Personalgewinnung (Berufsanfrage)

Alias der Datenquelle	Beschreibung	Häufiger Anwendungsfall
allJobApplications	Personalgewinnung von Anwendungen	ATS-Integration, Einstellungsanalyse
allJobRequisitions	Offene Anforderungen	Nachverfolgung der Anforderung
allCandidates	Kandidatenpool	Berichterstattung über Kandidatenpipelines
allOffers	Stellenangebote	Angebotsverwaltungsfeeds
allInterviews	Gesprächsdatensätze	Analyse der Gesprächsplanung
allReferrals	Mitarbeiterempfehlungen	Nachverfolgung von Empfehlungsprogrammen

Kompensation

Alias der Datenquelle	Beschreibung	Häufiger Anwendungsfall
allCompensationPlans	Strukturen des Vergütungsplans	Planverwaltung
allCompensationGrades	Stufen- und Rollendefinitionen	Stufenzuordnungsintegrationen
allCompensationPackages	Paketvergütung	Berichterstattung über die gesamten Belohnungen
allBonusPlans	Bonusstrukturen	Bonusauszahlungsfeeds
allStockPlans	Aktien- und Aktienplänen	Kapitalverwaltung
allMeritPlans	Pläne zur Leistungssteigerung	Jährliche Leistungszyklus-Feeds

Vorteile

Alias der Datenquelle	Beschreibung	Häufiger Anwendungsfall
allBenefitPlans	Leistungsplankatalog	Validierung der Einrichtung
allBenefitGroups	Nutzenberechtigungsgruppen	Überprüfung der Teilnahmeberechtigung
allHealthCareCoverage	Daten zur Gesundheitsabdeckung	Feeds zur Registrierung von Anbietern
allInsuranceCoverage	Lebens- und Risikoversicherung	Versicherungsträger-Feeds
allRetirementPlans	401.000 und automatisch	Einstellungs-Anbieterfeeds
allBenefitElections	Aktive Wahlen	Öffnen Sie die Registrierungsberichterstattung

Zeiterfassung und Abwesenheitsnotiz

Alias der Datenquelle	Beschreibung	Häufiger Anwendungsfall
allTimeEntries	Zeituhreinträge	Gehaltsabrechnungszeitfeeds
allAbsenceRequests	Urlaubsanfragen	Verwaltung verlassen
allTimeOffPlans	Definitionen des Auszeitplans	Plankonfigurationssynchronisierung
allLeaveTypes	Typkatalog verlassen	Richtlinienberichterstattung verlassen
allTimeCalendars	Kalenderkonfigurationen	Zeitplanverwaltung

Talent und Leistung

Alias der Datenquelle	Beschreibung	Häufiger Anwendungsfall
allPerformanceReviews	Überprüfen Sie die Zyklusdaten	Leistungsanalyse
allGoals	Mitarbeiterziele	Integration der Zielverfolgung
allCompetencies	Kompetenzframeworks	Analyse der Qualifikationslücken
allSuccessionPlans	Nachverfolgungspools	Nachfolgeplanung
allTalentPools	Talent-Pipeline	Talentmanagement
allLearningCourses	LMS-Kurskatalog	Lernplattform synchronisieren

HTTP-Anfrage (HTTP Request)

Sie können die Aktivität HTTP Request verwenden, um eine beliebige Workday-REST-API aufzurufen, sofern Sie dem verwendeten API-Client die erforderlichen Berechtigungen zuweisen. Weitere Informationen finden Sie im Handbuch zur Authentifizierung des Workday REST Connectors.