Trabalho de fluxo de uip

uip flow job inspeciona um trabalho de fluxo individual — uma tentativa de execução de uma instância de processo — transmitindo seus rastreamentos ou buscando seu status detalhado.

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

Resumo

uip flow job traces <job-key>
                    [-t, --tenant <name>] [--poll-interval <ms>]
                    [--traces-service <name>] [--pretty]
                    [--login-validity <minutes>]

uip flow job status <job-key>
                    [-t, --tenant <name>] [--folder-key <key>] [--detailed]
                    [--login-validity <minutes>]

rastreamentos de trabalho do fluxo uipath

Eventos de trace de execução de transmissão para um trabalho em execução ou concluído recentemente. As linhas são transmitidas para stderr conforme elas chegam; o estado final e a duração também são transmitidos.

Argumentos

• <job-key> (necessário) — chave do trabalho (GUID de process run).

Opções

Opção	Padrão	Description
-t, --tenant <name>	Tenant autenticado	Nome do tenant.
--poll-interval <ms>	2000	Intervalo de pesquisa. Deve ser um número positivo.
--traces-service <name>	llmopstenant_	Nome do serviço de traces (avançado; substituído apenas quando orientado).
--pretty	desativada	Eventos de trace de impressão virtual. Sem ele, cada evento é emitido como uma única linha JSON — adequada para canalizar em jq.
--login-validity <minutes>	10	Limite de atualização do token.

Comportamento

• Grava uma linha de cabeçalho no stderr: Streaming traces for job: <key> Polling every Ns...
• Transmite cada evento de trace por meio de ScreenLogger.progress (stderr).
• Na conclusão, emite Job <key>: <finalState> (<durationMs>ms).
• Código de saída: 0 se o trabalho foi bem-sucedido, 1 caso contrário (por result.success).

Exemplos

# Raw JSON lines — best for piping
uip flow job traces b2c3d4e5-… | jq -c 'select(.level=="error")'

# Human-readable
uip flow job traces b2c3d4e5-… --pretty

# Slower polling for quiet jobs
uip flow job traces b2c3d4e5-… --poll-interval 5000

Saída: os traces são transmitidos diretamente — sem carga Data .

status do trabalho do fluxo de uip

Obtenha o status de um trabalho de fluxo. Retorna um resumo de 14 campos selecionado por padrão; --detailed retorna a resposta completa do Orchestrator.

Argumentos

• <job-key> necessário) — chave do trabalho (GUID).

Opções

Opção	Padrão	Description
-t, --tenant <name>	Tenant autenticado	Nome do tenant.
--folder-key <key>	pasta autenticada	Chave da pasta (GUID).
--detailed	desativada	Retornar a resposta completa em vez do resumo de 14 campos.
--login-validity <minutes>	10	Limite de atualização do token.

Data shape (default summary)

{
  "Code": "FlowJobStatus",
  "Data": {
    "key":             "b2c3d4e5-…",
    "state":           "Successful",
    "runtimeType":     "…",
    "processType":     "Flow",
    "startTime":       "2025-04-15T10:30:00Z",
    "endTime":         "2025-04-15T10:32:11Z",
    "creationTime":    "2025-04-15T10:29:58Z",
    "inputArguments":  "{}",
    "outputArguments": "{}",
    "info":            "",
    "releaseName":     "InvoiceFlow",
    "processKey":      "a1b2c3d4-…",
    "robotName":       "…",
    "hostMachineName": "…"
  }
}

Com --detailed, Data é o objeto de trabalho completo do Orchestrator (todos os campos, não mesclados).

Observação:

A forma de resposta detalhada completa é a que o Orchestrator retorna e não é estritamente digitada pela CLI. A presença do campo pode derivar entre versões do Orchestrator — para scripts que analisam campos específicos, consulte defensivamente e fixe @uipath/cli no CI.

Exemplos

# Start a job, capture the key, stream traces to completion
JOB_KEY=$(uip flow process run "InvoiceFlow.flow.Flow:1.0.0" "<folder-key>" \
           --inputs '{}' --output-filter "jobKey" --output plain)
uip flow job traces "$JOB_KEY" --pretty

# Get the summary once the job is done
uip flow job status "$JOB_KEY" --folder-key "<folder-key>"

# Full response
uip flow job status "$JOB_KEY" --detailed

Veja também

• uip flow process run — iniciar um trabalho
• uip flow instance — a visualização de instância da mesma execução
• Trabalhos do Orchestrator
• Visão geral do fluxo