registro bpmn do uip Maestro

uip maestro bpmn registry navega e pesquisa o registro BPMN do Maestro — um catálogo dos tipos de extensão BPMN, conectores do Integration Service e processos descobertos pelo Orchestrator que o Maestro pode criar. Agentes (humanos ou não) o usam para descobrir quais tipos de extensão existem, pesquisar suas formas e enriquecer tipos de conectores com metadados em tempo real do Integration Service antes de gerar BPMN.

Sem o login, apenas os tipos de extensão integrados (OTB) estão disponíveis. Faça login para ver conectores e processos descobertos no Integration Service e no Orchestrator.

Resumo

uip maestro bpmn registry <verb> [options]

Fluxo de trabalho típico:

1. ( uip login — os tipos OOTB funcionam offline).
2. uip maestro bpmn registry pull sincronize o registro no cache local.
3. uip maestro bpmn registry search <keyword> encontre uma entrada.
4. uip maestro bpmn registry get <extensionType> inspecione a especificação completa.

Verbo

Texto	Finalidade
pull	Buscar e armazenar em cache o registro (BPMN estático + recursos descobertos).
list	Listar tipos de extensão em cache e recursos descobertos.
search	Encontre entradas por palavra-chave em tipos de extensão, conectores e processos.
get	Obter as especificações completas para um único tipo de extensão; opcionalmente, enriqueça com metadados IS.

Todos os verbos honram as opções globais (--output, --output-filter, --log-level, --log-file). Os códigos de saída seguem o contrato padrão.

Extração do registro bpmn do uip Maestro

Buscar e armazenar em cache o registro. Por padrão, retorna resultados em cache quando novos; passe --force para sincronizar novamente.

Opções

Short	Long	Valor	Padrão	Description
-f	--force	Bandeira	desativada	Ignore o cache e busque novamente.

Exemplos

uip maestro bpmn registry pull
uip maestro bpmn registry pull --force

Formato dos dados (--output json)

{
  "Code": "RegistryPullSuccess",
  "Data": {
    "ExtensionTypeCount": 48,
    "ConnectorCount": 12,
    "ProcessCount": 5,
    "FromCache": false,
    "AgeMinutes": 0,
    "CacheWritten": true,
    "Message": "Synced fresh registry"
  }
}

Quando o cache é usado, FromCache é true, AgeMinutes relata a idade do cache e Message é Using cached registry (age: <n>m).

lista de registros bpmn do uip Maestro

Listar tipos de extensão em cache e recursos descobertos. O limite padrão é 30; passar --limit -1 para todos.

Opções

Short	Long	Valor	Padrão	Description
-l	--limit	Número	30	Número de tipos de extensão a serem retornados; -1 todos.

Exemplos

uip maestro bpmn registry list
uip maestro bpmn registry list --limit 100
uip maestro bpmn registry list --limit -1

Formato dos dados (--output json)

{
  "Code": "RegistryListSuccess",
  "Data": {
    "ExtensionTypes": [
      {
        "ExtensionType": "Orchestrator.StartJob",
        "Label": "Start Job",
        "BpmnElement": "bpmn:ServiceTask",
        "ExtensionTag": "uipath:startJob",
        "InputPattern": "...",
        "BindingPattern": "...",
        "RequiresDiscovery": "No"
      }
    ],
    "Connectors": [
      {
        "Key": "slack",
        "Name": "Slack",
        "Connections": 2,
        "Activities": 14,
        "Triggers": 3
      }
    ],
    "Processes": [
      {
        "Name": "InvoiceProcessing",
        "ProcessKey": "c3d4e5f6-0000-0000-0000-000000000001",
        "Type": "Maestro",
        "Folder": "Shared"
      }
    ]
  }
}

Se o resultado for truncado, uma nota Showing first <n> of <total> extension types será gravada nos logs.

pesquisa de registro do uip Maestro bpmn

Pesquise o registro por palavra-chave em IDs de tipo de extensão, rótulos, nomes de conectores e nomes de processos. A correspondência da palavra-chave é insensível a maiúsculas e minúsculas.

Argumentos

Name	Required	Finalidade
<keyword>	sim	Termo de pesquisa.

Exemplos

uip maestro bpmn registry search connector
uip maestro bpmn registry search queue
uip maestro bpmn registry search slack
uip maestro bpmn registry search agent

Formato dos dados (--output json)

{
  "Code": "RegistrySearchSuccess",
  "Data": {
    "ExtensionTypes": [
      {
        "ExtensionType": "Intsvc.ActivityExecution",
        "Label": "Execute Activity",
        "BpmnElement": "bpmn:ServiceTask",
        "ExtensionTag": "uipath:activityExecution",
        "InputPattern": "...",
        "BindingPattern": "...",
        "RequiresDiscovery": "Yes"
      }
    ],
    "Connectors": [
      { "Key": "slack", "Name": "Slack", "Connections": 2, "Activities": 14, "Triggers": 3 }
    ],
    "Processes": [
      { "Name": "SlackNotifier", "ProcessKey": "c3d4e5f6-0000-0000-0000-000000000002", "Type": "Maestro" }
    ]
  }
}

Registro bpmn do uip Maestro Get

Obtenha as especificações completas para um único tipo de extensão. Para tipos de conector (Intsvc.ActivityExecution, Intsvc.WaitForEvent, …), passe --connection-id e --object-name para enriquecer a resposta com metadados de campo ao vivo do Integration Service.

Argumentos

Name	Required	Finalidade
<extensionType>	sim	Identificador do tipo de extensão (por exemplo, Orchestrator.StartJob).

Opções

Short	Long	Valor	Padrão	Description
—	--connection-id	ID	—	ID de conexão para o enriquecimento do Integration Service. Requer --object-name.
—	--object-name	name	—	Nome do objeto para o enriquecimento do Integration Service. Requer --connection-id.

Exemplos

uip maestro bpmn registry get Orchestrator.StartJob

# Connector extension type enriched with live IS metadata
uip maestro bpmn registry get Intsvc.ActivityExecution \
    --connection-id abc123 --object-name contacts

# Just the field names
uip maestro bpmn registry get Orchestrator.StartJob \
    --output-filter 'Data.ExtensionType'

Formato dos dados (--output json)

Resposta base:

{
  "Code": "RegistryGetSuccess",
  "Data": {
    "ExtensionType": {
      "extensionType": "Orchestrator.StartJob",
      "label": "Start Job",
      "bpmnElement": "bpmn:ServiceTask",
      "extensionTag": "uipath:startJob"
    }
  }
}

Quando --connection-id e --object-name são fornecidos e a chamada do Integration Service é bem-sucedida, a resposta também inclui um campo ISEnrichment contendo a carga de metadados ao vivo. Se a chamada de enriquecimento falhar, um aviso será registrado e ISEnrichment será omitido — a especificação base ainda será retornada.

Comandos relacionados

• uip maestro pack — empacotar um projeto do Maestro; o registro informa quais tipos de extensão você pode usar.
• uip maestro process — descubra processos voltados para o Orchestrator que o registro catálogos.
• uip login — faça login antes de pull para ver conectores e processos.

Veja também

• Opções globais — --output, --output-filter, --log-level, --log-file.
• Códigos de saída — contrato de código de saída padrão.