Erweitern Sie die Funktionalität von Workday HR Spoke

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

Um zu erweitern Workday HR Spoke, stellen Sie sicher, dass der Administrator über die Kenntnis hat Workday API für öffentliche Webservices Und können konfigurieren Workday System.

Erweitern Sie die Aktion „Mitarbeiter suchen“

Die Aktion „Mitarbeiter suchen“, die zusammen mit der Spoke verfügbar ist, stellt die meisten erforderlichen Eingaben und Ausgaben bereit. Bevor Sie dieser Aktion weitere Eingaben und Ausgaben hinzufügen, erkunden Sie Möglichkeiten zur Verwendung der standardmäßigen Spoke-Aktion.

Diese Aktion transformiert die Eingabefelddatenpillen in Workday HR Spoke mit zugehörigem Workday Fordert eine XML-Nachricht an und rendert synchron zurück Workday Antwort-XML-Nachricht als Ausgabefeld-Datenpillen in ServiceNow Workflow-Studio. Vergewissern Sie sich, dass Sie überprüfen Beispiel für Anforderungsnachricht Und Beispiel für Antwortnachricht .

Ändern oder erweitern Sie die Standardaktion „Mitarbeiter suchen“, indem Sie eine Kopie davon erstellen.

So fügen Sie die Positionsreferenz-ID als Teil der Anforderungskriterien für diese Aktion hinzu:

Hinweis:

• Überprüfen Sie, ob das reguläre Eingabefeld oder das Zusätzliches Feld Das Eingabefeld hat die gewünschte Eingabe. Wenn keiner der beiden die gewünschte Eingabe hat, führen Sie diese Anweisungen aus, um das erforderliche Eingabefeld manuell zu erstellen.
• Die Aktion „Mitarbeiter suchen“ unterstützt das Anforderungselement „Positionsreferenz-ID“ in Zusätzliche Felder Eingabefeld. Zu Demonstrationszwecken wird dieses Feld manuell in der Anwenderoberfläche hinzugefügt.

1. Bewerten und verstehen Sie, wie die Positionsreferenz-ID in strukturiert ist Workday-Anforderungsnachricht . Der XPath zum Hinzufügen einer Positionsreferenz-ID in der Anforderungsnachricht wird gemäß doppelt gefaltet Community-Beitrag zu Workday Public Web Services .
   1. Attribut „Positionsreferenztyp“ : Get_Worker_Request/Request_Criteria/Position_Reference/@type
   2. Der oben genannte Attributwert gemäß dem Dokument für öffentliche Webservices ist eine hartcodierte „Positions-ID“.

      

   3. Positionsreferenzwert: Get_Worker_Request/Request_Criteria/Position_Reference
   4. Der obige ist-Wert ist ein neues Eingabefeld in der Spoke-Aktion.
2. Erstellen Sie eine Eingabevariable in Aktionseingabe Schritt. Klicken Sie Auf Eingabe Erstellen Und fügen Sie eine einfache Eingabevariable vom Typ Zeichenfolge hinzu.

   

3. Erstellen Sie eine Eingabevariable im Schritt Vorverarbeitungsskript.
   1. Klicken Sie Auf Variable Erstellen .
   2. Fügen Sie den Namen der Eingabevariable mit dem Namen hinzu Position_Reference_ID .
   3. Ziehen Sie Positionsreferenz-ID Datenpille von Eingabevariablen Und legen Sie sie am Wert der Eingabevariable ab.

      

4. Nutzen Sie das Designmuster von var organisierationReferenceStr im Skriptabschnitt.
   1. Erstellen Sie den XML-Knoten, der dem entspricht Workday – Mitarbeiteranforderungsnachricht abrufen In diesem Beispiel.
   2. Suchen Sie entsprechend das entsprechende Designmuster im Skriptabschnitt. 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 mit dem ähnlichen XML-Knoten verglichen wird, ist die Organisationsreferenz ein guter Kandidat, um das zugehörige Designmusterskript aus zu nutzen. In Skript Abschnitt befindet sich das zugehörige Skript-Fragment unter „var organisierungReferenceStr.

      <bsvc:Organization_Reference bsvc:Descriptor="string">
      <bsvc:ID bsvc:type="Organization_ID">string</bsvc:ID>
      </bsvc:Organization_Reference>
      

   4. Verwenden Sie das Code-Snippet „var organisierationReferenceStr“, um den XML-Knoten der Positionsreferenz entsprechend zu erstellen.

      

   5. Im selben Skript, in VAR-Anforderung Verwenden Sie das Designmuster, und definieren Sie eine Ausgabevariable.

      

5. Erstellen Sie den XML-Knoten der Position im SOAP-Schritt.
   1. Siehe Workday – Mitarbeiteranforderungsnachricht abrufen Und der Positionsreferenzknoten entsprechend.

      

   2. Speichern und veröffentlichen Sie es.
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.

      

   2. Geben Sie An Positions-ID Und testen Sie den Flow.

      

   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.

      

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 strukturiert ist Workday-Antwortnachricht .
   • Lokaler Vorname: Der XPath für dieses Element ist GET_Worker_Response/Response_Data/Worker/Worker_Data/Personal_Data/Name_Data/legal_Name_Data/Name_Data/Name_Detail_Data/local_Name_Detail_Data/first_Name
   • Lokaler Nachname: Der XPath für dieses Element ist GET_Worker_Response/Response_Data/Worker/Worker_Data/Personal_Data/Name_Data/legal_Name_Data/Name_Data/Name_Detail_Data/local_Name_Detail_Data/Last_Name
2. Nutzen Sie das Designmuster für den offiziellen Namen 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,
           };
   

   

3. Fügen Sie dem PersonalData-Objekt LocalLegalName hinzu.

   

4. Erstellen Sie Ausgabevariablen in Ausgaben Schritt.
   1. Klicken Sie Auf Bearbeiten Sie Die Ausgabe .
   2. Ausgabefelder müssen nicht der Hierarchie der exakten Workday-Antwortnachricht folgen. Solange der XPath aus Schritt 2 dem richtigen Workday-XPath folgt, kann die Spoke-Aktion die Elemente entsprechend rendern. In diesem Fall wird hinzugefügt Lokaler Offizieller Name Unter Personenbezogene Daten Ist ausreichend.

      

      Hinweis:

      Name der Zeichenfolgenvariablen unter Name Abschnitt muss mit demselben VAR-Namen übereinstimmen, der in Schritt 2 oben definiert wurde.
5. Speichern und veröffentlichen Sie die Aktion.
   Hinweis:

   Die Aktion „Mitarbeiter suchen“ hat eine maximale Anzahl von Ausgabeelementen, die eine Datenstromaktion haben kann. Wenn beim Veröffentlichen der kopierten Aktion mit neuen Ausgabeelementen ein Fehler auftritt, löschen Sie einige Ausgabeelemente, die nicht erforderlich sind, und versuchen Sie erneut, sie zu veröffentlichen.
6. Testen Sie die Aktion.
   1. Stellen Sie sicher, dass der Betreff des Testmitarbeiters in Workday den lokalen Vornamen und den lokalen Nachnamen hat.
   2. Erstellen Sie einen Beispiel-Flow, fügen Sie ihm die Aktion hinzu, und protokollieren Sie die Antwort, um Ausgabeelemente zu verifizieren.

      

   3. Geben Sie die Mitarbeiter-ID des zugehörigen Testarbeiters an, um den Flow zu testen und auszuführen.

      

   4. Überprüfen Sie das Protokoll und die Ausführungen, um sicherzustellen, dass der lokale Vorname und der lokale Nachname korrekt abgerufen werden.