UIP Maestro Flowhitl und UIP Maestro Flow werden migriert

Syntax und Optionen für „uip Maestro Flowhitl“ ( einen Human-in-the-Loop-Knoten hinzufügen) und „uip Maestro Flow migrate“ (Aktualisieren einer „.flow“-Datei auf das aktuelle Schema).

Diese Seite behandelt zwei kleine, nicht verwandte Befehlsgruppen, die beide eine .flow -Datei direkt bearbeiten:

• uip maestro flow hitl – Fügen Sie einen Human-in-the-Loop (HITL)-Knoten hinzu, der die Ausführung anhält und darauf wartet, dass eine Person eine Aufgabe im Action Center abschließt.
• uip maestro flow migrate – Aktualisieren Sie die Workflow- und Knotenschemaversionen einer .flow -Datei.

Zusammenfassung

uip maestro flow hitl add <file> [--schema <json>] [--priority <Low|Medium|High>] [--position <x,y>] [--label <label>] [--assignee <email-or-group>]

uip maestro flow migrate <file> [--dry-run] [--no-include-optional]

Beachten Sie globale Optionen. Austrittscodes folgen dem Standardvertrag. Keiner der Befehl erfordert uip login.

UIP Maestro Flow Insights hinzufügen

Fügen Sie einen HITL-Knoten zu einer .flow -Datei hinzu.

Argumente

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

Optionen

Option	Beschreibung
--schema <json>	JSON-Objekt des Aufgabenschemas. inputs[] Einträge werden über Flow-Variablen vorab ausgefüllt ("binding":"varName" hinzufügen); outputs[] Einträge werden in eine Flow-Variable zurückgeschrieben ("variable":"varName" hinzufügen); outcomes[] listet die möglichen Entscheidungen auf (z. B. Genehmigen/Ablehnen).
--priority <level>	Low, Medium, oder High. Standardmäßig: Low.
--position <x,y>	Position der Arbeitsfläche, z. B. 250,300).
--label <label>	Anzeigebeschriftung für den Knoten.
--assignee <email-or-group>	Zuweisungsziel: eine Benutzer-E-Mail-Adresse oder ein Gruppenname.

Beispiele

# Bare HITL node, no schema
uip maestro flow hitl add workflow.flow

# With label, priority, and a group assignee
uip maestro flow hitl add workflow.flow --label "Invoice Review" --priority High --assignee finance-approvers

# Full schema: pre-filled input, a required output written back to a variable, two outcomes
uip maestro flow hitl add workflow.flow --label "Approval" \
  --schema '{"inputs":[{"name":"invoiceId","binding":"fetchInvoice1.result.invoiceId"}],"outputs":[{"name":"decision","variable":"approvalDecision","required":true}],"outcomes":[{"name":"Approve"},{"name":"Reject"}]}'

Datenform (--output json)

{
  "Code": "HitlNodeAdded",
  "Data": {
    "NodeId": "approval1",
    "NodeType": "uipath.human-in-the-loop",
    "Label": "Approval",
    "DefinitionAdded": true
  }
}

UIP Maestro Flow migrieren

Aktualisieren Sie die Workflowschemaversion einer .flow -Datei und optional auch die typeVersions ihrer Knoten auf die aktuelle Version. Idempotent – Bei der Ausführung für eine bereits aktuelle Datei werden keine Änderungen gemeldet.

Argumente

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

Optionen

Option	Beschreibung
--dry-run	Zeigen Sie an, was sich ohne Schreiben der Datei ändern würde.
--no-include-optional	Überspringen Sie optionale Knotenmigrationen (z. B. typeVersion -Normalisierung). Standard: Es werden optionale Migrationen angewendet.

Beispiele

# Migrate to the current schema version
uip maestro flow migrate ./my-flow/my-flow.flow

# Preview only
uip maestro flow migrate ./my-flow/my-flow.flow --dry-run

# Skip optional node migrations
uip maestro flow migrate ./my-flow/my-flow.flow --no-include-optional

Datenform (--output json)

{
  "Code": "FlowMigrate",
  "Data": {
    "File": "./my-flow/my-flow.flow",
    "Migrated": true,
    "DryRun": false,
    "FromVersion": "1.0.0",
    "ToVersion": "1.0",
    "WorkflowSteps": ["1.0.0 -> 1.0"],
    "NodeMigrations": {
      "ForcedAvailable": 0,
      "OptionalAvailable": 2,
      "OptionalApplied": 2,
      "Failed": 0
    }
  }
}

Migrated ist false und WorkflowSteps ist leer, wenn sich die Datei bereits in der aktuellen Version befindet. Bei --dry-run ist Data.DryRun gleich true und die Datei bleibt unberührt.

Siehe auch

• uip maestro flow validate – Nach der Migration validieren
• uip maestro flow node, uip maestro flow variable
• Flow-Übersicht
• Globale Optionen, Beendigungscodes