UIP Maestro、BPMN の初期化

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

uip maestro bpmn init 、有効な BPMN 2.0 スターターと、Orchestrator がプロセス オーケストレーション パッケージに対して期待するメタデータ ファイルを使用して、新しい Maestro プロジェクト ディレクトリのスキャフォールディングを作成します。bpmn ブランチに登録されています。

概要

uip maestro bpmn init <name> [--process-id <id>] [--force] [--skip-solution-registration]

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

引数

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

オプション

オプション	説明
--process-id <id>	生成されたテンプレートに書き込む BPMN プロセス ID です。既定値は Process_1です。
--force	ターゲット ディレクトリが存在していて、空でなくても初期化します。既存のファイルはクリア されず 、ファイルは一緒に書き込まれます。これは、事前に作成されたフォルダー内で再初期化する場合に役立ちます。
--skip-solution-registration	このプロジェクトを周囲のソリューションに自動登録しないでください (以下の「動作」を参照)。

動作

現在の作業ディレクトリに <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	Event_start → _Implicit_EndEventを含むスターター BPMN で、--process-id (既定Process_1) を使用して uipath:entryPointId 拡張子で接続されます。

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

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

ソリューションの自動登録: --skip-solution-registration に合格しない限り、 init は周囲のソリューションを探します。いずれかの中で実行すると、新しいプロジェクトが登録されます。いずれかのソリューションの外部で実行すると、親 <name>Solution が自動的にスキャフォールディングされ、プロジェクトはその中に入れ子になります。これは明示的に要求された場合だけでなく、既定で行われます。

例

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

# Set a custom BPMN process ID
uip maestro bpmn init invoice-orchestration --process-id InvoiceApproval

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

# Scaffold standalone, without touching any surrounding solution
uip maestro bpmn init invoice-orchestration --skip-solution-registration

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

{
  "Code": "MaestroInit",
  "Data": {
    "Status": "Created successfully",
    "Path": "/workspace/invoice-orchestration",
    "SolutionRegistration": { "...": "registration outcome against the surrounding or newly created solution" },
    "AutoCreatedSolution": { "...": "present only when a parent <name>Solution was scaffolded automatically" },
    "ProjectArtifacts": { "...": "present only when additional project artifacts were generated" },
    "NextSteps": "present only when SolutionRegistration carries follow-up instructions"
  }
}

AutoCreatedSolution、ProjectArtifacts、およびNextStepsは、該当しない場合は完全に省略され、、Path、SolutionRegistrationStatusのみが常に存在します。失敗した場合、応答には Result: "Failure"、 Message、および Instructionsが返されます。

参照

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