Introduction

Créez un workflow pour récupérer un taux de change en direct et envoyer une alerte s'il est inférieur à un certain seuil.

Vue d'ensemble (Overview)

Dans ce tutoriel, nous allons créer le workflow Surveillance des prix : un Maestro Flow qui récupère un taux de change en direct à partir d'une API externe, le compare à un seuil que nous avons défini et renvoie une alerte ou un résultat sans action en fonction du seuil . Cela montre comment un workflow peut avoir une logique de ramification basée sur les valeurs qu'il récupère. Le flux comporte six nœuds, l’accent reste donc sur la façon dont le flux relie les données entre les nœuds plutôt que sur un workflow plus complexe comportant plusieurs branches logiques.

Durée estimée: 30 minutes.

Qu’est-ce que Maestro

Maestro est une plateforme d'orchestration native pour le cloud qui unifie l'automatisation, les agents d'IA et les interactions humaines dans des processus métier rationalisés de bout en bout. Il s'agit d'un moteur avec trois aires de modélisation:

• Maestro Flow (.flow) pour l'orchestration créée par le développeur.
• Maestro BPMN (.bpmn) pour les diagrammes de modèle de processus métier et de notation que les parties prenantes métier examinent.
• Gestion Maestro Case (caseplan.json) pour le travail humain lourde en exceptions.

Flow est un modélisateur différent construit sur le même runtime que Maestro BPMN, conçu pour les développeurs qui préfèrent une expérience visuelle basée sur des nœuds à la notation BPMN. Si vous avez déjà créé des workflows d’ automatisation des processus robotisés ou lu un diagramme BPMN, les concepts sont directement transférés; ce qui change, c'est l'écosystème. Pour obtenir des conseils sur le choix d'une surface, consultez Choix d'un modélisateur Maestro.

Ce que vous créez

Nous allons créer le reste du flux de surveillance des prix, qui prend trois entrées sur son déclencheur manuel et renvoie un objet avec le résultat en fonction de notre logique. Chaque nœud dans le flux a une seule tâche, et le flux les connecte pour créer le workflow complet.

Vous trouverez ci-dessous un diagramme textuel des différents nœuds, de la façon dont ils sont connectés, et montre des détails sur l'objectif de chacun:

     start              fetchRate1           reshapeRate1        belowThreshold1
┌──────────────┐      ┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│ Manual       │─────▶│ HTTP Request │────▶│ Script       │────▶│ Decision     │
│ trigger      │      │              │     │              │     │              │
└──────────────┘      └──────────────┘     └──────────────┘     └──────┬───────┘
 baseCurrency          GET /v2/rates        reads .body          rate below
 quoteCurrency         ?base&quotes         returns pair,        threshold?
 alertThreshold                             rate, asOf,                │
                                            belowThreshold             │
                                                                ┌──────┴──────┐
                                                           true │             │ false
                                                                ▼             ▼
                                                           endAlert1     endNoAction1
                                                          ┌──────────┐  ┌──────────┐
                                                          │ End      │  │ End      │
                                                          └──────────┘  └──────────┘
                                                           "alert"       "no action"

Astuce :

Nous utiliserons les valeurs de nœud ID indiquées ci-dessus en les mettant à jour pour qu'elles soient plus lisibles à partir des valeurs générées. Les instructions vous indiqueront comment mettre à jour chacune d'entre elles.

Voici la liste de tous les composants qui constituent le flux:

Composant (Component)	Détails (Details)
Entrée : baseCurrency	string, valeur par défaut USD; la devise à partir de laquelle déterminer le prix
Entrée : quoteCurrency	string, valeur par défaut EUR; la devise dans laquelle évaluer le prix
Entrée : alertThreshold	number, valeur par défaut 0.9; alerte lorsque le taux est inférieur à cette valeur
Sortie : watchResult	object avec pair, rate, asOf et belowThreshold
Nœud (déclencheur manuel): start	Démarre l'exécution à la demande et apporte les trois entrées dans le flux
Nœud (requête HTTP): fetchRate1	Envoie une requête GET à l'API de taux de change de Franc seton
Nœud (Script): reshapeRate1	Lit le corps de la réponse et renvoie pair, rate, asOf et belowThreshold
Nœud (Décision): belowThreshold1	Évalue belowThreshold et prend le chemin vrai ou faux
Nœud (Fin): endAlert1	Renvoie watchResult comme objet avec les valeurs pair, rate, asOf et belowThreshold à partir du nœud reshapeRate1
Nœud (Fin): endNoAction1	Renvoie watchResult comme objet avec les valeurs pair, rate, asOf et belowThreshold à partir du nœud reshapeRate1

API d’échange de devises

Pour obtenir de vraies valeurs de taux de change, nous utiliserons Franc Manager, une API gratuite et open source de données sur les devises qui suit les taux de change quotidiens à partir de sources gouvernementales. Il ne nécessite aucune clé API, aucun compte et aucun en-tête d’authentification, c’est pourquoi il est adapté à la création de votre premier flux.

Un exemple de réponse pour le taux USD à EUR de l’API contient un tableau JSON avec une entrée par devise cochée:

[
  {
    "date": "2026-09-01",
    "base": "USD",
    "quote": "EUR",
    "rate": 0.86111
  }
]

Remarque :

La forme du tableau est importante pour le nœud de script que vous créez ultérieurement: le débit n’est pas défini sur un chemin fixe, de sorte que le script recherche l’entrée dont le quote correspond à votre entrée quoteCurrency plutôt que de lire une clé connue.

Prérequis

• Node.js et npm sur votre PATH - l'interface de ligne de commande UiPath (uip) s'installe avec npm. Vérifiez avec node --version et npm --version, et installez depuis nodejs.org si l’un ou l’autre est manquant.
• Un compte UiPath : inscrivez-vous ou connectez-vous à UiPath Automation Cloud avant de commencer.
• Un locataire avec Maestro Flow activé - les exécutions de débogage et le déploiement sont tous deux acheminés via votre locataire sélectionné.
• Accès réseau à votre environnement UiPath - La connexion CLI utilise un flux de navigateur OAuth avec un rappel sur le port localhost 8104.
• VS Code 1.110.0 ou supérieur avec l'extension UiPath Maestro – requis pour créer sur la zone de dessin et utile sur l'un ou l'autre chemin pour observer le flux prendre forme. Vérifiez votre version dans Code > À propos du code de Visual Studio, ou exécutez code --version.

Aucune expérience UiPath antérieure n’est requise et vous n’avez pas besoin que Studio Web soit ouvert à tout moment dans ce tutoriel.

Astuce :

Vous travaillez dans un espace de travail distant? Dans le sous-système Windows pour Linux (WSL), Secure Shell (SSH), les espaces de code et les espaces de travail de conteneur de développement, l'extension s'exécute sur l'hôte distant, de sorte que la UiPath CLI doit y être installée plutôt que sur votre machine locale.

Si vous n'avez pas encore installé les prérequis, suivez les étapes de configuration de votre environnement pour les tutoriels UiPath. Utilisez uip --version et uip login status pour vérifier que la CLI est installée et que vous l'avez authentifiée.

Étape 1 – Élaborer le flux de surveillance des prix

Une solution est l’unité déployable qui contient un ou plusieurs projets que nous allons utiliser pour compresser et déployer notre flux. Commençons par créer d’abord la solution, puis le projet Flow à l’intérieur:

1. Créer la solution: elle crée un répertoire avec le nom que vous spécifiez via uip solution init <solution name>.

   uip solution init tutorial-maestro-flow-price-watch
   

2. Changez dans le répertoire de solution nouvellement créé.

   cd tutorial-maestro-flow-price-watch
   

3. Créez le projet Flux à l'intérieur de la solution.

   uip maestro flow init PriceWatch
   

   Remarque :

   La commande flow init crée le répertoire PriceWatch/ contenant PriceWatch.flow (le seul fichier que vous modifiez), project.uiproj et operate.json. Lorsque flow init est exécuté depuis l'intérieur d'un répertoire de solution, il enregistre également le projet avec la solution parente et rapporte "Status": "Registered". Il crée également un dossier resources/ à la racine de la solution qui contient l'état généré qui se régénère à chaque déploiement, mais vous n'aurez pas besoin de modifier ces fichiers pour ce tutoriel.

4. Confirmez que le flux a été élaboré avec un seul nœud de déclencheur:

   uip maestro flow node list PriceWatch/PriceWatch.flow --output table
   

   Vous ne devriez voir qu'une seule ligne pour trigger dans la sortie - vos coordonnées X et Y peuvent différer car elles changent lorsque vous déplacez les nœuds dans la zone de dessin visuelle:

   Id              | Type                | Label           | Position                         
   ----------------|---------------------|-----------------|----------------------------------
   start           | core.trigger.manual | Manual trigger  | {"X":-192,"Y":0}
   

5. Ouvrez le fichier PriceWatch/PriceWatch.flow dans VS Code. Lorsque l' extension UiPath Maestro est installée, le fichier s'ouvre sur le canevas visuel plutôt que sous forme de texte brut, ce qui vous permet de voir la représentation visuelle de votre workflow.

   

---

Prochaine étape

Nous sommes maintenant prêts à créer notre flux.