Créer le flux

Créez le flux de surveillance des prix à l’aide de VS Code en ajoutant chacun des 6 nœuds et en les configurant.

Maintenant que nous avons élaboré notre projet à partir de l’étape 1, nous allons couvrir les blocs de construction de base, puis ajouter les cinq nœuds restants, les trois entrées de déclencheur et la variable de sortie de notre flux.

Remarque :

Nous utiliserons les termes « en aval »; et « en amont » pour le reste de ce tutoriel, et vous devez vous familiariser avec eux.

• Amont: les nœuds qui précèdent un nœud donné dans le chemin d'exécution du flux. Les nœuds en amont d'un nœud représentent tout ce dont il dépend: leurs sorties l'intègrent et ils doivent se terminer avant qu'il puisse s'exécuter.
• En aval: les nœuds qui suivent un nœud donné dans le chemin d'exécution du flux. Les nœuds en aval d'un nœud représentent tout ce qui en dépend: ils consomment ses sorties et sont affectés en cas d'échec, de modification ou de réexécution.

Comment renommer un ID de nœud

Au cours de ce tutoriel, nous renommerons les valeurs de nœud ID générées dans la plupart des étapes de ce tutoriel afin de les rendre plus faciles à lire. Il est plus facile de comprendre le rôle d'un nœud appelé fetchRate1 que de httpRequest1. Un nœud se compose de label et de ID.

Vous pouvez avoir plusieurs nœuds avec le même label, mais chaque ID doit être unique. Lors de l'ajout d'un nouveau nœud, la valeur par défaut de ID est le type de nœud avec un numéro ajouté, à partir de 1. Par exemple, l'ajout du premier type de nœud End aura un ID de end1 et le second sera end2. La modification du label d'un nœud ne met pas à jour le ID.

Les étapes permettant de modifier le ID d'un nœud sont les suivantes:

1. Sélectionnez le nœud sur le canevas pour afficher la barre d'outils intégrées au-dessus.
2. Sélectionnez le crayon, Modifier.
3. Ouvrez l'onglet Avancé et vous verrez le champ ID affiché en lecture seule, avec un bouton en forme de crayon à côté pour Renommer l'ID du nœud.
4. Sélectionnez ce crayon pour ouvrir une boîte de dialogue Renommer l'ID du nœud avec une entrée pour Nouvel ID.
5. Saisissez le nouvel ID et sélectionnez Renommer.

La boîte de dialogue inclura les détails de toutes les mises à jour requises lors du changement de nom du champ ID , par exemple « 3 références seront mises à jour», « 2 connexions» et « 1 expression dans d’autres nœuds». L'option Renommer restera désactivée jusqu'à ce que vous modifiiez la valeur. Elle mettra alors à jour toutes les références qui s'affichaient.

Étape 2 - Construire le flux

Nous allons maintenant créer notre workflow de surveillance des prix un nœud à la fois. Dans VS code, ouvrez PriceWatch/PriceWatch.flow - vous devriez voir un nœud de déclencheur manuel nommé start sur la zone de dessin.

Étape 2.1 - Déclarez les entrées du déclencheur

Nous devons ajouter trois entrées au nœud de déclencheur de démarrage que nous utiliserons dans notre appel d'API depart à être utilisé dans notre appel d'API de assisté. Le baseCurrency est celui pour lequel nous avons besoin du taux de change actuel de quoteCurrency, et le alertThreshold est la valeur au-dessous de laquelle nous voulons recevoir une alerte. Ajoutons ces 3 entrées avec:

1. Sélectionnez le nœud Déclencheur manuel sur le canevas.

2. Ouvrez les propriétés du nœud avec la mention &`;Modifier`; bouton.

3. Utilisez le bouton + Add input argument pour ajouter baseCurrency avec le type String et la valeur par défaut USD.

4. Utilisez le bouton + Add input argument pour ajouter quoteCurrency avec le type String et la valeur par défaut EUR.

5. Utilisez le bouton + Add input argument pour ajouter alertThreshold avec le type Number et la valeur par défaut 0.9.

6. Confirmez que vous avez ajouté les 3 variables d'entrée en les comparant à l'image ci-dessous:

Étape 2.2 - Ajoutez le nœud de requête HTTP

Le type de nœud HTTP sera utilisé pour appeler l'API Fractionner afin de récupérer les données du taux de change à l'aide de nos 3 variables d'entrée de déclencheur. Créez-le avec les étapes suivantes:

1. Sélectionnez + dans la gestion sortante du nœud Déclencheur manuel.

2. Recherchez dans la palette des nœuds la requête HTTP et sélectionnez-la.

3. Ouvrez les propriétés du nouveau nœud avec la mention &`;Modifier`. bouton.

4. Définissez le Libellé du nœud sur Fetch rate.

5. Renommez le champ ID de httpRequest1 en fetchRate1.

6. Dans le panneau Propriétés, laissez Authentification définie sur Authentification manuelle.

7. Définissez la méthode HTTP sur GET.

8. Définissez l' URL sur https://api.frankfurter.dev/v2/rates.

9. Dans la section Paramètres de requête , utilisez + Add pair deux fois pour ajouter deux paires clé/valeur vides.

10. Pour la première paire, définissez la clé sur base et la valeur sur $vars.start.output.baseCurrency.

11. Pour la deuxième paire, définissez la clé sur quotes et la valeur sur $vars.start.output.quoteCurrency.

Confirmez que le ID du nœud dans le panneau Propriétés lit fetchRate1 sous l'onglet Advanced et que les deux paramètres de requête sont enregistrés. Lors de l'exécution, le nœud demande https://api.frankfurter.dev/v2/rates?base=USD&quotes=EUR et expose exactement trois clés:

• $vars.fetchRate1.output.body - le corps de la réponse analysé
• $vars.fetchRate1.output.code - le code de statut de la réponse HTTP
• $vars.fetchRate1.output.headers: les en-têtes de réponse HTTP

Autrement dit, tout nœud de requête HTTP nécessite qu'un Integration Service passe un appel d'API. Cela nécessite généralement d’en créer un, puis de le référencer à partir du nœud de la requête HTTP. Étant donné que l’API Franc ne nécessite pas d’authentification, la définition de la méthode d’authentification sur Manual authentication crée une connexion implicite en utilisant la configuration que nous avons fournie au lieu de nous obliger à créer d’abord la connexion, puis à la sélectionner dans la liste déroulante.

Étape 2.3 - Reformulez la réponse avec un nœud de script

Nous allons utiliser un nœud Script pour extraire le taux de change actuel et le comparer à notre valeur de seuil d'alerte. Les données du corps de la réponse JSON de l’API de assistée sont un tableau , car vous pouvez demander le taux de change pour plusieurs devises dans un seul appel d’API. Le tableau aura une entrée par devise inter-guillemets - nous inclurons uniquement 1 valeur quoteCurrency , donc le tableau ne contiendra qu’un seul résultat:

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

Suivez ces étapes pour créer le nœud Script:

1. Sélectionnez + dans la gestion sortante du nœud Récupérer le taux .

2. Recherchez Script dans la palette de nœuds et sélectionnez-le.

3. Ouvrez les propriétés du nouveau nœud Script avec le &`;Modifier`. bouton.

4. Définissez le Libellé du nœud sur Reshape rate.

5. Renommez le ID de script1 en reshapeRate1.

6. Dans l’éditeur de script, saisissez les informations suivantes:

   const rates = $vars.fetchRate1.output.body;
   const quote = $vars.start.output.quoteCurrency;
   const match = rates.find(function (entry) { return entry.quote === quote; });
   const rate = match.rate;
   
   return {
     pair: match.base + "/" + quote,
     rate: rate,
     asOf: match.date,
     belowThreshold: rate < $vars.start.output.alertThreshold
   };
   

Même si nous savons qu'il n'y aura qu'un seul résultat dans l'API, le script ne doit pas supposer que la valeur que nous voulons est la première entrée. Au lieu d'utiliser une référence d'emplacement d'index avec rates[0] ou de rechercher une entrée avec "EUR" , nous trouvez l'entrée où quote correspond à la valeur quoteCurrency fournie à partir de la variable d'entrée du déclencheur. Le script compare ensuite le taux actuel par rapport au seuil et inclut le résultat dans l’objet de sortie du nœud, en conservant la logique de comparaison à côté du code qui consomme les données de l’API plutôt que de les répéter dans le nœud de décision.

Avertissement :

Saisissez le corps exactement comme indiqué, sans encapsuleur function . Un encapsuleur function main(input) { … } autour du code s'exécutera toujours avec succès, mais il renverra null au lieu de l'objet de retour. Cela empêchera les nœuds en aval d'utiliser les données; cela est différent de la fonction codée UiPath, qui utilise le wrapper.

Les nœuds en aval peuvent désormais lire les variables de sortie comme suit:

• $vars.reshapeRate1.output.pair
• $vars.reshapeRate1.output.rate
• $vars.reshapeRate1.output.asOf
• $vars.reshapeRate1.output.belowThreshold

Étape 2.4 - Routez en fonction du résultat

Un nœud de décision divise le flux en deux chemins en fonction de la valeur de belowThreshold - il s'agit d'une valeur booléenne, il ne peut donc être que true ou false. Pour chacune de ces branches, nous ajouterons un nœud Fin pour renvoyer le résultat à l'aide d'une variable de sortie. Nous définissons la valeur de cette variable de sortie sur chacune des branches du nœud de décision, mais nous devons d'abord créer la variable, puis l'utiliser lors de l'ajout de notre nœud de décision:

1. Sélectionnez l'onglet Variables dans le panneau Propriétés sans nœud sélectionné.

2. Utilisez le + à côté de « Sorties »; pour ouvrir la boîte de dialogue afin d'ajouter une variable de sortie.

3. Créez la variable avec le nom watchResult, saisissez Object et sans valeur par défaut.

4. Sélectionnez + dans la poignée sortante du nœud de taux de reformulation .

5. Recherchez Décision dans la palette de nœuds et sélectionnez-la.

6. Ouvrez les propriétés du nouveau nœud avec la mention &`;Modifier`. bouton.

7. Définissez le Libellé du nœud sur Below threshold.

8. Renommez le ID du nœud decision1 en belowThreshold1.

9. Définissez la condition sur:

   $vars.reshapeRate1.output.belowThreshold === true
   

   Pas de préfixe =js: ici, contrairement aux paramètres de requête du nœud HTTP. Une expression Décision est un champ Flux natif que le moteur Flux évalue lui-même, il est donc déjà JavaScript.

10. Définissez le libellé de la branche Vrai sur Alert.

11. Définissez le libellé de branche Faux sur No action.

    Les libellés apparaissent sur les deux gestionnaires de sortie du nœud, de sorte que la zone de dessin et le traçage d'exécution sont tous deux lus comme des règles métier plutôt que comme true et false.

Étape 2.5 - Ajoutez le nœud Fin d'alerte

Le nœud de décision a 2 branches. Ajoutez d'abord celle de la branche Alert avec:

1. Sélectionnez + sur la branche Alerte .

2. Recherchez dans la palette des nœuds Fin et sélectionnez-le.

3. Ouvrez les propriétés du nouveau nœud Fin avec le champ &`;Modifier` les propriétés du nouveau nœud. bouton.

4. Dans l'onglet Paramètres, définissez l'Expression pour watchResult sur:

   $vars.reshapeRate1.output
   

5. Dans l'onglet Avancé, définissez le Libellé sur End alert.

6. Renommez l'ID du nœud end1 en endAlert1.

Étape 2.6 - Ajoutez le nœud Fin d'action

Ajoutez maintenant le No action Nœud final pour l'autre branche du nœud Décision avec:

1. Sélectionnez + sur la branche Aucune action .

2. Recherchez dans la palette des nœuds Fin et sélectionnez-le.

3. Ouvrez les propriétés du nouveau nœud Fin avec le champ &`;Modifier` les propriétés du nouveau nœud. bouton.

4. Dans l'onglet Paramètres, définissez l'Expression pour watchResult sur:

   $vars.reshapeRate1.output
   

5. Dans l'onglet Avancé, définissez le Libellé du nœud sur End no action.

6. Renommez l'ID du nœud end2 en endNoAction1.

Révision (Review)

Le canevas doit désormais afficher six nœuds connectés et cinq bords, un seul embranchement après le nœud de décision et les deux nœuds de fin doivent comporter un mappage pour watchResult. Votre flux devrait maintenant ressembler à celui ci-dessous; vous pouvez utiliser l'icône en forme de robot pour organiser les nœuds dans le flux et le bouton Fit to screen pour redimensionner la zone de dessin afin qu'elle s'adapte à votre écran.

---

Prochaine étape

Maintenant qu’il est créé, nous allons vérifier le flux à l’aide de la commande uip maestro flow validate .