Étendre les Finances Workday HR fonctionnalités du spoke

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 4 minutes de lecture

    • Étendez le Finances Workday HR 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 Finances Workday HR spoke, assurez-vous que l’administrateur connaît l’attribut 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 méthodes d’utilisation de l’action de spoke par défaut.

    Cette action transforme les pastilles de données de champ d’entrée dans le Finances Workday HR spoke en message XML de demande associé Finances Workday et renvoie de manière synchrone le message XML de Finances Workday réponse sous forme de pastilles de données de champ de sortie dans ServiceNow Concepteur de flux. Assurez-vous de vérifier le message de demande d’exemple et le message de réponse d’échantillon.

    Modifiez ou étendez l’action Rechercher des agents par défaut en créant une copie de celle-ci.
    Créer une copie de l’action.
    Pour ajouter l’ID de référence de poste 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.
    1. Évaluez et comprenez comment l’ID de référence de poste est structuré dans le message de demande Workday. L’XPath pour ajouter un ID de référence de poste 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 de l’attribut ci-dessus, selon le document Public Web Services, est un « ID de poste » codé en dur.
        ID de poste.
      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.
    2. 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éez l’entrée ID de référence de poste.
    3. Créez 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 sur la valeur de la variable d’entrée.
        ID de référence de position
    4. Exploitez le modèle de conception de var organizationReferenceStr dans la section de script.
      1. Créez le nœud XML pour qu’il corresponde au message Workday Obtenir une demande d’agent 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 code XML ci-dessus est comparé au nœud XML similaire, 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. Utilisez l’extrait de code var organizationReferenceStr pour construire le nœud XML de référence de position en conséquence.
        var : extrait de code organizationReferenceStr.
      5. Sur le même script, dans la section de demande de var , utilisez le modèle de conception et définissez une variable de sortie.
        var de la section de demande .
    5. Créez le nœud Positionner XML à l’étape SOAP.
      1. Reportez-vous au message Workday Get Worker Request (Obtenir un agent Workday) et au nœud de référence de position en conséquence.
        Nœud de référence de position.
      2. Enregistrez-le et publiez-le.
    6. 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 avec l’action qu’il contient.
        Testez l’action dans un flux.
      2. Fournissez l’ID de poste et testez le flux.
        Fournissez l’ID du poste.
      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 la référence de position est créé.
        Vérifier l’exécution.

    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 local.

    1. Évaluez et comprenez la façon dont 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
    2. Utilisez le modèle de conception Nom juridique dans l’étape 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,
        };
      Modèle de conception Nom juridique à l’étape de l’analyseur de script.
    3. Ajoutez LocalLegalName à l’objet PersonalData.
      LocalLegalName à l’objet PersonalData.
    4. 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 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 .
        Champs de sortie.
        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.
    5. Enregistrez et publiez l’action.
      Remarque :
      L’action Rechercher des agents a 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.
    6. Testez l’action.
      1. Assurez-vous que le sujet de l’agent testé a le prénom local et le nom local dans Workday.
      2. Créez un échantillon de flux, ajoutez-y l’action et consignez la réponse pour vérifier les éléments de sortie.
        Testez l’action.
      3. Fournissez l’ID d’employé de l’objet de l’agent de test associé pour tester et exécuter le flux.
        Exécutez 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.
        Vérifiez les exécutions.