uip maestro bpmn debug

Upload a local Maestro BPMN project (or a single .bpmn file) to Studio Web and run a server-side debug session with streamed status updates using `uip maestro bpmn debug`.

uip maestro bpmn debug uploads a local Maestro project — or a single .bpmn file — to Studio Web and runs a server-side debug session, streaming per-element status updates back to the console and returning a final status. It's registered under the bpmn branch.

Zusammenfassung

uip maestro bpmn debug [project-path]
                  [--bpmn-file <path>]
                  [--folder-id <id>]
                  [--poll-interval <ms>]
                  [-i, --inputs <json>]
                  [--login-validity <minutes>]

Erfordert uip login. Beachten Sie globale Optionen. Austrittscodes folgen dem Standardvertrag.

Argumente

• [project-path] (optional) — path to the Maestro project directory. Must contain project.uiproj. Omit when using --bpmn-file. One of <project-path> or --bpmn-file is required; passing both is an error ("Provide either a project path or --bpmn-file, not both.").

Optionen

Option	Standard	Beschreibung
--bpmn-file <path>	–	Debug a single .bpmn file directly instead of a project directory. Mutually exclusive with <project-path>.
--folder-id <id>	Automatisch erkennen	Orchestrator-Ordner (OrganizationUnitId). Wenn keine Angabe erfolgt, wird der Ordner der aktuellen Anmeldesitzung verwendet. Über parseFolderId geparst und validiert.
--poll-interval <ms>	2000	Abrufintervall in Millisekunden. Muss eine positive Zahl sein.
-i, --inputs <json>	–	Geben Sie Argumente als JSON-Zeichenfolge oder @path/to/file.json.
--login-validity <minutes>	10	Mindestens Minuten vor dem Tokenablauf zum Auslösen einer automatischen Aktualisierung.

Verhalten

1. Validiert die Anmeldung und ruft die Organisation, den Mandanten, die Basis-URL und das Authentifizierungstoken aus der Sitzung ab.
2. Lädt das Projekt in Studio Web unter dem Zielordner hoch.
3. Abfragen nach einem endgültigen Status, wobei Statuszeilen pro Element ausgegeben werden wie:

   Status: InProgress (2/5 elements completed)
     v Activity_1 [Completed]
     > Activity_2 [InProgress]
     - Activity_3 [NotStarted]
   

4. Gibt bei Vorfällen während der Ausführung eine Protokollzeile aus.
5. 0 wird beendet, wenn finalStatus Completed oder Successful ist; 1 andernfalls.

Beispiele

# Debug with auto-detected folder
uip maestro bpmn debug ./invoice-orchestration

# Specify folder and inline inputs
uip maestro bpmn debug ./invoice-orchestration --folder-id 2553016 \
  --inputs '{"amount":100,"customer":"Acme"}'

# Inputs from a file
uip maestro bpmn debug ./invoice-orchestration --inputs @inputs.json

# Debug a single .bpmn file directly, without a full project directory
uip maestro bpmn debug --bpmn-file ./main.bpmn

Datenform (--output json)

{
  "Code": "MaestroDebug",
  "Data": {
    "jobKey":      "b2c3d4e5-0000-0000-0000-000000000001",
    "instanceId":  "c3d4e5f6-0000-0000-0000-000000000001",
    "runId":       "d4e5f6a7-0000-0000-0000-000000000001",
    "finalStatus": "Completed",
    "solutionId":  "e5f6a7b8-0000-0000-0000-000000000001",
    "studioWebUrl": "https://cloud.uipath.com/org/studio_/designer/f6a7b8c9-...?solutionId=e5f6a7b8-...",
    "elementExecutions": [
      { "elementId": "Activity_1", "status": "Completed" }
    ]
  }
}

studioWebUrl links directly to the debug run in Studio Web.

Siehe auch

• uip maestro bpmn process run – Führen Sie einen veröffentlichten Prozess aus
• uip maestro bpmn job traces – Stream-Ablaufverfolgungen für einen bereits gestarteten Auftrag
• Authentication
• Maestro-Übersicht