UIP Maestro の BPMN プロセスと UIP Maestro の BPMN プロセス

「uip maestro bpmn プロセス」および「uip maestro bpmn プロセス」の構文とオプション。フォルダーごとおよびテナント全体にパブリッシュされた Maestro BPMN プロセスの操作をカバーします。

Maestro の BPMN パッケージを Orchestrator にパブリッシュすると、そのパッケージは種類が ProcessOrchestrationのプロセスになります。以下の両方のコマンド グループは、 bpmn ブランチに登録されています。このページでは、次の 2 つの関連するコマンド グループについて説明します。

• uip maestro bpmn process — 単一のプロセス定義に対するフォルダーごとの操作 (フォルダーへの登録、スキーマの取得、実行、パッケージ化 + パブリッシュ)。
• uip maestro bpmn processes (複数形) — テナント全体の概要、プロセスごとのインシデントの検索、診断。

概要

# Singular — per-folder, operational
uip maestro bpmn process list    -f <folder-key> [--filter <odata>] [--login-validity <minutes>]
uip maestro bpmn process get     <process-key> <feed-id> -f <folder-key> [--login-validity <minutes>]
uip maestro bpmn process run     <process-key> <folder-key> --release-key <key>
                                  [-i, --inputs <json>] [--feed-id <id>] [--robot-ids <ids>]
                                  [--login-validity <minutes>]
uip maestro bpmn process publish <project-path> [output-path] -f <folder-key>
                                  [-n, --name <name>] [--process-name <name>] [-v, --version <version>]
                                  [-i, --inputs <json>] [--feed-id <id>] [--entry-point <path>]
                                  [--wait [--timeout <seconds>] [--poll-interval <seconds>]] [--login-validity <minutes>]

# Plural — tenant-wide summary, incidents, and diagnostics
uip maestro bpmn processes list       [--folder-key <key>] [-l <limit>] [--offset <n>] [--status <status>]
uip maestro bpmn processes incidents  <process-key> --folder-key <key>
uip maestro bpmn processes diagnose   <process-key> --folder-key <key>
uip maestro bpmn processes error-codes <process-key> --folder-key <key>

すべてのサブコマンドには uip login が必要であり、 グローバルオプションが適用されます。終了コードは 標準コントラクトに従います。

---

UIP Maestro BPMN プロセスのリスト

特定のフォルダー内の利用可能な Maestro プロセス (リリース) のリストを取得します。

オプション

オプション	Required	説明
-f, --folder-key <key>	○	フォルダー キー (GUID)。
--filter <odata>	×	サーバー側で追加の OData フィルターを適用します。
--login-validity <minutes>	×	トークン更新のしきい値 (既定 10)。

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

{
  "Code": "MaestroProcessList",
  "Data": [
    {
      "name":           "InvoiceOrchestration",
      "processKey":     "a1b2c3d4-0000-0000-0000-000000000001",
      "processVersion": "1.0.0",
      "packageId":      "a1b2c3d4-0000-0000-0000-000000000001",
      "packageVersion": "1.0.0",
      "releaseKey":     "e5f6a7b8-0000-0000-0000-000000000001",
      "folderKey":      "c3d4e5f6-0000-0000-0000-000000000001",
      "feedId":         "default",
      "folderId":       42,
      "active":         "Yes",
      "latest":         "Yes"
    }
  ]
}

---

UIP Maestro、BPMN プロセス Get

Maestro プロセスのエントリ ポイント スキーマ (入力/出力 JSON スキーマ) を取得します。

引数

• <process-key> (必須) — プロセス キー。
• <feed-id> (必須) — フィード ID ( listから)。

オプション

• -f, --folder-key <key> (必須)
• --login-validity <minutes> (既定 10)

データシェイプ

{
  "Code": "MaestroProcessGet",
  "Data": [
    {
      "Path":         "/content/main.bpmn#Event_start",
      "DisplayName":  "Manual trigger",
      "Type":         "processorchestration",
      "InputSchema":  "{\"type\":\"object\",\"properties\":{}}",
      "OutputSchema": "{\"type\":\"object\",\"properties\":{}}"
    }
  ]
}

InputSchema と OutputSchema は、JSON スキーマの文字列を再文字列化したものです。

---

UIP Maestro、BPMN プロセスの実行

パブリッシュ済みのプロセスに対して Maestro ジョブを開始します。

引数

• <process-key> (必須) — process listのバージョン管理されたパッケージ プロセス キーです (例: MyProcess:1.0.0)。
• <folder-key> (必須) — フォルダー キー (GUID)。

オプション

オプション	Required	説明
--release-key <key>	○	キー (GUID) — process listから 。
-i, --inputs <json>	×	JSON 文字列または @path/to/file.jsonとして入力します。省略して stdin をパイプすると、stdin が解析されます。
--feed-id <id>	×	パッケージ検索用のフィード ID (任意)。
--robot-ids <ids>	×	コンマ区切りのロボット ID です (任意)。
--login-validity <minutes>	×	トークン更新のしきい値 (既定 10)。

このコマンドには --validate オプションはありません。入力はそのまま送信されます。不正な入力を拒否する責任はプロセス自体にあります。

入力の優先順位: --inputs <json> / --inputs @file.json > stdin >空のオブジェクト {}。

例

# Inline JSON
uip maestro bpmn process run "InvoiceOrchestration:1.0.0" "<folder-key>" \
  --release-key <release-key> --inputs '{"amount":100}'

# From a file
uip maestro bpmn process run "InvoiceOrchestration:1.0.0" "<folder-key>" \
  --release-key <release-key> --inputs @inputs.json

# Piped stdin
echo '{"amount":100}' | uip maestro bpmn process run "InvoiceOrchestration:1.0.0" "<folder-key>" --release-key <release-key>

データシェイプ

{
  "Code": "MaestroJobStarted",
  "Data": {
    "jobKey":  "b2c3d4e5-0000-0000-0000-000000000001",
    "state":   "Pending",
    "traceId": "d4e5f6a7-0000-0000-0000-000000000001"
  }
}

次の手順: ストリームの実行またはポーリングuip maestro bpmn job status <jobKey>uip maestro bpmn job traces <jobKey>します。

---

UIP Maestro: BPMN プロセスのパブリッシュ

Maestro の BPMN プロジェクト ディレクトリを .nupkg にパックし、Orchestrator のプロセス リリースとしてパブリッシュする手順が 1 ステップで完了します。

引数

• <project-path> (必須) — Maestro の BPMN プロジェクト ディレクトリへのパスです。
• [output-path] (任意) — 生成される .nupkgの出力ディレクトリです。既定値は一時ディレクトリです。

オプション

オプション	説明
-f, --folder-key <key>	必須。フォルダー キー (GUID)。
-n, --name <name>	パッケージ名。既定: プロジェクトのフォルダー名です。
--process-name <name>	プロセス リリース名。既定: パッケージ名です。
-v, --version <version>	パッケージ バージョン。既定 1.0.0です。
-i, --inputs <json>	既定の入力パラメーターは、JSON 文字列、 @file.json、または stdin の場合は - です。
--feed-id <id>	パッケージをアップロードするフィード ID (任意)。
--entry-point <path>	プロセスのエントリ ポイントのパスです。
--wait	アップロード後すぐに戻るのではなく、パブリッシュされたパッケージのエントリ ポイントが利用可能になるまで待ちます。
--timeout <seconds>	[ --wait ] が設定されている場合、パブリッシュの反映を待機する最大秒数です。既定 300です。
--poll-interval <seconds>	[ --wait ] が設定されている場合は、パブリッシュの反映を確認する間隔 (秒数) を指定します。既定 5です。
--login-validity <minutes>	トークンの更新しきい値です。既定 10です。

例

uip maestro bpmn process publish ./invoice-process \
  --folder-key <folder-key> --version 1.2.0 --wait

データシェイプ

{
  "Code": "MaestroProcessPublished",
  "Data": {
    "Package": "invoice-process@1.2.0",
    "PackagePath": "/tmp/maestro-process-publish-.../invoice-process.processOrchestration.ProcessOrchestration.1.2.0.nupkg",
    "ProcessKey": "invoice-process.processOrchestration.ProcessOrchestration",
    "ProcessVersion": "1.2.0",
    "ReleaseKey": "e5f6a7b8-0000-0000-0000-000000000001",
    "ReleaseName": "invoice-process",
    "Action": "Created",
    "Upload": [
      { "key": "invoice-process.processOrchestration.ProcessOrchestration", "status": "Created" }
    ],
    "EntryPoints": 1
  }
}

Actionは、特定のプロセス キーの最初のパブリッシュ時"Updated"、それ以降のパブリッシュ時に"Created"されます。

---

UIP Maestro BPMN プロセスのリスト

テナント全体 (またはフォルダー範囲) の Maestro プロセスの概要。単数形の process listとは異なり、サーバー側では processType フィルターは適用されません。複数形のコマンドはツール (Maestro、Flow、Case) 間で共有され、単独で ProcessOrchestration するためのスコープはありません。

オプション

オプション	説明
--folder-key <key>	任意です。要約のスコープを 1 つのフォルダーに設定します。
-l, --limit <number>	返すアイテムの数 (1-10000)。
--offset <number>	スキップする項目の数 (0 から 1000000)。既定 0です。
--status <status>	プロセスのステータスでフィルター処理する。

データシェイプ

{
  "Code": "ProcessList",
  "Data": [ /* array of Maestro process summaries */ ]
}

注:

各プロセス概要の正確なフィールド セットは Maestro ランタイムによって指定され、さらに進化する可能性があります。データがあるテナントに対して --output json でコマンドを 1 回実行して使用するフィールドを確認し、特定のフィールドを解析する場合は CI に @uipath/cli ピン留めします。

---

UIP Maestro: BPMN によるインシデントの処理

特定の Maestro プロセス定義のすべてのインシデントを取得します。

引数

• <process-key> (必須) — プロセス定義キー。

オプション

• --folder-key <key> (必須)

データシェイプ

{
  "Code": "ProcessIncidents",
  "Data": [ /* array of process incidents */ ]
}

---

UIP Maestro: BPMN プロセス診断

プロセスの概要、インシデント、およびエラー コードを 1 回の呼び出しで関連付けます。これは、 processes list、 processes incidents、 processes error-codesに対する便利なラッパーです。

引数

• <process-key> (必須) — プロセス定義キー。

オプション

• --folder-key <key> (必須)

データシェイプ

{
  "Code": "ProcessDiagnostics",
  "Data": {
    "ProcessKey": "InvoiceOrchestration",
    "FolderKey": "c3d4e5f6-0000-0000-0000-000000000001",
    "Summary": { /* the matching process summary object, or null if not found */ },
    "FaultedCount": 2,
    "RunningCount": 5,
    "Incidents": [ /* array of incident objects */ ],
    "IncidentCount": 1,
    "ErrorCodes": [ /* array of error code strings */ ],
    "ErrorCodeCount": 1
  }
}

---

UIP Maestro BPMN プロセスのエラー コード

特定のプロセスのインシデントによって発生した一意のエラー コードを取得します。

引数

• <process-key> (必須) — プロセス定義キー。

オプション

• --folder-key <key> (必須)

データシェイプ

{
  "Code": "ProcessIncidentErrorCodes",
  "Data": [ /* array of error code strings */ ]
}

参照

• uip maestro bpmn instances — 実行中の実行を検査およびステアリングする
• uip maestro bpmn job — 単一のジョブのトレースとステータス
• uip maestro bpmn incidents — インシデントの概要と詳細
• Orchestrator のジョブ、 Orchestrator のプロセス
• Maestro の概要