Arbeitstag
Verwenden Sie den Workday-Connector, um Workday-SOAP- und REST-Dienste für die Ausführung verschiedener On-Demand-Geschäftsverwaltungsdienste aufzurufen.
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Dienstleistung | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Logic Apps | Norm | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: - Azure Government Regionen - Azure China-Regionen - US Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | Microsoft |
| URL | https://support.microsoft.com |
| Connectormetadaten | |
|---|---|
| Publisher | Microsoft |
| Webseite | https://www.workday.com/ |
| Datenschutzrichtlinie | https://www.workday.com/en-us/privacy.html |
| Kategorien | Personalabteilung |
Eine Verbindung wird erstellt
Der Connector unterstützt die folgenden Authentifizierungstypen:
| [variables('aadAuthDefaultDisplayName')] | [variables('aadAuthDefaultDescription')] | Alle Regionen | Nicht teilbar |
| Basic | Geben Sie einen Benutzernamen und ein Kennwort für den Zugriff auf den Workday-Dienst an. | Alle Regionen | Nicht teilbar |
| Microsoft Entra ID integriert | Greifen Sie mit Microsoft Entra ID auf Ihre Workday-Instanz zu. | Nur | Nicht teilbar |
| Microsoft Entra ID in API-Verwaltung integriert | Greifen Sie über den API-Verwaltungsdienst auf Ihre Workday-Instanz mit Microsoft Entra ID zu. | Alle Regionen | Nicht teilbar |
| OAuth 2.0 | Greifen Sie mithilfe der OAuth 2.0-Authentifizierung auf Ihre Workday-Instanz zu. | Alle Regionen | Nicht teilbar |
| Standard [VERALTET] | Diese Option ist nur für ältere Verbindungen ohne expliziten Authentifizierungstyp vorgesehen und wird nur aus Gründen der Abwärtskompatibilität bereitgestellt. | Alle Regionen | Nicht teilbar |
[variables('aadAuthDefaultDisplayName')]
Authentifizierungs-ID: oauth
Anwendbar: Alle Regionen
[variables('aadAuthDefaultDescription')]
Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.
| Name | Typ | Description | Erforderlich |
|---|---|---|---|
| Microsoft Entra Ressourcen-URL (Anwendungs-ID-URI) | Schnur | URL-ID in Microsoft Entra ID für die Zielressource | Richtig |
| Workday OAuth-Token-URL | Schnur | URL des OAuth-Tokenendpunkts von Workday (Format: https://< workday-host-name.workday.com/ccx/oauth2/>< tenant-name>/token) | Richtig |
| Workday OAuth-Client-ID | Schnur | Ihre Workday OAuth-Client-ID | Richtig |
| SOAP-Basis-URL | Schnur | Endpunkt-URL der Workday-Instanz (Format: https://< workday-host-name.workday.com/ccx/service>) | Richtig |
| REST-Basis-URL | Schnur | Workday REST-API-Stamm-URL (Format: https://< workday-host-name.workday.com/ccx/api>) | |
| Mandantenname | Schnur | Name des Workday-Instanzmandanten | Richtig |
Basic
Authentifizierungs-ID: einfach
Anwendbar: Alle Regionen
Geben Sie einen Benutzernamen und ein Kennwort für den Zugriff auf den Workday-Dienst an.
Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.
| Name | Typ | Description | Erforderlich |
|---|---|---|---|
| SOAP-Basis-URL | Schnur | Endpunkt-URL der Workday-Instanz (Format: https://< workday-host-name.workday.com/ccx/service>) | Richtig |
| Mandantenname | Schnur | Name des Workday-Instanzmandanten | Richtig |
| Nutzername | securestring | Benutzername des Workday-Kontos (Format: <user>@<tenant-name>) | Richtig |
| Kennwort | securestring | Kennwort für das Workday-Konto | Richtig |
Microsoft Entra ID integriert
Authentifizierungs-ID: oauth
Anwendbar: nur
Greifen Sie mit Microsoft Entra ID auf Ihre Workday-Instanz zu.
Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.
| Name | Typ | Description | Erforderlich |
|---|---|---|---|
| Microsoft Entra Ressourcen-URL (Anwendungs-ID-URI) | Schnur | URL-ID in Microsoft Entra ID für die Zielressource | Richtig |
| Workday OAuth-Token-URL | Schnur | URL des OAuth-Tokenendpunkts von Workday (Format: https://< workday-host-name.workday.com/ccx/oauth2/>< tenant-name>/token) | Richtig |
| Workday OAuth-Client-ID | Schnur | Ihre Workday OAuth-Client-ID | Richtig |
| SOAP-Basis-URL | Schnur | Endpunkt-URL der Workday-Instanz (Format: https://< workday-host-name.workday.com/ccx/service>) | Richtig |
| REST-Basis-URL | Schnur | Workday REST-API-Stamm-URL (Format: https://< workday-host-name.workday.com/ccx/api>) | |
| Mandantenname | Schnur | Name des Workday-Instanzmandanten | Richtig |
Microsoft Entra ID in API-Verwaltung integriert
Auth-ID: oauthapim
Anwendbar: Alle Regionen
Greifen Sie über den API-Verwaltungsdienst auf Ihre Workday-Instanz mit Microsoft Entra ID zu.
Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.
| Name | Typ | Description | Erforderlich |
|---|---|---|---|
| Microsoft Entra Ressourcen-URL (Anwendungs-ID-URI) | Schnur | URL-ID in Microsoft Entra ID für die Zielressource | Richtig |
| BASIS-URL des API-Verwaltungsdiensts | Schnur | Endpunkt-URL für API-Verwaltung (Format: https://< apim-host-name.azure-api.net/>< APIM-URL-Suffix>) | Richtig |
| REST-Basis-URL | Schnur | Workday REST-API-Stamm-URL (Format: https://< workday-host-name.workday.com/ccx/api>) | |
| Mandantenname | Schnur | Name des Workday-Instanzmandanten | Richtig |
OAuth 2.0
Auth-ID: oauth2generic
Anwendbar: Alle Regionen
Greifen Sie mithilfe der OAuth 2.0-Authentifizierung auf Ihre Workday-Instanz zu.
Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.
| Name | Typ | Description | Erforderlich |
|---|---|---|---|
| OAuth-Autorisierungs-URL | Schnur | OAuth-Autorisierungsendpunkt-URL von Workday (Format: https://< workday-host-name>/workday/<tenant-name>/authorize) | Richtig |
| OAuth-Token-URL | Schnur | OAuth-Tokenendpunkt-URL von Workday (Format: https://< workday-host-name>/ccx/oauth2/<tenant-name>/token) | Richtig |
| OAuth-Client-ID | Schnur | OAuth-Client-ID von Workday | Richtig |
| Geheimer OAuth-Clientschlüssel | securestring | Geheimer OAuth-Clientschlüssel von Workday | Richtig |
| SOAP-Basis-URL | Schnur | Endpunkt-URL der Workday-Instanz (Format: https://< workday-host-name.workday.com/ccx/service>) | Richtig |
| REST-Basis-URL | Schnur | Workday REST-API-Stamm-URL (Format: https://< workday-host-name.workday.com/ccx/api>) | |
| Name des Workday-Mandanten | Schnur | Name des Workday-Instanzmandanten | Richtig |
Standard [VERALTET]
Anwendbar: Alle Regionen
Diese Option ist nur für ältere Verbindungen ohne expliziten Authentifizierungstyp vorgesehen und wird nur aus Gründen der Abwärtskompatibilität bereitgestellt.
Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.
| Name | Typ | Description | Erforderlich |
|---|---|---|---|
| SOAP-Basis-URL | Schnur | Endpunkt-URL der Workday-Instanz (Format: https://< workday-host-name.workday.com/ccx/service>) | Richtig |
| Mandantenname | Schnur | Name des Workday-Instanzmandanten | Richtig |
| Nutzername | securestring | Benutzername des Workday-Kontos (Format: <user>@<tenant-name>) | Richtig |
| Kennwort | securestring | Kennwort für das Workday-Konto | Richtig |
Drosselungsgrenzwerte
| Name | Aufrufe | Verlängerungszeitraum |
|---|---|---|
| API-Aufrufe pro Verbindung | 200 | 60 Sekunden |
Aktionen
| Abrufen von Aufgaben im Posteingang von Mitarbeitern (Vorschau) |
Gibt die Posteingangsaufgaben zurück, die dem angegebenen Worker zugewiesen sind. Filtern Sie nach Status, um geöffnete oder abgeschlossene Aufgaben anzuzeigen. Erfordert OAuth 2.0-Authentifizierung. |
| Abrufen von aufsichtsrechtlichen Organisationen, die von Mitarbeitern verwaltet werden (Vorschau) |
Gibt die vom angegebenen Mitarbeiter verwalteten Aufsichtsorganisationen zurück. Verwenden Sie dies, um die Mitarbeiter-ID eines Vorgesetzten in ihre Aufsichtsorganisations-ID für Übertragungsvorgänge aufzulösen. Erfordert OAuth 2.0-Authentifizierung. |
| Ausführen des RaaS-Vorgangs |
Führen Sie RaaS -Vorgang (Report as a Service) aus. |
| Ausführen eines SOAP-Vorgangs |
Führt SOAP-Vorgang aus. |
| Ausführen eines SOAP-Vorgangs mit JSON-Extraktion (Vorschau) |
Führt SOAP-XML aus und extrahiert aufrufernamente JSON-Werte.Executes SOAP XML and extracts caller-named JSON values. Pfade werden für die gesamte Antwort ausgewertet. Text-, Attribute- und Nur-Blatt-Elemente geben Zeichenfolgen zurück; Strukturierte Elemente behalten untergeordnete Elemente und Attribute bei. Legen Sie mehrere auf "true" fest, um alle Übereinstimmungen in einem Array zurückzugeben, einschließlich eines leeren Arrays ohne Übereinstimmungen. Andernfalls ist höchstens eine Übereinstimmung zulässig, und keine Übereinstimmung gibt NULL zurück. Wählen Sie vollständige Worker-Elemente aus, um arbeitsübergreifende Daten zu gruppieren. Http-Gzip-Antworten mit einem einzelnen Element werden vor der XML-Extraktion decodiert; Andere Inhaltscodierungen und verkettete Gzip-Member werden nicht unterstützt. Empfangene Bytes und jede dekomprimierte Ebene sind auf 10 MiB beschränkt und json auf 1 MiB extrahiert. |
| Ausführen von REST-Anforderung (JSON) (Vorschau) |
Führt eine Workday REST-Anforderung mithilfe der OAuth-Anmeldeinformationen der Verbindung mit nativer JSON-Eingabe und -Ausgabe aus. Verwenden Sie den Platzhalter "{tenant}" im relativen Pfad. JSON-Textkörper werden nur für POST, PUT und PATCH weitergeleitet. Anforderungen sind auf 4 MiB beschränkt. Http-Gzip-Antworten mit einem einzelnen Element werden vor der JSON-Überprüfung decodiert; Andere Inhaltscodierungen und verkettete Gzip-Member werden nicht unterstützt. Empfangene Bytes, jede dekomprimierte Ebene und UTF-8-normalisierte Antworten sind auf 10 MiB beschränkt; Falsch formatierte codierte Bytes werden abgelehnt. Das Antwort-Shape hängt vom ausgewählten Endpunkt ab; es wird kein endpunktspezifisches Feldschema bereitgestellt. Datei- und mehrteilige Nutzlasten werden nicht unterstützt; verwenden Sie execute REST-Anforderung für binäre Antworten. Wenn Workday erfolgreich ist, die Antwort jedoch nicht verwendet werden kann, gibt GET 502 zurück. POST, PUT, PATCH und DELETE geben 422 mit einer Warnung für abgeschlossene Anrufe zurück. Wiederholen Sie diese Schreibvorgänge nicht automatisch. Ist-Workday-Fehlerstatus bleiben erhalten. Workday-Berechtigungen und vorhandene Einschränkungen für relative Pfade gelten. Anrufer sind für die Wiederholungssemantik und idempotenz verantwortlich. |
| Direkte Mitarbeiterberichte abrufen (Vorschau) |
Gibt die Liste der Mitarbeiter zurück, die direkt an den angegebenen Worker berichten. Erfordert OAuth 2.0-Authentifizierung. |
| Feedback zu Mitarbeitern anfordern (Vorschau) |
Fordert Feedback an den angegebenen Mitarbeiter von einem oder mehreren Antwortenden an. Erfordert OAuth 2.0-Authentifizierung. |
| Feedbackvorlagen abrufen (Vorschau) |
Gibt Feedbackvorlagen zurück, die im Mandanten konfiguriert sind. Verwenden Sie templateType, um nach Feedback zu Worker oder Feedback on Self zu filtern. Erfordert OAuth 2.0-Authentifizierung. |
| Lohnscheine für Arbeitnehmer erhalten (Vorschau) |
Gibt Zusammenfassungen der Lohnabrechnungen für den angegebenen Mitarbeiter zurück, einschließlich Lohnkomponenten, Summen und Datumsangaben. Erfordert OAuth 2.0-Authentifizierung. |
| Mein Arbeitsprofil abrufen (Vorschau) |
Gibt das Workday-Profil des authentifizierten Mitarbeiters zurück. Erfordert OAuth 2.0-Authentifizierung. |
| Mitarbeiter übertragen (Vorschau) |
Initiiert eine Auftragsänderung (Übertragung) für den angegebenen Arbeitnehmer in eine neue Aufsichtsorganisation. Erfordert OAuth 2.0-Authentifizierung. |
| Rest-Anforderung ausführen (Vorschau) |
Führt eine Workday REST-Anforderung mit der REST-Basis-URL der Verbindung mithilfe der OAuth-Anmeldeinformationen des angemeldeten Benutzers aus. Geben Sie die HTTP-Methode und den relativen Pfad an (verwenden Sie den Platzhalter "{tenant}" für das Mandantensegment, z. B. "person/v4/{tenant}/values/commonPhone/phoneDeviceTypes/"). Die Anforderung kann nur auf den Workday-Host abzielen, der für die Verbindung konfiguriert ist, und Workday erzwingt die Berechtigungen des angemeldeten Benutzers. Der unformatierte Workday-Antwortstatus und der Textkörper werden unverändert zurückgegeben. Anforderungstexte für Schreibmethoden (POST, PUT, PATCH) werden mit dem vom contentType-Parameter angegebenen Inhaltstyp (application/json standardmäßig) gesendet. Diese Aktion stellt keine Idempotenzschlüssel bereit, sodass Aufrufer für die Wiederholungssemantik für Schreibvorgänge verantwortlich sind. Erfordert OAuth 2.0-Authentifizierung. |
| Suchmitarbeiter (Vorschau) |
Sucht nach Mitarbeitern anhand des Namens. Verwenden Sie den Suchparameter, um Mitarbeiter für Personenauswahlszenarien zu finden. Erfordert OAuth 2.0-Authentifizierung. |
Abrufen von Aufgaben im Posteingang von Mitarbeitern (Vorschau)
Gibt die Posteingangsaufgaben zurück, die dem angegebenen Worker zugewiesen sind. Filtern Sie nach Status, um geöffnete oder abgeschlossene Aufgaben anzuzeigen. Erfordert OAuth 2.0-Authentifizierung.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Arbeits-ID
|
workerID | True | string |
Die Arbeitstag-Arbeits-ID. |
|
Begrenzung
|
limit | integer |
Die maximale Anzahl der zurückzugebenden Vorgänge. Der Standardwert ist 20. Das Maximum beträgt 100. |
|
|
Offset
|
offset | integer |
Der nullbasierte Index des ersten Vorgangs in der Antwort. Verwendung mit Grenzwert für Paginierung. |
Gibt zurück
Paginierte Liste der Posteingangsaufgaben.
- Körper
- InboxTasksResponse
Abrufen von aufsichtsrechtlichen Organisationen, die von Mitarbeitern verwaltet werden (Vorschau)
Gibt die vom angegebenen Mitarbeiter verwalteten Aufsichtsorganisationen zurück. Verwenden Sie dies, um die Mitarbeiter-ID eines Vorgesetzten in ihre Aufsichtsorganisations-ID für Übertragungsvorgänge aufzulösen. Erfordert OAuth 2.0-Authentifizierung.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Arbeits-ID
|
workerID | True | string |
Die Arbeitstag-Arbeits-ID des Vorgesetzten. |
|
Begrenzung
|
limit | integer |
Die maximale Anzahl von Organisationen, die zurückgegeben werden sollen. Der Standardwert ist 20. Das Maximum beträgt 100. |
|
|
Offset
|
offset | integer |
Der nullbasierte Index der ersten Organisation in der Antwort. Verwendung mit Grenzwert für Paginierung. |
Gibt zurück
Paginierte Liste der Aufsichtsorganisationen.
Ausführen des RaaS-Vorgangs
Führen Sie RaaS -Vorgang (Report as a Service) aus.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Kontoname
|
accountName | True | string |
Der Name des Workday-Berichtskontos. |
|
Berichtname
|
reportName | True | string |
Der Name des Workday-Berichts. |
|
SOAP-Anforderungstext
|
requestBody | True | binary |
Der SOAP-Anforderungstext. |
|
Name der Berichtsinstanz
|
reportInstanceName | True | string |
Der Name der Workday-Berichtsinstanz (Beispiel: Report2 oder customReport2). |
Gibt zurück
Der SOAP-Antworttext.
- SOAP-Antworttext
- binary
Ausführen eines SOAP-Vorgangs
Führt SOAP-Vorgang aus.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Dienstname
|
service | True | string |
Der Name des Workday-Webdiensts. |
|
Dienstversion
|
version | True | string |
Die Dienstversion. |
|
SOAP-Anforderungstext
|
requestBody | True | binary |
Der SOAP-Anforderungstext. |
Gibt zurück
Der SOAP-Antworttext.
- SOAP-Antworttext
- binary
Ausführen eines SOAP-Vorgangs mit JSON-Extraktion (Vorschau)
Führt SOAP-XML aus und extrahiert aufrufernamente JSON-Werte.Executes SOAP XML and extracts caller-named JSON values. Pfade werden für die gesamte Antwort ausgewertet. Text-, Attribute- und Nur-Blatt-Elemente geben Zeichenfolgen zurück; Strukturierte Elemente behalten untergeordnete Elemente und Attribute bei. Legen Sie mehrere auf "true" fest, um alle Übereinstimmungen in einem Array zurückzugeben, einschließlich eines leeren Arrays ohne Übereinstimmungen. Andernfalls ist höchstens eine Übereinstimmung zulässig, und keine Übereinstimmung gibt NULL zurück. Wählen Sie vollständige Worker-Elemente aus, um arbeitsübergreifende Daten zu gruppieren. Http-Gzip-Antworten mit einem einzelnen Element werden vor der XML-Extraktion decodiert; Andere Inhaltscodierungen und verkettete Gzip-Member werden nicht unterstützt. Empfangene Bytes und jede dekomprimierte Ebene sind auf 10 MiB beschränkt und json auf 1 MiB extrahiert.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Dienstname
|
service | True | string |
Arbeitstag-SOAP-Dienstname. |
|
Dienstversion
|
version | True | string |
Workday SOAP-Dienstversion, z. B. v42.0. |
|
SOAP-Anforderungstext
|
requestBody | True | string |
Workday SOAP-Anforderungs-XML ohne SOAP-Umschlag. DTDs sind verboten, und die XML-Tiefe ist auf 64 beschränkt. |
|
Antwortschlüssel
|
key | True | string |
Name der benutzerdefinierten Ausgabeeigenschaft. Muss ein Nicht-Leerzeichen enthalten. Jeder Schlüssel kann nur einmal ausgewählt werden. Schlüssel, die mit NULL-Werten serialisiert werden, müssen zusammen in 1 MiB von UTF-8 JSON passen, einschließlich Escape- und Interpunktion. |
|
Extrahieren des Pfads
|
extractPath | True | string |
Eingeschränkter XPath-Wert auf Dokumentebene mit nicht vordefinierten Namen, untergeordneter Platzhalter-/Attributnavigation, übergeordneter (..) und vorgänger::* Navigation außerhalb von Prädikaten, local-name(), text(), Literalgleichheit und/oder booleschen Filtern und numerischen Positionsprädikaten. Gruppierte Selektoren wie (//name)[1] werden unterstützt. Für Vergleiche ist eine Zeichenfolge oder ein numerisches Literal auf der rechten Seite erforderlich. Arithmetische, Knotensatzvergleiche, beliebige Funktionen, andere Achsen und stammstammige, untergeordnete, übergeordnete oder übergeordnete Navigation innerhalb von Prädikaten werden vor dem Aufrufen von Workday abgelehnt. Prädikate ermöglichen relative untergeordnete/Attributpfade und geschachtelte Filter. Bei den meisten 256 Token werden 16 Ebenen von Prädikat/Gruppenschachtelung, zwei absteigende Suchvorgänge (//) und ein Vorgänger::* Schritt unterstützt. Weitere untergeordnete Suchvorgänge und vorgänger::* Schritte werden vor dem Aufrufen von Workday abgelehnt. Die Extraktion teilt ein Arbeitsbudget von 10.000.000 Einheiten für dokumentindizierung, XPath-Navigation und XML-zu-JSON-Projektion, einschließlich Knoten-/Attributscans und Wertlesevorgänge für alle Eigenschaften und Übereinstimmungen. Die Indizierung enthält nicht ausgewählte Knoten und Attribute. Wenn Sie das Budget überschreiten, schlägt die Extraktion nach dem SOAP-Aufruf mit HTTP 422 fehl. Wiederholen Sie schreibvorgänge nicht automatisch. Verwenden Sie mehrere, um Sammlungen oder positionsbezogenen Prädikate zurückzugeben, um eine Übereinstimmung auszuwählen. |
|
Zurückgeben mehrerer Übereinstimmungen
|
multiple | boolean |
Gibt alle übereinstimmenden Werte in einem Array zurück. Eine Übereinstimmung gibt ein Array mit einem Element zurück; keine Übereinstimmungen gibt ein leeres Array zurück. Der Standardwert "false" gibt einen einzelnen Wert oder null zurück und lehnt mehrere Übereinstimmungen ab. |
Gibt zurück
Benutzerdefinierte Schlüssel enthalten Zeichenfolgen, strukturierte Objekte, Arrays oder Null. Strukturierte Elemente lassen ihren ausgewählten Stammnamen aus, entfernen Namespacepräfixe und Deklarationen, behalten Attribute als #text und attributierten Text bei @name und stellen jede untergeordnete Elementgruppe als Array dar, auch für ein untergeordnetes Element. Numerische und boolesche XML-Werte bleiben Zeichenfolgen. Gemischte Text-/untergeordnete Inhalte und Namespacenamenkonflikte schlagen explizit fehl, anstatt Informationen zu verlieren. Bei mehrfach falscher Übereinstimmung ist eine fehlende Übereinstimmung null; mit mehreren true ist es ein leeres Array.
- response
- object
Ausführen von REST-Anforderung (JSON) (Vorschau)
Führt eine Workday REST-Anforderung mithilfe der OAuth-Anmeldeinformationen der Verbindung mit nativer JSON-Eingabe und -Ausgabe aus. Verwenden Sie den Platzhalter "{tenant}" im relativen Pfad. JSON-Textkörper werden nur für POST, PUT und PATCH weitergeleitet. Anforderungen sind auf 4 MiB beschränkt. Http-Gzip-Antworten mit einem einzelnen Element werden vor der JSON-Überprüfung decodiert; Andere Inhaltscodierungen und verkettete Gzip-Member werden nicht unterstützt. Empfangene Bytes, jede dekomprimierte Ebene und UTF-8-normalisierte Antworten sind auf 10 MiB beschränkt; Falsch formatierte codierte Bytes werden abgelehnt. Das Antwort-Shape hängt vom ausgewählten Endpunkt ab; es wird kein endpunktspezifisches Feldschema bereitgestellt. Datei- und mehrteilige Nutzlasten werden nicht unterstützt; verwenden Sie execute REST-Anforderung für binäre Antworten. Wenn Workday erfolgreich ist, die Antwort jedoch nicht verwendet werden kann, gibt GET 502 zurück. POST, PUT, PATCH und DELETE geben 422 mit einer Warnung für abgeschlossene Anrufe zurück. Wiederholen Sie diese Schreibvorgänge nicht automatisch. Ist-Workday-Fehlerstatus bleiben erhalten. Workday-Berechtigungen und vorhandene Einschränkungen für relative Pfade gelten. Anrufer sind für die Wiederholungssemantik und idempotenz verantwortlich.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Relativer Pfad
|
relativePath | True | string |
Der relative Workday REST-Pfad nach der REST-Basis-URL der Verbindung, z. B. common/v1/{tenant}/workers/me. Absolute URLs werden abgelehnt. |
|
HTTP-Methode
|
method | string |
Die HTTP-Methode, die für die Workday REST-Anforderung verwendet werden soll. |
|
|
|
object |
Das endpunktspezifische JSON-Anforderungsobjekt. |
Gibt zurück
Endpunktspezifisches JSON, einschließlich Objekte oder Arrays.
- JSON-Antwort
- string
Direkte Mitarbeiterberichte abrufen (Vorschau)
Gibt die Liste der Mitarbeiter zurück, die direkt an den angegebenen Worker berichten. Erfordert OAuth 2.0-Authentifizierung.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Arbeits-ID
|
workerID | True | string |
Die Arbeitstag-Arbeits-ID des Vorgesetzten. |
|
Begrenzung
|
limit | integer |
Die maximale Anzahl von direkten Berichten, die zurückgegeben werden sollen. Der Standardwert ist 20. Das Maximum beträgt 100. |
|
|
Offset
|
offset | integer |
Der nullbasierte Index des ersten direkten Berichts in der Antwort. Verwendung mit Grenzwert für Paginierung. |
Gibt zurück
Paginierte Liste der direkten Berichte.
- Körper
- DirectReportsResponse
Feedback zu Mitarbeitern anfordern (Vorschau)
Fordert Feedback an den angegebenen Mitarbeiter von einem oder mehreren Antwortenden an. Erfordert OAuth 2.0-Authentifizierung.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Arbeits-ID
|
workerID | True | string |
Die Arbeitstag-Arbeits-ID des Mitarbeiterfeedbacks wird angefordert. |
|
ID
|
id | string |
Die Workday-Ressourcen-ID. |
|
|
ID
|
id | string |
Die Workday-Ressourcen-ID. |
|
|
Vertraulich
|
feedbackConfidential | boolean |
Bei "true" ist das Feedback zwischen dem Anbieter und dem Vorgesetzten vertraulich. Mitarbeiter sehen kein vertrauliches Feedback. |
|
|
Anbietername anzeigen
|
showFeedbackProviderName | boolean |
Wenn true, wird der Name des Antwortenden angezeigt. Wenn falsch, bleiben sie anonym. |
|
|
Ablaufdatum
|
expirationDate | date |
Das Datum, an dem die Feedbackanfrage abläuft (JJJJ-MM-DD). |
Gibt zurück
Das erstellte Feedbackanforderungsereignis.
- Körper
- RequestFeedbackResponse
Feedbackvorlagen abrufen (Vorschau)
Gibt Feedbackvorlagen zurück, die im Mandanten konfiguriert sind. Verwenden Sie templateType, um nach Feedback zu Worker oder Feedback on Self zu filtern. Erfordert OAuth 2.0-Authentifizierung.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Search
|
search | string |
Suchbegriff zum Filtern von Vorlagen nach Namen. |
|
|
Vorlagentyp-ID
|
templateType | string |
Die Typ-ID der Feedbackvorlage. Verwenden Sie 133de7d11fea10001dbb45973dec0097 for Feedback on Worker oder 133de7d11fea10001dbb45a701140098 for Feedback on Self. |
|
|
Arbeits-ID
|
worker | string |
Der Worker WID. Erforderlich für den Vorlagentyp "Feedback zu Worker". |
|
|
Begrenzung
|
limit | integer |
Die maximale Anzahl von Vorlagen, die zurückgegeben werden sollen. Der Standardwert und maximal 1000. |
|
|
Offset
|
offset | integer |
Der nullbasierte Index der ersten Vorlage in der Antwort. Verwendung mit Grenzwert für Paginierung. |
Gibt zurück
Liste der Feedbackvorlagen.
- Körper
- FeedbackTemplatesResponse
Lohnscheine für Arbeitnehmer erhalten (Vorschau)
Gibt Zusammenfassungen der Lohnabrechnungen für den angegebenen Mitarbeiter zurück, einschließlich Lohnkomponenten, Summen und Datumsangaben. Erfordert OAuth 2.0-Authentifizierung.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Arbeits-ID
|
workerID | True | string |
Die Arbeitstag-Arbeits-ID. |
|
Begrenzung
|
limit | integer |
Die maximale Anzahl von Auszahlungsscheinen, die zurückgegeben werden sollen. Der Standardwert ist 20. Das Maximum beträgt 100. |
|
|
Offset
|
offset | integer |
Der nullbasierte Index des ersten Zahlungsscheins in der Antwort. Verwendung mit Grenzwert für Paginierung. |
Gibt zurück
Paginierte Liste der Zahlungsscheine.
- Körper
- PaySlipsResponse
Mein Arbeitsprofil abrufen (Vorschau)
Gibt das Workday-Profil des authentifizierten Mitarbeiters zurück. Erfordert OAuth 2.0-Authentifizierung.
Gibt zurück
Eine Arbeitstag-Arbeitszusammenfassung.
- Körper
- WorkerSummary
Mitarbeiter übertragen (Vorschau)
Initiiert eine Auftragsänderung (Übertragung) für den angegebenen Arbeitnehmer in eine neue Aufsichtsorganisation. Erfordert OAuth 2.0-Authentifizierung.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Arbeits-ID
|
workerID | True | string |
Die Arbeitstag-Arbeits-ID des zu übertragenden Mitarbeiters. |
|
ID
|
id | string |
Die Workday-Ressourcen-ID. |
|
|
ID
|
id | string |
Die Workday-Ressourcen-ID. |
|
|
Gültigkeitsdatum
|
effective | True | date |
Das Datum, an dem die Übertragung wirksam wird (JJJJ-MM-DD). |
|
Verschieben des Teams des Vorgesetzten
|
moveManagersTeam | boolean |
Wenn wahr, verschiebt das Berichtsteam des Mitarbeiters in die neue Aufsichtsorganisation. |
Gibt zurück
Der initiierte Auftragsänderungsprozess.
- Körper
- JobChangeResponse
Rest-Anforderung ausführen (Vorschau)
Führt eine Workday REST-Anforderung mit der REST-Basis-URL der Verbindung mithilfe der OAuth-Anmeldeinformationen des angemeldeten Benutzers aus. Geben Sie die HTTP-Methode und den relativen Pfad an (verwenden Sie den Platzhalter "{tenant}" für das Mandantensegment, z. B. "person/v4/{tenant}/values/commonPhone/phoneDeviceTypes/"). Die Anforderung kann nur auf den Workday-Host abzielen, der für die Verbindung konfiguriert ist, und Workday erzwingt die Berechtigungen des angemeldeten Benutzers. Der unformatierte Workday-Antwortstatus und der Textkörper werden unverändert zurückgegeben. Anforderungstexte für Schreibmethoden (POST, PUT, PATCH) werden mit dem vom contentType-Parameter angegebenen Inhaltstyp (application/json standardmäßig) gesendet. Diese Aktion stellt keine Idempotenzschlüssel bereit, sodass Aufrufer für die Wiederholungssemantik für Schreibvorgänge verantwortlich sind. Erfordert OAuth 2.0-Authentifizierung.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Relativer Pfad
|
relativePath | True | string |
Der relative Pfad "Workday REST" nach der REST-Basis-URL. Verwenden Sie den Platzhalter "{tenant}" für das Mandantensegment (Beispiel: person/v4/{tenant}/values/commonPhone/phoneDeviceTypes/). Muss ein relativer Pfad sein; absolute URLs werden abgelehnt. |
|
HTTP-Methode
|
method | string |
Die HTTP-Methode, die für die Workday REST-Anforderung verwendet werden soll. |
|
|
Inhaltstyp
|
contentType | string |
Inhaltstyp für den Anforderungstext für Schreibmethoden (POST, PUT, PATCH). |
|
|
Anforderungstext
|
body | binary |
Der Anforderungstext für Schreibmethoden (POST, PUT, PATCH). An Arbeitstag gesendet. Lassen Sie leer für GET und DELETE. |
Gibt zurück
Der unformatierte Rest-Antworttext von Workday.
- Antwortkörper
- binary
Suchmitarbeiter (Vorschau)
Sucht nach Mitarbeitern anhand des Namens. Verwenden Sie den Suchparameter, um Mitarbeiter für Personenauswahlszenarien zu finden. Erfordert OAuth 2.0-Authentifizierung.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Search
|
search | string |
Suchbegriff zum Filtern von Workern nach Namen (Groß-/Kleinschreibung wird nicht beachtet). |
|
|
Begrenzung
|
limit | integer |
Die maximale Anzahl der zurückzugebenden Arbeitnehmer. Der Standardwert ist 20. Das Maximum beträgt 100. |
|
|
Offset
|
offset | integer |
Der nullbasierte Index des ersten Workers in der Antwort. Verwendung mit Grenzwert für Paginierung. |
Gibt zurück
Paginierte Liste der Arbeitnehmer.
- Körper
- WorkerSummaryResponse
Definitionen
WorkdayObjectReference
Ein Workday-Ressourcenverweis.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
ID
|
id | string |
Die Workday-Ressourcen-ID. |
PosteingangTask
Eine einzelne Workday-Posteingangsaufgabe.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Vorgangs-ID
|
id | string |
Die Workday-ID der Posteingangsaufgabe. |
|
Aufgabentitel
|
descriptor | string |
Der Anzeigename der Posteingangsaufgabe. |
|
Workday-Link
|
href | string |
Ein Link zur Aufgabe im Workday-Portal. |
|
Zugewiesenes Datum
|
assigned | date |
Das Datum, an dem der Vorgang zugewiesen wurde. |
|
Fälligkeitsdatum
|
due | date |
Das Fälligkeitsdatum für diesen Vorgang. |
|
status
|
status | WorkdayObjectReference |
Ein Workday-Ressourcenverweis. |
|
stepType
|
stepType | WorkdayObjectReference |
Ein Workday-Ressourcenverweis. |
|
initiator
|
initiator | WorkdayObjectReference |
Ein Workday-Ressourcenverweis. |
|
Betreff
|
subject | WorkdayObjectReference |
Ein Workday-Ressourcenverweis. |
|
overallProcess
|
overallProcess | WorkdayObjectReference |
Ein Workday-Ressourcenverweis. |
PosteingangTasksResponse
Paginierte Liste der Posteingangsaufgaben.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Aufgaben
|
data | array of InboxTask |
Die Liste der Posteingangsaufgaben. |
|
Total
|
total | integer |
Die Gesamtanzahl der Vorgänge, die dem Filter entsprechen. |
JobChangeResponse
Der initiierte Auftragsänderungsprozess.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Prozess-ID
|
id | string |
Die Auftragsänderungsprozess-ID. |
|
Aufgabentitel
|
descriptor | string |
Eine lesbare Beschreibung der Auftragsänderung. |
|
Workday-Link
|
href | string |
Ein Link zur Auftragsänderung im Workday-Portal. |
|
Gültigkeitsdatum
|
effective | date |
Das Gültigkeitsdatum der Übertragung. |
|
supervisoryOrganization
|
supervisoryOrganization | WorkdayObjectReference |
Ein Workday-Ressourcenverweis. |
RequestFeedbackResponse
Das erstellte Feedbackanforderungsereignis.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Ereignis-ID
|
id | string |
Die Ereignis-ID der Feedbackanforderung. |
|
Description
|
descriptor | string |
Eine lesbare Beschreibung der Feedbackanfrage. |
|
Anforderungsdatum
|
requestDate | date |
Das Datum, an dem die Feedbackanforderung initiiert wurde. |
|
Status
|
feedbackOverallStatus | string |
Der Gesamtstatus des Feedbackanforderungsprozesses. |
|
feedbackAbout
|
feedbackAbout | WorkdayObjectReference |
Ein Workday-Ressourcenverweis. |
FeedbackTemplate
Eine Workday-Feedbackvorlage.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Vorlagenkennung
|
id | string |
Die Feedbackvorlagen-ID. |
|
Vorlagenname
|
descriptor | string |
Der Anzeigename der Feedbackvorlage. |
FeedbackTemplatesResponse
Liste der Feedbackvorlagen.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Vorlagen
|
data | array of FeedbackTemplate |
Die Liste der Feedbackvorlagen. |
|
Total
|
total | integer |
Gesamtanzahl der Vorlagen. |
WorkerSummary
Eine Arbeitstag-Arbeitszusammenfassung.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Arbeits-ID
|
id | string |
Die Arbeitstag-Arbeits-ID. |
|
Name der Arbeitskraft
|
descriptor | string |
Der Anzeigename des Mitarbeiters. |
|
Worker-URL
|
href | string |
Eine Verknüpfung mit der Arbeitsressource. |
|
Ist Manager
|
isManager | boolean |
Gibt an, ob der Mitarbeiter ein Vorgesetzter ist. |
|
Geschäftstitel
|
businessTitle | string |
Der Geschäftstitel des Arbeitnehmers. |
|
E-Mail (geschäftlich)
|
primaryWorkEmail | string |
Die primäre Geschäftliche E-Mail-Adresse des Mitarbeiters. |
|
Telefon (Arbeit)
|
primaryWorkPhone | string |
Die primäre Geschäftliche Telefonnummer des Mitarbeiters. |
|
primarySupervisoryOrganization
|
primarySupervisoryOrganization | WorkdayObjectReference |
Ein Workday-Ressourcenverweis. |
WorkerSummaryResponse
Paginierte Liste der Arbeitnehmer.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Arbeitnehmer
|
data | array of WorkerSummary |
Die Liste der Arbeitnehmer. |
|
Total
|
total | integer |
Die Gesamtzahl der Mitarbeiter, die der Suche entsprechen. |
Aufsichtsorganisation
Eine Workday-Aufsichtsorganisation.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Organisations-ID
|
id | string |
Die Workday-Aufsichtsorganisations-ID. |
|
Organisationsname
|
descriptor | string |
Der Anzeigename der Organisation. |
|
Organisations-URL
|
href | string |
Eine Verknüpfung mit der Organisationsressource. |
|
Name
|
name | string |
Der Name der Organisation. |
|
Code
|
code | string |
Der Organisationscode. |
SupervisoryOrganizationsResponse
Paginierte Liste der Aufsichtsorganisationen.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Organizations
|
data | array of SupervisoryOrganization |
Die Liste der Aufsichtsorganisationen. |
|
Total
|
total | integer |
Gesamtzahl der Aufsichtsorganisationen. |
DirectReport
Ein Mitarbeiter, der direkt an den angegebenen Vorgesetzten meldet.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Arbeits-ID
|
id | string |
Die Arbeitstag-Arbeits-ID. |
|
Name der Arbeitskraft
|
descriptor | string |
Der Anzeigename des Mitarbeiters. |
|
Worker-URL
|
href | string |
Die URL-Verknüpfung mit der Arbeitsressource. |
|
Ist Manager
|
isManager | boolean |
Gibt an, ob der Mitarbeiter ein Vorgesetzter ist. |
|
Geschäftstitel
|
businessTitle | string |
Der Geschäftstitel des Arbeitnehmers. |
|
E-Mail (geschäftlich)
|
primaryWorkEmail | string |
Die primäre Geschäftliche E-Mail-Adresse des Mitarbeiters. |
|
Telefon (Arbeit)
|
primaryWorkPhone | string |
Die primäre Geschäftliche Telefonnummer des Mitarbeiters. |
|
primarySupervisoryOrganization
|
primarySupervisoryOrganization | WorkdayObjectReference |
Ein Workday-Ressourcenverweis. |
DirectReportsResponse
Paginierte Liste der direkten Berichte.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Direkte Mitarbeiter
|
data | array of DirectReport |
Die Liste der direkten Berichte. |
|
Total
|
total | integer |
Gesamtanzahl der direkten Berichte. |
PaySlip
Eine einzelne Lohnabrechnungszusammenfassung.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Pay slip ID
|
id | string |
Die Zahlungsschein-ID. |
|
Lohnperiode
|
descriptor | string |
Der Anzeigename des Zahlungsscheins enthält in der Regel die Zahlungstermine. |
|
Workday-Link
|
href | string |
Ein Link zum Lohnzettel im Workday-Portal. |
|
Zahlungsdatum
|
date | date |
Das Zahlungsdatum. |
|
Bruttozahlung
|
gross | number |
Bruttozahlungsbetrag. |
|
Nettozahlung
|
net | number |
Nettozahlungsbetrag nach Abzug. |
|
status
|
status | WorkdayObjectReference |
Ein Workday-Ressourcenverweis. |
PaySlipsResponse
Paginierte Liste der Zahlungsscheine.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Zahlungsscheine
|
data | array of PaySlip |
Die Liste der Zahlungsscheine. |
|
Total
|
total | integer |
Gesamtzahl der Zahlungsscheine. |
binär
Dies ist der grundlegende Datentyp "binary".
object
Dies ist der Typ „Objekt“.