Extraction de la hiérarchie de travailleurs de Workday

Le tutoriel suivant montre comment utiliser efficacement les fonctionnalités clés des workflows d’API :

• Schémas d’entrée et de sortie
• Activités du connecteur
• Activités HTTP du connecteur
• Expressions JavaScript
• Formatage et transformation des réponses
• Publication des workflows sur Orchestrator

Workday contient des données sur les employés volumineuses et sensibles. Vous pouvez extraire et transformer des informations spécifiques à l’aide d’un workflow d’API. Dans ce tutoriel, le workflow récupère une hiérarchie d’employés en fonction des demandes de prénom et de nom.

Une connexion valide à Workday est requise.

1. Créez un workflow d’API.
2. Ouvrez le Gestionnaire de données et ajoutez les propriétés Prénom et Nom en tant qu'entrée. Vous pouvez référencer ces propriétés ultérieurement via l'objet $workflow.input .
3. Ajoutez un connecteur et configurez-le pour utiliser l'activité Workday (Rest) suivante : Rechercher des travailleurs par nom ou sur ID.
   1. Pour le champ Rechercher la chaîne ou l’ID , ouvrez l’éditeur d’expressions et écrivez ce qui suit :

      $workflow.input.firstName + " " + $workflow.input.lastName

   
4. Déboguez votre workflow et notez la réponse réussie. Pourtant, aucun travailleur n’a été trouvé.
5. Ajoutez une activité Si et utilisez l’extrait suivant comme condition:

   $context.outputs.Workers_1.content.length <= 0

6. Pour la branche Puis de l'activité Si , ajoutez une activité Réponse et configurez-la comme suit :
   • Type—Échec
   • Détails—

     { "notFound": "No workers found for given input" }

7. Déboguez à nouveau votre workflow. Étant donné que vous n’avez pas fourni l’entrée requise, le workflow passe automatiquement à cette réponse et définit le statut du workflow sur Échec.
8. Définissez une configuration de débogage avec la charge utile suivante :

   {
     "firstName": "Betty",
     "lastName": "Liu"
   }

9. Déboguez votre workflow jusqu'à ce que vous commencez à voir les résultats dans la propriété Contenu du schéma de Sortie .
   
10. Pour la branche Sinon de l'activité Si , ajoutez une boucle > Pour chaque activité et configurez-la comme suit :
    • Dans—

      $context.outputs.Workers_1.content

    • Nom de l’élément—ÉlémentActuel
    • Cumul des résultats—Activé
11. Dans le corps de l'activité Pour chaque , ajoutez trois activités Demande HTTPWorkday REST pour le connecteur Workday REST) :
    • Workday REST HTTP Request 1 : Trouver des rapports directs
    • Workday REST HTTP 2 : Trouver les détails de l'organisation
    • Requête HTTP Workday REST 2 : Rechercher des pairs

    Cela signifie que pour chaque travail de la boucle, l'activité renvoie les détails mentionnés : rapports directs, détails de l'organisation et pairs.
12. Configurez l'activité Workday REST HTTP Request 1 : Trouver des rapports directs comme suit :
    • Méthode—GET
    • URL de la demande—

      "/common/v1/uipath_dpt1/workers/" + $currentItem.id + "/directReports"

      Où uipath_dpt1/workers fait partie de la définition de la sandbox.
13. Configurez l’activité Workday REST HTTP Request 2 : Find Organization Details comme suit :
    • Méthode—GET
    • URL de la demande—

      "/common/v1/uipath_dpt1/supervisoryOrganizations/" + $currentItem.primaryJob.supervisoryOrganization.id

      Où uipath_dpt1/supervisoryOrganizations fait partie de la définition de la sandbox.
14. Configurez l’activité Workday REST HTTP Requête 3 : Rechercher des pairs comme suit :
    • Méthode—GET
    • URL de la demande—

      "/common/v1/uipath_dpt1/supervisoryOrganizations/" + $currentItem.primaryJob.supervisoryOrganization.id + "/workers"

      Où uipath_dpt1/supervisoryOrganizations fait partie de la définition de la sandbox.
15. Déboguez à nouveau votre workflow. Notez que le workflow effectue un nombre de fois spécifié de fois par le nombre de résultats de la première activité sur ces trois requêtes HTTP.
16. Dans le corps d'activité Pour chaque , ajoutez une activité Script après les trois activités de requête HTTPWorkday REST .
17. Pour configurer l'activité de script , utilisez le générateur Autopilot dans l'éditeur d'expressions et fournissez l'invite suivante :

    « À partir des 3 activités précédentes, créez 3 objets. L'objet 1 est le gestionnaire des fichiers et doit renvoyer le descripteur sous la forme nom et person.email sous la forme e-mail. L'objet 2 est des pairs de la 3e requête http et doit parcourir tous les résultats et renvoyer le descripteur en tant que « nom » et Mainworkemail en tant que « email ». Enfin, ajoutez un objet « rapports » qui parcourt tous les premiers résultats http et le nom du rapport (descripteur) et l’e-mail de travail principal en tant qu’e-mail. »

    Le code JavaScript généré doit ressembler à ceci :

    return {
    
        // Details on the worker
    
        manager: {
    
            name: $currentItem.descriptor,
    
            email: $currentItem.person.email
    
        },
    
        // Details for their peers
    
        peers: $context.outputs.Workday_REST_HTTP_Request_1.content.data.map(peer => ({
    
            name: peer.descriptor,
    
            email: peer.primaryWorkEmail
    
        })).filter(peers => peers.name !== $currentItem.descriptor), // Filter out the employee itself,
    
        // Details for their direct reports
    
        reports: $context.outputs.Workday_REST_HTTP_Request_3.content.data.map(report => ({
    
            name: report.descriptor,
    
            email: report.primaryWorkEmail
    
        }))
    
    }

18. En dehors de la boucle Pour chaque , ajoutez une activité Réponse et configurez-la comme suit :
    • Type—Réussite
    • Détails (Details)

      $context.outputs.For_Each_1.results

    Cette étape indique au workflow de renvoyer la liste complète des résultats générés par la boucle Pour chaque .
19. Déboguez votre workflow de bout en bout. Vous devriez avoir une exécution réussie et un schéma de réponse devraient répondre à vos besoins.
20. Générez le schéma de sortie de l'exécution réussie de votre workflow :
    1. Accédez à la section Output du panneau Run output .
    2. Sélectionnez Copier dans le presse-papiers.
    3. Accédez à la section Sortie du panneau Data Manager .
    4. Sélectionnez Générer à partir de la charge utile.
    5. Collez la sortie copiée depuis Sortie > Exécuter la sortie.
    Votre workflow d’API inclut désormais des schémas d’entrée et de sortie, ce qui lui permet d’être invoqué sur l’ensemble de la plateforme.
21. Publiez votre workflow d'API sur Orchestrator.