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 の概要