exécutions uip tm

uip tm executions inspecte et manipule les exécutions de test — les objets produits par uip tm testsets run. Ces verbes répertorient les exécutions d'un ensemble de tests, énumérent les journaux de cas de test d'une exécution terminée, réexécutent une exécution existante par ID et réessaient uniquement les cas ayant échoué en place.

La commande qui permet de lancer une exécution est uip tm testsets run, qui renvoie une ExecutionId. Chaque verbe de cette page prend cet ID (ou le dérive du contexte).

Synthèse

uip tm executions list --project-key <key> [--test-set-id <uuid>] [--filter <text>] [--limit <n>] [--offset <n>]
uip tm executions list-filtered --project-key <key> [--status <status>] [--execution-type <type>] [--execution-finished-interval <interval>] [--updated-by <userId>] [--search <text>] [--labels <labels...>] [--test-execution-ids <ids...>] [--sort-by <expr>] [--limit <n>] [--offset <n>]
uip tm executions testcaselogs list --execution-id <uuid> --project-key <key> [--only-failed] [--filter <text>] [--limit <n>] [--offset <n>]
uip tm executions run --project-key <key> --execution-id <uuid> --execution-type <type> [--test-case-log-ids <ids...>] [--async]
uip tm executions retry --execution-id <uuid> (--project-key <key> | --test-set-key <key>) [--execution-type <type>]
uip tm executions get-stats --execution-id <uuid> --project-key <key>

Tous les verbes respectent les options globales et les codes de sortie standard. Chaque verbe accepte -t, --tenant <name> et --log-level <level> (par défaut Information).

liste des exécutions uip tm

Répertoriez les exécutions associées à un ensemble de tests. --test-set-id est facultatif — omettez-le de répertorier les exécutions dans tous les ensembles de test dans le projet.

Arguments

Aucun

Options

• --project-key <key> (obligatoire) : propriétaire du projet.
• --test-set-id <uuid> — UUID de l'ensemble de tests (le Id champ de testsets list, non TestSetKey).
• --filter <text> — recherchez des exécutions par nom.
• --limit <n> — taille de la page. La valeur par défaut est 50.
• --offset <n> — résultats à ignorer. La valeur par défaut est 0.

Exemple

uip tm executions list \
  --project-key DEMO \
  --test-set-id a1b2c3d4-0000-0000-0000-000000000001 \
  --limit 2

Format des données

{
  "Code": "ExecutionsList",
  "Data": [
    {
      "Id": "b2c3d4e5-0000-0000-0000-000000000001",
      "Name": "Nightly Run 2025-04-15",
      "Status": "Passed"
    },
    {
      "Id": "b2c3d4e5-0000-0000-0000-000000000002",
      "Name": "Nightly Run 2025-04-14",
      "Status": "Failed"
    }
  ]
}

Exécutions UIP tm filtrées par liste

Répertoriez les exécutions à l’aide de filtres avancés côté serveur. Remarque: --status et --execution-type sont des indicateurs singatifs à valeur unique. Le filtrage des plages de dates est effectué via --execution-finished-interval, et non des indicateurs de date.

Arguments

Aucun

Options

• --project-key <key> (obligatoire) : propriétaire du projet.
• --status <status> — filtrer par un statut d'exécution unique. Les valeurs acceptées proviennent de l’enum du SDK TestExecutionStatus . Exécutez --help pour voir l'ensemble actuel.
• --execution-type <type> — filtrer par un seul type d'exécution (automated, manual, mixed, none).
• --execution-finished-interval <interval> — filtrer par date de fin d'exécution récente. Les valeurs acceptées proviennent de l’enum du SDK TestExecutionFinishedInterval .
• --updated-by <userId> — filtrer par l'ID utilisateur qui a mis à jour l'exécution pour la dernière fois.
• --search <text> — recherche en texte libre sur les noms et les métadonnées des exécutions.
• --labels <labels...> — noms de libellés séparés par des espaces par lesquels filtrer.
• --test-execution-ids <ids...> — UUID d'exécution séparés par des espaces à inclure.
• --sort-by <expr> — expression de tri (nom de champ, éventuellement suffixé par :asc ou :desc).
• --limit <n> — taille de la page. La valeur par défaut est 50.
• --offset <n> — résultats à ignorer. La valeur par défaut est 0.

Exemple

uip tm executions list-filtered \
  --project-key DEMO \
  --status Failed \
  --execution-type automated \
  --limit 10

Format des données

{
  "Code": "ExecutionsFilteredList",
  "Data": [
    {
      "Id": "b2c3d4e5-0000-0000-0000-000000000002",
      "Name": "Nightly Run 2025-04-14",
      "Status": "Failed",
      "ExecutionType": "automated"
    }
  ]
}

Liste des journaux de cas de test d'exécutions uip tm

Répertorie les journaux de cas de test produits par une seule exécution. Chaque journal est l'exécution d'un cas de test, qui porte le résultat, le statut et la synchronisation.

Arguments

Aucun

Options

• --execution-id <uuid> (requis) : exécution à inspecter.
• --project-key <key> (obligatoire) : propriétaire du projet.
• --only-failed — afficher uniquement les journaux ayant échoué.
• --filter <text> — recherchez les journaux par nom.
• --limit <n> — taille de la page. La valeur par défaut est 50.
• --offset <n> — résultats à ignorer. La valeur par défaut est 0.

Exemple

uip tm executions testcaselogs list \
  --execution-id a1b2c3d4-0000-0000-0000-000000000001 \
  --project-key DEMO \
  --only-failed

Format des données

{
  "Code": "ExecutionTestCaseLogs",
  "Data": [
    {
      "Id": "c3d4e5f6-0000-0000-0000-000000000001",
      "TestCaseName": "Login flow",
      "Status": "Finished",
      "Result": "Failed"
    }
  ]
}

Chaque Id est un UUID du journal de cas de test. Transmettez-le à uip tm testcaselog list-assertions pour voir pourquoi un journal de cas de test a été marqué Failed.

Exécutions UiPtm

Réexécutez une exécution existante par son ID. Ce n'est pas la même chose que pour démarrer une nouvelle exécution: elle est rejouée dans le même enregistrement d'exécution, ciblant tous les scénarios de test ou un sous-ensemble spécifique.

Remarque :

Pour démarrer une toute nouvelle exécution, utilisez uip tm testsets run à la place.

Arguments

Aucun

Options

• --project-key <key> (obligatoire) : propriétaire du projet.
• --execution-id <uuid> (requis) : l'ID de l'exécution existante à réexécuter.
• --execution-type <type> (obligatoire) — quels cas de test exécuter (automated, manual, mixed, none).
• --test-case-log-ids <ids...> — UUID du journal de cas de test séparé par des espaces. Lorsqu'ils sont fournis, seuls ces journaux spécifiques sont réexécutés.
• --async — renvoie immédiatement après la mise en file d'attente sans attendre la confirmation.

Exemples

# re-run the entire execution
uip tm executions run \
  --project-key DEMO \
  --execution-id a1b2c3d4-0000-0000-0000-000000000001 \
  --execution-type automated

# re-run specific failed logs only
uip tm executions run \
  --project-key DEMO \
  --execution-id a1b2c3d4-0000-0000-0000-000000000001 \
  --execution-type automated \
  --test-case-log-ids c3d4e5f6-0000-0000-0000-000000000001 c3d4e5f6-0000-0000-0000-000000000002

Format des données

{
  "Code": "ExecutionRun",
  "Data": {
    "ExecutionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "Status": "Running",
    "StartTime": "2025-04-15T10:30:00Z"
  }
}

Nouvelle tentative d’exécutions uip tm

Réessayer uniquement les cas de test ayant échoué d’une exécution terminée, en place. La commande récupère les statistiques de l'exécution et refuse de se poursuivre à moins que l'exécution ne soit dans un état terminal. S'il n'y a aucun cas ayant échoué, il quitte 0 avec un message. La nouvelle tentative utilise le même ID d’exécution; il n'en crée pas de nouveau.

Arguments

Aucun

Options

• --execution-id <uuid> (requis) : l'exécution à réessayer.
• --project-key <key> — propriétaire du projet. Il est obligatoire de spécifier soit ceci, soit --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.
• --execution-type <type> — type d'exécution pour la nouvelle tentative: automated (par défaut), manual, mixed, ou none

Exemple

uip tm executions retry \
  --execution-id a1b2c3d4-0000-0000-0000-000000000001 \
  --project-key DEMO

Format des données — lorsqu'il y a des échecs de réessai

{
  "Code": "ExecutionRetry",
  "Data": {
    "ExecutionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "Status": "Running",
    "StartTime": "2025-04-15T10:30:00Z",
    "RetriedCount": 3
  }
}

Format des données — lorsqu'il n'y a pas d'échec de la nouvelle tentative

{
  "Code": "ExecutionRetry",
  "Data": {
    "Message": "Execution 'a1b2c3d4-0000-0000-0000-000000000001' has no failed test cases to retry."
  }
}

Obtenir les statistiques des exécutions uip tm

Obtenez une exécution de test par son ID avec des nombres agrégés de réussite/d’échec/aucun. Utilisez cette option pour lire le point de vue final d'une exécution terminée sans récupérer le rapport complet.

Arguments

Aucun

Options

• --execution-id <uuid> (requis) : UUID de l'exécution de test.
• --project-key <key> (obligatoire) : propriétaire du projet.

Exemple

uip tm executions get-stats \
  --execution-id a1b2c3d4-0000-0000-0000-000000000001 \
  --project-key DEMO

Format des données

{
  "Code": "ExecutionStats",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Name": "Nightly Run 2025-04-15",
    "Status": "Finished",
    "ExecutionType": "automated",
    "Passed": 8,
    "Failed": 2,
    "None": 0,
    "ExecutionStart": "2025-04-15T10:00:00Z",
    "ExecutionFinished": "2025-04-15T11:00:00Z"
  }
}

Codes de sortie

Le modèle CI standard est un pipeline en trois étapes:

1. Lancer — uip tm testsets run renvoie une ExecutionId et quitte 0
2. Bloquer — uip tm wait interrogations jusqu'à ce que l'exécution atteigne un état terminal. Quitte 0 lorsque vous avez terminé, 2 lors du délai d'expiration, 1 lors de l'échec.
3. Verdict — uip tm report get lit Passed / Failed décomptes. Votre script échoue explicitement la génération.

id=$(uip tm testsets run \
  --project-key DEMO \
  --test-set-key DEMO:10 \
  --execution-type automated \
  --output-filter .Data.ExecutionId)

if ! uip tm wait --execution-id "$id" --project-key DEMO --timeout 1800000; then
  code=$?
  [ "$code" -eq 2 ] && { echo "timed out" >&2; exit 2; }
  echo "wait failed ($code)" >&2; exit "$code"
fi

failed=$(uip tm report get \
  --execution-id "$id" --project-key DEMO --output-filter .Data.Failed)
[ "$failed" -gt 0 ] && { echo "$failed test(s) failed" >&2; exit 1; }
echo "all passed"

Associé

• exécution des ensembles de tests — le démarrage d'une exécution.
• attendre — bloquer jusqu'à ce qu'une exécution atteigne un état terminal.
• rapport, résultat, pièce jointe — artefacts post-exécution.
• testcases — testcaselog list-assertions transforme une journalisation échouée en détail par assertion.

Voir également

• Vue d’ensemble de Test Manager
• Codes de sortie
• Modèles de script