processo uip Maestro Bpmn e processos uip Maestro Bpmn

Sintaxe e opções para "uip Maestro bpmn process" e "uip Maestro bpmn processes", cobrindo operações de processo BPMN do Maestro publicadas por pasta e em todo o tenant.

Depois que um pacote BPMN do Maestro é publicado no Orchestrator, ele se torna um processo do tipo ProcessOrchestration. Ambos os grupos de comando abaixo estão registrados na ramificação bpmn. Esta página abrange dois grupos de comando relacionados:

• uip maestro bpmn process operações por pasta em uma única definição de processo (listar em uma pasta, obter seu esquema, executá-lo, empacotar+publicá-lo).
• uip maestro bpmn processes plral) — resumos em todo o tenant, pesquisa de incidentes por processo e diagnóstico.

Resumo

# Singular — per-folder, operational
uip maestro bpmn process list    -f <folder-key> [--filter <odata>] [--login-validity <minutes>]
uip maestro bpmn process get     <process-key> <feed-id> -f <folder-key> [--login-validity <minutes>]
uip maestro bpmn process run     <process-key> <folder-key> --release-key <key>
                                  [-i, --inputs <json>] [--feed-id <id>] [--robot-ids <ids>]
                                  [--login-validity <minutes>]
uip maestro bpmn process publish <project-path> [output-path] -f <folder-key>
                                  [-n, --name <name>] [--process-name <name>] [-v, --version <version>]
                                  [-i, --inputs <json>] [--feed-id <id>] [--entry-point <path>]
                                  [--wait [--timeout <seconds>] [--poll-interval <seconds>]] [--login-validity <minutes>]

# Plural — tenant-wide summary, incidents, and diagnostics
uip maestro bpmn processes list       [--folder-key <key>] [-l <limit>] [--offset <n>] [--status <status>]
uip maestro bpmn processes incidents  <process-key> --folder-key <key>
uip maestro bpmn processes diagnose   <process-key> --folder-key <key>
uip maestro bpmn processes error-codes <process-key> --folder-key <key>

Todos os subcomandos exigem uip login e honram as opções globais. Os códigos de saída seguem o contrato padrão.

---

lista de processos bpmn do uip Maestro

Liste os processos (versões) do Maestro disponíveis em uma pasta específica.

Opções

Opção	Required	Description
-f, --folder-key <key>	sim	Chave da pasta (GUID).
--filter <odata>	não	Filtro OData adicional aplicado no lado do servidor.
--login-validity <minutes>	não	Limite de atualização do token (padrão 10).

Formato dos dados (--output json)

{
  "Code": "MaestroProcessList",
  "Data": [
    {
      "name":           "InvoiceOrchestration",
      "processKey":     "a1b2c3d4-0000-0000-0000-000000000001",
      "processVersion": "1.0.0",
      "packageId":      "a1b2c3d4-0000-0000-0000-000000000001",
      "packageVersion": "1.0.0",
      "releaseKey":     "e5f6a7b8-0000-0000-0000-000000000001",
      "folderKey":      "c3d4e5f6-0000-0000-0000-000000000001",
      "feedId":         "default",
      "folderId":       42,
      "active":         "Yes",
      "latest":         "Yes"
    }
  ]
}

---

processo bpmn do uip Maestro obtido

Buscar o esquema de entry-point (esquemas JSON de entrada/saída) para um processo do Maestro.

Argumentos

• <process-key> necessário) — chave de processo.
• <feed-id> (necessário) — ID do feed (de list).

Opções

• -f, --folder-key <key> (necessário)
• (padrão --login-validity <minutes> 10

Formato dos dados

{
  "Code": "MaestroProcessGet",
  "Data": [
    {
      "Path":         "/content/main.bpmn#Event_start",
      "DisplayName":  "Manual trigger",
      "Type":         "processorchestration",
      "InputSchema":  "{\"type\":\"object\",\"properties\":{}}",
      "OutputSchema": "{\"type\":\"object\",\"properties\":{}}"
    }
  ]
}

InputSchema e OutputSchema são strings de Esquema JSON redefinidas.

---

execução de processo bpmn do uip Maestro

Inicie um trabalho do Maestro para um processo publicado.

Argumentos

• <process-key> (necessário) — chave de processo do pacote versionado de process list, por exemplo, MyProcess:1.0.0.
• <folder-key> necessário) — chave de pasta (GUID).

Opções

Opção	Required	Description
--release-key <key>	sim	Chave de lançamento (GUID) — de process list.
-i, --inputs <json>	não	Entradas como uma string JSON ou @path/to/file.json. Se omitido e stdin estiver tabulado, stdin será analisado.
--feed-id <id>	não	ID do feed para pesquisa de pacote (opcional).
--robot-ids <ids>	não	IDs de robô separados por vírgulas (opcional).
--login-validity <minutes>	não	Limite de atualização do token (padrão 10).

Não há opção --validate neste comando — as entradas são enviadas como estão; o próprio processo é responsável por rejeitar entradas ruins.

Precedência de entrada: --inputs <json> / --inputs @file.json > stdin > empty object {}.

Exemplos

# Inline JSON
uip maestro bpmn process run "InvoiceOrchestration:1.0.0" "<folder-key>" \
  --release-key <release-key> --inputs '{"amount":100}'

# From a file
uip maestro bpmn process run "InvoiceOrchestration:1.0.0" "<folder-key>" \
  --release-key <release-key> --inputs @inputs.json

# Piped stdin
echo '{"amount":100}' | uip maestro bpmn process run "InvoiceOrchestration:1.0.0" "<folder-key>" --release-key <release-key>

Formato dos dados

{
  "Code": "MaestroJobStarted",
  "Data": {
    "jobKey":  "b2c3d4e5-0000-0000-0000-000000000001",
    "state":   "Pending",
    "traceId": "d4e5f6a7-0000-0000-0000-000000000001"
  }
}

Próxima etapa: para transmitir uip maestro bpmn job status <jobKey> uip maestro bpmn job traces <jobKey> pesquisar.

---

publicação de processos bpmn do uip Maestro

Empacote um diretório de projeto BPMN do Maestro em um .nupkg e publique-o como uma versão de processo do Orchestrator, em uma etapa.

Argumentos

• <project-path> (necessário) — caminho para o diretório do projeto BPMN do Maestro.
• [output-path] (opcional) — diretório de saída para o .nupkg gerado. O padrão é um diretório temporário.

Opções

Opção	Description
-f, --folder-key <key>	Obrigatório. Chave da pasta (GUID).
-n, --name <name>	Nome do pacote. Padrão: o nome da pasta do projeto.
--process-name <name>	Nome da versão do processo. Padrão: o nome do pacote.
-v, --version <version>	Versão do pacote. 1.0.0Padrão.
-i, --inputs <json>	Parâmetros de entrada padrão como uma string JSON, @file.json, ou - para stdin.
--feed-id <id>	ID do feed para carregar o pacote (opcional).
--entry-point <path>	Caminho do ponto de entrada para o processo.
--wait	Aguarde até que os pontos de entrada do pacote publicados estejam disponíveis, em vez de retornar imediatamente após o upload.
--timeout <seconds>	Máximo de segundos para esperar pela propagação da publicação quando --wait está definido. Padrão 300.
--poll-interval <seconds>	Segundos entre as verificações de propagação de publicação quando --wait está definido. Padrão 5.
--login-validity <minutes>	Limite de atualização do token. 10Padrão.

Exemplo

uip maestro bpmn process publish ./invoice-process \
  --folder-key <folder-key> --version 1.2.0 --wait

Formato dos dados

{
  "Code": "MaestroProcessPublished",
  "Data": {
    "Package": "invoice-process@1.2.0",
    "PackagePath": "/tmp/maestro-process-publish-.../invoice-process.processOrchestration.ProcessOrchestration.1.2.0.nupkg",
    "ProcessKey": "invoice-process.processOrchestration.ProcessOrchestration",
    "ProcessVersion": "1.2.0",
    "ReleaseKey": "e5f6a7b8-0000-0000-0000-000000000001",
    "ReleaseName": "invoice-process",
    "Action": "Created",
    "Upload": [
      { "key": "invoice-process.processOrchestration.ProcessOrchestration", "status": "Created" }
    ],
    "EntryPoints": 1
  }
}

Action é "Created" na primeira publicação de uma determinada chave de processo, "Updated" nas publicações subsequentes.

---

lista de processos bpmn do uip Maestro

Resumo de todo o tenant (ou com escopo de pasta) dos processos do Maestro. Ao contrário do singular process list, nenhum filtro processType é aplicado no lado do servidor — o comando plural é compartilhado entre as ferramentas (Maestro, Flow, Case) e não se restringe a ProcessOrchestration por si só.

Opções

Opção	Description
--folder-key <key>	Opcional. Faça o escopo do resumo de uma pasta.
-l, --limit <number>	Número de itens a serem retornados (1 a 10000).
--offset <number>	Número de itens a ignorar (0-1000000). 0Padrão.
--status <status>	Filtrar por status do processo.

Formato dos dados

{
  "Code": "ProcessList",
  "Data": [ /* array of Maestro process summaries */ ]
}

Observação:

O conjunto de campos exato de cada resumo de processo é especificado pelo runtime do Maestro e pode evoluir; execute o comando uma vez com --output json em um tenant com dados para ver os campos que você consumirá e fixe @uipath/cli no CI se você analisar campos específicos.

---

incidentes de processos do uip Maestro bpmn

Obtenha todos os incidentes para uma definição de processo específica do Maestro.

Argumentos

• <process-key> necessário) — chave de definição de processo.

Opções

• --folder-key <key> (necessário)

Formato dos dados

{
  "Code": "ProcessIncidents",
  "Data": [ /* array of process incidents */ ]
}

---

diagnóstico de processos bpmn do uip Maestro

Correlacione o resumo, incidentes e códigos de erro de um processo em uma única chamada — um wrapper de conveniência sobre processes list, processes incidents e processes error-codes.

Argumentos

• <process-key> necessário) — chave de definição de processo.

Opções

• --folder-key <key> (necessário)

Formato dos dados

{
  "Code": "ProcessDiagnostics",
  "Data": {
    "ProcessKey": "InvoiceOrchestration",
    "FolderKey": "c3d4e5f6-0000-0000-0000-000000000001",
    "Summary": { /* the matching process summary object, or null if not found */ },
    "FaultedCount": 2,
    "RunningCount": 5,
    "Incidents": [ /* array of incident objects */ ],
    "IncidentCount": 1,
    "ErrorCodes": [ /* array of error code strings */ ],
    "ErrorCodeCount": 1
  }
}

---

códigos de erro de processos do uip Maestro bpmn

Obtenha os códigos de erro exclusivos gerados por incidentes para um processo específico.

Argumentos

• <process-key> necessário) — chave de definição de processo.

Opções

• --folder-key <key> (necessário)

Formato dos dados

{
  "Code": "ProcessIncidentErrorCodes",
  "Data": [ /* array of error code strings */ ]
}

Veja também

• uip maestro bpmn instances — inspeciona e orienta execuções em execução
• uip maestro bpmn job — rastreamentos e status para um único trabalho
• uip maestro bpmn incidents — resumos e detalhes de incidentes
• Trabalhos do Orchestrator, Processos do Orchestrator
• Visão geral do Maestro