Flux UIP

uip flow écrit, compresse, débogue et exploite des projets UiPath Flow — workflows de forme graphique composés de nœuds (activités, déclencheurs, connecteurs) connectés par des bords. Flow est l'une des deux interfaces d'orchestration dans UiPath; voir uip maestro pour l'orchestration des processus métier basée sur BPMN, son frères.

L'outil est livré sous la forme du plug-in @uipath/flow-tool (préfixe de commande flow). Voir Outils pour savoir comment les plug-ins sont installés et versionnés.

Quand utiliser Flow vs Maestro

Surface	Format du graphique	Fichier de ressource	Cas d'utilisation principal
Flux	Graphique visuel des nœuds et des bords	.flow (JSON)	Workflows agentiques, automatisations des connecteurs, enchaînement des nœuds d'IA
Maestro	Diagramme BPMN 2.0	.bpmn	Orchestration des processus métier de longue durée

Les deux outils publient des packages .nupkg dans Orchestrator et partagent les primitives d'exécution (processes, instance, incident, job, registry).

Création du flux

Un projet Flow est un répertoire avec un manifeste project.uiproj et un ou plusieurs fichiers .flow (ainsi que les fichiers associés générés au moment du package).

# 1. Scaffold a new project
uip flow init invoice-flow

# 2. Discover nodes in the registry
uip flow registry pull
uip flow registry search slack

# 3. Edit the .flow file — add nodes, edges, variables, bindings
uip flow node add invoice-flow/invoice-flow.flow uipath.connector.slack.send-message --label "Notify"
uip flow edge add invoice-flow/invoice-flow.flow start node_a1b2c3d4
uip flow node configure invoice-flow/invoice-flow.flow node_a1b2c3d4 --detail '{"connectionId":"…","folderKey":"…","method":"POST","endpoint":"/…"}'

# 4. Validate structure (and optionally governance policy)
uip flow validate invoice-flow/invoice-flow.flow

# 5. Run against Studio Web to smoke-test
uip flow debug ./invoice-flow

# 6. Pack for deployment
uip flow pack ./invoice-flow ./dist --version 1.0.0

Création de commandes

Commande	Objectif
uip flow init	Élaborer un nouveau projet Flow
uip flow node	Ajouter, configurer, répertorier et supprimer des nœuds dans un fichier .flow
uip flow edge	Ajouter, répertorier et supprimer des bords entre les nœuds
uip flow validate	Valider un fichier .flow par rapport au schéma (et à la politique de gouvernance)
uip flow debug	Charger le projet dans Studio Web et exécuter une session de Debug
uip flow pack	Créer un déployable .nupkg
uip flow registry	Parcourir et rechercher les types de nœuds disponibles (OOTB + connecteur)

Assistants de variable, de liaison et de mise en page

Ces interfaces CLI ne se trouvent pas encore sur la barre latérale, mais sont appelables aujourd'hui — ce sont des encapsuleurs légers pour modifier le JSON .flow par programmation:

• uip flow variable — ajouter / répertorier / supprimer les variables de workflow de niveau supérieur (in, out, inout). Voir node-edge.md.
• uip flow variable-update — joignez une expression d'affectation JS à un nœud (=js:ctx.output) qui s'exécute à la fin.
• uip flow binding — ajouter / répertorier / supprimer des liaisons de ressources (processus, agent, connexion, etc.) qui sont résolues au moment de la publication.
• uip flow tidy — mise en page automatique: repositionnez les nœuds pour supprimer les chevauchements.

Runtime

Lors de l'exécution, un paquet de flux publié devient un processus sur Orchestrator. L'étape de démarrage crée une instance; chaque tentative d'exécution est une tâche; les échecs font l'objet d' un incident.

Commande	Objectif
uip flow process	Répertorier et exécuter les processus de flux déployés (list, get, run)
uip flow processes	Résumés des processus dans tous les dossiers et incidents par processus
uip flow instances	Inspectez et pilotez les instances en cours d'exécution (list, get, pause, resume, cancel, retry, migrate, goto, variables, …)
uip flow incidents	Lire les résumés et les détails des incidents
uip flow job	Flux des traçages (traces) et inspecter le statut de la tâche

Les tâches et les processus dans Orchestrator sont manipulés via l'outil Orchestrator — voir Tâches Orchestrator et Processus Orchestrator.

Conventions

• Chaque sous-commande uip flow respecte les options globales (--output, --output-filter, --log-level, --log-file).
• La sortie par défaut est JSON.
• Les codes de sortie suivent le contrat standard.
• La plupart des commandes de runtime nécessitent d'abord uip login - voir Authentification.

Voir également

• uip maestro — Simultanéité BPMN pour l'orchestration des processus métier
• Outils (extensions)
• Authentification
• Options globales, codes de sortie