UIP Maestro フロー debug-instance

「uip maestro flow debug-instance」の構文とオプション。Studio Web のデバッグ セッションをステップ実行、検査、および操作するための低レベルのデバッガー制御サーフェスです。

uip maestro flow debug-instance は低レベルのデバッガーのコントロール サーフェスです。デバッグ インスタンスを作成してステップ実行し、その変数とインシデントを検査して、キャンセルまたは続行します。これは、プロジェクトをアップロードし、1 回の呼び出しで完了までポーリングを行う uip maestro flow debugとは異なり、よりきめ細かいレイヤーです。debug-instance 、Studio Web のデバッグ プロトコルを中心としたカスタム デバッグ ツール (エディターとの連携など) を構築し、一度に 1 つのステップずつ推進する必要があります。

概要

uip maestro flow 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 flow debug-instance status         <instance-id>
uip maestro flow debug-instance breakpoints    <instance-id> [--inputs <json|@file>]
uip maestro flow debug-instance cancel         <instance-id>
uip maestro flow debug-instance continue       <instance-id> [--inputs <json|@file>]
uip maestro flow debug-instance incidents      <instance-id>
uip maestro flow debug-instance variables      <instance-id> [--parent-element-id <id>]
uip maestro flow debug-instance variables-set  <instance-id> [--inputs <json|@file>]
uip maestro flow debug-instance variables-all  <instance-id>

グローバル オプションを尊重します。終了コードは 標準契約に従います。uip loginが必要です。

uip maestro flow debug-instance create

Orchestrator でデバッグ セッションを開始し、アップロード済みのソリューションに対応するデバッグ インスタンスを作成します。

オプション

オプション	Required	既定 (Default)	説明
--solution-id <id>	○	—	以前にアップロードしたソリューション ID または Studio Web から取得したソリューション ID
--project-id <id>	○	—	ソリューション内の Studio Web プロジェクト ID。
--entry-point <path>	○	—	エントリ ポイントのパス (例:/Main.bpmn#startです。
--process-type <type>	×	processOrchestration	プロセスの種類。
--debug-mode <mode>	×	Default	Default (ブレークポイントで一時停止)、 StepByStep (すべてのステップで一時停止)、または SingleStep (1 つのステップのみを実行)。
--simulation-mode <mode>	×	None	None、 All (すべての要素をシミュレート)、または Selective (オプトアウトを除くシミュレート) です。
-i, --inputs <json>	×	{}	引数を JSON 文字列として入力します。

無効な --debug-mode/--simulation-mode 値がすぐに失敗し、有効なセットが一覧表示されます。

データシェイプ

{
  "Code": "DebugInstanceCreated",
  "Data": {
    "instanceId": "…",
    "runId": "…",
    "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 フローのデバッグ - インスタンスのステータス

要素ごとの実行ステータスを取得します。引数: <instance-id>。データ図形: Code: "DebugInstanceStatus"。

UIP Maestro フローのデバッグ - インスタンスのブレークポイント

一時停止したインスタンスのブレークポイント セットを更新します。引数: <instance-id>。オプション: --inputs <value> — ブレークポイントのペイロードは、JSON 文字列、 @file パス、または標準値を介してパイプされます。データ図形: Code: "DebugInstanceBreakpointsUpdated"。

UIP Maestro フロー デバッグ - インスタンスのキャンセル

デバッグ インスタンスをキャンセルします。引数: <instance-id>。データ図形: Code: "DebugInstanceCanceled"。

UIP Maestro フロー デバッグ - インスタンスの続行

一時停止したインスタンスで実行を再開します。引数: <instance-id>。オプション: --inputs <value> — JSON 文字列、 @file パス、または標準値です。省略すると既定で {"nextStep": false} されます (単一のステップではなく、次のブレークポイントまで実行)。データ図形: Code: "DebugInstanceContinued"。

UIP Maestro フローのデバッグ - インスタンスのインシデント

デバッグ セッション中に発生したインシデントを取得します。引数: <instance-id>。データ図形: Code: "DebugInstanceIncidents" Data は配列です (配列がない場合は空)。

UIP Maestro フローのデバッグ インスタンス変数

インスタンスの変数を取得します。引数: <instance-id>。オプション: --parent-element-id <id> — フィルターを適用し、1 つの要素のスコープを持つ変数に絞り込みます。データ図形: Code: "DebugInstanceVariables"。

uip maestro フロー debug-instance variables-set

変数にパッチを適用 (一部更新) します。引数: <instance-id>。オプション: --inputs <value> — パッチ ペイロードを JSON 文字列、 @file パス、または標準として指定します。データ図形: Code: "DebugInstanceVariablesSet"。

uip maestro フロー debug-instance variables-all

サブプロセスのスコープを含む、すべての変数を取得します。引数: <instance-id>。データ図形: Code: "DebugInstanceVariablesAll"。

参照

• uip maestro flow debug — ほとんどのワークフローで代わりに使用すべき、アップロードしてポーリングを行う高レベルのデバッグ コマンドです
• uip maestro flow instance — デバッグ セッションではなく、パブリッシュ済みの実行中のインスタンスに相当するコントロール サーフェスです
• フローの概要
• グローバル オプション、 終了コード