Étendre les fonctionnalités du Workday RH spoke

Rversion finale: Yokohama

Mis à jour 30 janv. 2025

4 minutes de lecture

Étendez le spoke au-delà des fonctionnalités par défaut, telles que l’ajout Workday RH de nouveaux champs d’entrée et de sortie.

Pour étendre le Workday RH spoke, assurez-vous que l’administrateur est au courant des Workday API des services Web publics et peut configurer le Workday système.

Étendre l’action Rechercher des agents

Rechercher l’action des agents disponible avec le spoke fournit la plupart des entrées et sorties requises. Avant d’ajouter d’autres entrées et sorties à cette action, explorez les façons d’utiliser l’action de spoke par défaut.

Cette action transforme les pastilles de données de champ d’entrée dans le Workday RH spoke en message XML de demande associé Workday et renvoie de façon synchrone le message XML de réponse Workday sous forme de pastilles de données de champ de sortie dans ServiceNow Studio de workflow. Vérifiez les exemples de message de demande et de message de réponse.

Modifiez ou étendez l’action Rechercher des agents par défaut en créant une copie de celle-ci.

Pour ajouter l’ID de référence de poste dans le cadre des critères de demande pour cette action :

Remarque :

Veillez à vérifier si le champ d’entrée standard ou le champ d’entrée Champ supplémentaire contient l’entrée souhaitée. Si aucun d’entre eux n’a l’entrée souhaitée, suivez ces instructions pour créer manuellement le champ d’entrée requis.
L’action Rechercher des agents prend en charge l’élément de demande d’ID de référence de poste dans le champ d’entrée Champs supplémentaires . À des fins de démonstration, ce champ est ajouté manuellement dans l’interface utilisateur.

Évaluez et comprenez la façon dont l’ID de référence de poste est structuré dans le message de demande Workday. Le XPath permettant d’ajouter un ID de référence de poste dans le message de demande est divisé en deux volets, selon la publication de la communauté des services Web publics Workday.
1. Attribut du type de référence de poste : Get_Workers_Request/Request_Criteria/Position_Reference/@type
2. La valeur d’attribut ci-dessus, selon le document Services Web publics, est un « ID de poste » codé en dur.
3. Valeur de référence de position : Get_Workers_Request/Request_Criteria/Position_Reference
4. La valeur réelle ci-dessus est un nouveau champ d’entrée dans l’action de spoke.
Créez une variable d’entrée dans l’étape Entrée d’action . Cliquez sur Créer une entrée et ajoutez une variable d’entrée simple de type chaîne.
Créez une variable d’entrée dans l’étape Script de prétraitement.
1. Cliquez sur Créer une variable.
2. Ajoutez le nom de la variable d’entrée avec le nom position_reference_id.
3. Faites glisser la pastille de données ID de référence de position à partir de Variables d’entrée et déposez-la à la valeur de la variable d’entrée.
Tirez parti du modèle de conception de var organizationReferenceStr dans la section Script.
1. Créez le nœud XML correspondant au message Workday Obtenir la demande de l’agent dans cet exemple.
2. Trouvez le modèle de conception approprié dans la section script en conséquence. Dans cet exemple, ce nœud XML doit être construit pour la référence de position.
```
<bsvc:Position_Reference bsvc:Descriptor="string">
<bsvc:ID bsvc:type="Position_ID">string</bsvc:ID>
</bsvc:Position_Reference>
```
3. Lorsque le code XML ci-dessus est comparé au nœud XML similaire, la référence d’organisation est un bon candidat pour tirer parti du script de modèle de conception associé. Dans la section Script , l’extrait de script associé se trouve sous « var organizationReferenceStr.
```
<bsvc:Organization_Reference bsvc:Descriptor="string">
<bsvc:ID bsvc:type="Organization_ID">string</bsvc:ID>
</bsvc:Organization_Reference>
```
4. Exploitez l’extrait de code var organizationReferenceStr pour construire le nœud XML de référence de poste en conséquence.
5. Sur le même script, dans la section de demande var , exploitez le modèle de conception et définissez une variable de sortie.
Créez le nœud XML de position à l’étape SOAP.
1. Reportez-vous à Workday Obtenir le message de demande de l’agent et le nœud de référence de poste en conséquence.
2. Enregistrez-le et publiez-le.
Testez l’action.
1. Comme il s’agit d’une action de flux de données, elle doit être testée à l’aide d’un flux. Créez un échantillon de flux avec l’action.
2. Fournissez l’ID de poste et testez le flux.
3. Ouvrez l’exécution et accédez à l’étape SOAP pour vérifier si le nœud d’élément XML mis à jour avec référence de position est créé.

Ajouter et modifier les champs de sortie de l’action de spoke Workday

Étendez le spoke Workday pour récupérer le prénom local et le nom de famille local.

Évaluez et comprenez la structure du nom local dans le message de réponse de Workday.
- Prénom local : Le XPath de cet élément est Get_Workers_Response/Response_Data/Worker/Worker_Data/Personal_Data/Name_Data/Legal_Name_Data/Name_Detail_Data/Local_Name_Detail_Data/First_Name
- Nom de famille local : Le XPath de cet élément est Get_Workers_Response/Response_Data/Worker/Worker_Data/Personal_Data/Name_Data/Legal_Name_Data/Name_Detail_Data/Local_Name_Detail_Data/Last_Name

Tirez parti du modèle de conception de nom juridique dans l’étape de l’analyseur de script et créez l’extrait pour le nom juridique local.

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,
        };

Ajoutez le LocalLegalName à l’objet PersonalData.
Créez des variables de sortie dans l’étape Sorties .
1. Cliquez sur Modifier la sortie.
2. Les champs de sortie n’ont pas besoin de suivre la hiérarchie exacte des messages de réponse Workday. Tant que le XPAth de l’étape 2 suit le XPath Workday droit, l’action du spoke peut restituer les éléments en conséquence. Dans ce cas, il suffit d’ajouter le nom légal local sous Données personnelles .
  
  Remarque :
  Le nom de la variable de chaîne sous la section Nom doit correspondre au même nom de variable défini à l’étape 2 ci-dessus.
Enregistrez et publiez l’action.
Remarque :
L’action Rechercher des agents comporte un nombre maximum d’éléments de sortie qu’une action de flux de données peut avoir. Si une erreur se produit lors de la publication de l’action copiée avec de nouveaux éléments de sortie, supprimez quelques éléments de sortie qui ne sont pas requis et essayez de publier à nouveau.
Testez l’action.
1. Assurez-vous que le sujet de l’agent de test a le prénom local et le nom de famille locaux dans Workday.
2. Créez un exemple de flux, ajoutez-y l’action et consignez la réponse pour vérifier les éléments de sortie.
3. Fournissez l’ID d’employé de l’objet de l’agent de test associé pour tester et exécuter le flux.
4. Vérifiez le journal et les exécutions pour vérifier si le prénom local et le nom de famille local sont récupérés correctement.