Initialisation bpmn uip maestro

Syntaxe et options pour `uip maestro bpmn init`, qui élaborationent un nouveau projet Maestro avec un démarrage BPMN 2.0 et des fichiers de métadonnées Orchestrator valides.

uip maestro bpmn init élabore un nouveau répertoire de projet Maestro avec un déclencheur BPMN 2.0 valide et les fichiers de métadonnées qu'Orchestrator attend pour les packages d'orchestration de processus. Elle est enregistrée sous la branche bpmn.

Synthèse

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

Les options globales sont respectées. Les codes de sortie suivent le contrat standard.

Arguments

• <name> (obligatoire) : nom du dossier du projet. Validé par rapport à VALID_PROJECT_NAME_REGEX: lettres, chiffres, traits de soulignement (_) et traits d’union (-) uniquement.

Options

Option	Description
--process-id <id>	ID du processus BPMN à écrire dans le modèle généré. Par défaut: Process_1.
--force	Initialisez même si le répertoire cible existe et n’est pas vide. Les fichiers existants ne sont pas effacés - les fichiers sont écrits avec; Cela est utile pour la réinitialisation dans un dossier pré-créé.
--skip-solution-registration	N’enregistrez pas automatiquement ce projet dans la solution voisine (voir Comportement ci-dessous).

Comportement

Crée <name>/ dans le répertoire de travail actuel et écrit six fichiers:

Fichier	Objectif
project.uiproj	{ "Name": "<name>", "ProjectType": "ProcessOrchestration" }
operate.json	Métadonnées de runtime — targetFramework: "Portable", contentType: "processOrchestration", runtimeOptions.isAttended: false.
entry-points.json	Un point d'entrée pointant sur Event_start à l'intérieur du BPMN de démarrage, avec des schémas d'entrée/de sortie vides.
bindings_v2.json	{ "version": "2.0", "resources": [] }.
package-descriptor.json	Manifest de fichier utilisé par le packer.
<name>.bpmn	BPMN de démarrage contenant Event_start → _Implicit_EndEvent, connecté avec une extension uipath:entryPointId à l'aide de --process-id (par défaut Process_1).

Le BPMN de démarrage est analysé via bpmn-moddle avant d'écrire; si des avertissements de structure (n'appartenant pas à l'extension UiPath) apparaissent, la commande échoue avec BPMN validation failed: ….

Si <name> existe déjà et n’est pas vide et que --force n’est pas défini, la commande échoue avec une erreur.

Enregistrement automatique de la solution: à moins que --skip-solution-registration ne soit transmis, init recherche une solution voisine. Si exécuté à l'intérieur de l'une d'entre elles, le nouveau projet y sera enregistré. S’il est exécuté en dehors de toute solution, un parent <name>Solution est automatiquement élaboration et le projet est imbriqué à l’intérieur — cela se produit par défaut et pas seulement lorsque cela est explicitement demandé.

Exemples

# 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

Format des données (--sortie 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 et NextSteps sont entièrement omis lorsqu'ils ne s'appliquent pas - seuls Status, Path et SolutionRegistration sont toujours présents. En cas d'échec, la réponse porte Result: "Failure", Message et Instructions.

Voir également

• uip maestro bpmn pack — compresser le projet structuré
• uip maestro bpmn debug — Exécuter via Studio Web
• uip maestro bpmn validate — valider avant la mise en package
• Vue d’ensemble de Maestro