Erweitern Sie die Funktionalität von WorkdayHR Spoke

Erweitern Sie WorkdayHR Spoke über die Standardfunktionen hinaus, z. B. Hinzufügen neuer Eingabe- und Ausgabefelder.

Um zu erweitern WorkdayHR Spoke, stellen Sie sicher, dass der Administrator über informiert ist 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.

Mit dieser Aktion werden die Eingabefeld-Datenpillen in transformiert WorkdayHR Sprach mit zugehörigem Workday Fordert die XML-Nachricht an und rendert synchron zurück Workday Antwort-XML-Nachricht als Ausgabefeld-Datenpillen in ServiceNow Workflow-Studio. Stellen Sie sicher, dass Sie überprüfen Beispiel für Anforderungsnachricht Und Beispielantwortnachricht .

Ä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 öffentlichen Workday-Webservices .
   1. Attribut für 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 Erstellen Sie Eine Variable .
   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 organisationReferenceStr“ im Skriptabschnitt.
   1. Erstellen Sie den XML-Knoten, der mit übereinstimmt Workday – Nachricht für Mitarbeiteranforderung 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 organisationReferenceStr.

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

   4. Nutzen Sie das Code-Fragment VAR organisierungReferenceStr, 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 Positions-XML-Knoten im SOAP-Schritt.
   1. Siehe Workday – Nachricht für Mitarbeiteranforderung 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_Data/Personal_Data/Name_Data/legal_Name_Data/legal_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 den 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 Exact 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 Persönliche Daten Ist ausreichend.

      

      Hinweis:

      Name der Zeichenfolgenvariablen unter Name Abschnitt muss mit demselben VAR-Namen übereinstimmen, der oben in Schritt 2 definiert wurde.
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 beim Veröffentlichen der kopierten Aktion mit neuen Ausgabeelementen ein Fehler auftritt, löschen Sie einige nicht erforderliche Ausgabeelemente, und versuchen Sie erneut, die Aktion zu veröffentlichen.
6. Testen Sie die Aktion.
   1. Stellen Sie sicher, dass der Betreff des Testarbeiters den lokalen Vornamen und den lokalen Nachnamen in Workday 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 zu überprüfen, ob der lokale Vorname und der lokale Nachname korrekt abgerufen werden.