uip-tm-Anforderungen

uip tm requirements verwaltet Anforderungen innerhalb eines Test Manager-Projekts. Anforderungen sind die Rückverfolgbarkeitsebene: Sie drücken aus, was das System tun muss, und jede Anforderung kann mit einem oder mehreren Testfällen verknüpft werden, um die Abdeckung anzuzeigen.

Zusammenfassung

uip tm requirements list --project-key <key> [--filter <text>] [--requirement-ids <ids...>] [--labels <labels...>] [--updated-by <userId>] [--test-case-id <uuid>] [--changed-since <datetime>] [--sort-by <expr>] [--limit <n>] [--offset <n>]
uip tm requirements get --project-key <key> [--requirement-id <uuid>] [--requirement-key <key>]
uip tm requirements create --project-key <key> --name <name> [--description <text>] [--external-reference <ref>] [--connector-requirement-uuid <uuid>]
uip tm requirements update --project-key <key> --requirement-id <uuid> [--name <name>] [--description <text>]
uip tm requirements delete --project-key <key> --requirement-ids <uuid...> [-y]
uip tm requirements export --project-key <key> --output-file <path>
uip tm requirements list-testcase-ids --project-key <key> --requirement-id <uuid>
uip tm requirements testcases --project-key <key> --requirement-id <uuid> (--add-testcase-ids <uuid...> | --remove-testcase-ids <uuid...>)
uip tm requirements list-by-test-execution --project-key <key> --execution-id <uuid> [--labels <label...>] [--updated-by <userId>] [--filter <text>] [--sort-by <expr>] [--limit <n>] [--offset <n>]

Alle Verben berücksichtigen die globalen Optionen und die Standardaustrittscodes. Jedes Verb akzeptiert -t, --tenant <name> und --log-level <level> (Standard: Information).

UIP-TM-Anforderungsliste

Listen Sie Anforderungen in einem Projekt mit umfangreicher serverseitiger Filterung auf.

Argumente

Keine.

Optionen

• --project-key <key> (erforderlich) – Projekt zur Liste.
• --filter <text> – Suchanforderungen nach Namen oder Schlüssel.
• --requirement-ids <uuid...> – durch Leerzeichen getrennte UUIDs.
• --labels <labels...> – Durch Leerzeichen getrennte Beschriftungsnamen, nach denen gefiltert werden soll.
• --updated-by <userId> – Filtern nach der Benutzer-ID, die die Anforderung zuletzt aktualisiert hat.
• --test-case-id <uuid> – gibt nur Anforderungen zurück, die mit dieser Testfall-UUID verknüpft sind.
• --changed-since <datetime> – Rückgabeanforderungen, die nach diesem ISO-8601-Zeitstempel geändert wurden.
• --sort-by <expr> – Sortierausdruck (Feldname, optional mit :asc oder :desc angehängt).
• --limit <n> – Seitengröße. Die Standardeinstellung ist 50.
• --offset <n> – Ergebnisse, die übersprungen werden sollen. Die Standardeinstellung ist 0.

Beispiel

uip tm requirements list \
  --project-key DEMO \
  --labels "high-priority" \
  --limit 20

Datenform

{
  "Code": "RequirementsList",
  "Data": [
    {
      "RequirementKey": "DEMO:1",
      "Id": "a1b2c3d4-0000-0000-0000-000000000001",
      "Name": "User must be able to log in",
      "Description": "Login with valid credentials succeeds"
    }
  ]
}

UIP-TM-Anforderungen abrufen

Rufen Sie eine einzelne Anforderung ab. Entweder --requirement-id oder --requirement-key muss angegeben werden; sie sind optional und schließen sich gegenseitig aus.

Argumente

Keine.

Optionen

• --project-key <key> (erforderlich) – besitzendes Projekt.
• --requirement-id <uuid> – UUID der internen Anforderung. Sich gegenseitig mit --requirement-key ausschließen.
• --requirement-key <key> – Anforderungsschlüssel (z. B. DEMO:1). Sich gegenseitig mit --requirement-id ausschließen.

Beispiel

uip tm requirements get \
  --project-key DEMO \
  --requirement-id a1b2c3d4-0000-0000-0000-000000000001

Datenform

{
  "Code": "RequirementGet",
  "Data": {
    "RequirementKey": "DEMO:1",
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Name": "User must be able to log in",
    "Description": "Login with valid credentials succeeds"
  }
}

uip-tm-Anforderungen erstellen

Erstellen Sie eine neue Anforderung in einem Projekt.

Argumente

Keine.

Optionen

• --project-key <key> (erforderlich) – besitzendes Projekt.
• --name <name> (erforderlich) – Anforderungsname.
• --description <text> – Freiform-Beschreibung. Standardmäßig leer.
• --external-reference <ref> – externe Systemreferenz (z. B. eine Jira-Ticket-ID).
• --connector-requirement-uuid <uuid> – UUID aus einem verbundenen externen Anforderungssystem.

Beispiel

uip tm requirements create \
  --project-key DEMO \
  --name "User must be able to log in" \
  --external-reference "JIRA-123"

Datenform

{
  "Code": "RequirementCreate",
  "Data": {
    "RequirementKey": "DEMO:1",
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Name": "User must be able to log in"
  }
}

Aktualisierung der UIP-TM-Anforderungen

Aktualisieren Sie eine vorhandene Anforderung. Mindestens eines dieser Felder muss ausgefüllt werden.

Argumente

Keine.

Optionen

• --project-key <key> (erforderlich) – besitzendes Projekt.
• --requirement-id <uuid> (erforderlich) – interne UUID der zu aktualisierenden Anforderung.
• --name <name> – Neuer Name.
• --description <text> – Neue Beschreibung.

Beispiel

uip tm requirements update \
  --project-key DEMO \
  --requirement-id a1b2c3d4-0000-0000-0000-000000000001 \
  --name "User must be able to log in with MFA"

Datenform

{
  "Code": "RequirementUpdate",
  "Data": {
    "RequirementKey": "DEMO:1",
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Name": "User must be able to log in with MFA",
    "Result": "Updated"
  }
}

UIP-TM-Anforderungen löschen

Löschen Sie eine oder mehrere Anforderungen durch ihre internen UUIDs.

Argumente

Keine.

Optionen

• --project-key <key> (erforderlich) – besitzendes Projekt.
• --requirement-ids <uuid...> (erforderlich) – durch Leerzeichen getrennte interne UUIDs, die gelöscht werden sollen.
• -y, --yes – Überspringen Sie die Bestätigungsaufforderung.

Beispiel

uip tm requirements delete \
  --project-key DEMO \
  --requirement-ids a1b2c3d4-0000-0000-0000-000000000001 b2c3d4e5-0000-0000-0000-000000000001 \
  --yes

Datenform

{
  "Code": "RequirementDelete",
  "Data": {
    "Deleted": 2,
    "Result": "Deleted"
  }
}

Export von UIP-TM-Anforderungen

Exportanforderungen in eine Datei.

Argumente

Keine.

Optionen

• --project-key <key> (erforderlich) – besitzendes Projekt.
• --output-file <path> (erforderlich) – Der Pfad zum Schreiben der Exportdatei.

Beispiel

uip tm requirements export \
  --project-key DEMO \
  --output-file ./requirements-export.xlsx

Datenform

{
  "Code": "RequirementExport",
  "Data": {
    "OutputPath": "./requirements-export.xlsx",
    "Result": "Exported"
  }
}

UIP-TM-Anforderungsliste-Testfall-IDs

Listen Sie die UUIDs der Testfälle auf, die mit einer Anforderung verknüpft sind.

Argumente

Keine.

Optionen

• --project-key <key> (erforderlich) – besitzendes Projekt.
• --requirement-id <uuid> (erforderlich) – interne UUID der Anforderung.

Beispiel

uip tm requirements list-testcase-ids \
  --project-key DEMO \
  --requirement-id a1b2c3d4-0000-0000-0000-000000000001

Datenform

{
  "Code": "RequirementTestCaseIds",
  "Data": [
    "b2c3d4e5-0000-0000-0000-000000000001",
    "c3d4e5f6-0000-0000-0000-000000000001"
  ]
}

Testfälle für UIP-TM-Anforderungen

Fügen Sie Testfalllinks für eine Anforderung hinzu oder entfernen Sie sie. Übergeben Sie entweder --add-testcase-ids oder --remove-testcase-ids (nicht beide im selben Aufruf).

Argumente

Keine.

Optionen

• --project-key <key> (erforderlich) – besitzendes Projekt.
• --requirement-id <uuid> (erforderlich) – zu ändernde Anforderung.
• --add-testcase-ids <uuid...> – durch Leerzeichen getrennte Testfall-UUIDs, die verknüpft werden sollen.
• --remove-testcase-ids <uuid...> – durch Leerzeichen getrennte Testfall-UUIDs, deren Verknüpfung aufgehoben werden soll.

Beispiele

# link test cases
uip tm requirements testcases \
  --project-key DEMO \
  --requirement-id a1b2c3d4-0000-0000-0000-000000000001 \
  --add-testcase-ids b2c3d4e5-0000-0000-0000-000000000001 c3d4e5f6-0000-0000-0000-000000000001

# unlink test cases
uip tm requirements testcases \
  --project-key DEMO \
  --requirement-id a1b2c3d4-0000-0000-0000-000000000001 \
  --remove-testcase-ids b2c3d4e5-0000-0000-0000-000000000001

Datenform

{
  "Code": "RequirementTestCases",
  "Data": {
    "RequirementId": "a1b2c3d4-0000-0000-0000-000000000001",
    "Result": "Updated"
  }
}

Liste der UIP-TM-Anforderungen nach Testausführung

Listen Sie die Anforderungen auf, die von einer bestimmten Testausführung abgedeckt werden. Gibt die Anforderungen zurück, deren verknüpfte Testfälle in dieser Ausführung enthalten waren.

Argumente

Keine.

Optionen

• --project-key <key> (erforderlich) – besitzendes Projekt.
• --execution-id <uuid> (erforderlich) – UUID der Testausführung.
• --labels <label...> – Filtern Sie nach Beschriftungsnamen (durch Leerzeichen getrennt).
• --updated-by <userId> – Filtern nach der Benutzer-ID, die die Anforderung zuletzt aktualisiert hat.
• --filter <text> – Suchanforderungen nach Namen oder Schlüssel.
• --sort-by <expr> – Sortierausdruck (Feldname, optional mit :asc oder :desc angehängt).
• --limit <n> – Seitengröße. Die Standardeinstellung ist 50.
• --offset <n> – Ergebnisse, die übersprungen werden sollen. Die Standardeinstellung ist 0.

Beispiel

uip tm requirements list-by-test-execution \
  --project-key DEMO \
  --execution-id b2c3d4e5-0000-0000-0000-000000000001

Datenform

{
  "Code": "RequirementsListByTestExecution",
  "Data": [
    {
      "RequirementKey": "DEMO:1",
      "Id": "a1b2c3d4-0000-0000-0000-000000000001",
      "Name": "User must be able to log in",
      "Description": "Login with valid credentials succeeds"
    }
  ]
}

Zugehörig

• project – besitzender Projekt-Scope.
• Testfälle – Testfälle, die mit Anforderungen verknüpft werden können.

Siehe auch

• Test Manager-Übersicht
• Authentication