Erweitern Sie die Funktionalität der Spoke Workday HR .

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 4 Minuten Lesedauer

    • Erweitern Sie die Spoke Workday HR über die Standardfunktionalitäten hinaus, z. B. durch Hinzufügen neuer Eingabe- und Ausgabefelder.

    Um die Spoke Workday HR zu erweitern, stellen Sie sicher, dass der Administrator den kennt Workday Öffentliche Webservices-API und können das Workday -System konfigurieren.

    Erweitern Sie die Aktion Mitarbeiter suchen

    Die Aktion Workers suchen, die zusammen mit der Spoke verfügbar ist, bietet die meisten erforderlichen Eingaben und Ausgaben. Bevor Sie dieser Aktion weitere Ein- und Ausgaben hinzufügen, prüfen Sie, wie Sie die standardmäßige Spoke-Aktion verwenden können.

    Diese Aktion transformiert die Eingabefeld-Datenpillen in der Spoke Workday HR in die zugeordnete Workday Anforderungs-XML-Nachricht und rendert die Workday Antwort-XML-Nachricht synchron als Ausgabefeld-Datenpillen in ServiceNow Flow Designer. Stellen Sie sicher, dass Sie die Beispielanforderungsnachricht und die Beispielantwortnachrichtüberprüfen.

    Ändern oder erweitern Sie die Standardaktion Workers suchen, indem Sie eine Kopie davon erstellen.
    Erstellen Sie eine Kopie der Aktion.
    So fügen Sie die Positionsreferenz-ID als Teil der Anforderungskriterien für diese Aktion hinzu:
    Hinweis:
    • Stellen Sie sicher, dass Sie überprüfen, ob das reguläre Eingabefeld oder das Eingabefeld Zusätzliches Feld die gewünschte Eingabe enthält. Wenn keines von ihnen die gewünschte Eingabe enthält, führen Sie diese Anweisungen aus, um das erforderliche Eingabefeld manuell zu erstellen.
    • Die Aktion Mitarbeiter suchen unterstützt das Anforderungselement „Stellenreferenz-ID“ im Eingabefeld „ Zusätzliche Felder “. Zu Demonstrationszwecken wird dieses Feld manuell in der Benutzeroberfläche hinzugefügt.
    1. Bewerten und verstehen Sie, wie die Positionsreferenz-ID in der Workday-Anforderungsnachrichtstrukturiert ist. Der XPath zum Hinzufügen einer Positionsreferenz-ID in der Anforderungsnachricht ist gemäß dem Community- Beitrag für öffentliche Webservices von Workday zweifach.
      1. Attribut „Positionsreferenztyp“: Get_Workers_Request/Request_Criteria/Position_Reference/@type
      2. Der obige Attributwert ist laut Dokument für öffentliche Webservices eine hartcodierte „Positions-ID“.
        Positions-ID
      3. Positionsreferenzwert: Get_Workers_Request/Request_Criteria/Position_Reference
      4. Der obige tatsächliche Wert ist ein neues Eingabefeld in der Spoke-Aktion.
    2. Erstellen Sie im Schritt „Aktionseingabe“ eine Eingabevariable. Klicken Sie auf Eingabe erstellen, und fügen Sie eine Eingabevariable vom Typ einfache Zeichenfolge hinzu.
      Erstellen Sie die Eingabe „Positionsreferenz-ID“.
    3. Erstellen Sie im Skriptschritt Vorverarbeitung eine Eingabevariable.
      1. Klicken Sie auf Variable erstellen.
      2. Fügen Sie den Namen der Eingabevariablen mit dem Namen position_reference_id hinzu.
      3. Ziehen Sie die Datenpille „Positionsreferenz- ID “ aus Eingabevariablen und legen Sie sie am Wert der Eingabevariablen ab.
        Positionsreferenz-ID
    4. Nutzen Sie das Designmuster von var organizationReferenceStr im Skriptabschnitt.
      1. Erstellen Sie den XML-Knoten so, dass er der Workday-Nachricht „Arbeiteranforderung abrufen“ in diesem Beispiel entspricht.
      2. Suchen Sie das entsprechende Designmuster im Skriptabschnitt entsprechend. In diesem Beispiel muss dieser XML-Knoten für die Positionsreferenz erstellt werden.
        <bsvc:Position_Reference bsvc:Descriptor="string">
<bsvc:ID bsvc:type="Position_ID">string</bsvc:ID>
</bsvc:Position_Reference>
      3. Wenn die obige XML-Datei mit dem ähnlichen XML-Knoten verglichen wird, ist die Organisationsreferenz ein guter Kandidat, um das zugehörige Designmusterskript aus zu nutzen. Im Abschnitt „ Skript “ befindet sich das zugehörige Skriptfragment unter „var organizationReferenceStr“. 
        <bsvc:Organization_Reference bsvc:Descriptor="string">
<bsvc:ID bsvc:type="Organization_ID">string</bsvc:ID>
</bsvc:Organization_Reference>
      4. Verwenden Sie das Code-Fragment var organizationReferenceStr, um den XML-Knoten der Positionsreferenz entsprechend zu erstellen.
        var organizationReferenceStr Code-Fragment.
      5. Nutzen Sie im selben Skript im Abschnitt „ var request “ das Entwurfsmuster, und definieren Sie eine Ausgabevariable.
        var-Anforderungsabschnitt.
    5. Erstellen Sie den Positions-XML-Knoten im SOAP-Schritt.
      1. Weitere Informationen finden Sie in der Workday-Nachricht „Mitarbeiteranforderung abrufen“ und den entsprechenden Positionsreferenzknoten.
        Positionsreferenzknoten.
      2. Speichern und veröffentlichen Sie sie.
    6. Testen Sie die Aktion.
      1. Da dies eine Datenstromaktion ist, sollte sie mit einem Flow getestet werden. Erstellen Sie einen Beispiel-Flow mit der darin enthaltenen Aktion.
        Testaktion in einem Flow.
      2. Geben Sie die Positions-ID an, und testen Sie den Flow.
        Geben Sie die Positions-IDan.
      3. Öffnen Sie die Ausführung, und navigieren Sie zum SOAP-Schritt, um zu überprüfen, ob der aktualisierte XML-Elementknoten mit Positionsreferenz erstellt wurde.
        Überprüfen Sie die Ausführung.

    Fügen Sie Ausgabefelder der Workday-Spoke-Aktion hinzu, und ändern Sie sie

    Erweitern Sie die Workday-Spoke, um den lokalen Vornamen und den lokalen Nachnamen abzurufen.

    1. Bewerten und verstehen Sie, wie der lokale Name in der Antwortnachricht von Workdaystrukturiert ist.
      • Lokaler Vorname: Der XPath für dieses Element lautet Get_Workers_Response/Response_Data/Worker/Worker_Data/Personal_Data/Name_Data/Legal_Name_Data/Name_Detail_Data/Local_Name_Detail_Data/First_Name
      • Lokaler Nachname: Der XPath für dieses Element lautet Get_Workers_Response/Response_Data/Worker/Worker_Data/Personal_Data/Name_Data/Legal_Name_Data/Name_Detail_Data/Local_Name_Detail_Data/Last_Name
    2. Nutzen Sie das Entwurfsmuster „Octoberfester Name“ im Schritt „Skriptparser“, und erstellen Sie das Fragment für den lokalen offiziellen Namen.
      var LocalFirstName = xmlDoc.getNodeText(Worker_DataXpath.concat("wd:Personal_Data/wd:Name_Data/wd:Legal_Name_Data/wd:Name_Detail_Data/wd:Local_Name_Detail_Data/wd:First_Name"));
        var LocalLastName = xmlDoc.getNodeText(Worker_DataXpath.concat("wd:Personal_Data/wd:Name_Data/wd:Legal_Name_Data/wd:Name_Detail_Data/wd:Local_Name_Detail_Data/wd:Last_Name"));

        var LocalLegalName = {
            LocalFirstName: LocalFirstName,
            LocalLastName: LocalLastName,
        };
      Designmuster „Obligatorischer Name“ im Schritt „Skriptparser“.
    3. Fügen Sie dem Objekt „PersonalData“ den LocalLegalName hinzu.
      LocalLegalName zum Objekt „PersonalData“.
    4. Erstellen Sie Ausgabevariablen im Schritt Ausgaben.
      1. Klicken Sie auf Ausgabe bearbeiten.
      2. Ausgabefelder müssen nicht der exakten Antwortnachrichtenhierarchie von Workday entsprechen. Solange der XPath aus Schritt 2 dem richtigen Workday-XPath folgt, kann die Spoke-Aktion die Elemente entsprechend rendern. In diesem Fall reicht es aus, den lokalen offiziellen Namen unter „Persönliche Daten “ hinzuzufügen.
        Ausgabefelder.
        Hinweis:
        Der Name der Zeichenfolgenvariablen im Abschnitt „ Name “ muss mit demselben Variablennamen übereinstimmen, der in Schritt 2 oben definiert ist.
    5. Speichern und veröffentlichen Sie die Aktion.
      Hinweis:
      Die Aktion Worker suchen hat eine maximale Anzahl von Ausgabeelementen, die eine Datenstromaktion haben kann. Wenn während der Veröffentlichung einer kopierten Aktion mit neuen Ausgabeelementen ein Fehler auftritt, löschen Sie einige nicht erforderliche Ausgabeelemente, und versuchen Sie erneut, zu veröffentlichen.
    6. Testen Sie die Aktion.
      1. Stellen Sie sicher, dass der Antragsteller des Testmitarbeiters den lokalen Vornamen und Nachnamen in Workday hat.
      2. Erstellen Sie einen Beispiel-Flow, fügen Sie die Aktion hinzu, und protokollieren Sie die Antwort, um Ausgabeelemente zu überprüfen.
        Testen Sie die Aktion.
      3. Geben Sie die Mitarbeiter-ID des zugehörigen Testmitarbeiter-Antragstellers an, um den Flow zu testen und auszuführen.
        Führen Sie den Flow aus.
      4. Überprüfen Sie das Protokoll und die Ausführungen, um sicherzustellen, dass der lokale Vorname und der lokale Nachname korrekt abgerufen wurden.
        Überprüfen Sie die Ausführungen.