Zu verwendende Konfigurationen Workday REST-API

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 3 Minuten Lesedauer
  • Konfigurieren Sie Ihren ServiceNowInstanz zum Ausführen von Aktionen, die verwenden Workday REST-API.

    Vorbereitungen

    • Fordern Sie an IntegrationHubAbonnement.
    • Aktivieren WorkdayHR Spoke.
    • Rufen Sie diese Werte von Workday ab, und zeichnen Sie sie für die spätere 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 RAAS-API (REST and Report-as-a-Service) arbeitet mit OAuth 2,0 zusammen, um den Zugriff auf Ressourcen in zu autorisieren Workday Mandant. Um OAuth 2,0 zu verwenden, müssen Sie Ihren Client im Mandanten mithilfe der Aufgabe API-Client registrieren registrieren.

    Konfigurieren Sie Ihren ServiceNowInstanz, die verwendet werden soll Workday REST-API, wenn Sie diese REST-basierten Spoke-Aktionen verwenden müssen:
    • Ruft Meine Berichtsstruktur Ab
    • Sucht nach anwenderdefinierten Objektfeldern
    • Aktualisieren Sie Anwenderdefinierte Objektfelder
    • Sucht nach Gehaltsabrechnung
    • Suchen Sie mithilfe des Berichts nach Gesamtvergütungen
    • Suchen Sie nach anwenderdefinierten Berichten
    • Suchen Sie nach Posteingangselementen
    • Sucht nach Zulagen- und Leistungsplandetails eines Mitarbeiters
    • Referenz-WID für Feiertagskalender eines Mitarbeiters suchen
    • Sucht nach Zeitplankalenderreferenz-WID eines Mitarbeiters
    • Sucht nach Feiertagskalendern eines Mitarbeiters
    Hinweis:
    Diese Konfigurationen sind erforderlich, um die REST-basierten Spoke-Aktionen zu verwenden.

    Registrieren WorkdayHR Als OAuth-Anbieter

    Registrieren Sie WorkdayHR Instanz als OAuth-Anbieter, also ServiceNowInstanz 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 Nachricht an: Welche Art von OAuth-Anwendung? .
    3. Wählen Sie Aus Stellen Sie eine Verbindung zu einem externen OAuth-Anbieter her .
    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 bei der Registrierung 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 WorkdayHR Spoke

    Erstellen Sie einen Anmeldeinformationsdatensatz für WorkdayHR Instanz. Die WorkdayHR Der Spoke-Alias für Verbindungen und Anmeldeinformationen verwendet diese Anmeldeinformationen, um Aktionen zu autorisieren.

    Vorbereitungen

    Erforderliche Rolle: admin.

    Prozedur

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

      Das System zeigt diese Nachricht 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 WorkdayHR Als OAuth-Anbieter. 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 WorkdayHR Instanz. Die Workday HR-Spoke Aliasse für Verbindungen und Anmeldeinformationen verwenden diese Verbindungen, um Aktionen in auszuführen WorkdayHR .

    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 .
      Anmeldeinformationen 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 WorkdayHR 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.