uip maestro init

有効な BPMN 2.0 スターターと Orchestrator メタデータ ファイルを使用して新しい Maestro プロジェクトをスキャフォールディングする uip maestro init の構文とオプション

uip maestro init 、有効な BPMN 2.0 スターターと、Orchestrator がプロセス オーケストレーション パッケージに期待するメタデータ ファイルを含む、新しい Maestro プロジェクト ディレクトリをスキャフォールディングします。

概要

uip maestro init <name> [--force]

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

引数

• <name> (必須) — プロジェクト フォルダーの名前。VALID_PROJECT_NAME_REGEXに対して検証されます。文字、数字、アンダースコア (_)、およびハイフン (-) のみ。

オプション

• --force — ターゲットディレクトリが存在し、空でない場合でも初期化します。既存のファイルはクリア されず 、ファイルは並行して書き込まれます。これは、事前に作成されたフォルダー内で再初期化する場合に便利です。

動作

現在の作業ディレクトリに <name>/ を作成し、次の 6 つのファイルを書き込みます。

ファイル	目的
project.uiproj	{ "Name": "<name>", "ProjectType": "ProcessOrchestration" }
operate.json	実行時のメタデータ — targetFramework: "Portable"、contentType: "processOrchestration"、runtimeOptions.isAttended: false
entry-points.json	スターター BPMN 内の Event_start を指す 1 つのエントリ ポイントと、空の入出力スキーマ
bindings_v2.json	{ "version": "2.0", "resources": [] }.
package-descriptor.json	パッカーによって消費されるファイル マニフェスト。
<name>.bpmn	uipath:entryPointId 拡張機能で接続された Event_start → _Implicit_EndEventを含むスターター BPMN。

スターター BPMN は、書き込み前に bpmn-moddle で解析されます。構造的な (UiPath 拡張機能以外の) 警告が表示された場合、コマンドは BPMN validation failed: …で失敗します。

<name>既に存在し、空でなく、--forceが設定されていない場合、コマンドは失敗し、エラーが表示されます。

例

# Create a new project in ./invoice-orchestration
uip maestro init invoice-orchestration

# Reinitialize into an existing non-empty folder
uip maestro init invoice-orchestration --force

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

{
  "Code": "MaestroInit",
  "Data": {
    "Status": "Created successfully",
    "Path": "/workspace/invoice-orchestration"
  }
}

失敗した場合、応答は Result: "Failure"、 Messageおよび Instructionsを運びます。

参照

• uip maestro pack — スキャフォールディングされたプロジェクトを梱包する
• uip maestro debug — Studio Web 経由で実行する
• Maestro の概要