Tâche - Script

Execute inline JavaScript in Maestro Orchestrate Script tasks to manipulate data, enrich payloads, apply conditional logic, or transform input before passing it to the next process component.

The Script Task in Maestro Orchestrate allows you to execute inline JavaScript to manipulate data, enrich payloads, apply conditional logic, or transform input before passing it to the next component in the process.

Utilisez des tâches de script pour préparer des données pour des files d'attente de schéma, 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 Orchestrate currently supports JavaScript only inside the expression editor.

Setting up a Script task in Maestro Orchestrate

1. Ajoutez un nœud de tâche Script à partir de la barre d'outils de processus (faites-le glisser sur la zone de dessin ou double-sélectionnez-le pour l'insérer au centre).
2. Ajoutez des arguments d'entrée dans la section Entrées du panneau de droite.

Les arguments d'entrée peuvent être des valeurs littérales, des variables de contexte ou des sorties de nœuds précédentes (par exemple, vars.inArg). 3. Rédigez votre script dans l'éditeur :

• Sélectionnez le champ d'entrée de script, puis développez dans la vue complète de l'éditeur.
• Les expressions JavaScript doivent return un objet ou une valeur, comme dans cet exemple :

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

4. Map outputs from the return object into Maestro Orchestrate variables using the Outputs section.

Résultat

The script task is configured with its inputs, logic, and output mappings. The return object's values are available as Maestro Orchestrate variables for use in subsequent process nodes.

Test de la logique de script

Vous pouvez tester des expressions en ligne en sélectionnant l’icône fx pour ouvrir l’éditeur d’expressions de fonctions JS. L’éditeur inclut 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) s'afficheront pour vous aider à Debug.

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 un workflow d’API

  Exécute un workflow basé sur une API 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.

• Bulk add queue items

  Ajoute jusqu'à 15 000 éléments à une file d'attente en un seul lot.

• Delete queue items

  Supprime les éléments avec le statut Nouveau d'une file d'attente.

• Postpone transaction item

  Diffère un élément de transaction en cours à une date ultérieure et le renvoie au statut Nouveau.

• Set transaction progress

  Met à jour un élément de transaction en cours avec une chaîne de statut personnalisée visible dans Orchestrator.

• Set transaction status

  Définit l'état final d'un élément de transaction sur Réussite ou Échec.

• 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.

  

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.

Prise en charge d'Autopilot pour les tâches de script

The JS Function Expression editor includes Autopilot for Maestro Orchestrate assistance that helps you write and refine JavaScript expressions directly in Script tasks. You can describe the logic you need in plain language, and Autopilot generates a function that you can review, edit, and test in place. The editor shows a live preview of the expression output and lets you insert variables from your workflow, so you can build and validate custom logic without leaving the canvas.

Pour les champs requis et le comportement de chaque action de file d’attente, reportez-vous à Activités de tâche de file d’attente.

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

Remarque :

L’accès aux workflows d'intégration d’agents et d’API dépend de l’offre Cloud que vous utilisez. Pour des détails, reportez-vous à Disponibilité des fonctionnalités Maestro Orchestrate.