UIP Maestro フロー ノードと UIP Maestro フロー エッジ

「uip maestro flow node」および「uip maestro flow edge」の構文とオプション。.flow」ファイル内のノードとエッジを追加、設定、表示、削除します。

フローはグラフです。ノードは 頂点 (トリガー、アクティビティ、コネクタ、エージェント) です。 エッジは、エッジ 間の有向接続です。uip maestro flow node コマンドと uip maestro flow edge コマンドは、.flow ファイルをその場で編集し、その両方を追加、設定、表示、削除します。

このページでは、.flow ファイルを同じ方法で編集する 2 つのコンパニオン コマンド グループ、 variable と bindingについても説明します。

概要

uip maestro flow node add       <file> <node-type> [-i <json>] [--position <x,y>] [--label <label>] [--source <uuid>]
uip maestro flow node configure <file> <node-id> --detail <json>
uip maestro flow node list      <file>
uip maestro flow node remove    <file> <node-id>

uip maestro flow edge add    <file> <source-id> <target-id> [--source-port <port>] [--target-port <port>]
uip maestro flow edge list   <file>
uip maestro flow edge remove <file> <edge-id>

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

---

UIP Maestro フロー ノード 追加

.flow ファイルにノードを追加します。ノードの種類はレジストリに存在する必要があります。有効な<node-type>値を検出するにはuip maestro flow registry searchを使用します。

引数

• <file> (必須) — .flow ファイルのパスです。
• <node-type> (必須) — ノードタイプ識別子 (例:core.trigger.manual、 uipath.connector.slack.send-message)。

オプション

オプション	説明
-i, --input <json>	ノードに設定する入力値の JSON オブジェクト (例:'{"script":"…"}')。配列やスカラーではなく、JSON オブジェクトである必要があります。コネクタ ノード (タイプ uipath.connector.*) の場合は、ここで--input渡さず、後でnode configureを実行してください。
--position <x,y>	キャンバスの位置 (例:250,150。x と y はどちらも必須の数値です。
--label <label>	ノードの表示ラベルです。
--source <uuid>	インライン エージェント ノードのソース識別子 ( model.sourceに入力されます)。
--parent <node-id>	このノードを含む必要がある既存のノードの ID — エッジだけでは包含を推測できないループ本体を作成するときに設定されます (通常は core.logic.loop ノードの ID)。

例

uip maestro flow node add invoice-flow.flow uipath.connector.slack.send-message --label "Notify team"

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

{
  "Code": "NodeAddSuccess",
  "Data": {
    "Node": { "id": "node_a1b2c3d4", "type": "uipath.connector.slack.send-message" },
    "DefinitionAdded": true,
    "BindingsCreated": 0,
    "VariableCount": 0
  }
}

DefinitionAddedは、特定のnode-typeの最初の挿入時にtrueされ、.flow definitions[]配列内の対応するエントリが作成されます。

---

UIP Maestro フロー ノードの設定

既に追加されているノードに inputs.detail を設定し、必要なワークフローのバインドを作成します。コネクタ ノードと Managed HTTP ノードに対してnode add後にこれを実行します。

引数

• <file> (必須) — .flow ファイルのパスです。
• <node-id> (必須) — 設定するノードの ID です ( node listで検索します)。

オプション

• --detail <json> (必須) — 構成 JSON。形状はノードタイプによって異なります。

コネクタ ノード (uipath.connector.*)

registry get出力のconnectorMethodInfoからmethodとendpointを取得します。

• 必須: connectionId、 folderKey、 method、 endpoint
• 任意: bodyParameters、 queryParameters、 pathParameters

uip maestro flow node configure invoice-flow.flow node_a1b2c3d4 --detail '{
  "connectionId": "b2c3d4e5-0000-0000-0000-000000000001",
  "folderKey":    "c3d4e5f6-0000-0000-0000-000000000001",
  "method":       "POST",
  "endpoint":     "/issues",
  "bodyParameters": { "summary": "Bug" }
}'

マネージド HTTP ノード (core.action.http.v2)

次の 2 つの認証モード:

コネクタ モード (authentication: "connector") — 認証に Integration Service のコネクションを使用します。

• 必須: authentication、 method、 connectionId、 folderKey、 targetConnector
• method ∈ GET、 POST、 PUT、 PATCH、 DELETE、 OPTIONS、 HEAD
• 任意: [ url (コネクタのベース URL に追加されるパス)、 headers、 query、 body

uip maestro flow node configure invoice-flow.flow node_abc --detail '{
  "authentication":  "connector",
  "targetConnector": "uipath-microsoft-outlook365",
  "connectionId":    "…",
  "folderKey":       "…",
  "method":          "GET",
  "url":             "/me"
}'

手動モード (authentication: "manual") — コネクタ認証なし、完全な URL と認証ヘッダーを自身で指定します。

• 必須: authentication、 method、 url (完全な URL)
• 任意: headers、 query、 body (文字列。式 (例:=js:({…}))

uip maestro flow node configure invoice-flow.flow node_abc --detail '{
  "authentication": "manual",
  "method":         "GET",
  "url":            "https://api.example.com/data",
  "headers":        { "Authorization": "Bearer <token>" }
}'

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

{
  "Code": "NodeConfigureSuccess",
  "Data": {
    "NodeId": "node_a1b2c3d4",
    "BindingsCreated": 2,
    "DetailPopulated": true
  }
}

---

UIP Maestro フロー ノードのリスト

.flowファイル内のすべてのノードのリストを取得します。

引数

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

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

{
  "Code": "NodeListSuccess",
  "Data": {
    "Nodes": [
      { "id": "start",          "type": "core.trigger.manual" },
      { "id": "node_a1b2c3d4",  "type": "core.action.http.v2" }
    ],
    "Count": 2
  }
}

各エントリには、少なくとも id と typeが含まれます。また、 .flow definitions[] 配列から表示メタデータもアタッチします。

---

UIP Maestro フロー ノード 削除

delete は remove の登録済みエイリアスです。どちらもファイルからノードを削除します。

ノードとノードが所有するすべてのものを削除します。削除:

• 接続されたエッジ
• 孤立した装丁
• 孤立した定義
• 削除されたノードが所有するノード変数
• 削除されたノードが所有する変数の更新

引数

• <file> (必須) — .flow ファイルのパスです。
• <node-id> (必須) — 削除するノードの ID。

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

{
  "Code": "NodeDeleteSuccess",
  "Data": {
    "DeletedNode":           { "id": "node_a1b2c3d4", "type": "core.action.http.v2" },
    "EdgesRemoved":          1,
    "BindingsRemoved":       0,
    "DefinitionsRemoved":    0,
    "VariablesRemoved":      0,
    "VariableUpdatesRemoved": 0
  }
}

---

UIP Maestro フロー エッジ 追加

2 つのノード間にエッジを追加します。delete は の登録済みエイリアスですedge removeです。

引数

• <file> (必須) — .flow ファイルのパスです。
• <source-id> (必須) — ソース ノードの ID。
• <target-id> (必須) — ターゲット ノードの ID。

オプション

• --source-port <port> — 送信元ポート名(デフォルト: output)。
• --target-port <port> — ターゲットポート名 (デフォルト: input)。

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

{
  "Code": "EdgeAddSuccess",
  "Data": {
    "Edge": {
      "id":         "edge_a1b2c3d4",
      "source":     "Node_1",
      "target":     "Node_2",
      "sourcePort": "output",
      "targetPort": "input"
    }
  }
}

---

UIP Maestro フロー エッジのリスト

{
  "Code": "EdgeListSuccess",
  "Data": {
    "Edges": [
      { "id": "edge_a1b2c3d4", "source": "Node_1", "target": "Node_2" }
    ],
    "Count": 1
  }
}

---

UIP Maestro フローのエッジの削除

ID によって 1 つのエッジを削除します。edge list を使用して ID を見つけます。

{
  "Code": "EdgeDeleteSuccess",
  "Data": {
    "DeletedEdge": { "id": "edge_a1b2c3d4", "source": "Node_1", "target": "Node_2" }
  }
}

---

変数

コンパニオンコマンドグループ(まだサイドバーにない)は、.flowファイルのvariablesサブツリーを編集します。

訂正: このページの以前のバージョンでは、 variable-update コマンドグループ (追加/リスト/削除、ノードへの JS 式のアタッチ) も記載されていました。そのグループはリポジトリのどこにも存在しません — 登録されておらず、実装ファイルも存在しません。このページから削除されました。

UIP Maestro のフロー変数

uip maestro flow variable add    <file> <variable-id> -d, --direction <direction> [-t, --type <type>] [--default-value <val>] [--description <text>] [--schema <json>] [--sub-type <type>] [--trigger-node-id <nodeId>]
uip maestro flow variable list   <file>
uip maestro flow variable remove <file> <variable-id>

• direction ∈ in、 out、 inout (必須)。
• type ∈ string、 number、 boolean、 object、 array、 file (既定値は stringです)。
• --default-value は --type ごとに解析されます — object/array 値は、一致するシェイプの有効なJSONである必要があります。
• --schema JSON オブジェクト (例:'{"type":"string"}')。
• --trigger-node-id <nodeId> — 入力 変数が属するトリガー ノード。既定では、フローの唯一のトリガー ノードです。フローに複数のエントリ ポイントがある場合に必要です。

データ形状: VariableAddSuccess (Data.Variable)、 VariableListSuccess ( Data.Variables[]、 Count)、 VariableRemoveSuccess (Data.DeletedVariable)。

---

Bindings

バインディングは、パブリッシュ/デプロイ時にフローが必要とする外部リソース(ターゲットプロセス、エージェント、接続、キューなど)と、それらが接続するノードプロパティを宣言します。

uip maestro flow binding add    <file> <name> <resource> <default-value> [--resource-key <key>] [--property-attribute <attr>] [--resource-sub-type <type>]
uip maestro flow binding list   <file>
uip maestro flow binding remove <file> <resource-key>

• <resource> 、サービスの VALID_RESOURCE_TYPES の 1 つである必要があります (無効な値が渡された場合に add コマンドのエラー メッセージに表示されます)。
• --property-attribute バインドによって設定されるターゲット ノード プロパティ (例:name、 folderPath、 connection)。
• --resource-sub-type では下位分類が提供されます (例:Agent、 Process)。
• binding remove (登録されている唯一の動詞 — node/edgeとは異なり、binding deleteエイリアスはありません) は、ID による単一のエントリではなく、指定されたリソースキーを持つすべてのバインディングを削除します。

データ形状: BindingAddSuccess (Data.Binding)、 BindingListSuccess (Data.Bindings[]、 Count)、 BindingRemoveSuccess (Data.DeletedBindings[]、 Count)。

---

UIP Maestro フロー形式

自動レイアウト: .flow ファイル内のノードを再配置して、オーバーラップを削除し、グラフをきれいに配置します。

uip maestro flow format <file>

データシェイプ: Code: "FlowFormat"、 Data: { File, NodesTotal, EdgesTotal, NodesRepositioned, NodesResized, SubflowsTidied, VariableCount }。

参照

• uip maestro flow registry — ノードタイプの検出
• uip maestro flow validate — 編集した.flowを検証します
• uip maestro flow init
• フローの概要