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.

attendre tm uip

Syntaxe et options de `uip tm wait`, qui interroge une exécution de test jusqu'à ce qu'elle atteigne un état terminal et imprime un résumé sur une ligne.

uip tm wait polls a test execution until it reaches a terminal state (Finished or Cancelled) and then prints a one-line summary. It turns the asynchronous uip tm testsets run into a blocking step in a CI pipeline.

wait is registered as a top-level verb under tm, not as a resource. Invoke it as uip tm wait, not uip tm executions wait.

Synthèse​

uip tm wait --execution-id <uuid> (--project-key <key> | --project-id <id> | --test-set-key <key>)
            [--timeout <seconds>]
uip tm wait --execution-id <uuid> (--project-key <key> | --project-id <id> | --test-set-key <key>)
            [--timeout <seconds>]

Respecte les options globales. Consultez la section Codes de sortie ci-dessous pour connaître le comportement spécifique au domaine en cas de délai d'expiration.

attendre tm uip​

Block until the given execution reaches a terminal state, polling Test Manager every 60 seconds.

Arguments​

Aucun

Options​

  • --execution-id <uuid> (requis) : exécution à attendre. Obtenez-le à partir de uip tm testsets run.

  • --project-key <key> — propriétaire de la clé du projet.

  • --project-id <id> — propriétaire de l'ID de projet. Utilisez au lieu de --project-key

    Pass --project-id, --project-key, or --test-set-key. When you pass more than one, --project-id is used first, then --project-key, then the project prefix of --test-set-key.

  • --test-set-key <key> — clé de l'ensemble de tests (par exemple, DEMO:42); la clé du projet est dérivée du préfixe.

  • --timeout <seconds> — maximum time to wait, in seconds. Defaults to 1800 (30 minutes). Pass 0 to wait indefinitely.

Remarque :

There is no --poll-interval flag on this command. The poll interval is fixed at 60 seconds.

Avertissement :

Une exécution manuelle fermée tôt avec executions finish conserve Status: "Running", donc wait ne voit jamais d'état terminal dessus. wait bloque jusqu'à --timeout , puis quitte 2. Vérifiez plutôt l'horodatage ExecutionFinished d'une exécution avec executions get-stats .

Exemple​

# wait up to 15 minutes
uip tm wait \
  --execution-id a1b2c3d4-0000-0000-0000-000000000001 \
  --project-key DEMO \
  --timeout 900
# wait up to 15 minutes
uip tm wait \
  --execution-id a1b2c3d4-0000-0000-0000-000000000001 \
  --project-key DEMO \
  --timeout 900

Format des données (état terminal atteint avant le délai d’expiration)​

{
  "Code": "WaitComplete",
  "Data": {
    "ExecutionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "Status": "Finished",
    "EndTime": "2025-04-15T10:32:11Z",
    "Duration": "00:02:11"
  }
}
{
  "Code": "WaitComplete",
  "Data": {
    "ExecutionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "Status": "Finished",
    "EndTime": "2025-04-15T10:32:11Z",
    "Duration": "00:02:11"
  }
}

Status is the terminal state Test Manager reports: Finished or Cancelled. Reaching a terminal state is the success signal for wait; the verb exits 0 whether the tests inside the execution passed or failed. To branch on pass or fail, read the report get output after wait returns.

Codes de sortie​

wait suit les codes de sortie standard pour 0, 1 et 3, avec une réutilisation spécifique au domaine de 2:

Code de sortieSignification
0L'exécution a atteint un état terminal dans le délai d'expiration.
1Échec de l’interrogation (trois erreurs d’API consécutives, interruption, abandon), de la connexion ou aucun projet n’a été donné. Consultez le champ Message pour plus de détails.
2Timed out. The timeout elapsed before the execution reached a terminal state.
3Erreur de validation (valeur d’indicateur incorrecte, option requise manquante).

Exit code 2 is domain-specific. The shared CLI contract reserves 2 for AuthenticationError, but wait reuses it for timeout so that scripts can distinguish "took too long" from "polling failed" without parsing text. uip tm run uses 4 for its own timeout instead. See Exit-code behavior on executions for the full pattern.

Modèle de script​

uip tm wait \
  --execution-id "$id" \
  --project-key DEMO \
  --timeout 1800
case $? in
  0) ;;
  2) echo "timed out" >&2; exit 2 ;;
  *) echo "wait failed" >&2; exit 1 ;;
esac
uip tm wait \
  --execution-id "$id" \
  --project-key DEMO \
  --timeout 1800
case $? in
  0) ;;
  2) echo "timed out" >&2; exit 2 ;;
  *) echo "wait failed" >&2; exit 1 ;;
esac

Voir également​

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

Connecter

Besoin d'aide ? Assistance(opens in new window)

Vous souhaitez apprendre ? UiPath Academy(opens in new window)

Vous avez des questions ? UiPath Forum(opens in new window)

Rester à jour