UIP Maestro フロー HITL と UIP Maestro フローの移行

「uip maestro flow hitl」 (人間参加型のノードを追加) と「uip maestro flow migrate」 (「.flow」ファイルを現在のスキーマにアップグレード) の構文とオプション。

このページでは、 .flow ファイルを直接編集する、関係のない 2 つの小さなコマンド グループについて説明します。

• uip maestro flow hitl — 実行を一時停止し、Action Center でユーザーがタスクを完了するのを待機する人間参加型 (HITL) ノードを追加します。
• uip maestro flow migrate — .flow ファイルのワークフローとノード スキーマのバージョンをアップグレードします。

概要

uip maestro flow hitl add <file> [--schema <json>] [--priority <Low|Medium|High>] [--position <x,y>] [--label <label>] [--assignee <email-or-group>]

uip maestro flow migrate <file> [--dry-run] [--no-include-optional]

グローバル オプションを尊重します。終了コードは 標準契約に従います。どちらのコマンドでも uip loginは必要ありません。

UIP Maestro フロー HITL 追加

HITL ノードを .flow ファイルに追加します。

引数

• <file> (必須) — .flow ファイルのパスです。

オプション

オプション	説明
--schema <json>	タスク スキーマ: JSON オブジェクト。inputs[] エントリはフロー変数から事前に入力されます ( "binding":"varName"を追加します)。 outputs[] エントリは、フロー変数に書き戻します ( "variable":"varName"を追加します)。 outcomes[] に考えられる決定 (例:承認/却下)。
--priority <level>	Low、 Medium、または Highです。既定 Lowです。
--position <x,y>	キャンバスの位置 (例:250,300です。
--label <label>	ノードの表示ラベルです。
--assignee <email-or-group>	割り当て対象: ユーザーのメール アドレスまたはグループ名。

例

# Bare HITL node, no schema
uip maestro flow hitl add workflow.flow

# With label, priority, and a group assignee
uip maestro flow hitl add workflow.flow --label "Invoice Review" --priority High --assignee finance-approvers

# Full schema: pre-filled input, a required output written back to a variable, two outcomes
uip maestro flow hitl add workflow.flow --label "Approval" \
  --schema '{"inputs":[{"name":"invoiceId","binding":"fetchInvoice1.result.invoiceId"}],"outputs":[{"name":"decision","variable":"approvalDecision","required":true}],"outcomes":[{"name":"Approve"},{"name":"Reject"}]}'

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

{
  "Code": "HitlNodeAdded",
  "Data": {
    "NodeId": "approval1",
    "NodeType": "uipath.human-in-the-loop",
    "Label": "Approval",
    "DefinitionAdded": true
  }
}

UIP Maestro フローの移行

.flow ファイルのワークフロー スキーマのバージョンと、必要に応じてそのノード typeVersionを 現在のバージョンにアップグレードします。べき等 — 既存のファイルに対して実行しても、変更は報告されません。

引数

• <file> (必須) — .flow ファイルのパスです。

オプション

オプション	説明
--dry-run	ファイルを書き込まなくても、何が変わるかを示します。
--no-include-optional	任意のノードの移行 ( typeVersion 正規化など) をスキップします。既定: 任意の移行が適用されます。

例

# Migrate to the current schema version
uip maestro flow migrate ./my-flow/my-flow.flow

# Preview only
uip maestro flow migrate ./my-flow/my-flow.flow --dry-run

# Skip optional node migrations
uip maestro flow migrate ./my-flow/my-flow.flow --no-include-optional

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

{
  "Code": "FlowMigrate",
  "Data": {
    "File": "./my-flow/my-flow.flow",
    "Migrated": true,
    "DryRun": false,
    "FromVersion": "1.0.0",
    "ToVersion": "1.0",
    "WorkflowSteps": ["1.0.0 -> 1.0"],
    "NodeMigrations": {
      "ForcedAvailable": 0,
      "OptionalAvailable": 2,
      "OptionalApplied": 2,
      "Failed": 0
    }
  }
}

ファイルがすでに現在のバージョンである場合、Migratedはfalseされ、WorkflowStepsは空です。--dry-runを使用すると、Data.DryRunはtrueされ、ファイルはそのまま残ります。

参照

• uip maestro flow validate — 移行後に検証します
• uip maestro flow node、 uip maestro flow variable
• フローの概要
• グローバル オプション、 終了コード