Richten Sie Webhooks für Ihre Workday HR -Spoke ein

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 14 Minuten Lesedauer
  • Rufen Sie Details der erforderlichen Mitarbeiter in der Anwendung Workday HR in Ihre Instanz ServiceNow ab, indem Sie die Webhooks einrichten.

    Vorbereitungen

    Erforderliche Rolle: admin

    Konfigurieren Sie den ServiceNow-Webhook-API-Client für OAuth 2.0 in Workday

    Konfigurieren Sie den API-Client in Workday, um Webhook-Anforderungen zu authentifizieren.

    Vorbereitungen

    Erforderliche Rolle: Workday-Administratorrolle oder Rolle mit erteilter Berechtigung zum Einrichten des OAuth 2.0-Clients in Workday.

    Warum und wann dieser Vorgang ausgeführt wird

    Sie müssen diesen Schritt nur konfigurieren, wenn Sie ServiceNow Platform als Listener-Endpunkt verwenden und Event-Benachrichtigungen von Workday erhalten möchten. Wenn Sie keine Event-Benachrichtigungen von Workday benötigen, können Sie die in diesem Abschnitt genannten Konfigurationen überspringen.
    Hinweis:
    Diese Konfigurationen müssen in Workday durchgeführt werden.

    Prozedur

    1. In Workday kann ein die Aufgabe „Mandanten-Setup bearbeiten – Sicherheit“ aufrufen.
    2. Wählen Sie im Abschnitt „ OAuth 2.0-Einstellungen “ die Option OAuth 2.0-Clients aktiviert aus.
    3. Greifen Sie auf die Aufgabe „API-Client registrieren“ zu.
    4. Geben Sie den Client-Namen ein.
    5. Wählen Sie als Client Grant-Typ die Option Autorisierungscode Gewährung aus.
    6. Wählen Sie Zugriffstokentyp als Bearer aus.
    7. Geben Sie einen gültigen Umleitungs-URI ein.
      Hinweis:
      Stellen Sie sicher, dass der OAuth 2.0-Umleitungs-URI eine gültige HTTPS-URL ist.
    8. Wahlweise: Wählen Sie die Zeitüberschreitung für Aktualisierungstoken in Tagen aus.
    9. Wahlweise: Wählen Sie die Option Nicht ablaufende Aktualisierungstoken aus, um zu verhindern, dass das Aktualisierungstoken abläuft.
    10. Wählen Sie die Option Administrative Einwilligung gewähren aus, um einem REST-API-Client mandantenweit die OAuth-Berechtigung zu erteilen.
      Wenn Sie diese Option auswählen, müssen Sie dem Client keinen expliziten Zugriff auf Funktionsbereiche von Workday gewähren.
    11. Wählen Sie in der Eingabeaufforderung „Funktionale Bereiche“ die Funktionsbereiche aus, auf die Ihr OAuth 2.0-Client Zugriff benötigt.
    12. Wahlweise: Wenn der OAuth 2.0-Client Zugriff auf zentrale Workday-Domänen erfordert, die sich nicht in Funktionsbereichen befinden, wählen Sie die Option Workday -Eigenen Bereich einbeziehen aus.

    Richten Sie den CreateUser-Webhook für die Workday-HR-Spoke ein

    Verwenden Sie den Webhook CreateUser, um die Details des neu eingearbeiteten Mitarbeiters aus Workday in Ihre ServiceNow-Instanz abzurufen.

    Generieren Sie Benutzername und Passwort in Ihrer ServiceNow -Instanz für den Webhook „Benutzer erstellen“.

    Generieren Sie Benutzername und Passwort in Ihrer Instanz ServiceNow, um Anforderungen für den Webhook „Benutzer erstellen“ zu authentifizieren und die erforderlichen Daten aus der Anwendung Workday abzurufen.

    Vorbereitungen

    Erforderliche Rolle: ServiceNow admin

    Hinweis:
    Diese Konfigurationen müssen in Ihrer ServiceNow -Instanz durchgeführt werden.

    Prozedur

    1. Melden Sie sich bei Ihrer Instanz ServiceNow als Administrator an.
    2. Navigieren zu Alle > Systemdefinition > Tabelle.
    3. Filtern und suchen Sie nach der Spoke-Webhook-Registrierungstabelle Workday HR.
      Beispiel: Workday-Webhook-Registrierung.
    4. Klicken Sie auf die zugehörige Liste Liste anzeigen.
    5. Klicken Sie auf Neu.
    6. Füllen Sie diese Werte im Formular aus.
      Feld Beschreibung
      Beschreibung Beschreibung des Webhook-Registrierungsdatensatzes. Geben Sie das Workday-Ereignis und die Authentifizierung für Benutzer erstellen ein.
      UserName Workday Benutzer, der über Integrationsrechte mit Workday Webservices verfügt.
      Passwort Passwort des Benutzers Workday.
      Workday-Ereignis Event, für das der Webhook eingerichtet wird Geben Sie Offboarding ein.
      Workday-Instanz Workday Host-URL und Mandantenname. Geben Sie die URL in diesem Format ein:https://<workday_host_url> /<workday_tenant_name>
    7. Klicken Sie mit der rechten Maustaste in den Header des Formulars und wählen Sie Speichern aus.
    8. Klicken Sie auf Benutzername und Passwort generieren.
      Kopieren und notieren Sie die Werte für Benutzername und Passwort. Diese Werte müssen in der Instanz Workday angegeben werden, um die Webhook-Anforderungen zu authentifizieren.
      Hinweis:
      Wenn Sie mehr als einen HIRE-BP in Ihrer Umgebung haben, müssen Sie alle HIRE-BPs so konfigurieren, dass der Webhook „Benutzer erstellen“ für alle HIRE-Mitarbeitertransaktionen aktiviert wird.

    Rufen Sie den Ressourcenpfad aus Ihrer ServiceNow -Instanz für den Webhook „Benutzer erstellen“ ab

    Rufen Sie den Ressourcenpfad aus Ihrer ServiceNow -Instanz zur späteren Verwendung ab, um Webhook-Anforderungen zum Erstellen eines Benutzers zu authentifizieren und die erforderlichen Daten aus der Anwendung Workday abzurufen

    Vorbereitungen

    Erforderliche Rolle: ServiceNow admin.

    Hinweis:
    Diese Konfigurationen müssen in Ihrer ServiceNow -Instanz durchgeführt werden.

    Prozedur

    1. Melden Sie sich bei Ihrer Instanz ServiceNow als Administrator an.
    2. Navigieren zu Alle > System-Webservices > Scripted Web Services > Scripted REST APIs.
    3. Öffnen Sie den Datensatz für die Spoke Workday HR.
    4. Klicken Sie auf der Registerkarte Ressourcen auf den Datensatz Rückruf.
    5. Notieren Sie den Wert des Ressourcenpfads, und speichern Sie ihn zur späteren Verwendung.

    Importieren Sie die CLAR-Datei in Ihre Workday -Instanz für den Webhook „Benutzer erstellen“.

    Importieren Sie die CLAR-Datei, die unter ServiceNow Store [] verfügbar ist, um den Webhook „Anwender erstellen“ einzurichten und Anforderungen von der Instanz ServiceNow zu authentifizieren.

    Vorbereitungen

    • Workday Studio muss installiert sein.
    • Zugriff auf benutzerdefinierte Berichtserstellungsrichtlinie.

      Erstellen Sie in Workday einen benutzerdefinierten Bericht basierend auf der Berichtsstruktur „New_Hire_record“, und geben Sie den Bericht für den ISU-Anwender frei.

    • Zugriff zum Bearbeiten der Geschäftsprozessdefinition.
    • Zugriff zum Erstellen und Bearbeiten des Integrationssystems.
    • Erforderliche Rolle: admin
    Hinweis:
    • Mit Ausnahme des Integrationsnamens, des Berichtsfelds XPath (falls erforderlich) und des Instanzheaders Workday werden Benutzer davor gewarnt, die Werte von Feldern oder Eigenschaften in der CLAR-Datei zu ändern.
    • Diese Konfigurationen müssen in Workday Studio durchgeführt werden.

    Prozedur

    1. Über die Workday-HR-Spoke -Seite in ServiceNow Store, laden Sie die Datei „Workday-HR-Webhook-Studio-Sample “ aus unterstützenden Links undDokumenten herunter.
    2. Entpacken Sie die Beispieldatei, um die CLAR-Datei zu erhalten.
    3. Importieren Sie die CLAR-Datei in Workday Studio.
    4. Navigieren Sie auf der Registerkarte Eigenschaften der StartHere- Komponente zu Services, und wählen Sie den für diesen Webhook erstellten RAAS-Bericht aus.
      Konfigurieren Sie die StartHere-Komponente
    5. Wählen Sie die Umgebung aus, in der Ihr Bericht vorhanden ist, z. B. Implementierung oder Sandbox, und konfigurieren Sie den Bericht gemäß Ihren Anforderungen.
    6. Geben Sie einen Berichtsnamen an, und wählen Sie den erforderlichen Bericht aus.
      Berichtname
    7. Geben Sie den Aliasnamen des Berichts an.
      Aliasname
    8. Nachdem der Berichtsalias hinzugefügt wurde, fügen Sie den ausgewählten Pfad des Berichts in Zusätzlicher Pfad hinzu, der zum Ausführen des Berichts basierend auf der Eingabeaufforderung verwendet wird.
      Zusätzlicher Pfad
    9. Geben Sie in der Komponente „Header festlegen “ Ihre Instanz Workday für den WorkdayInstance -Header an.
      Konfigurieren Sie die Komponente Header festlegen
    10. Geben Sie in den Eigenschaften von HttpOutdiese Werte ein.
      Feld Wert
      Endpunkt REST-Endpunkt
      Hinweis:
      HTTP-Methode POST
      Konfigurieren Sie die HttpOut-Eigenschaften
    11. Speichern Sie die Änderungen.
    12. Wählen Sie im Projektexplorer die Integration aus, und stellen Sie sie in Ihrem Workday -System bereit.
    13. Melden Sie sich bei Ihrer Instanz Workday an, und navigieren Sie zu Integration > Integrationssystem > Konfigurieren Sie Integrationsattribute.
      Konfigurieren Sie Integrationsattribute
    14. Geben Sie den Benutzernamen und das Passwort in Integrationsattribute konfigurieren an, die Sie in Generieren Sie Benutzername und Passwort in Ihrer ServiceNow -Instanzgeneriert haben.
      Konfigurieren Sie Integrationsattribute
    15. Ändern Sie einen Geschäftsprozess, und fügen Sie diese Integration Ihrem Geschäftsprozess hinzu.
      1. Bearbeiten Sie die Definition des Geschäftsprozesses.
        Bearbeiten Sie die Definition
      2. Wählen Sie das Gültigkeitsdatum aus, und klicken Sie auf OK.
      3. Klicken Sie auf das +-Zeichen, und fügen Sie einen neuen Geschäftsprozessschritt in BP hinzu.
      4. Wählen Sie einen Auftrag aus, der nach dem Abschlussschritt des Geschäftsprozesses liegt.
      5. Fügen Sie den Geschäftsprozess hinzu, und wählen Sie Typ als Integrationaus.
        Wählen Sie Integrationstyp aus
      6. Geben Sie den ISU-Benutzernamen in Als Benutzer ausführen ein, und klicken Sie auf OK.
      7. Klicken Sie im neu hinzugefügten Geschäftsprozessschritt in BP einstellen auf Integration konfigurieren.
        Konfigurieren Sie die Integration
      8. Wählen Sie in den Integrationskriterien Wert zur Laufzeit bestimmen als Werttyp und wählen Sie den Wert als Mitarbeiter-IDaus.
        Bestimmen Sie den Wert zur Laufzeit

        Das ausgewählte Feld „ Mitarbeiter-ID “ im Wert wird angezeigt.

        Feld Mitarbeiter-ID
      9. Klicken Sie auf OK.
      10. Erstellen Sie einen Bericht für den Webhook mit diesen Details:

        Berichtsdefinition:

        Berichtsdefinition

        Spaltenbezeichnungen:

        Spaltenbezeichnungen

        Berechnete Felddetails:

        Berechnete Felddetails

        Filter- und Aufforderungsdetails:

        Filter- und Eingabeaufforderungsdetails

    Richten Sie den Offboarding-Webhook für die Workday-HR-Spoke ein

    Verwenden Sie den Offboarding-Webhook, um die Details des Offboarding-Mitarbeiters aus Workday in Ihre ServiceNow-Instanz abzurufen.

    Generieren Sie Benutzername und Passwort in Ihrer ServiceNow -Instanz für den Offboarding-Webhook

    Generieren Sie Benutzername und Passwort in Ihrer Instanz ServiceNow, um Anforderungen für den Offboarding-Webhook zu authentifizieren und die erforderlichen Daten aus der Anwendung Workday abzurufen.

    Vorbereitungen

    Erforderliche Rolle: admin

    Hinweis:
    Diese Konfigurationen müssen in Ihrer ServiceNow -Instanz durchgeführt werden.

    Prozedur

    1. Melden Sie sich bei Ihrer Instanz ServiceNow als Administrator an.
    2. Navigieren zu Alle > Systemdefinition > Tabelle.
    3. Filtern und suchen Sie nach der Spoke-Webhook-Registrierungstabelle Workday HR.
      Beispiel: Workday-Webhook-Registrierung.
    4. Klicken Sie auf die zugehörige Liste Liste anzeigen.
    5. Klicken Sie auf Neu.
    6. Füllen Sie diese Werte im Formular aus.
      Feld Beschreibung
      Beschreibung Beschreibung des Webhook-Registrierungsdatensatzes. Geben Sie das Workday-Ereignis und die Authentifizierung für Offboarding ein.
      UserName Workday Benutzer, der über Integrationsrechte mit Workday Webservices verfügt.
      Passwort Passwort des Benutzers Workday.
      Workday-Ereignis Event, für das der Webhook eingerichtet wird Geben Sie Offboarding ein.
      Workday-Instanz Workday Host-URL und Mandantenname. Geben Sie die URL in diesem Format ein:https://<workday_host_url> /<workday_tenant_name>
    7. Klicken Sie mit der rechten Maustaste in den Header des Formulars und wählen Sie Speichern aus.
    8. Klicken Sie auf Benutzername und Passwort generieren.
      Kopieren und notieren Sie die Werte für Benutzername und Passwort. Diese Werte müssen in der Instanz Workday angegeben werden, um die Webhook-Anforderungen zu authentifizieren.
      Hinweis:
      Wenn Sie mehr als einen HIRE-BP in Ihrer Umgebung haben, müssen Sie alle HIRE-BPs so konfigurieren, dass der Webhook „Benutzer erstellen“ für alle HIRE-Mitarbeitertransaktionen aktiviert wird.

    Rufen Sie den Ressourcenpfad aus Ihrer ServiceNow -Instanz für den Offboarding-Webhook ab

    Rufen Sie den Ressourcenpfad aus Ihrer ServiceNow -Instanz zur späteren Verwendung ab, um Offboarding-Webhook-Anforderungen zu authentifizieren und die erforderlichen Daten aus der Anwendung Workday abzurufen

    Vorbereitungen

    Erforderliche Rolle: admin.

    Hinweis:
    Diese Konfigurationen müssen in Ihrer ServiceNow -Instanz durchgeführt werden.

    Prozedur

    1. Melden Sie sich bei Ihrer Instanz ServiceNow als Administrator an.
    2. Navigieren zu Alle > System-Webservices > Scripted Web Services > Scripted REST APIs.
    3. Öffnen Sie den Datensatz für die Spoke Workday HR.
    4. Klicken Sie auf der Registerkarte Ressourcen auf den Datensatz Rückruf.
    5. Notieren Sie den Wert des Ressourcenpfads, und speichern Sie ihn zur späteren Verwendung.

    Importieren Sie die CLAR-Datei in Ihre Workday -Instanz für den Offboarding-Webhook

    Importieren Sie die CLAR-Datei, die unter ServiceNow Store [] verfügbar ist, um den Offboarding-Webhook einzurichten und Anforderungen von der Instanz ServiceNow zu authentifizieren.

    Vorbereitungen

    • Workday Studio muss installiert sein.
    • Zugriff auf benutzerdefinierte Berichtserstellungsrichtlinie.

      Erstellen Sie in Workday einen benutzerdefinierten Bericht basierend auf der Berichtsstruktur „New_terminated_record“, und geben Sie den Bericht für den ISU-Anwender frei.

    • Zugriff zum Bearbeiten der Geschäftsprozessdefinition.
    • Zugriff zum Erstellen und Bearbeiten des Integrationssystems.
    • Erforderliche Rolle: admin
    Hinweis:
    • Mit Ausnahme des Integrationsnamens, des Berichtsfelds XPath (falls erforderlich) und des Instanzheaders Workday werden Benutzer davor gewarnt, die Werte von Feldern oder Eigenschaften in der CLAR-Datei zu ändern.
    • Diese Konfigurationen müssen in Workday Studio durchgeführt werden.

    Prozedur

    1. Über die Workday-HR-Spoke -Seite in ServiceNow Store, laden Sie die Datei „Workday-HR-Offboarding-Webhook-Studio-Sample “ von Supporting Links andDocuments herunter.
    2. Entpacken Sie die Beispieldatei, um die CLAR-Datei zu erhalten.
    3. Importieren Sie die CLAR-Datei in Workday Studio.
    4. Navigieren Sie auf der Registerkarte Eigenschaften der StartHere- Komponente zu Services, und wählen Sie den für diesen Webhook erstellten RAAS-Bericht aus.
      RAAS-Bericht für Offboarding-Spoke
    5. Wählen Sie die Umgebung aus, in der Ihr Bericht vorhanden ist, z. B. Implementierung oder Sandbox, und konfigurieren Sie den Bericht gemäß Ihren Anforderungen.
    6. Geben Sie einen Berichtsnamen an, und wählen Sie den erforderlichen Bericht aus.
      Benutzerdefinierter RaaS-Bericht für Offboarding-Webhook
    7. Geben Sie den Aliasnamen des Berichts an.
      Aliasbericht für Offboarding-Webhook
    8. Nachdem der Berichtsalias hinzugefügt wurde, fügen Sie den ausgewählten Pfad des Berichts in Zusätzlicher Pfad hinzu, der zum Ausführen des Berichts basierend auf der Eingabeaufforderung verwendet wird.
      Zusätzlicher Pfad für das Offboarding des Webhooks
    9. Wählen Sie den Berichtsalias aus.
    10. Geben Sie in der Komponente „Header festlegen “ Ihre Instanz Workday für den WorkdayInstance -Header an.
      Legen Sie den Offboarding-Webhook der Headerkomponente fest
    11. Geben Sie in den Eigenschaften von HttpOutdiese Werte ein.
      Feld Wert
      Endpunkt REST-Endpunkt
      Hinweis:
      HTTP-Methode POST
      httpout-Eigenschaften für Offboarding
    12. Speichern Sie die Änderungen.
    13. Wählen Sie im Projektexplorer die Integration aus, und stellen Sie sie in Ihrem Workday -System bereit.
    14. Melden Sie sich bei Ihrer Instanz Workday an, und navigieren Sie zu Integration > Integrationssystem > Konfigurieren Sie Integrationsattribute.
      Integrationsattribute konfigurieren Offboarding
    15. Geben Sie den Benutzernamen und das Passwort in Integrationsattribute konfigurieren an, die Sie in Generieren Sie Benutzername und Passwort in Ihrer ServiceNow -Instanz für den Offboarding-Webhookgeneriert haben.
      Konfiguration von Integrationsattributen Offboarding-Webhook
    16. Ändern Sie einen Geschäftsprozess, und fügen Sie diese Integration Ihrem Geschäftsprozess hinzu.
      1. Bearbeiten Sie die Definition des Geschäftsprozesses.
      2. Wählen Sie den ISU-Benutzer im Feld Workday-Account aus.
      3. Wählen Sie das Gültigkeitsdatum aus, und klicken Sie auf OK.
      4. Klicken Sie auf das +-Zeichen, und fügen Sie einen neuen Geschäftsprozessschritt in BP hinzu.
      5. Wählen Sie einen Auftrag aus, der nach dem Abschlussschritt des Geschäftsprozesses liegt.
      6. Fügen Sie den Geschäftsprozess hinzu, und wählen Sie Typ als Integrationaus.
      7. Geben Sie den ISU-Benutzernamen in Als Benutzer ausführen ein, und klicken Sie auf OK.
      8. Klicken Sie im neu hinzugefügten Geschäftsprozessschritt in BP einstellen auf Integration konfigurieren.
        Konfigurieren Sie den Offboarding-Webhook für die Integration
      9. Wählen Sie in den Integrationskriterien Wert zur Laufzeit bestimmen als Werttyp und wählen Sie den Wert als Mitarbeiter-IDaus.
        Wert der Integrationskriterien zur Laufzeit

        Das ausgewählte Feld Mitarbeiter-ID in Wert wird angezeigt.

        Integrationskriterien Mitarbeiter-ID für Offboarding-Webhook
      10. Klicken Sie auf OK.
      11. Öffnen Sie die Aufgabe Benutzerdefinierten Bericht erstellen.
      12. Geben Sie den Namen des Berichts ein, z. B. New_terminated_record.
      13. Wählen Sie als Berichtstyp Erweitert aus.
      14. Deaktivieren Sie die Option Optimiert für Leistung.
      15. Wählen Sie als Datenquelle Alle Worker aus.
        Zeigen Sie den benutzerdefinierten Offboarding-Bericht an
      16. Erstellen Sie einen Bericht wie unten gezeigt:
        Beispielbericht für Offboarding-Webhook

        Gruppenspaltenüberschriften in Berichten Gruppenspaltenüberschriften in Berichten

        Abschnitt in Berichten sortieren

        Filterabschnitt in Berichten Filterabschnitt in Berichten

      17. Wählen Sie auf der Registerkarte „ Eingabeaufforderungen “ die Option Standardwerte für nicht definierte Aufforderung ausfüllen aus.
      18. Wählen Sie auf der Registerkarte Erweitert die Option Als Webservice aktivieren aus.

    Richten Sie den LeaveofAbsence-Webhook für die Workday-HR-Spoke ein

    Verwenden Sie den LeaveofAbsence-Webhook, um Details zur Beurlaubung eines Mitarbeiters aus Workday in Ihre ServiceNow-Instanz abzurufen.

    Generieren Sie Benutzername und Passwort in Ihrer ServiceNow -Instanz für LeaveofAbsence-Webhook

    Generieren Sie Benutzername und Passwort in Ihrer ServiceNow -Instanz, um Anforderungen für den LeaveofAbsence-Webhook zu authentifizieren und die erforderlichen Daten aus der Workday -Anwendung abzurufen.

    Vorbereitungen

    Erforderliche Rolle: admin

    Hinweis:
    Diese Konfigurationen müssen in Ihrer ServiceNow -Instanz durchgeführt werden.

    Prozedur

    1. Melden Sie sich bei Ihrer Instanz ServiceNow als Administrator an.
    2. Navigieren zu Alle > Systemdefinition > Tabelle.
    3. Filtern und suchen Sie nach der Spoke-Webhook-Registrierungstabelle Workday HR, z. B. Workday-Webhook-Registrierung.
    4. Klicken Sie auf die zugehörige Liste Liste anzeigen.
    5. Klicken Sie auf Neu.
    6. Füllen Sie diese Werte im Formular aus.
      Feld Beschreibung
      Beschreibung Beschreibung des Webhook-Registrierungsdatensatzes. Geben Sie das Workday-Ereignis und die Authentifizierung für die Beurlaubung ein.
      UserName Workday Benutzer, der über Integrationsrechte mit Workday Webservices verfügt.
      Passwort Passwort des Benutzers Workday.
      Workday-Ereignis Event, für das der Webhook eingerichtet wird Geben Sie Beurlaubung ein.
      Workday-Instanz Workday Host-URL und Mandantenname. Geben Sie die URL in diesem Format ein:https://<workday_host_url> /<workday_tenant_name>
    7. Klicken Sie mit der rechten Maustaste in den Header des Formulars und wählen Sie Speichern aus.
    8. Klicken Sie auf Benutzername und Passwort generieren.
      Kopieren und notieren Sie die Werte für Benutzername und Passwort. Diese Werte müssen in der Instanz Workday angegeben werden, um die Webhook-Anforderungen zu authentifizieren.
      Hinweis:
      Wenn Sie mehr als einen HIRE-BP in Ihrer Umgebung haben, müssen Sie alle HIRE-BPs so konfigurieren, dass der Webhook „Benutzer erstellen“ für alle HIRE-Mitarbeitertransaktionen aktiviert wird.

    Rufen Sie den Ressourcenpfad aus Ihrer ServiceNow -Instanz für den LeaveofAbsence-Webhook ab

    Rufen Sie den Ressourcenpfad aus Ihrer ServiceNow -Instanz zur späteren Verwendung ab, um Offboarding-Webhook-Anforderungen zu authentifizieren und die erforderlichen Daten aus der Anwendung Workday abzurufen

    Vorbereitungen

    Erforderliche Rolle: admin.

    Hinweis:
    Diese Konfigurationen müssen in Ihrer ServiceNow -Instanz durchgeführt werden.

    Prozedur

    1. Melden Sie sich bei Ihrer Instanz ServiceNow als Administrator an.
    2. Navigieren zu Alle > System-Webservices > Scripted Web Services > Scripted REST APIs.
    3. Öffnen Sie den Datensatz für die Spoke Workday HR.
    4. Klicken Sie auf der Registerkarte Ressourcen auf den Datensatz Rückruf.
    5. Notieren Sie den Wert des Ressourcenpfads, und speichern Sie ihn zur späteren Verwendung.

    Importieren Sie die CLAR-Datei in Ihre Workday -Instanz für LeaveofAbsence-Webhook

    Importieren Sie die CLAR-Datei, die unter ServiceNow Store [] verfügbar ist, um den LeaveofAbsence-Webhook einzurichten und Anforderungen von der Instanz ServiceNow zu authentifizieren.

    Vorbereitungen

    • Workday Studio muss installiert sein.
    • Zugriff auf benutzerdefinierte Berichtserstellungsrichtlinie.

      Erstellen Sie in Workday einen benutzerdefinierten Bericht basierend auf der Berichtsstruktur Leave_of_absence_request, und geben Sie den Bericht für den ISU-Anwender frei.

    • Zugriff zum Bearbeiten der Geschäftsprozessdefinition.
    • Zugriff zum Erstellen und Bearbeiten des Integrationssystems.
    • Erforderliche Rolle: admin
    Hinweis:
    • Mit Ausnahme des Integrationsnamens, des Berichtsfelds XPath (falls erforderlich) und des Instanzheaders Workday werden Benutzer davor gewarnt, die Werte von Feldern oder Eigenschaften in der CLAR-Datei zu ändern.
    • Diese Konfigurationen müssen in Workday Studio durchgeführt werden.

    Prozedur

    1. Über die Workday-HR-Spoke -Seite in ServiceNow Store, laden Sie die Datei Workday-HR-Leave-of-Absence-Webhook-Studio-Sample von Supporting Links andDocuments herunter.
    2. Entpacken Sie die Beispieldatei, um die CLAR-Datei zu erhalten.
    3. Importieren Sie die CLAR-Datei in Workday Studio.
    4. Navigieren Sie auf der Registerkarte Eigenschaften der StartHere- Komponente zu Services, und wählen Sie den für diesen Webhook erstellten RAAS-Bericht aus.
      RaaS-Bericht für Beurlaubungs-Webhook
    5. Wählen Sie die Umgebung aus, in der Ihr Bericht vorhanden ist, z. B. Implementierung oder Sandbox, und konfigurieren Sie den Bericht gemäß Ihren Anforderungen.
    6. Geben Sie einen Berichtsnamen an, und wählen Sie den erforderlichen Bericht aus.
      Benutzerdefinierter RaaS-Bericht für Beurlaubungs-Webhook
    7. Geben Sie den Aliasnamen des Berichts an.
      Alias für den Berichtsnamen
    8. Nachdem der Berichtsalias hinzugefügt wurde, fügen Sie den ausgewählten Pfad des Berichts in Zusätzlicher Pfad hinzu, der zum Ausführen des Berichts basierend auf der Eingabeaufforderung verwendet wird.
      Zusätzlicher Pfad für Berichtsalias
    9. Wählen Sie den Berichtsalias aus.
    10. Geben Sie in der Komponente „Header festlegen “ Ihre Instanz Workday für den WorkdayInstance -Header an.
      Legen Sie Header für die Workday-Instanz fest
    11. Geben Sie in den Eigenschaften von HttpOutdiese Werte ein.
      Feld Wert
      Endpunkt REST-Endpunkt
      Hinweis:
      HTTP-Methode POST
      http out-Eigenschaften für Beurlaubungs-Webhook
    12. Speichern Sie die Änderungen.
    13. Wählen Sie im Projektexplorer die Integration aus, und stellen Sie sie in Ihrem Workday -System bereit.
    14. Melden Sie sich bei Ihrer Instanz Workday an, und navigieren Sie zu Integration > Integrationssystem > Konfigurieren Sie Integrationsattribute.
      Konfigurieren Sie Integrationsattribute für den Beurlaubungs-Webhook
    15. Geben Sie den Benutzernamen und das Passwort in Integrationsattribute konfigurieren an, die Sie in Generieren Sie Benutzername und Passwort in Ihrer ServiceNow -Instanz für LeaveofAbsence-Webhookgeneriert haben.
      Benutzername und Passwort für die Konfiguration der Integrationsattribute
    16. Ändern Sie einen Geschäftsprozess, und fügen Sie diese Integration Ihrem Geschäftsprozess hinzu.
      1. Bearbeiten Sie die Definition des Geschäftsprozesses.
        Geschäftsprozessdefinition
      2. Wählen Sie den ISU-Benutzer im Feld Workday-Account aus.
      3. Wählen Sie das Gültigkeitsdatum aus, und klicken Sie auf OK.
      4. Klicken Sie auf das +-Zeichen, und fügen Sie einen neuen Geschäftsprozessschritt in BP hinzu.
      5. Wählen Sie einen Auftrag aus, der nach dem Abschlussschritt des Geschäftsprozesses liegt.
      6. Fügen Sie den Geschäftsprozess hinzu, und wählen Sie Typ als Integrationaus.
        Integration des Geschäftsprozesstyps
      7. Geben Sie den ISU-Benutzernamen in Als Benutzer ausführen ein, und klicken Sie auf OK.
      8. Klicken Sie im neu hinzugefügten Geschäftsprozessschritt in BP einstellen auf Integration konfigurieren.
        Konfigurieren Sie die Integration für den Geschäftsprozess
      9. Wählen Sie in den Integrationskriterien Wert zur Laufzeit bestimmen als Werttyp und wählen Sie den Wert als Mitarbeiter-IDaus.
        Wert der Integrationskriterien zur Laufzeit

        Das ausgewählte Feld „ Mitarbeiter-ID “ im Wert wird angezeigt.

        Mitarbeiter-ID, die für die Integrationskriterien ausgewählt wurde
      10. Klicken Sie auf OK.
      11. Öffnen Sie die Aufgabe Benutzerdefinierten Bericht erstellen.
      12. Geben Sie den Namen des Berichts ein, z. B. Leave_of_absence_request.
      13. Wählen Sie als Berichtstyp Erweitert aus.
      14. Deaktivieren Sie die Option Optimiert für Leistung.
      15. Wählen Sie als DatenquelleAlle aktiven und beendeten Mitarbeiteraus.
      16. Erstellen Sie einen Bericht wie unten gezeigt:
        Beispielbericht

        Abschnitt „Gruppenspaltenüberschrift“ im Bericht Gruppenspaltenüberschriften im Bericht

        Filterabschnitt im Bericht Filterabschnitt im Bericht

      17. Wählen Sie auf der Registerkarte „ Eingabeaufforderungen “ die Option Standardwerte für nicht definierte Aufforderung ausfüllen aus.
      18. Wählen Sie auf der Registerkarte Erweitert die Option Als Webservice aktivieren aus.