UIP フローのデバッグ

uip flow debug は、ローカルの Flow プロジェクトを Studio Web にアップロードし、サーバー側のデバッグ セッションを実行して、要素ごとのステータスの更新をコンソールにストリーミングし、最終ステータスを返します。

概要

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

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

引数

• <project-path> (必須) — Flow プロジェクトディレクトリへのパス。次の文字列を含む必要があります project.uiproj。

オプション

オプション	既定 (Default)	説明
--folder-id <id>	自動検出	Orchestrator のフォルダー (OrganizationUnitId)省略すると、現在のログイン セッションのフォルダーが使用されます。整数として解析されます。
--poll-interval <ms>	2000	Studio Web がセッションを前進させるのを待機する間のポーリング間隔 (ミリ秒単位)。
-i, --inputs <json>	—	引数を JSON 文字列として入力するか、ファイルから読み込む @path/to/file.json として入力します。また、どちらも指定されていない場合はstdinから読みます(ここではuip flow process runではなく、JSON文字列または@fileのみを受け入れますdebug)。
--login-validity <minutes>	10	トークンの有効期限の最小時間 (分) 前に自動更新がトリガーされます。

動作

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

   Status: InProgress (2/5 elements completed)
     v Node_1 [Completed]
     > Node_2 [InProgress]
     - Node_3 [NotStarted]
   

4. 実行中のインシデントに対して、警告ラインを発します。
5. finalStatus が Completed または Successfulの場合に 0 を終了します。1そうでなければ。

例

# Debug a local project, auto-detect folder, default poll interval
uip flow debug ./invoice-flow

# Debug against a specific folder with inline JSON inputs
uip flow debug ./invoice-flow --folder-id 2553016 \
  --inputs '{"amount":100,"customer":"Acme"}'

# Debug with inputs from a file
uip flow debug ./invoice-flow --inputs @inputs.json

# Slower polling for long-running flows
uip flow debug ./invoice-flow --poll-interval 5000

データシェイプ(--output json)

{
  "Code": "FlowDebug",
  "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/tenant/studio_/debug/e5f6a7b8",
    "elementExecutions": [
      { "elementId": "Node_1", "status": "Completed" }
    ],
    "variables": {}
  }
}

ブラウザーで studioWebUrl を開き、対話形式でセッションを検査します。

参照

• uip flow validate — 実行前の静的チェック
• uip flow process run — パブリッシュ済みのプロセスを実行します
• uip flow job traces — 開始済みのジョブのストリームトレース
• 認証
• フローの概要