Étendre les Workday RH fonctionnalités du spoke

Rversion finale: Xanadu

Mis à jour 1 août 2024

4 minutes de lecture

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

Pour étendre le Workday RH spoke, assurez-vous que l’administrateur est au courant de l' Finances Workday Public Web Services API et peut configurer le Finances 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, 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é Finances Workday et restitue de façon synchrone le message XML de Finances Workday réponse sous forme de pastilles de données de champ de sortie dans ServiceNow Studio de workflow. Assurez-vous de vérifier le message d’exemple de demande et le message d’exemple de réponse.

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

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

Remarque :

Assurez-vous de vérifier si le champ d’entrée normal ou le champ d’entrée Champ supplémentaire a 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 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 pour ajouter un ID de référence de position dans le message de demande est double, selon la publication de la communauté Workday Public Web Services.
1. Attribut de 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 Public Web Services, est un « ID de poste » codé en dur.
3. Valeur de référence de poste : 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 de type chaîne simple.
Créer une variable d’entrée dans l’étape de script 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 de l’ID de référence de position à partir des variables d’entrée et déposez-la à la valeur de la variable d’entrée.
Exploitez le modèle de conception de var organizationReferenceStr dans la section de script.
1. Créez le nœud XML pour correspondre au message Workday Get Worker Request dans cet exemple.
2. Trouvez le modèle de conception approprié dans la section de 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 XML ci-dessus est comparé au nœud XML similaire, la référence d’organisation est un bon candidat pour exploiter le 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. Tirez parti de 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 Position XML dans l’étape SOAP.
1. Reportez-vous au message Workday Obtenir la demande d’agent et au 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 exemple de flux contenant l’action.
2. Fournissez un 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 et le nom locaux.

Évaluez et comprenez comment le nom local est structuré dans le message de réponse 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 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

Utilisez le modèle de conception du nom juridique dans l’étape de l’analyseur de script et créez l’extrait de code 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,
        };

Modèle de conception de nom juridique dans l’étape de l’analyseur de script.

Ajoutez le LocalLegalName à l’objet PersonalData.
Créez des variables de sortie à l’étape Sorties .
1. Cliquez sur Edit Output (Modifier la sortie).
2. Les champs de sortie n’ont pas besoin de suivre exactement la hiérarchie des messages de réponse Workday. Tant que le XPAth de l’étape 2 suit le XPath Workday approprié, l’action de spoke peut restituer les éléments en conséquence. Dans ce cas, il suffit d’ajouter le nom juridique 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 l’agent testé dispose du prénom local et du nom local 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é du sujet 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 locaux sont récupérés correctement.