UIP Maestro Flow-Knoten und UIP Maestro Flow Edge

Syntax und Optionen für „uip Maestro Flow Node“ und „UIP Maestro Flow Edge“, die Knoten und Edges in einer „.flow“-Datei hinzufügen, konfigurieren, auflisten und entfernen.

Ein Flow ist ein Diagramm. Knoten sind die Knoten (Trigger, Aktivitäten, Connectors, Agents); Kanten sind die ausgerichteten Verbindungen zwischen ihnen. Die Befehle uip maestro flow node und uip maestro flow edge bearbeiten direkt eine .flow -Datei – hinzufügen, konfigurieren, auflisten und entfernen.

Diese Seite behandelt auch zwei begleitende Befehlsgruppen, die die .flow -Datei auf die gleiche Weise bearbeiten: variable 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.

---

Hinzufügen von UIP Maestro Flow Node

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).
--parent <node-id>	ID des vorhandenen Knotens, der diesen Knoten enthalten soll – wird festgelegt, wenn ein Schleifenkörper erstellt wird, dessen Enthält nicht nur von Edges abgeleitet werden kann (normalerweise die ID eines core.logic.loop -Knotens).

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.

---

Konfigurieren des UIP Maestro Flow-Knotens

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-Knotenliste

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-Knoten entfernen

delete ist ein registrierter Alias für remove – beide entfernen einen Knoten aus der Datei.

Entfernen Sie einen Knoten und alles, was dazu gehört. Entfernt:

• Verbundene Edges
• Verwaiste Bindungen
• Verwaiste Definitionen
• Knotenvariablen, die dem entfernten Knoten gehören
• Variablenaktualisierungen, die dem entfernten Knoten gehören

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. delete ist ein registrierter Alias für edge remove.

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-Liste

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

---

UIP Maestro Flow Edge entfernen

Entfernt eine einzelne Edge nach ID. Verwenden Sie edge list, um die ID zu finden.

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

---

Variablen

Eine Companion-Befehlsgruppe (noch nicht in der Seitenleiste) bearbeitet die variables -Unterstruktur einer .flow -Datei.

Korrektur: In einer früheren Version dieser Seite wurde auch eine variable-update -Befehlsgruppe dokumentiert (Hinzufügen/Listen/Entfernen, Anhängen eines JS-Ausdrucks an einen Knoten). Diese Gruppe ist nirgendwo im Repository vorhanden – sie wurde nie registriert und es ist keine Implementierungsdatei vorhanden. Es wurde von dieser Seite entfernt.

UIP Maestro Flow-Variable

uip maestro flow variable add    <file> <variable-id> -d, --direction <direction> [-t, --type <type>] [--default-value <val>] [--description <text>] [--schema <json>] [--sub-type <type>] [--trigger-node-id <nodeId>]
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"}').
• --trigger-node-id <nodeId> – Der Triggerknoten, zu dem eine Eingabevariable gehört. Standardmäßig der einzige Triggerknoten des Flows; erforderlich, wenn der Flow mehr als einen Einstiegspunkt hat.

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

---

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 remove (das einzige registrierte Verb – es gibt kein binding delete -Alias, im Gegensatz zu node/edge) entfernt alle Bindungen mit dem angegebenen Ressourcenschlüssel, nicht einen einzelnen Eintrag nach ID.

Datenstrukturen: BindingAddSuccess (Data.Binding), BindingListSuccess (Data.Bindings[], Count), BindingRemoveSuccess (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: "FlowFormat", Data: { File, NodesTotal, EdgesTotal, NodesRepositioned, NodesResized, SubflowsTidied, VariableCount }.

Siehe auch

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