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.

Diese Seite behandelt auch drei begleitende Befehlsgruppen, die die .flow -Datei auf die gleiche Weise bearbeiten: variable, variable-update und binding.

Zusammenfassung

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>

Beachten Sie globale Optionen. Austrittscodes folgen dem Standardvertrag.

---

uip maestro flow node add

Fügen Sie einen Knoten zu einer .flow -Datei hinzu. Der Knotentyp muss in der Registrierung vorhanden sein – verwenden Sie uip maestro flow registry search um gültige <node-type> -Werte zu erkennen.

Argumente

• <file> (erforderlich) – Der Pfad zur .flow -Datei.
• <node-type> (erforderlich) – Bezeichner des Knotentyps (z. B core.trigger.manual, uipath.connector.slack.send-message).

Optionen

Option	Beschreibung
-i, --input <json>	JSON-Objekt von Eingabewerten, die auf dem Knoten festgelegt werden sollen (z. B '{"script":"…"}'). Muss ein JSON-Objekt sein, kein Array oder Skalar. Übergeben Sie bei Connector- Knoten (Typ uipath.connector.*) hier nicht --input – führen Sie node configure anschließend aus.
--position <x,y>	Position der Arbeitsfläche, z. B 250,150. Sowohl x als auch y sind erforderliche Zahlen.
--label <label>	Anzeigebeschriftung für den Knoten.
--source <uuid>	Quellbezeichner für Inline-Agentknoten (füllt model.source aus).

Beispiel

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

Datenform (--output json)

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

DefinitionAdded ist true beim ersten Einfügen eines bestimmten node-type – der entsprechende Eintrag im .flow definitions[] -Array wird erstellt.

---

uip maestro flow node configure

Füllen Sie inputs.detail auf einem bereits hinzugefügten Knoten aus und erstellen Sie die benötigten Workflowbindungen. Führen Sie dies nach node add für Connector- und verwaltete HTTP-Knoten aus.

Argumente

• <file> (erforderlich) – Der Pfad zur .flow -Datei.
• <node-id> (erforderlich) – ID des zu konfigurierenden Knotens (finden Sie unter node list).

Optionen

• --detail <json> (erforderlich) – Konfigurations-JSON. Die Form hängt vom Knotentyp ab:

Connector-Knoten (uipath.connector.*)

Rufen Sie method und endpoint von connectorMethodInfo in der registry get -Ausgabe ab.

• Erforderlich: connectionId, folderKey, method, endpoint
• Optional: 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" }
}'

Verwaltete HTTP-Knoten (core.action.http.v2)

Zwei Authentifizierungsmodi:

Connector-Modus (authentication: "connector") – verwendet eine Integration Service-Verbindung für die Authentifizierung:

• Erforderlich: authentication, method, connectionId, folderKey, targetConnector
• method ∨ GET, POST, PUT, PATCH, DELETE, OPTIONS, HEAD
• Optional: url (Pfad an Connector-Basis-URL angefügt), 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"
}'

Manueller Modus (authentication: "manual") – keine Connector-Authentifizierung, geben Sie die vollständige URL und alle Authentifizierungsheader selbst an:

• Erforderlich: authentication, method, url (vollständige URL)
• Optional: headers, query, body (Zeichenfolge; kann ein Ausdruck sein, z. B =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>" }
}'

Datenform (--output json)

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

---

uip maestro flow node list

Listen Sie alle Knoten in einer .flow -Datei auf.

Argumente

• <file> (erforderlich) – Der Pfad zur .flow -Datei.

Datenform (--output json)

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

Jeder Eintrag enthält mindestens id und type; der Dienst fügt auch Anzeigemetadaten aus dem .flow definitions[] -Array an.

---

uip maestro flow node remove

Remove a node and everything it owns. Removes:

• Verbundene Edges
• Verwaiste Bindungen
• Verwaiste Definitionen
• Node variables owned by the removed node
• Variable updates owned by the removed node

Argumente

• <file> (erforderlich) – Der Pfad zur .flow -Datei.
• <node-id> (erforderlich) – ID des zu löschenden Knotens.

Datenform (--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

Fügen Sie eine Edge zwischen zwei Knoten hinzu.

Argumente

• <file> (erforderlich) – Der Pfad zur .flow -Datei.
• <source-id> (erforderlich) – ID des Quellknotens.
• <target-id> (erforderlich) – ID des Zielknotens.

Optionen

• --source-port <port> – Name des Quellports (Standard: output).
• --target-port <port> – Zielportname (Standard: input).

Datenform (--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" }
  }
}

---

Variablen und Variablenaktualisierungen

Zwei begleitende Befehlsgruppen (noch nicht in der Seitenleiste) bearbeiten die Unterstrukturen variables und variable-update einer .flow -Datei.

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 (erforderlich).
• type ∨ string, number, boolean, object, array, file (Standard: string).
• --default-value wird pro --type geparst – object/array -Werte müssen gültige JSON der übereinstimmenden Form sein.
• --schema muss ein JSON-Objekt sein (z. B '{"type":"string"}').

Datenstrukturen: VariableAddSuccess (Data.Variable), VariableListSuccess (Data.Variables[], Count), VariableDeleteSuccess (Data.DeletedVariable).

uip maestro flow variable-update

Fügen Sie einen JS-Ausdruck an einen Knoten an, der nach Abschluss ausgeführt und einer globalen Variablen zugewiesen wird (die out oder inout sein muss).

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>

Dem Ausdruck wird automatisch =js: vorangestellt, wenn er fehlt. Beispiel: --expression "=js:ctx.output".

Datenstrukturen: VariableUpdateAddSuccess (Data.VariableUpdate), VariableUpdateListSuccess (Data.VariableUpdates[], Count), VariableUpdateDeleteSuccess (Data.DeletedUpdate).

---

Bindings

Bindungen deklarieren die externen Ressourcen, die ein Flow zum Zeitpunkt der Veröffentlichung/Bereitstellung benötigt (einen Zielprozess, ein Agent, eine Verbindung, eine Warteschlange, …) und welche Knoteneigenschaft sie verknüpfen.

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> muss einer von VALID_RESOURCE_TYPES des Dienstes sein (wird in der Fehlermeldung des Befehls add angezeigt, wenn ein ungültiger Wert übergeben wird).
• --property-attribute ist die Zielknoteneigenschaft, die die Bindung ausfüllt (z. B name, folderPath, connection).
• --resource-sub-type bietet eine Unterklassifizierung (z. B Agent, Process).
• binding delete entfernt alle Bindungen mit dem angegebenen Ressourcenschlüssel, nicht einen einzelnen Eintrag nach ID.

Datenstrukturen: BindingAddSuccess (Data.Binding), BindingListSuccess (Data.Bindings[], Count), BindingDeleteSuccess (Data.DeletedBindings[], Count).

---

uip maestro flow format

Automatisches Layout: Positionieren Sie Knoten in einer .flow -Datei neu, um Überlappungen zu entfernen und das Diagramm sauber anzuordnen.

uip maestro flow format <file>

Datenform: Code: "FlowTidy", Data: { File, NodesTotal, EdgesTotal, NodesRepositioned }.

Siehe auch

• uip maestro flow registry – Knotentypen erkennen
• uip maestro flow validate – das bearbeitete .flowvalidieren
• uip maestro flow init
• Flow-Übersicht