Invocation de fonctions

Une fois déployée en tant que processus, une fonction s'exécute en tant que tâche Orchestrator. Vous pouvez l'invoquer depuis plusieurs fenêtres. Une fonction JavaScript qui déclare qu'une route en possède une autre: elle peut également être appelée directement sur HTTP.

À partir d'une tâche de service Maestro

Dans un processus Maestro, ajoutez une tâche de service et liez-la à la fonction déployée:

1. Sélectionnez le package et le point d'entrée.
2. Associez les variables de processus aux champs Input de la fonction.
3. Associez les champs Output de la fonction aux variables de processus.

Les schémas d'entrée et de sortie exportés à partir de vos modèles Input/Output pilotent l'interface utilisateur de liaison, de sorte que les champs saisis apparaissent directement dans le panneau de mappage.

À partir d'une activité Run Job (Exécuter la tâche) de Studio

Dans Studio ou Studio Web, ajoutez l'activité Exécuter la tâche et indiquez-la à la fonction déployée. Le même schéma d'entrée/sortie exporté entraîne le mappage de l'argument, de sorte que les champs saisis apparaissent directement dans les panneaux d'entrée/de sortie de l'activité.

Depuis l'API Orchestrator

Démarrez la fonction en tant que tâche:

POST /orchestrator_/odata/Jobs/UiPath.Server.Configuration.OData.StartJobs

Transmettez le package (version) et les arguments d’entrée dans le corps de la demande. La tâche exécute la fonction et renvoie sa sortie via le résultat de tâche standard.

À partir d'un déclencheur de tâche

Étant donné qu'une fonction déployée est un processus Orchestrator, elle peut être démarrée par n'importe quel déclencheur de tâche - planifié, basé sur une file d'attente ou basé sur un événement/un webhook.

Sur HTTP

Une fonction JavaScript qui déclare une method et une path est également exposée en tant que déclencheur HTTP Orchestrator. Les appelants l'atteignent à l'URL du déclencheur avec un jeton du porteur, et la plate-forme transmet l'identité de l'appelant à la fonction, ce qui permet à une application codée d'utiliser une fonction comme backend sans jamais conserver d'informations d'identification dans le navigateur.

La requête et la réponse sont délimitées sur cette surface: environ 10 000 caractères d'entrée et environ 512 Ko de sortie. Une tâche n'a pas ce type de limite, car elle transporte des charges utiles volumineuses sous forme de pièces jointes. Ainsi, une fonction gérant les mégaoctets doit être invoquée en tant que tâche même lorsqu'elle dispose également d'un chemin.

Cette surface est spécifique aux fonctions JavaScript; une fonction Python est toujours invoquée en tant que tâche. Consultez Déclencheurs et routage HTTP.

Observabilité

Chaque invocation s'exécute en tant que tâche et est enregistrée dans l'historique des tâches d'Orchestrator avec l'identité de l'appelant et les horodatages. Lorsqu'elle est invoquée depuis Maestro, l'exécution génère également des étendues de Trace - voir Traçage et observabilité.

Prochaines étapes

• À propos des fonctions : examinez où les fonctions se situent dans la plate-forme.