UIP Maestro

uip maestro autores, pacotes, depura e opera projetos do UiPath Maestro — orquestrações de processos de negócios BPMN 2.0 com semântica de intervenção humana de longa duração. O Maestro é o irmãos do Flow (uip flow) na superfície de orquestração da UiPath; escolha Maestro quando precisar de semântica BPMN padrão (tarefas de usuário, eventos de limite, temporizadores, subprocessos), escolha Fluxo quando precisar de um gráfico de nó e borda de etapas altamente agênticas ou de conector.

A ferramenta é enviada como o plug-in @uipath/maestro-tool . Os comandos do Maestro são registrados em uip maestro (ou, para subsurfaces específicas de BPMN, uip maestro bpmn). Consulte Ferramentas ( plugins ) para obter o modelo de plug-in.

Fluxo de criação

Um projeto do Maestro é um diretório com um project.uiproj, um arquivo .bpmn e arquivos de metadados de suporte (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

Criando comandos

Command	Finalidade
uip maestro init	Estruture um novo projeto do Maestro (iniciador BPMN)
uip maestro debug	Faça upload para o Studio Web e execute uma sessão de depuração
uip maestro pack	Produzir um implantável .nupkg

Runtime

No runtime, um pacote Maestro publicado se torna um processo do tipo ProcessOrchestration no Orchestrator. Iniciar um cria uma instância; cada tentativa de execução é um trabalho; as falhas aparecem como incidentes.

Command	Finalidade
uip maestro process	Listar e executar processos implantados do Maestro (list, get, run)
uip maestro processes	Resumos de processos em pastas e incidentes por processo
uip maestro instances	Inspecionar e orientar instâncias em execução (list, get, pause, resume, cancel, retry, migrate, goto, variables,…)
uip maestro incidents	Ler resumos e detalhes de incidentes
uip maestro job	Transmitir rastreamentos (traces) e inspecionar o status dos trabalhos

Os trabalhos e processos no nível do Orchestrator são manipulados por meio da ferramenta do Orchestrator — consulte Trabalhos do Orchestrator e Processos do Orchestrator.

Registro (BPMN)

O Maestro também envia um registro BPMN — uip maestro bpmn registry — para navegar nos tipos de extensão, conectores e processos utilizáveis dentro de um .bpmn. Ela ainda não está na barra lateral, mas pode ser chamada hoje:

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 dados: RegistryPullSuccess (contagens: ExtensionTypeCount, ConnectorCount, ProcessCount), RegistryListSuccess / RegistrySearchSuccess (Data.ExtensionTypes[], Data.Connectors[], Data.Processes[]), RegistryGetSuccess (Data.ExtensionType, opcional Data.ISEnrichment quando --connection-id e --object-name forem fornecidos).

Convenções

• Cada uip maestro subcomando honra as opções globais (--output, --output-filter, --log-level, --log-file).
• A saída padrão é JSON.
• Os códigos de saída seguem o contrato padrão.
• A maioria dos comandos de runtime requer uip login primeiro — consulte Autenticação.

Veja também

• uip flow — fluxo de trabalho irmãos em forma de gráfico
• Ferramentas ( plugins )
• Autenticação
• Opções globais, Códigos de saída