uip maestro flow node and uip maestro flow edge

Syntax and options for `uip maestro flow node` and `uip maestro flow edge`, which add, configure, list, and remove nodes and edges in a `.flow` file.

A Flow is a graph. Nodes are the vertices (triggers, activities, connectors, agents); edges are the directed connections between them. The uip maestro flow node and uip maestro flow edge commands edit a .flow file in place — adding, configuring, listing, and removing both.

Cette page couvre également trois groupes de commandes complémentaires qui modifient le fichier .flow de la même manière: variable, variable-update et binding.

Synthèse

uip maestro flow node add       <file> <node-type> [-i <json>] [--position <x,y>] [--label <label>] [--source <uuid>]
uip maestro flow node configure <file> <node-id> --detail <json>
uip maestro flow node list      <file>
uip maestro flow node remove    <file> <node-id>

uip maestro flow edge add    <file> <source-id> <target-id> [--source-port <port>] [--target-port <port>]
uip maestro flow edge list   <file>
uip maestro flow edge remove <file> <edge-id>

Les options globales sont respectées. Les codes de sortie suivent le contrat standard.

---

uip maestro flow node add

Ajoutez un nœud à un fichier .flow . Le type de nœud doit exister dans le registre. Utilisez uip maestro flow registry search pour découvrir des valeurs <node-type> valides.

Arguments

• <file> (obligatoire) : chemin d'accès au fichier .flow .
• <node-type> (obligatoire) : identificateur de type de nœud (par ex. core.trigger.manual, uipath.connector.slack.send-message).

Options

Option	Description
-i, --input <json>	Objet JSON des valeurs d'entrée à définir sur le nœud (par ex. '{"script":"…"}'). Doit être un objet JSON, et non un tableau ou un scalaire. Pour les nœuds de connecteur (type uipath.connector.*), ne transmettez pas --input ici — exécutez node configure ensuite.
--position <x,y>	Position de la zone de dessin, par exemple 250,150. X et y sont tous deux des nombres requis.
--label <label>	Affichez le libellé pour le nœud.
--source <uuid>	Identifiant source pour les nœuds d'agent en ligne (remplit model.source).

Exemple

uip maestro flow node add invoice-flow.flow uipath.connector.slack.send-message --label "Notify team"

Format des données (--output json)

{
  "Code": "NodeAddSuccess",
  "Data": {
    "Node": { "id": "node_a1b2c3d4", "type": "uipath.connector.slack.send-message" },
    "DefinitionAdded": true,
    "BindingsCreated": 0,
    "VariableCount": 0
  }
}

DefinitionAdded est true lors de la première insertion d'un node-type donné — l'entrée correspondante dans le tableau .flow definitions[] est créée.

---

uip maestro flow node configure

Renseignez inputs.detail sur un nœud déjà ajouté et créez les liaisons de workflow dont il a besoin. Exécutez-le après node add pour le connecteur et les nœuds HTTP gérés.

Arguments

• <file> (obligatoire) : chemin d'accès au fichier .flow .
• <node-id> (requis) — ID du nœud à configurer (recherchez-le avec node list).

Options

• --detail <json> (obligatoire) — configuration JSON. La forme dépend du type de nœud:

Nœuds du connecteur

Obtenez method et endpoint de connectorMethodInfo dans la sortie registry get .

• Requis: connectionId, folderKey, method, endpoint
• Facultatif: bodyParameters, queryParameters, pathParameters

uip maestro flow node configure invoice-flow.flow node_a1b2c3d4 --detail '{
  "connectionId": "b2c3d4e5-0000-0000-0000-000000000001",
  "folderKey":    "c3d4e5f6-0000-0000-0000-000000000001",
  "method":       "POST",
  "endpoint":     "/issues",
  "bodyParameters": { "summary": "Bug" }
}'

Nœuds HTTP gérés

Deux modes d'authentification:

Mode connecteur (authentication: "connector") — utilise une connexion Integration Service pour l'authentification:

• Requis: authentication, method, connectionId, folderKey, targetConnector
• method ⅵ GET, POST, PUT, PATCH, DELETE, OPTIONS, HEAD
• Facultatif: url (chemin ajouté à l'URL de base du connecteur), headers, query, body

uip maestro flow node configure invoice-flow.flow node_abc --detail '{
  "authentication":  "connector",
  "targetConnector": "uipath-microsoft-outlook365",
  "connectionId":    "…",
  "folderKey":       "…",
  "method":          "GET",
  "url":             "/me"
}'

Mode manuel (authentication: "manual") — sans authentification du connecteur, fournissez vous-même l'URL complète et les en-têtes d'authentification:

• Requis: authentication, method, url (URL complète)
• Facultatif: headers, query, body (chaîne; peut être une expression, par ex. =js:({…}))

uip maestro flow node configure invoice-flow.flow node_abc --detail '{
  "authentication": "manual",
  "method":         "GET",
  "url":            "https://api.example.com/data",
  "headers":        { "Authorization": "Bearer <token>" }
}'

Format des données (--output json)

{
  "Code": "NodeConfigureSuccess",
  "Data": {
    "NodeId": "node_a1b2c3d4",
    "BindingsCreated": 2,
    "DetailPopulated": true
  }
}

---

uip maestro flow node list

Répertorie tous les nœuds dans un fichier .flow .

Arguments

• <file> (obligatoire) : chemin d'accès au fichier .flow .

Format des données (--output json)

{
  "Code": "NodeListSuccess",
  "Data": {
    "Nodes": [
      { "id": "start",          "type": "core.trigger.manual" },
      { "id": "node_a1b2c3d4",  "type": "core.action.http.v2" }
    ],
    "Count": 2
  }
}

Chaque entrée inclut au minimum id et type; le service joint également les métadonnées d'affichage du tableau .flow definitions[] .

---

uip maestro flow node remove

Remove a node and everything it owns. Removes:

• Bords connectés
• Liaisons orphelines
• Définitions orphelines
• Node variables owned by the removed node
• Variable updates owned by the removed node

Arguments

• <file> (obligatoire) : chemin d'accès au fichier .flow .
• <node-id> (requis) — L'ID du nœud à supprimer.

Format des données (--output json)

{
  "Code": "NodeDeleteSuccess",
  "Data": {
    "DeletedNode":           { "id": "node_a1b2c3d4", "type": "core.action.http.v2" },
    "EdgesRemoved":          1,
    "BindingsRemoved":       0,
    "DefinitionsRemoved":    0,
    "VariablesRemoved":      0,
    "VariableUpdatesRemoved": 0
  }
}

---

uip maestro flow edge add

Ajoutez un bord entre deux nœuds.

Arguments

• <file> (obligatoire) : chemin d'accès au fichier .flow .
• <source-id> (requis) : ID du nœud source.
• <target-id> (requis) : ID du nœud cible.

Options

• --source-port <port> — nom du port source (par défaut: output).
• --target-port <port> — nom du port cible (par défaut: input).

Format des données (--output json)

{
  "Code": "EdgeAddSuccess",
  "Data": {
    "Edge": {
      "id":         "edge_a1b2c3d4",
      "source":     "Node_1",
      "target":     "Node_2",
      "sourcePort": "output",
      "targetPort": "input"
    }
  }
}

---

uip maestro flow edge list

{
  "Code": "EdgeListSuccess",
  "Data": {
    "Edges": [
      { "id": "edge_a1b2c3d4", "source": "Node_1", "target": "Node_2" }
    ],
    "Count": 1
  }
}

---

uip maestro flow edge remove

Removes a single edge by ID. Use edge list to find the ID.

{
  "Code": "EdgeDeleteSuccess",
  "Data": {
    "DeletedEdge": { "id": "edge_a1b2c3d4", "source": "Node_1", "target": "Node_2" }
  }
}

---

Variables et mises à jour de variables

Deux groupes de commandes compagnons (pas encore dans la barre latérale) modifient les sous-arbres variables et de mise à jour des variables d'un fichier .flow .

uip maestro flow variable

uip maestro flow variable add    <file> <variable-id> -d <direction> [-t <type>] [--default-value <val>] [--description <text>] [--schema <json>] [--sub-type <type>]
uip maestro flow variable list   <file>
uip maestro flow variable remove <file> <variable-id>

• direction ⅵ in, out, inout (requis).
• type ⅵ string, number, boolean, object, array, file (par défaut string).
• --default-value est analysé par --type — object/array Les valeurs doivent être valides JSON de la forme correspondante.
• --schema doit être un objet JSON (par ex. '{"type":"string"}').

Formats de données: VariableAddSuccess (Data.Variable), VariableListSuccess (Data.Variables[], Count), VariableDeleteSuccess (Data.DeletedVariable).

uip maestro flow variable-update

Joignez une expression JS à un nœud qui s'exécute à la fin et s'affecte à une variable globale (qui doit être out ou inout).

uip maestro flow variable-update add    <file> --node-id <id> --variable-id <id> --expression <expr>
uip maestro flow variable-update list   <file> [--node-id <id>]
uip maestro flow variable-update remove <file> <node-id> <variable-id>

L'expression est automatiquement préfixée par =js: si manquant. Exemple: --expression "=js:ctx.output".

Formats de données: VariableUpdateAddSuccess (Data.VariableUpdate), VariableUpdateListSuccess (Data.VariableUpdates[], Count), VariableUpdateDeleteSuccess (Data.DeletedUpdate).

---

Bindings

Les liaisons déclarent les ressources externes dont un flux a besoin au moment de la publication/du déploiement (un processus cible, un agent, une connexion, une file d'attente, etc.) et la propriété du nœud dans lequel il se connecte.

uip maestro flow binding add    <file> <name> <resource> <default-value> [--resource-key <key>] [--property-attribute <attr>] [--resource-sub-type <type>]
uip maestro flow binding list   <file>
uip maestro flow binding remove <file> <resource-key>

• <resource> doit être l'un des VALID_RESOURCE_TYPES du service (affiché dans le message d'erreur de la commande add si une valeur non valide est transmise).
• --property-attribute est la propriété du nœud cible renseignée par la liaison (par ex. name, folderPath, connection).
• --resource-sub-type fournit la sous-classification (par ex. Agent, Process).
• binding delete supprime toutes les liaisons avec la clé de ressource donnée, et pas une seule entrée par ID.

Formats de données: BindingAddSuccess (Data.Binding), BindingListSuccess (Data.Bindings[], Count), BindingDeleteSuccess (Data.DeletedBindings[], Count).

---

uip maestro flow format

Disposition automatique: repositionnez les nœuds dans un fichier .flow pour supprimer les chevauchements et organiser le graphique proprement.

uip maestro flow format <file>

Format des données: Code: "FlowTidy", Data: { File, NodesTotal, EdgesTotal, NodesRepositioned }

Voir également

• uip maestro flow registry — découvrir les types de nœuds
• uip maestro flow validate — valide le .flowmodifié
• uip maestro flow init
• Vue d’ensemble du flux