uip Maestro BPMN Debug-Instanz

Syntax und Optionen für „uip Maestro BPMN Debug-Instanz“, die eine interaktive, Haltepunkt-fähige Debug-Sitzung für eine bereits hochgeladene Studio Web-Lösung ausführt.

uip maestro bpmn debug-instance steuert eine interaktive Debugging-Sitzung auf niedriger Ebene – erstellen Sie die Instanz, überprüfen Sie ihren Status/Variablen/Vorfälle, legen Sie Haltepunkte fest und machen Sie einen Schritt nach vorn. Er wird unter der Verzweigung bpmn registriert.

Dies ist eine andere Oberfläche mit niedrigerer Ebene als uip maestro bpmn debug: debug ist ein einmaliger Befehl „Hochladen und bis zum Abschluss ausführen“. debug-instance geht davon aus, dass die Lösung bereits in Studio Web hochgeladen wurde, und gibt Ihnen die manuelle Kontrolle über eine Debug-Ausführung – Pausieren an Haltepunkten, Überprüfen von Variablen mitten in der Ausführung und Vorgehen – das interaktive Gegenstück, auf das die eigenen Fehleranweisungen von debug verweisen wenn eine Debugging-Sitzung eine Steuerung auf Schrittebene erfordert.

Zusammenfassung

uip maestro bpmn debug-instance create --solution-id <id> --project-id <id> --entry-point <path>
                                        [--process-type <type>] [--debug-mode <mode>] [--simulation-mode <mode>] [-i, --inputs <json>]
uip maestro bpmn debug-instance status         <instance-id>
uip maestro bpmn debug-instance breakpoints    <instance-id> --inputs <json|@file>
uip maestro bpmn debug-instance cancel         <instance-id>
uip maestro bpmn debug-instance continue       <instance-id> [--inputs <json|@file>]
uip maestro bpmn debug-instance incidents      <instance-id>
uip maestro bpmn debug-instance variables      <instance-id> [--parent-element-id <id>]
uip maestro bpmn debug-instance variables-set  <instance-id> --inputs <json|@file> [--parent-element-id <id>]
uip maestro bpmn debug-instance variables-all  <instance-id>

Alle Unterbefehle erfordern uip login, berücksichtigen globale Optionen und folgen dem Standard-Exit-Code-Vertrag.

UIP Maestro BPMN Debug-Instanz erstellen

Erstellen Sie eine Debug-Instanz aus einer Lösung, die bereits in Studio Web hochgeladen wurde, und starten Sie eine Debug-Sitzung im Ordner des persönlichen Arbeitsbereichs von Orchestrator.

Optionen

Option	Erforderlich	Beschreibung
--solution-id <id>	ja	Lösungs-ID aus einem vorherigen Upload oder Studio Web.
--project-id <id>	ja	Studio Web-Projekt-ID innerhalb der Lösung.
--entry-point <path>	ja	Einstiegspunktpfad, z. B. /Main.bpmn#start).
--process-type <type>	nein	Prozesstyp. Der Standardwert ist processOrchestration.
--debug-mode <mode>	nein	Entweder None, Default (Pausierung an Haltepunkten), StepByStep (bei jedem Schritt anhalten), SingleStep (nur ein Schritt). Standardmäßig: Default. Ein ungültiger Wert schlägt beim schnellen Auflisten des akzeptierten Satzes fehl.
--simulation-mode <mode>	nein	Eines von None, All (Alle Elemente simulieren), Selective (Simulieren mit Ausnahme von Opt-outs). Standard: None. Ein ungültiger Wert schlägt beim schnellen Auflisten des akzeptierten Satzes fehl.
-i, --inputs <json>	nein	Geben Sie Argumente als JSON-Zeichenfolge ein. Der Standardwert ist {}.

Datenform

{
  "Code": "DebugInstanceCreated",
  "Data": {
    "instanceId": "c3d4e5f6-...",
    "runId": "d4e5f6a7-...",
    "jobKey": "b2c3d4e5-..."
  },
  "Instructions": "Use 'debug-instance status <instance-id>' to check the run. Use 'debug-instance incidents <instance-id>' or 'debug-instance variables <instance-id>' to inspect it."
}

UIP Maestro BPMN Debug-Instanz Status

Rufen Sie den aktuellen Ausführungsstatus einer Debuginstanz pro Element ab.

Argumente: <instance-id> (erforderlich). Datenform: Code: "DebugInstanceStatus".

Haltepunkte für UIP Maestro BPMN Debug-Instanz

Ersetzen Sie den für eine Debuginstanz festgelegten Haltepunkt.

Argumente: <instance-id> (erforderlich).

Optionen: --inputs <value> – Haltepunkte-Nutzlast als JSON-Zeichenfolge, @file -Pfad oder festgelegt über Standardeinstellungen. Wenn keine Angabe erfolgt, wird eine leere Haltepunktliste ({"breakpoints": []}) gesendet, die alle Haltepunkte löscht.

Datenform: Code: "DebugInstanceBreakpointsUpdated".

Abbruch der UIP Maestro BPMN Debug-Instanz

Debuggen Sie die Instanz.

Argumente: <instance-id> (erforderlich). Datenform: Code: "DebugInstanceCanceled".

UIP Maestro BPMN Debug-Instanz fortsetzen

Setzen Sie die Ausführung für eine angehaltene Debug-Instanz fort.

Argumente: <instance-id> (erforderlich).

Optionen: --inputs <value> – Setzen Sie die Nutzlast als JSON-Zeichenfolge, @file -Pfad oder über Standardpipeline fort. Wenn keine Angabe erfolgt, wird {"nextStep": false} gesendet (bis zum nächsten Haltepunkt anstatt eines einzelnen Schritts ausgeführt).

Datenform: Code: "DebugInstanceContinued".

uip Maestro BPMN Debug-Instanz-Vorfälle

Rufen Sie Vorfälle ab, die während der Ausführung einer Debuginstanz ausgelöst wurden.

Argumente: <instance-id> (erforderlich). Datenform: Code: "DebugInstanceIncidents", Data ist ein Array (leer, wenn keine vorhanden sind).

Variablen von uip Maestro BPMN Debug-Instanz

Rufen Sie die aktuellen Variablenwerte einer Debuginstanz ab.

Argumente: <instance-id> (erforderlich).

Optionen: --parent-element-id <id> – Filtern Sie Variablen nach der ID des übergeordneten Elements.

Datenform: Code: "DebugInstanceVariables".

UIP Maestro BPMN Debug-Instanz Variablen-Set

Patchen (Aktualisieren) Sie die Variablen einer Debug-Instanz während der Ausführung.

Argumente: <instance-id> (erforderlich).

Optionen:

Option	Erforderlich	Beschreibung
--inputs <value>	ja	Patch-Variablen-Nutzlast als JSON-Zeichenfolge, @file -Pfad oder über Standardpipeline. Schlägt fehl, wenn keine Nutzlast aufgelöst wird.
--parent-element-id <id>	nein	Scope des Patches auf eine übergeordnete Element-ID.

Datenform: Code: "DebugInstanceVariablesSet".

uip Maestro BPMN Debug-Instanz Variablen-Alle

Rufen Sie jede Variable für eine Debuginstanz ab, einschließlich der Teilprozessvariablen.

Argumente: <instance-id> (erforderlich). Datenform: Code: "DebugInstanceVariablesAll".

Beispiele

# Create a debug session, stepping through one element at a time
uip maestro bpmn debug-instance create \
  --solution-id <solution-id> --project-id <project-id> \
  --entry-point "/Main.bpmn#start" --debug-mode StepByStep

# Check status, then step forward
uip maestro bpmn debug-instance status <instance-id>
uip maestro bpmn debug-instance continue <instance-id>

# Inspect and patch a variable mid-run
uip maestro bpmn debug-instance variables <instance-id>
uip maestro bpmn debug-instance variables-set <instance-id> --inputs '{"amount": 250}'

# Clean up
uip maestro bpmn debug-instance cancel <instance-id>

Siehe auch

• uip maestro bpmn debug – einmaliges Hochladen und Ausführen der Debugging-Sitzung
• uip maestro bpmn instance – die entsprechenden Vorgänge auf einer veröffentlichten Prozessinstanz anstelle einer Debugging-Sitzung
• Maestro-Übersicht