uip maestro bpmn

Comandos para crear, empaquetar, depurar y operar proyectos de orquestación de procesos BPMN de UiPath Maestro utilizando la herramienta `uip maestro bpmn`.

uip maestro bpmn , empaqueta, depura y opera proyectos de UiPath Maestro : orquestaciones de procesos empresariales BPMN 2.0 con semántica de larga duración e intervención humana. Maestro es una de las tres superficies de orquestación hermanas: BPMN (esta página), Flujo (uip maestro flow) y Gestión de casos (uip maestro case). Elige BPMN para la semántica BPMN estándar (tareas de usuario, eventos de límite, temporizadores, subprocesos), Flujo para un gráfico de nodo y borde de pasos de agente o con muchos conectores, y Gestión de casos para una unidad de larga duración impulsada por humanos del trabajo modelado como etapas/tareas/SLA en lugar de un proceso lineal.

La herramienta se envía como complemento @uipath/maestro-tool. Cada comando de esta página está registrado en la rama bpmn: la invocación real siempre es uip maestro bpmn <verb>, nunca un simple uip maestro <verb>. Consulta Herramientas (complementos) para el modelo de complemento.

Flujo de creación

Un proyecto de Maestro es un directorio con un project.uiproj, un archivo .bpmn y archivos de metadatos compatibles (operate.json, entry-points.json, bindings_v2.json, package-descriptor.json).

# 1. Scaffold
uip maestro bpmn init invoice-orchestration

# 2. Edit the .bpmn in Studio Web or your IDE
#    (BPMN is validated at init time via bpmn-moddle)

# 3. Smoke-test via Studio Web
uip maestro bpmn debug ./invoice-orchestration

# 4. Validate the .bpmn file before packing
uip maestro bpmn validate ./invoice-orchestration/invoice-orchestration.bpmn

# 5. Pack for deployment
uip maestro bpmn pack ./invoice-orchestration ./dist --version 1.0.0

# ...or pack + publish straight to Orchestrator in one step
uip maestro bpmn process publish ./invoice-orchestration --folder-key <key>

Comandos de creación

Comando	Propósito
uip maestro bpmn init	Andamiar un nuevo proyecto de Maestro (iniciador BPMN)
uip maestro bpmn debug	Cargar en Studio Web y ejecutar una sesión de depuración
uip maestro bpmn validate	Validar el BPMN y los metadatos de un proyecto sin empaquetar
uip maestro bpmn format	Formatear y ordenar automáticamente un archivo .bpmn
uip maestro bpmn refresh	Regenerar los archivos de proyecto generados a partir del actual .bpmn
uip maestro bpmn update-metadata	(Obsoleto: utiliza refresh) Actualizar los archivos de metadatos generados
uip maestro bpmn pack	Producir un implementable .nupkg
uip maestro bpmn process publish	Empaquetar y publicar en Orchestrator en un solo paso

Tiempo de ejecución

En runtime, un paquete de Maestro publicado se convierte en un proceso de tipo ProcessOrchestration en Orchestrator. Al iniciar uno se crea una instancia; cada intento de ejecución es un trabajo; los fallos emergen como incidentes.

Comando	Propósito
uip maestro bpmn process	Enumerar y ejecutar procesos de Maestro implementados (list, get, run, publish)
uip maestro bpmn processes	Procesar resúmenes en carpetas, incidentes por proceso y diagnósticos (list, incidents, diagnose, error-codes)
uip maestro bpmn instance	Inspeccionar y dirigir instancias en ejecución (list, get, pause, resume, cancel, retry, migrate, goto, variables, message send, element cancel/retry,...)
uip maestro bpmn debug-instance	Depurar una instancia específica en ejecución de forma interactiva
uip maestro bpmn incident	Leer resúmenes y detalles de incidentes
uip maestro bpmn job	Seguimientos de transmisión (traces) e inspección del estado del trabajo

Los trabajos y procesos en el nivel de Orchestrator se manipulan a través de la herramienta de Orchestrator — consulta Trabajos de Orchestrator y Procesos de Orchestrator.

Registro (BPMN)

Maestro también incluye un registro BPMN — uip maestro bpmn registry — para explorar los tipos de extensión, conectores y procesos utilizables dentro de un .bpmn. Todavía no está en la barra lateral, pero ya se puede llamar:

uip maestro bpmn registry pull   [-f, --force]
uip maestro bpmn registry list   [-l, --limit <n>]
uip maestro bpmn registry search <keyword>
uip maestro bpmn registry get    <extensionType> [--connection-id <id>] [--object-name <name>] [--operation <name>]

Formas de datos: RegistryPullSuccess (recuentos: ExtensionTypeCount, ConnectorCount, ProcessCount), RegistryListSuccess / RegistrySearchSuccess (Data.ExtensionTypes[], Data.Connectors[], Data.Processes[]), RegistryGetSuccess (Data.ExtensionType, opcional Data.ISEnrichment cuando se proporcionan tanto --connection-id como --object-name ).

Convenciones

• Cada subcomando uip maestro bpmn respeta las opciones globales (--output, --output-filter, --log-level, --log-file).
• La salida predeterminada es JSON.
• Los códigos de salida siguen el contrato estándar.
• La mayoría de los comandos de runtime requieren uip login primero: consulta Autenticación.

Ver también

• uip maestro flow : flujo de trabajo relacionado en forma de gráfico
• uip maestro case — Gestión de casos del mismo nivel
• Herramientas (complementos)
• Autenticación
• Opciones globales, Códigos de salida