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.

概要

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

uip loginが必要です。グローバルオプションを優先します。終了コードは 標準コントラクトに従います。

引数

• [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.").

オプション

オプション	既定 (Default)	説明
--bpmn-file <path>	—	Debug a single .bpmn file directly instead of a project directory. Mutually exclusive with <project-path>.
--folder-id <id>	自動検出	Orchestrator のフォルダー (OrganizationUnitId)省略すると、現在のログイン セッションのフォルダーが使用されます。parseFolderIdで解析および検証されます。
--poll-interval <ms>	2000	ポーリング間隔 (ミリ秒単位)。正の数である必要があります。
-i, --inputs <json>	—	引数を JSON 文字列または @path/to/file.jsonとして入力します。
--login-validity <minutes>	10	トークンの有効期限の最小時間 (分) 前に自動更新がトリガーされます。

動作

1. ログインを検証し、組織、テナント、ベース URL、認証トークンをセッションから取得します。
2. プロジェクトを Studio Web のターゲット フォルダーにアップロードします。
3. 最終ステータスをポーリングし、次のような要素ごとのステータス行を出力します。

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

4. 実行中のインシデントでは、ログ行を出力します。
5. finalStatus が Completed または Successfulの場合に 0 を終了します。1そうでなければ。

例

# 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

データシェイプ(--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.

参照

• uip maestro bpmn process run — パブリッシュ済みのプロセスを実行します
• uip maestro bpmn job traces — 開始済みのジョブのストリームトレース
• 認証
• Maestro の概要