init de uip maestro bpmn

Sintaxis y opciones para `uip maestro bpmn init`, que andamia un nuevo proyecto de Maestro con un iniciador BPMN 2.0 válido y archivos de metadatos de Orchestrator.

uip maestro bpmn init andamia un nuevo directorio de proyecto de Maestro con un iniciador BPMN 2.0 válido y los archivos de metadatos que Orchestrator espera para los paquetes de orquestación de procesos. Está registrado en la rama bpmn.

Sinopsis

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

Prevalece las opciones globales. Los códigos de salida siguen el contrato estándar.

Argumentos

• <name> obligatorio) : nombre de la carpeta del proyecto. Validado para VALID_PROJECT_NAME_REGEX: solo letras, números, guiones bajos (_) y guiones (-).

Opciones

Opción	Descripción
--process-id <id>	ID de proceso BPMN para escribir en la plantilla generada. Predeterminado: Process_1.
--force	Inicializar incluso si el directorio de destino existe y no está vacío. Los archivos existentes no se borran: los archivos se escriben al lado; esto es útil para reiniciar dentro de una carpeta creada previamente.
--skip-solution-registration	No registres automáticamente este proyecto en la solución circundante (consulta Comportamiento a continuación).

Comportamiento

Crea <name>/ en el directorio de trabajo actual y escribe seis archivos:

Archivo	Propósito
project.uiproj	{ "Name": "<name>", "ProjectType": "ProcessOrchestration" }
operate.json	Metadatos de runtime: targetFramework: "Portable", contentType: "processOrchestration", runtimeOptions.isAttended: false.
entry-points.json	Un punto de entrada que apunta a Event_start dentro del BPMN de inicio, con esquemas de entrada/salida vacíos.
bindings_v2.json	{ "version": "2.0", "resources": [] }.
package-descriptor.json	Manifiesto de archivo consumido por el empaquetador.
<name>.bpmn	BPMN de inicio que contiene Event_start → _Implicit_EndEvent, conectado con una extensión uipath:entryPointId utilizando --process-id (predeterminado: Process_1).

El BPMN de inicio se analiza a través de bpmn-moddle antes de escribir; si aparecen advertencias estructurales (extensión no UiPath), el comando falla con BPMN validation failed: ….

Si <name> ya existe y no está vacío y --force no está establecido, el comando falla con un error.

Registro automático de soluciones: a menos que se pase --skip-solution-registration , init busca una solución circundante. Si se ejecuta dentro de uno, el nuevo proyecto se registra en él. Si se ejecuta fuera de cualquier solución, un <name>Solution principal se aplica andamios automáticamente y el proyecto se anida en su interior; esto sucede de forma predeterminada, no solo cuando se solicita explícitamente.

Ejemplos

# 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

Forma de datos (--json de salida)

{
  "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 y NextSteps se omiten por completo cuando no son aplicables: solo Status, Path y SolutionRegistration están siempre presentes. En caso de fallo, la respuesta lleva Result: "Failure", Message y Instructions.

Ver también

• uip maestro bpmn pack — empaqueta el proyecto andamiado
• uip maestro bpmn debug : ejecútalo a través de Studio Web
• uip maestro bpmn validate — validar antes de empaquetar
• Descripción general de Maestro