UIP-TM warten

Syntax und Optionen für „uip tm Wait“, das eine Testausführung abfragt, bis sie einen Endstatus erreicht, und eine einzeilige Zusammenfassung ausgibt.

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.

Zusammenfassung

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

Beachten Sie die globalen Optionen. Im nachfolgenden Abschnitt Beendigungscodes finden Sie weitere Informationen zum domänenspezifischen Verhalten bei Timeouts.

UIP-TM warten

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

Argumente

Keine.

Optionen

• --execution-id <uuid> (erforderlich) – Ausführung, auf die gewartet werden soll. Rufen Sie es von uip tm testsets run ab.

• --project-key <key> — owning project key.

• --project-id <id> — owning project ID. Use instead of --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> – Testsatzschlüssel (z. B. DEMO:42); Der Projektschlüssel ist aus dem Präfix abgeleitet.

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

Hinweis:

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

Warnung:

A manual run closed early with executions finish keeps Status: "Running", so wait never sees a terminal state on it. wait blocks until --timeout and then exits 2. Check such a run's ExecutionFinished timestamp with executions get-stats instead.

Beispiel

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

Data shape (terminal state reached before the timeout)

{
  "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.

Exitcodes

wait folgt den Standard -Exitcodes für 0, 1 und 3 mit einer domain-spezifischen Wiederverwendung von 2:

Code beenden	Bedeutung
0	Die Ausführung hat innerhalb des Timeouts einen Endstatus erreicht.
1	Polling failed (three consecutive API errors, interrupt, abort), sign-in failed, or no project was given. See the Message field for detail.
2	Timed out. The timeout elapsed before the execution reached a terminal state.
3	Validierungsfehler (false Flag-Wert, fehlende erforderliche Option).

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.

Skriptmuster

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

Zugehörig

• testsets run – erzeugt das ExecutionId , auf das gewartet werden soll.
• report – Zusammenfassung, die gelesen werden soll, sobald wait 0 zurückgibt.
• Ergebnis – JUnit-XML-Export.
• Ausführungswiederholung – führen Sie die fehlgeschlagenen Fälle einer abgeschlossenen Ausführung erneut aus.
• executions cancel — stop a running automated execution; poll it to Cancelled with wait.
• run — run every test in an uploaded package, wait, and write a report in one command.

Siehe auch

• Test Manager-Übersicht
• Austrittscodes – gemeinsam genutzter Vertrag.
• Skriptingmuster – die Launch-Wait-Verify-Pipeline.