UIP Maestro

UiPath Maestro プロジェクトの作成、パッケージ化、デバッグ、運用をuip maestroします。これは、長期実行の人間参加型のセマンティクスを備えた BPMN 2.0 ビジネス プロセス オーケストレーションです。Maestro は、UiPath オーケストレーション サーフェスにおけるフロー (uip flow) の兄弟です。標準的な BPMN セマンティクス (ユーザー タスク、境界イベント、タイマー、サブプロセス) が必要な場合は [Maestro] を選択し、エージェンティック ステップやコネクタを多用するステップのノードとエッジのグラフが必要な場合は [フロー] を選択します。

このツールは、 @uipath/maestro-tool プラグインとして出荷されます。Maestro コマンドは uip maestro (BPMN 固有のサブサーフェスの場合は uip maestro bpmn) で登録されます。プラグインモデルについては、 ツール(プラグイン) を参照してください。

オーサリング フロー

Maestro プロジェクトは、 project.uiproj、 .bpmn ファイル、およびサポート メタデータ ファイル (operate.json、 entry-points.json、 bindings_v2.json、 package-descriptor.json) を含むディレクトリです。

# 1. Scaffold
uip maestro init invoice-orchestration

# 2. Edit the .bpmn in Studio Web or your IDE
#    (BPMN is validated at init time via bpmn-moddle)

# 3. Smoke-test via Studio Web
uip maestro debug ./invoice-orchestration

# 4. Pack for deployment
uip maestro pack ./invoice-orchestration ./dist --version 1.0.0

オーサリングコマンド

コマンド	目的
uip maestro init	新しい Maestro プロジェクトのスキャフォールディング (BPMN スターター)
uip maestro debug	Studio Web にアップロードしてデバッグ セッションを実行する
uip maestro pack	デプロイ可能な .nupkg

実行時

実行時に、パブリッシュされた Maestro パッケージは、Orchestrator 上でProcessOrchestrationタイプのプロセスになります。1 つ起動する とインスタンスが作成されます。各実行試行は ジョブです。失敗 はインシデントとして表面化します。

コマンド	目的
uip maestro process	デプロイ済みの Maestro プロセスの一覧を表示して実行する (list、 get、 run)
uip maestro processes	複数のフォルダーにわたるプロセスの概要、およびプロセスごとのインシデント
uip maestro instances	実行中のインスタンス (list、 get、 pause、 resume、 cancel、 retry、 migrate、 goto、 variables、...) を検査およびステアリングします。
uip maestro incidents	インシデントの概要と詳細を読む
uip maestro job	トレース (traces) をストリームし、ジョブのステータスを検査する

Orchestrator レベルのジョブやプロセスは、Orchestrator ツールを使用して操作します。詳しくは、「 Orchestrator のジョブ 」および「 Orchestrator のプロセス」をご覧ください。

レジストリ (BPMN)

Maestro には、.bpmn内で使用可能な拡張機能の種類、コネクタ、プロセスを参照するための BPMN レジストリ ( uip maestro bpmn registry ) も付属しています。まだサイドバーにはありませんが、今日呼び出すことができます。

uip maestro bpmn registry pull   [-f, --force]
uip maestro bpmn registry list   [-l, --limit <n>]
uip maestro bpmn registry search <keyword>
uip maestro bpmn registry get    <extensionType> [--connection-id <id>] [--object-name <name>]

データシェイプ:RegistryPullSuccess(カウント:ExtensionTypeCount、ConnectorCount、ProcessCount)、RegistryListSuccess/RegistrySearchSuccess(Data.ExtensionTypes[]、Data.Connectors[]、Data.Processes[])、RegistryGetSuccess(Data.ExtensionType、--connection-idと--object-nameの両方が提供される場合はオプションのData.ISEnrichment)。

命名規則

• すべての uip maestro サブコマンドは、 グローバルオプション (--output、 --output-filter、 --log-level、 --log-file) を尊重します。
• 既定の出力は JSON です。
• 終了コードは 標準コントラクトに従います。
• ほとんどのランタイム コマンドでは、最初に uip login が必要です — 「認証」をご覧ください。

参照

• uip flow — グラフ型のワークフローの兄弟
• ツール (プラグイン)
• 認証
• グローバル オプション、 終了コード