Erweitern Sie die Funktionalität der Spoke Workday HR-

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 4 Minuten Lesedauer

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

    Stellen Sie zum Erweitern der Workday HR- -Spoke sicher, dass der Administrator Bescheid weiß Workday Public Web Services-API und können das System Workday konfigurieren.

    Erweitern Sie die Aktion „Mitarbeiter suchen“.

    Die Aktion Mitarbeiter 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, informieren Sie sich über die Möglichkeiten zur Verwendung der Standard-Spoke-Aktion.

    Diese Aktion wandelt die Datenpillen des Eingabefelds in der Spoke Workday HR- in die zugeordnete Anforderungs-XML-Nachricht Workday um und rendert die XML-Antwortnachricht Workday synchron als Datenpillen des Ausgabefelds in ServiceNow Workflow-Studiozurück. Achten Sie darauf, Beispielanforderungsnachricht und Beispielantwortnachrichtzu aktivieren.

    Ändern oder erweitern Sie die Standardaktion „Mitarbeiter 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 „Positionsreferenz-ID“ im Eingabefeld „ Zusätzliche Felder “. Zu Demonstrationszwecken wird dieses Feld manuell in der Anwenderoberfläche hinzugefügt.
    1. Bewerten und verstehen Sie, wie die Stellenreferenz-ID in der Workday-Anforderungsnachrichtstrukturiert ist. Der XPath zum Hinzufügen einer Positionsreferenz-ID in der Anforderungsnachricht ist gemäß Community-Beitrag zu Workday Public Web Serviceszweigeteilt.
      1. Positionsreferenztyp-Attribut: Get_Workers_Request/Request_Criteria/Position_Reference/@type
      2. Der obige Attributwert ist gemäß dem Dokument für öffentliche Webservices eine hartcodierte „Positions-ID“.
        Positions-ID
      3. Positionsreferenzwert: Get_Workers_Request/Request_Criteria/Position_Reference
      4. Der obige Ist-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 eine Eingabevariable im Skriptschritt „Vorverarbeitung“.
      1. Klicken Sie auf Variable erstellen.
      2. Fügen Sie den Namen der Eingabevariablen mit dem Namen position_reference_idhinzu.
      3. Ziehen Sie die Datenpille „Positionsreferenz-ID“ aus Eingabevariablen, und legen Sie sie auf den Wert der Eingabevariablen.
        Positionsreferenz-ID
    4. Nutzen Sie das Designmuster der var organizationReferenceStr im Skriptabschnitt.
      1. Erstellen Sie den XML-Knoten, der der Workday-Nachricht „Mitarbeiteranforderung abrufen“ in diesem Beispiel entspricht.
      2. Suchen Sie entsprechend im Skriptabschnitt nach dem entsprechenden Designmuster. 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 Designmuster-Skript 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. Nutzen Sie das Codefragment var organizationReferenceStr, um den Positionsreferenz-XML-Knoten entsprechend zu erstellen.
        var organizationReferenceStr – Codefragment.
      5. Nutzen Sie im selben Skript im Abschnitt „Var-Anforderung“ das Designmuster, und definieren Sie eine Ausgabevariable.
        Abschnitt„Var-Anforderung“.
    5. Erstellen Sie den Positions-XML-Knoten im SOAP-Schritt.
      1. Weitere Informationen finden Sie in der Workday-Nachricht „Mitarbeiteranforderung abrufen“ und entsprechend auf dem Positionsreferenzknoten.
        Positionsreferenzknoten.
      2. Speichern und veröffentlichen Sie sie.
    6. Testen Sie die Aktion.
      1. Da es sich um eine Datenstromaktion handelt, sollte sie mit einem Flow getestet werden. Erstellen Sie einen Beispiel-Flow mit der darin enthaltenen Aktion.
        Testet die Aktion in einem Flow.
      2. Geben Sie die Positions-ID an, und testen Sie den Flow.
        Geben Sie die Positions-ID an.
      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üft 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 Workday-Antwortnachrichtstrukturiert 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 Designmuster „Rechtlicher Name“ im Schritt „Skript-Parser“, 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 des offiziellen Namens im Schritt „Skriptparser“.
    3. Fügen Sie dem Objekt „PersonalData“ den LocalLegalName hinzu.
      LocalLegalName für das PersonalData-Objekt.
    4. Erstellen Sie Ausgabevariablen im Schritt Ausgaben.
      1. Klicken Sie auf Ausgabe bearbeiten.
      2. Ausgabefelder müssen nicht der genauen Hierarchie der Workday-Antwortnachrichten 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 „Personal Data“ hinzuzufügen.
        Ausgabefelder
        Hinweis:
        Der Name der Zeichenfolgenvariablen im Abschnitt „Name“ muss mit dem in Schritt 2 oben definierten Variablennamen übereinstimmen.
    5. Speichern und veröffentlichen Sie die Aktion.
      Hinweis:
      Die Aktion „Mitarbeiter suchen“ hat die 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, sie zu veröffentlichen.
    6. Testen Sie die Aktion.
      1. Stellen Sie sicher, dass für den Betreff des Test-Mitarbeiters der lokale Vorname und der lokale Nachname in Workday angegeben sind.
      2. Erstellen Sie einen Beispiel-Flow, fügen Sie ihm die Aktion hinzu, und protokollieren Sie die Antwort, um die Ausgabeelemente zu überprüfen.
        Testen Sie die Aktion.
      3. Geben Sie die Mitarbeiter-ID des zugehörigen Test-Worker-Betreffs 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 zu überprüfen, ob der lokale Vorname und der lokale Nachname ordnungsgemäß abgerufen wurden.
        Verifizieren Sie die -Ausführungen.