Maestro de UIP

uip maestro , 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 el hermano de Flow (uip flow) en la superficie de orquestación de UiPath; elige Maestro cuando necesites semántica BPMN estándar (tareas de usuario, eventos de límite, temporizadores, subprocesos), elige Flujo cuando necesites un gráfico de nodo y borde de pasos de agente o con muchos conectores.

La herramienta se envía como complemento @uipath/maestro-tool . Los comandos de Maestro se registran en uip maestro (o, para subsuperficies específicas de BPMN, uip maestro bpmn). 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 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 debug ./invoice-orchestration

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

Comandos de creación

Comando	Propósito
uip maestro init	Andamiar un nuevo proyecto de Maestro (iniciador BPMN)
uip maestro debug	Cargar en Studio Web y ejecutar una sesión de depuración
uip maestro pack	Producir un implementable .nupkg

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 process	Enumerar y ejecutar procesos de Maestro implementados (list, get, run)
uip maestro processes	Resúmenes de procesos en todas las carpetas e incidentes por proceso
uip maestro instances	Inspeccionar y dirigir instancias en ejecución (list, get, pause, resume, cancel, retry, migrate, goto, variables, …)
uip maestro incidents	Leer resúmenes y detalles de incidentes
uip maestro 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>]

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 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 flow : flujo de trabajo relacionado en forma de gráfico
• Herramientas (complementos)
• Autenticación
• Opciones globales, Códigos de salida