UiPath Documentation
uipath-cli
latest
false
Guide de l'utilisateur de UiPath CLI
Important :
Ce contenu a été traduit à l'aide d'une traduction automatique. La localisation du contenu nouvellement publié peut prendre 1 à 2 semaines avant d’être disponible.

tâche bpmn uip maestro

Syntaxe et options de la tâche « uip maestro bpmn », qui affiche les traçages d'exécution et extrait le statut détaillé des tâches Maestro BPMN individuelles.

uip maestro bpmn job inspecte une tâche Maestro individuelle - une tentative d'exécution d'une instance de processus) en affichant ses traces ou en récupérant son statut détaillé. Elle est enregistrée sous la branche bpmn.

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 bpmn job traces <job-key>
                       [-f, --folder-key <key>] [--poll-interval <ms>]
                       [--traces-service <name>] [--pretty]
                       [--login-validity <minutes>]

uip maestro bpmn job status <job-key>
                       --folder-key <key> [--detailed]
                       [--login-validity <minutes>]
uip maestro bpmn job traces <job-key>
                       [-f, --folder-key <key>] [--poll-interval <ms>]
                       [--traces-service <name>] [--pretty]
                       [--login-validity <minutes>]

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

Traçages de tâche BPMN 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.

Arguments​

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

Options​

OptionDefaultDescription
-f, --folder-key <key>—Clé de dossier. Facultatif: utilisé uniquement pour définir l'étendue de la demande de traçage.
--poll-interval <ms>2000Intervalle d'interrogation. Doit être un nombre positif.
--traces-service <name>llmopstenant_Nom du service de traçages.
--prettydésactivéÉvénements de traçage. Sans cela, chaque événement est émis sous la forme d'une seule ligne JSON.
--login-validity <minutes>10Seuil d’actualisation du jeton.

Comportement​

  • Écrit une ligne d'en-tête: 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> completed with state <finalState> (<durationMs>ms).
  • Code de sortie: 0 si result.success, 1 dans le cas contraire.

Exemples​

# Raw JSON lines
uip maestro bpmn job traces b2c3d4e5-… | jq -c 'select(.level=="error")'

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

# Slower polling
uip maestro bpmn job traces b2c3d4e5-… --poll-interval 5000

# Scope the trace request to a folder
uip maestro bpmn job traces b2c3d4e5-… --folder-key <folder-key>
# Raw JSON lines
uip maestro bpmn job traces b2c3d4e5-… | jq -c 'select(.level=="error")'

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

# Slower polling
uip maestro bpmn job traces b2c3d4e5-… --poll-interval 5000

# Scope the trace request to a folder
uip maestro bpmn job traces b2c3d4e5-… --folder-key <folder-key>

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

Statut de la tâche BPMN uip Maestro​

Obtenir le statut d’une tâche Maestro. 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​

OptionRequisDefaultDescription
--folder-key <key>oui—Clé de process list dossier. Aucune valeur par défaut — chaque appel doit la transmettre explicitement.
--detailednondésactivéRenvoyez la réponse complète au lieu du résumé dans les 14 champs.
--login-validity <minutes>non10Seuil d’actualisation du jeton.

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

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

Avec --detailed, Data est l'objet de tâche Orchestrator complet.

Exemples​

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

# Summary once done
uip maestro bpmn job status "$JOB_KEY" --folder-key "<folder-key>"

# Full response
uip maestro bpmn job status "$JOB_KEY" --folder-key "<folder-key>" --detailed
# Start a job, capture the key, stream traces to completion
JOB_KEY=$(uip maestro bpmn process run "InvoiceOrchestration:1.0.0" "<folder-key>" \
           --release-key <release-key> --inputs '{}' --output-filter "jobKey" --output plain)
uip maestro bpmn job traces "$JOB_KEY" --pretty

# Summary once done
uip maestro bpmn job status "$JOB_KEY" --folder-key "<folder-key>"

# Full response
uip maestro bpmn job status "$JOB_KEY" --folder-key "<folder-key>" --detailed

Voir également​

Cette page vous a-t-elle été utile ?

Connecter

Besoin d'aide ? Assistance

Vous souhaitez apprendre ? UiPath Academy

Vous avez des questions ? UiPath Forum

Rester à jour