Étendre les Workday RH fonctionnalités du spoke

Rversion finale: Australia

Mis à jour 12 mars 2026

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

L’action Rechercher 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, découvrez comment 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 restitue de manière 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 l’exemple de message de demande et l’exemple de message de réponse.

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

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

Remarque :

Vérifiez 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 ne comporte 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 position 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 comment 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 exemplaires, 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 sur les 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 de 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 pour correspondre 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 position en conséquence.
5. Sur le même script, dans la section var request , exploitez le modèle de conception et définissez une variable de sortie.
Créez le nœud XML de position dans l’étape SOAP.
1. Consultez Workday Obtenir le message de demande de l’agent et le nœud de référence de position 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 exemple de flux contenant 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 des 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 comment le nom local est structuré dans le message de réponse Workday.
- Prénom local : XPath pour 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 : XPath pour 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 de 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 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 maximal 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 testeur utilise le prénom local et le nom de famille local dans Workday.
2. Créez un exemple de flux, ajoutez-y l’action et enregistrez la réponse pour vérifier les éléments de sortie.
3. Fournissez l’ID d’employé de l’objet 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.