Zu verwendende Konfigurationen Workday REST-API

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 3 Minuten Lesedauer
  • Konfigurieren Sie Ihren ServiceNow Instanz zum Ausführen von Aktionen, die verwenden Workday REST-API.

    Vorbereitungen

    • Fordern Sie an IntegrationHub Abonnement.
    • Aktivieren Workday HR Spoke.
    • Rufen Sie diese Werte in Workday ab, und zeichnen Sie sie zur späteren Verwendung auf. Diese Werte sind erforderlich, um Ihren Client zu registrieren:
      • Client-ID
      • Geheimer Clientschlüssel
      • Workday REST-API-Endpunkt
      • Token-Endpunkt
      • Autorisierungsendpunkt
    • Erforderliche Rolle: Administrator

    Warum und wann dieser Vorgang ausgeführt wird

    Workday DIE REST and Report-as-a-Service-API (RAAS) arbeitet mit OAuth 2,0 zusammen, um den Zugriff auf Ressourcen in Ihrem zu autorisieren Workday Mandant. Um OAuth 2,0 zu verwenden, müssen Sie Ihren Client im Mandanten mit der Aufgabe API-Client registrieren registrieren registrieren.

    Konfigurieren Sie Ihren ServiceNow Instanz, die verwendet werden soll Workday REST API, wenn Sie diese REST-basierten Spoke-Aktionen verwenden müssen:
    • Meine Berichtsstruktur abrufen
    • Anwenderdefinierte Objektfelder suchen
    • Anwenderdefinierte Objektfelder aktualisieren
    • Gehaltsabrechnung suchen
    • Suchen Sie mit dem Bericht nach Gesamtvergütungen
    • Anwenderdefinierte Berichte suchen
    • Posteingangselemente suchen
    • Leistungs- und Leistungsplandetails eines Mitarbeiters suchen
    • Referenz-WID der Feiertagskalender eines Mitarbeiters suchen
    • Referenz-WID der Zeitplankalender eines Mitarbeiters suchen
    • Feiertagskalender eines Mitarbeiters suchen
    Hinweis:
    Diese Konfigurationen sind erforderlich, um die REST-basierten Spoke-Aktionen zu verwenden.

    Registrieren Workday HR Als OAuth-Provider

    Registrieren Sie Workday HR Instanz als OAuth-Provider, also ServiceNow Instanz kann OAuth 2,0-Token anfordern.

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Prozedur

    1. Navigieren zu Alle > System-OAuth > Applikationsregistrierungan.
    2. Klicken Sie auf Neu.
      Das System zeigt diese Meldung an: Welche Art von OAuth-Anwendung? .
    3. Wählen Sie Verbindung zu einem fremden OAuth-Provider herstellen aus.
    4. Füllen Sie diese Werte im Formular aus.
      Tabelle : 1. Anwendungsregistrierungen-Formular
      Feld Beschreibung
      Name Name zur eindeutigen Identifizierung des Datensatzes. Geben Sie beispielsweise Folgendes ein: Workday HR OAuth
      Anwendung Anwendung, für die der Datensatz gilt. Wählen Sie Aus Workday HR-Spoke .
      Client-ID Client-ID, die bei der Registrierung Ihres Clients generiert wurde.
      Geheimer Clientschlüssel Geheimer Clientschlüssel, der beim Registrieren Ihres Clients generiert wurde.
      Autorisierungs-URL Autorisierungs-Endpunkt, der bei der Registrierung Ihres Clients generiert wurde.
      Token-URL Token-Endpunkt, der bei der Registrierung Ihres Clients generiert wurde.
      Umleitungs-URL OAuth-Rückrufendpunkt in diesem Format: https://<instance>.service-now.com/oauth_redirect.do
      Standardgewährungstyp Zum Erstellen des Tokens verwendeter Gewährungstyp. Wählen Sie Autorisierungscode.
      Aktiv Option zur aktiven Verwendung der Anwendungsregistrierung.
    5. Klicken Sie mit der rechten Maustaste auf den Formularheader und wählen Sie Speichern aus.
      Ein OAuth-Entitätsprofil wird erstellt.

    Erstellen Sie einen Anmeldeinformationsdatensatz für Workday HR Spoke

    Erstellen Sie einen Anmeldeinformationsdatensatz für Workday HR Instanz. Die Workday HR Der Alias für Spoke-Verbindungen und -Anmeldeinformationen verwendet diese Anmeldeinformationen zum Autorisieren von Aktionen.

    Vorbereitungen

    Erforderliche Rolle: admin.

    Prozedur

    1. Navigieren zu Alle > Verbindungen und Anmeldeinformationen > Anmeldeinformationenan.
    2. Klicken Sie auf Neu.

      Das System zeigt diese Meldung an: Welche Art von Anmeldeinformationen möchten Sie erstellen?

    3. Wählen Sie OAuth 2.0-Anmeldeinformationen aus.
    4. Füllen Sie diese Werte im Formular aus.
      Tabelle : 2. Formular „OAuth 2.0-Anmeldeinformationen“
      Feld Beschreibung
      Name Name zur eindeutigen Identifizierung des Datensatzes. Beispiel: Workday-HR-Berechtigung .
      Aktiv Option zur aktiven Verwendung des Anmeldeinformationsdatensatzes.
      OAuth-Einheitenprofil OAuth-Entitätsprofil, das während der Registrierung von erstellt wurde Workday HR Als OAuth-Provider. Beispiel: OAuth-Profil.
    5. Klicken Sie mit der rechten Maustaste auf den Formularheader, und klicken Sie auf Absenden.
    6. Um das OAuth-Token zu generieren, klicken Sie auf den zugehörigen Link OAuth-Token abrufen.

    Erstellen Sie einen Verbindungsdatensatz für Workday HR-Spoke

    Erstellen Sie einen Verbindungsdatensatz für Ihren Workday HR Instanz. Die Workday HR-Spoke Aliasse für Verbindungen und Anmeldeinformationen verwenden diese Verbindungen, um Aktionen in auszuführen Workday HR .

    Vorbereitungen

    Erforderliche Rolle: admin.

    Prozedur

    1. Navigieren zu Alle > Verbindungen und Anmeldeinformationen > Aliasse Für Verbindungen Und Anmeldeinformationenan.
    2. Öffnen Sie den Aliasdatensatz, WorkdayHR .
    3. Von Verbindungen Klicken Sie auf die Registerkarte Neu .
    4. Füllen Sie diese Felder im Formular aus.
      Hinweis:
      Stellen Sie sicher, dass Sie den Verbindungsdatensatz in erstellen Workday HR-Spoke Anwendung.
      Tabelle : 3. Verbindungsformular
      Feld Beschreibung
      Name Name zur eindeutigen Identifizierung des Datensatzes. Beispiel: Workday HR-Verbindung .
      Anmeldeinformation Anmeldeinformationsdatensatz für erstellt Workday HR-Spoke . Beispiel: Workday-HR-Berechtigung .
      Verbindungsalias Alias-Datensatz, der dieser Verbindung zugeordnet ist.
      Verbindungs-URL URL, um eine Verbindung mit herzustellen Workday HR Instanz.
      Aktiv Option zur aktiven Verwendung des Verbindungsdatensatzes.
    5. In Attribute Geben Sie diese Werte ein.
      Feld Wert
      Mandantenname Mandantenname von Workday Anwendung.
      Version v1
    6. Klicken Sie auf Absenden.