Si vous avez configuré un processus automatisé dans votre orchestrateur UiPath basé sur le cloud, il peut être pratique de lancer son exécution d'un simple clic sur votre smartphone. Dans cet article, j'expliquerai comment implémenter une telle intégration à l'aide d'un flux de processus simple dans Make .
Vous savez peut-être déjà que Make propose trois modules d'intégration avec UiPath . Cependant, ces modules nécessitent un compte Enterprise, car les modules de niveau 3 ne sont pas utilisables avec la version gratuite. Mon objectif était de développer une solution d'intégration simple pour UiPath ne nécessitant pas de compte Enterprise. Un compte Make gratuit permet d'exécuter deux scénarios simultanément, ce qui est parfaitement suffisant pour cette application.
1. Configurez l'accès à l'API dans UiPath Orchestrator
Après avoir configuré un processus sans surveillance dans UiPath Orchestrator, vous devez configurer l'accès à l'API. Procédez comme suit :
1. Cliquez sur la grille de menu et sélectionnez Admin (la dernière option de la section « Exploiter »).
2. Accédez à Applications externes et, sous l'onglet « Applications OAuth », cliquez sur + Ajouter une application.
3. Entrez un nom d'application et sélectionnez Application confidentielle.
4. Cliquez sur + Ajouter des étendues . Dans le menu déroulant Ressource , sélectionnez Accès à l'API Orchestrator , accédez à l' onglet Étendue(s) de l'application , activez au moins les autorisations suivantes, puis cliquez sur Enregistrer: - OR.Jobs - OR.Execution.Read
5. (Facultatif) Entrez une URL de redirection (par exemple, https://www.make.com ) et cliquez sur Ajouter.
6. Copiez l'ID de l'application et le secret de l'application – vous en aurez besoin plus tard pour configurer l'accès à l'API dans Make.
Les autorisations (étendues) sélectionnées sont cruciales pour accéder à des parties spécifiques de l'orchestrateur via l'API.
Cliquez maintenant sur votre icône de profil en haut à droite, accédez à Paramètres et, dans la section Confidentialité et sécurité, sélectionnez l'option Afficher l'accès API . Copiez l'identifiant et le nom de l'organisation figurant dans le tableau.
La configuration dans UiPath Orchestrator est maintenant terminée – il est temps de l'implémenter dans Make.
Swagger pour UiPath
Pour consulter les appels d'API disponibles, vous pouvez accéder à la documentation Swagger de l'API Orchestrator en /swagger/index.html à l'URL de base de votre instance UiPath Cloud : https://cloud.uipath.com/{Organization ID}/{Tenant Name}/orchestrator_.
2. Mise en œuvre du processus dans Make
Notre objectif est de lancer un processus UiPath depuis un smartphone d'un simple clic. Afin de garantir une implémentation optimale, nous testerons chaque étape avant la mise en place du déclencheur final.
2.1 Authentification
Connectez-vous à Make, cliquez sur Scénarios et créez un nouveau scénario. Commencez par ajouter le HTTP : Effectuer une requête . Cliquez sur ce module et configurez-le comme suit :
- URL :
https://cloud.uipath.com/{ID de l'organisation}/identity_/connect/token - Méthode :
POST - Type de corps :
Application/x-www-form-urlencoded
Sous Champs, définissez les quatre éléments suivants (l'ordre n'a pas d'importance) :
Définissez l' Analyser la réponse sur Oui et cliquez sur Enregistrer.
Pour obtenir une réponse, cliquez sur « Exécuter une fois » ou sélectionnez « Exécuter uniquement ce module » dans le menu contextuel. La valeur de access_token est nécessaire pour tous les appels API suivants.
2.2 Récupération de la clé de déverrouillage
Pour exécuter une tâche UiPath, vous avez besoin de la clé de version du package UiPath correspondant. Ajoutez un autre module, HTTP : Effectuer une requête . Dans le URL, saisissez l'URL de base suivie de /odata/Releases. Il s'agit de la version de base pour interroger les informations de version. Vous pouvez affiner la requête en ajoutant des opérateurs comme $filter pour obtenir des résultats plus précis. Par exemple : ?$filter=contains(Name,'MyText')&$top=1 (voir https://docs.uipath.com/orchestrator/automation-cloud/latest/api-guide/building-api-requests).
Dans section En-têtes , deux éléments doivent être configurés. Pour l'en-tête d'autorisation, saisissez le texte « Bearer » et associez le access_token du tableau de données en le faisant glisser depuis la réponse du module précédent.
Pour trouver le X-UIPATH-OrganizationUnitId , qui correspond à l'identifiant numérique d'un dossier (OrganizationUnitId), accédez à ce dossier dans votre orchestrateur UiPath et extrayez la valeur du fid de l'URL, par exemple /?tid=12345&fid=1234567 .
Définissez l' Analyser la réponse sur Oui et cliquez sur Enregistrer.
2.3 Démarrage de la tâche dans UiPath Orchestrator
Nous allons maintenant définir notre requête API principale pour démarrer une tâche dans UiPath Orchestrator. Nous ajoutons un module, HTTP : Effectuer une requête . Dans le URL , saisissez l’URL de base, suivie de/odata/Jobs/UiPath.Server.Configuration.OData.StartJobs. Nous utilisons la POST et les mêmes deux en-têtes que pour la requête précédente.
Sélectionnez « Brut » comme type de corps et « JSON (application/json) » comme type de contenu . Saisissez la structure JSON suivante dans le champ « Contenu de la requête » (et associez la valeur de ReleaseKey de la réponse précédente – n’oubliez pas d’entourer la valeur associée de guillemets) :
Vous pouvez exécuter cette requête temporaire en utilisant les deux premiers modules définis ci-dessus, mais avec cette URL dans le deuxième module.
Vous pouvez ajouter d'autres éléments à la charge utile JSON selon vos besoins, par exemple : « Source » : « Manual » ou « InputArguments » : « {…} » (valeur au format JSON). La clé de version (ReleaseKey) est obligatoire.
Définissez l' option « Analyser la réponse » sur « Oui » et cliquez sur « Enregistrer » . Vous trouverez plus d'informations sur la création de cette requête API sur la page d'assistance technique : https://uipath.my.salesforce-sites.com/CaseView/articles/Knowledge/start-a-job-using-Orchestrator-API
Nous avons maintenant la conception de processus suivante dans Make :
Essayez maintenant d'exécuter ce processus de compilation. Si tout est correctement configuré, le processus UiPath démarrera immédiatement ou passera à l'état « En attente ».
2.4 Déclenchement du processus d'automatisation
Pour terminer, nous devons intégrer une fonction permettant de lancer notre processus d'automatisation via un smartphone. Vous pouvez utiliser le module « Bouton pour montre » pour Apple iOS ou Android . Commencez par connecter votre smartphone via le menu Plus > Appareils > Ajouter un appareil, puis donnez-lui un nom et scannez le code QR avec l'application Make sur votre appareil mobile. Créez ensuite un bouton dans l'application . Le nom que vous lui attribuez correspond à son identifiant, nécessaire pour configurer le module « Bouton pour montre » dans Make.
module Webhook personnalisé . Après l'avoir nommé, copiez l'URL et ouvrez-la dans un navigateur web. La structure des données sera alors automatiquement définie (dans notre cas, une structure vide). Placez le module déclencheur au début de votre processus d'automatisation et connectez-le aux modules suivants. Vous pouvez utiliser la d'alignement automatiquepour une présentation plus esthétique, comme illustré ci-dessous.
Testez l'ensemble du processus en « Exécuter une fois ». Le webhook sera alors à l'écoute des données entrantes. Le processus démarrera dès que l'URL du webhook sera consultée. Enfin, n'oubliez pas d' activer. Pour un déclencheur webhook, sélectionnez généralement l'option préconfigurée « Immédiatement ». Vous pouvez également enregistrer cette URL comme raccourci sur l'écran d'accueil de votre smartphone pour y accéder facilement d'un simple clic.
2.5 Développement du scénario
Grâce à la multitude de requêtes API dans UiPath Orchestrator, vous pouvez, par exemple, étendre ce scénario en insérant une requête pour connaître l'état d'une tâche précédemment lancée après un délai et en envoyant le résultat à une adresse e-mail. N'oubliez pas que vous ne pouvez utiliser dans les requêtes API que les étendues que vous avez préalablement configurées dans UiPath Orchestrator, comme décrit dans la première section.
3. Approches alternatives
Pour atteindre notre objectif, nous avons utilisé Make afin de lancer le processus UiPath à l'aide d'un bouton sur smartphone. Toutefois, il est également possible d'exécuter les mêmes appels d'API avec d'autres outils tels que PowerShell ou des scripts Bash. Si vous utilisiez l'application UiPath Orchestrator, vous ne pourriez pas lancer une tâche d'un simple clic.
4. Conclusion
Dans cet article, nous avons démontré comment configurer une intégration entre UiPath Orchestrator et Make pour lancer à distance des processus automatisés. Si vous ne pouvez pas utiliser le module UiPath officiel dans Make, cette méthode alternative constitue une solution viable. En implémentant l'authentification, en récupérant la clé de validation et en démarrant la tâche, vous pouvez exécuter efficacement des workflows UiPath depuis votre appareil mobile à l'aide d'un déclencheur.
Si vous avez besoin d'aide pour l'automatisation des processus à l'aide d'outils comme Make ou UiPath , n'hésitez pas à nous contacter. Nous proposons également UiPath en tant que service .
