Tâche - Script

La tâche Script de Maestro vous permet d'exécuter JavaScript en ligne pour manipuler des données, enrichir des données de charge utile, appliquer une logique conditionnelle ou transformer des entrées avant de les transmettre au composant suivant du processus. Cette option est particulièrement utile lorsque vous souhaitez préparer des données pour des files de schémas, des appels d'API, des agents ou des systèmes de stockage.

Implémentation > Type : exécuter un script inline.

Quand utiliser les tâches de script

Utilisez une tâche Script lorsque :

• Vous devez transformer ou restructurer les données entrantes.
• Vous souhaitez valider les champs ou rejeter les entrées non valides.
• Vous devez combiner plusieurs entrées en un seul objet.
• Vous souhaitez filtrer, nettoyer ou reformater les données avant de les transférer.

Remarque : Maestro prend actuellement en charge JavaScript uniquement dans l'éditeur d'expressions.

Configuration d’une tâche Script dans Maestro

1. Faites glisser un nœud de tâche Script depuis la barre d'outils du processus.
2. Ajoutez des arguments d'entrée dans la section Entrées du panneau de droite.
   Les arguments d'entrée peuvent prendre la forme de valeurs littérales, de variables de contexte ou de sorties de nœuds précédentes (par exemple, vars.inArg).
3. Écrivez votre script dans l’éditeur :
   • Cliquez sur la zone d'entrée sous Script, puis affichez l'éditeur en mode plein écran.
   • Les expressions JavaScript doivent return un objet ou une valeur, comme dans cet exemple :

     return {
       param1: inputString,
       param2: "staticValue"
     };

4. Associez les sorties de l'objet de retour aux variables Maestro à l'aide de la section Sorties.

Test de la logique de script

Vous pouvez tester des expressions en ligne en cliquant sur l’icône fx pour ouvrir l’Éditeur d'expressions JS. L’éditeur comprend les éléments suivants :

• Un panneau de saisie de test dans lequel vous pouvez coller des exemples d'entrées.

• Un panneau Résultat d'expression en temps réel pour prévisualiser votre objet de retour.

Les erreurs de runtime (par exemple, les échecs JSON.parse) seront affichées pour vous aider à déboguer.

Les actions disponibles pour les tâches de script

La liste déroulante Action d'une tâche Script vous permet de définir le type d'exécution externe que le processus doit appeler. Chaque option correspond à une fonctionnalité ou à une méthode d'intégration UiPath spécifique. Vous trouverez ci-dessous un aperçu rapide de chaque option :

• Aucun (None)

  Aucune implémentation n'est configurée pour la tâche Script.

• Créer une tâche d’application d’action

  Crée une tâche dans une application d'action pour permettre une interaction de l'utilisateur, sans attendre la fin de la tâche.

• Démarrer et attendre un workflow RPA

  Démarre un workflow RPA déployé (par exemple, un projet UiPath Studio) et attend qu'il se termine avant de continuer.

• Démarrer et attendre un agent

  Démarre un agent UiPath (un bloc logique réutilisable) et attend que son exécution se termine.

• Démarrer et attendre un agent externe

  Déclenche un agent hébergé en dehors de UiPath, tel que CrewAI, Salesforce ou ServiceNow, et attend le résultat.

• Démarrer et attendre le workflow d’API [Aperçu]

  Exécute un workflow basé sur une API (en version préliminaire) et attend une réponse.

• Démarrer le processus agentique

  Démarre un processus basé sur une conception agentique (logique modulaire), sans attendre sa fin.

• Démarrer et attendre le processus agentique

  Démarre un processus autonome et le suspend jusqu'à la fin de l'exécution.

• Exécuter une règle métier [Aperçu]

  Évalue une règle métier et utilise le résultat dans le processus (actuellement en version préliminaire).

• Créer un élément de la file dʹattente

  Ajoute un nouvel élément à une file d'attente UiPath pour un traitement asynchrone, sans attendre le résultat.

• Créer et attendre un élément de la file d’attente

  Ajoute un élément à une file d'attente et attend qu'il soit traité avant de continuer.

• Exécuter l’activité du connecteur

  Exécute une activité de connecteur Integration Service préconfigurée (par exemple, Salesforce ou Slack).

• Attendre l’événement du connecteur

  Suspend le processus jusqu'à la réception d'un événement spécifique d'un connecteur (par exemple, soumission de formulaire ou déclencheur externe).

• Exécuter le script

  Exécute un script court (JavaScript ou similaire) au cours du processus pour une logique légère ou une transformation.

  
  
  
  
  

Pour ajouter une sortie supplémentaire, sélectionnez Ajouter nouveaupour introduire une variable directement dans la tâche Script. La sortie nouvellement introduite sera disponible dans les étapes suivantes.

La boîte de dialogue Ajouter une variable vous permet de définir une nouvelle variable en spécifiant son nom, son type (tel que Chaîne de caractères, Nombre, Booléen, etc.) et une valeur par défaut facultative. Une fois enregistrée, la variable devient disponible pour une utilisation dans les entrées, sorties ou expressions au sein de la tâche Script.

Pour mettre à jour la valeur d'une variable existante, sélectionnez Définir la valeur d'une variable.

Pour plus d'informations sur les tâches, consultez la section Tâches dans la modélisation BPMN.