tâche de flux uip maestro

Syntaxe et options de `uip maestro flow job`, qui diffuse les traces d'exécution et extrait le statut détaillé pour les tâches de flux individuelles.

uip maestro flow job inspecte une tâche de flux individuelle - une tentative d'exécution d'une instance de processus) en streaming ses traces ou en récupérant son statut détaillé.

Toutes les sous-commandes nécessitent uip login et respectent les options globales. Les codes de sortie suivent le contrat standard.

Synthèse

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>]

Liste des tâches de flux uip Maestro

Répertoriez les tâches Flow dans un dossier.

Options

Option	Default	Description
--folder-key <key>	dossier authentifié	Clé de dossier.
--state <state>	—	Filtrer par état de la tâche: Pending, Running, Successful, Faulted, Stopped, Stopping, Suspended, Resumed, Terminating.
--process-name <name>	—	Filtrer par nom de processus de flux (contient la correspondance).
-l, --limit <n>	50	Nombre d'éléments à renvoyer.
--offset <n>	0	Nombre d'éléments à ignorer.
--sort-by <field>	Valeur par défaut du serveur	Trier les résultats par champ, par exemple 'Id desc'.
--all-fields	désactivé	Renvoyez tous les champs de la réponse de l’API au lieu d’un résumé sélectionné.
--login-validity <minutes>	10	Seuil d’actualisation du jeton.

Exemple

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

Format des données (résumé par défaut)

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

Avec --all-fields, chaque élément porte l'objet de tâche Orchestrator complet au lieu de ce résumé organisé.

Traçages de tâche de flux uip maestro

Flux les événements de Trace de l’exécution pour une tâche en cours d’exécution ou récemment terminée. Les lignes sont transmises à stderr au fur et à mesure qu'elles arrivent; l'état final et la durée sont également diffusés.

Arguments

• <job-key> (obligatoire) : clé de tâche (GUID de process run).

Options

Option	Default	Description
--poll-interval <ms>	2000	Intervalle d'interrogation. Doit être un nombre positif.
--traces-service <name>	llmopstenant_	Nom du service de traçage (Avancé; remplacement uniquement lorsqu'il est indiqué).
--pretty	désactivé	Événements de traçage. Sans cela, chaque événement est émis sous forme de une seule ligne JSON — convivial pour les pipelines dans jq.
--login-validity <minutes>	10	Seuil d’actualisation du jeton.

Comportement

• Écrit une ligne d'en-tête dans stderr: Streaming traces for job: <key> Polling every Ns...
• Flux chaque événement de traçage via ScreenLogger.progress .
• À la fin, génère Job <key>: <finalState> (<durationMs>ms).
• Code de sortie: 0 si la tâche a réussi, 1 dans le cas contraire (par result.success).

Exemples

# 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

Sortie: les traçages sont diffusés directement — aucune charge utile Data finale.

Statut de la tâche du flux uip maestro

Obtenez le statut d'une tâche de flux. Renvoie un résumé sélectionné de 14 champs par défaut; --detailed renvoie la réponse complète d'Orchestrator.

Arguments

• <job-key> (obligatoire) — clé de tâche.

Options

Option	Default	Description
--folder-key <key>	dossier authentifié	Clé de dossier.
--detailed	désactivé	Renvoyez la réponse complète au lieu du résumé dans les 14 champs.
--login-validity <minutes>	10	Seuil d’actualisation du jeton.

Format des données (résumé par défaut)

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

Avec --detailed, Data est l'objet de tâche Orchestrator complet (tous les champs, non aplatis).

Remarque :

La forme de la réponse détaillée complète est ce que renvoie Orchestrator et n'est pas strictement saisie par la CLI. La présence des champs peut varier d'une version d'Orchestrator à l'autre — pour les scripts qui analysent des champs spécifiques, interrogez de manière défensive et épinglez @uipath/cli dans CI.

Exemples

# 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

Voir également

• uip maestro flow process run — démarrer une tâche
• uip maestro flow instance — la vue d'instance de la même exécution
• Tâches Orchestrator
• Vue d’ensemble du flux