maestro
latest
false
Benutzerhandbuch zu Maestro Orchestrate
- Einleitung
- Erste Schritte
- Erstellen Sie auf einer beliebigen Canvas
- Erstellen Sie mit Fall
- Referenz (Reference)
- Definieren von Fallschlüsseln (System vs. extern)
- Erstellen von Task-E/A- und Write-Back-Verträgen
- Modellieren von primären und sekundären Phasen
- Auslösen eines Falls aus Data Fabric
- Implementieren von Personas und Berechtigungen auf Phasenebene
- Festlegen von SLAs und automatisierten Eskalationsregeln
- Konfigurieren einer Nacharbeitsschleife (Wiedereintritt)
- Konfigurieren und Testen des Case Manager-Agents (Vorschau)
- Erstellen Sie mit Flow
- Erstellen Sie mit BPMN
- Betrieb
- Überwachung
- Optimieren
- Referenzinformationen
Wichtig :
Es kann 1–2 Wochen dauern, bis die Lokalisierung neu veröffentlichter Inhalte verfügbar ist.
File format (.flow)
Structure and key fields of the .flow JSON format for Flow workflows.
A Flow workflow is stored as a .flow file — a JSON document that describes the workflow's nodes, the edges that connect them, the node definitions they reference, and the variables that carry data between them.
Überblick
The .flow format is designed to be human-readable, diffable in version control, and portable between environments. The visual editor serializes the canvas to this format on save, and parses it back when you open a workflow.
Top-level structure
{
"id": "EmailTriage",
"version": "1.0",
"name": "Email triage",
"runtime": "maestro",
"nodes": [],
"edges": [],
"definitions": [],
"variables": {},
"bindings": [],
"layout": {}
}
{
"id": "EmailTriage",
"version": "1.0",
"name": "Email triage",
"runtime": "maestro",
"nodes": [],
"edges": [],
"definitions": [],
"variables": {},
"bindings": [],
"layout": {}
}
Key fields
| Feld | Typ | Beschreibung |
|---|---|---|
id | string | Unique workflow identifier. |
version | string | Workflow format version (for example, 1.0). Drives the migration system that upgrades older files when they are opened. |
name | string | Display name of the workflow. |
description | string | Optional workflow description. |
runtime | string | Execution runtime the workflow targets (for example, maestro). |
nodes | Array | The workflow's nodes. Each node has an id, a type that resolves to an entry in definitions, a typeVersion, a display block, and its configured inputs (and outputs where applicable). |
edges | Array | The connections between nodes. Each edge links a source node's output port to a target node's input port. |
definitions | Array | The node definitions (manifests) referenced by the nodes in this workflow. Each node's type and typeVersion resolve to one of these. |
variables | object | The workflow's data: inputs, outputs, and the intermediate values produced by nodes. Node outputs are exposed here so downstream nodes can reference them with $vars. |
bindings | Array | Bindings that connect the workflow to platform resources (for example, published processes, agents, or connections) it invokes. |
subflows | object | Optional. Nested subflow content, keyed by subflow id; each entry holds its own nodes, edges, and variables. |
layout | object | Canvas layout (node positions and visual arrangement). Stored separately from the nodes so the logical workflow stays diff-friendly. |
solutionId, projectId | string | Optional. Identify the Studio Web solution and project backing the workflow when it is part of a solution. |
Node entry
Each entry in nodes follows this shape:
{
"id": "listInboxEmails1",
"type": "uipath.connector.uipath-microsoft-outlook365.get-email-list",
"typeVersion": "1.0.0",
"display": { "label": "List inbox emails" },
"inputs": {}
}
{
"id": "listInboxEmails1",
"type": "uipath.connector.uipath-microsoft-outlook365.get-email-list",
"typeVersion": "1.0.0",
"display": { "label": "List inbox emails" },
"inputs": {}
}
typeis the node's type identifier. It points to a matchingnodeTypein thedefinitionsarray, which carries the node's configuration form, input definition, and output definition.typeVersionpins the node to a specific definition version so migrations can upgrade it safely.
Edge entry
Each entry in edges connects two nodes by port:
{
"id": "weeklyTrigger1-output-process1-input",
"sourceNodeId": "weeklyTrigger1",
"sourcePort": "output",
"targetNodeId": "process1",
"targetPort": "input"
}
{
"id": "weeklyTrigger1-output-process1-input",
"sourceNodeId": "weeklyTrigger1",
"sourcePort": "output",
"targetNodeId": "process1",
"targetPort": "input"
}
Hinweise
- The
.flowfile is the canonical source of truth for a workflow. Edits made in the visual editor are serialized to this format on save. - Manual edits to
.flowfiles are intended only for bulk migrations or tooling integrations. Invalid JSON or schema violations prevent the workflow from loading. - The format evolves across Flow versions. Older files are upgraded automatically by the migration system when opened, based on their
versionand each node'stypeVersion.