trabajo de flujo maestro de uip

Sintaxis y opciones para `trabajo de flujo maestro de uip`, que transmite seguimientos de ejecución y obtiene el estado detallado para trabajos de flujo individuales.

uip maestro flow job un trabajo de flujo individual (un intento de ejecución de una instancia de proceso) transmitiendo sus seguimientos u obteniendo su estado detallado.

Todos los subcomandos requieren uip login y respetan las opciones globales. Los códigos de salida siguen el contrato estándar.

Sinopsis

uip maestro flow job list  [--folder-key <key>] [--state <state>] [--process-name <name>]
                    [-l, --limit <n>] [--offset <n>] [--sort-by <field>] [--all-fields]
                    [--login-validity <minutes>]

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

uip maestro flow job status <job-key>
                    [--folder-key <key>] [--detailed]
                    [--login-validity <minutes>]

lista de trabajos de flujo maestro de uip

Enumerar trabajos de flujo en una carpeta.

Opciones

Opción	Predeterminado	Descripción
--folder-key <key>	carpeta autenticada	Clave de carpeta (GUID).
--state <state>	—	Filtrar por estado del trabajo: Pending, Running, Successful, Faulted, Stopped, Stopping, Suspended, Resumed, Terminating.
--process-name <name>	—	Filtrar por nombre de proceso de flujo (contiene coincidencias).
-l, --limit <n>	50	Número de elementos que se van a devolver.
--offset <n>	0	Número de elementos que omitir.
--sort-by <field>	predeterminado del servidor	Ordenar resultados por campo, por ejemplo 'Id desc'.
--all-fields	Desactivado	Devuelve todos los campos de la respuesta de la API en lugar de un resumen seleccionado.
--login-validity <minutes>	10	Umbral de actualización del token.

Ejemplo

uip maestro flow job list --folder-key c3d4e5f6-… --limit 2

Forma de datos (resumen predeterminado)

{
  "Code": "FlowJobList",
  "Data": [
    {
      "key": "b2c3d4e5-…",
      "state": "Successful",
      "processName": "InvoiceFlow",
      "source": "Manual",
      "startTime": "2025-04-15T10:30:00Z",
      "endTime": "2025-04-15T10:32:11Z"
    }
  ]
}

Con --all-fields, cada elemento lleva el objeto de trabajo completo de Orchestrator en lugar de este resumen seleccionado.

seguimientos de trabajo de flujo maestro de uip

Transmite eventos de seguimiento de ejecución para un trabajo en ejecución o completado recientemente. Las líneas se transmiten a stderr a medida que llegan; el estado final y la duración también se transmiten.

Argumentos

• <job-key> (obligatorio) : clave de trabajo (GUID de process run).

Opciones

Opción	Predeterminado	Descripción
--poll-interval <ms>	2000	Intervalo de sondeo. Debe ser un número positivo.
--traces-service <name>	llmopstenant_	Nombre del servicio de seguimiento (avanzado; anular solo cuando se le indique).
--pretty	Desactivado	Eventos de seguimiento de impresión bonita. Sin él, cada evento se emite como una sola línea JSON, fácil de canalizar a jq.
--login-validity <minutes>	10	Umbral de actualización del token.

Comportamiento

• Escribe una línea de encabezado en stderr: Streaming traces for job: <key> Polling every Ns...
• Transmite cada evento de seguimiento a través de ScreenLogger.progress (stderr).
• Al finalizar, emite Job <key>: <finalState> (<durationMs>ms).
• Código de salida: 0 si el trabajo se realizó correctamente, 1 de lo contrario (según result.success).

Ejemplos

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

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

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

Salida: los seguimientos se transmiten directamente, sin carga útil final Data .

estado del trabajo de flujo maestro de uip

Obtener el estado de un trabajo de flujo. Devuelve un resumen seleccionado de 14 campos de forma predeterminada; --detailed devuelve la respuesta completa de Orchestrator.

Argumentos

• <job-key> obligatorio) : clave de trabajo (GUID).

Opciones

Opción	Predeterminado	Descripción
--folder-key <key>	carpeta autenticada	Clave de carpeta (GUID).
--detailed	Desactivado	Devuelve la respuesta completa en lugar del resumen de 14 campos.
--login-validity <minutes>	10	Umbral de actualización del token.

Forma de datos (resumen predeterminado)

{
  "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": "…"
  }
}

Con --detailed, Data es el objeto de trabajo de Orchestrator completo (todos los campos, sin aplanar).

Nota:

La forma de respuesta detallada completa es lo que devuelve Orchestrator y no está estrictamente tipada por la CLI. La presencia de campo puede variar entre versiones de Orchestrator: para scripts que analizan campos específicos, consulta de forma defensiva y fija @uipath/cli en CI.

Ejemplos

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

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

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

Ver también

• uip maestro flow process run — iniciar un trabajo
• uip maestro flow instance : la vista de instancia de la misma ejecución
• Trabajos de Orchestrator
• Descripción general del flujo