uip tm requirement

uip tm requirement manages requirements inside a Test Manager project — create, read, update, delete, and relate requirements to test cases and defects. Requirements are the traceability layer: they express what the system must do, and each requirement can be linked to one or more test cases to show coverage.

A requirement is identified by a RequirementKey (PROJECT:N) and optionally by a connector-native key (--requirement-key-external / --get-by-key).

Sinopsis

uip tm requirement list --project-key <key> [filters…]
uip tm requirement get --project-key <key> --requirement-id <uuid>
uip tm requirement get-by-key --project-key <key> --requirement-key <key>
uip tm requirement create --project-key <key> --name <name> [options…]
uip tm requirement update --project-key <key> --requirement-key <key> [options…]
uip tm requirement delete --project-key <key> --requirement-key <key>
uip tm requirement bulk-delete --project-key <key> --requirement-keys <keys>
uip tm requirement clone --project-key <key> --requirement-key <key> [--name <name>]
uip tm requirement list-filtered --project-key <key> [filters…]
uip tm requirement list-related-defects --project-key <key> --requirement-key <key>
uip tm requirement list-by-test-execution --project-key <key> --execution-id <uuid>
uip tm requirement search-by-label --project-key <key> --label <text>
uip tm requirement export --project-key <key> [--format <format>] [--output-path <path>]
uip tm requirement list-testcase-ids --project-key <key> --requirement-key <key>
uip tm requirement assign-testcases --project-key <key> --requirement-key <key> --test-case-keys <keys>
uip tm requirement unassign-testcases --project-key <key> --requirement-key <key> --test-case-keys <keys>
uip tm requirement unlink-connector --project-key <key> --requirement-key <key>

Todos los verbos respetan las opciones globales y los códigos de salida estándar. Cada verbo acepta -t, --tenant <name> y --log-level <level> (predeterminado Information).

uip tm requirement list

List all requirements in a project. The CLI pages through results automatically.

Argumentos

Nada.

Opciones

• --project-key <key> (requerido) — proyecto a listar.
• --filter <text> : filtrar por nombre o clave (búsqueda en el servidor).
• --top <number> — tamaño de la página. El valor predeterminado es 50.
• --skip <number> : resultados a omitir. El valor predeterminado es 0.

Ejemplo

uip tm requirement list --project-key DEMO

Forma de datos

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

uip tm requirement get

Get a single requirement by its internal UUID.

Argumentos

Nada.

Opciones

• --project-key <key> (obligatorio) : proyecto propietario.
• --requirement-id <uuid> (required) — internal requirement UUID. Obtain from requirement list or from RequirementCreate output.

Ejemplo

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

Forma de datos

{
  "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 requirement get-by-key

Get a requirement by its PROJECT:N key.

Argumentos

Nada.

Opciones

• --project-key <key> (obligatorio) : proyecto propietario.
• --requirement-key <key> (required) — requirement key (for example, DEMO:1).

Ejemplo

uip tm requirement get-by-key \
  --project-key DEMO \
  --requirement-key DEMO:1

Forma de datos

{
  "Code": "RequirementGetByKey",
  "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 requirement create

Create a new requirement in a project.

Argumentos

Nada.

Opciones

• --project-key <key> (obligatorio) : proyecto propietario.
• --name <name> (required) — requirement name.
• --description <text> — descripción de forma libre. El valor predeterminado es vacío.

Ejemplo

uip tm requirement create \
  --project-key DEMO \
  --name "User must be able to log in" \
  --description "Login with valid credentials succeeds"

Forma de datos

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

uip tm requirement update

Rename a requirement or change its description. At least one of --name or --description is required.

Argumentos

Nada.

Opciones

• --project-key <key> (obligatorio) : proyecto propietario.
• --requirement-key <key> (required) — requirement key (for example, DEMO:1).
• --name <name> — nuevo nombre. Omitir para dejar sin cambios.
• --description <text> — nueva descripción. Omitir para dejar sin cambios.

Ejemplo

uip tm requirement update \
  --project-key DEMO \
  --requirement-key DEMO:1 \
  --name "User must be able to log in (revised)"

Forma de datos

{
  "Code": "RequirementUpdate",
  "Data": {
    "RequirementKey": "DEMO:1",
    "Name": "User must be able to log in (revised)",
    "Result": "Updated"
  }
}

uip tm requirement delete

Delete a single requirement by its key.

Argumentos

Nada.

Opciones

• --project-key <key> (obligatorio) : proyecto propietario.
• --requirement-key <key> (required) — requirement key (for example, DEMO:1).

Ejemplo

uip tm requirement delete \
  --project-key DEMO \
  --requirement-key DEMO:1

Forma de datos

{
  "Code": "RequirementDelete",
  "Data": {
    "RequirementKey": "DEMO:1",
    "Result": "Deleted"
  }
}

uip tm requirement bulk-delete

Delete multiple requirements in one call.

Argumentos

Nada.

Opciones

• --project-key <key> (obligatorio) : proyecto propietario.
• --requirement-keys <keys> (required) — comma-separated PROJECT:N keys (for example, DEMO:1,DEMO:2).

Ejemplo

uip tm requirement bulk-delete \
  --project-key DEMO \
  --requirement-keys DEMO:1,DEMO:2

Forma de datos

{
  "Code": "RequirementBulkDelete",
  "Data": {
    "Deleted": 2
  }
}

uip tm requirement clone

Clone a requirement, optionally renaming the copy.

Argumentos

Nada.

Opciones

• --project-key <key> (obligatorio) : proyecto propietario.
• --requirement-key <key> (required) — requirement key to clone (for example, DEMO:1).
• --name <name> — name for the cloned requirement. Defaults to Copy of <original name>.

Ejemplo

uip tm requirement clone \
  --project-key DEMO \
  --requirement-key DEMO:1 \
  --name "User must be able to log in (copy)"

Forma de datos

{
  "Code": "RequirementClone",
  "Data": {
    "RequirementKey": "DEMO:5",
    "Name": "User must be able to log in (copy)"
  }
}

uip tm requirement list-filtered

List requirements with richer server-side filters than list. Supports multi-value status and label filters.

Argumentos

Nada.

Opciones

• --project-key <key> obligatorio) : proyecto a consultar.
• --statuses <statuses...> — space-separated requirement statuses to include. Accepted values are tool-version-dependent; run uip tm requirement list-filtered --help to see the current set.
• --labels <labels...> — space-separated label names to filter by.
• --top <number> — tamaño de la página. El valor predeterminado es 50.
• --skip <number> : resultados a omitir. El valor predeterminado es 0.

Ejemplo

uip tm requirement list-filtered \
  --project-key DEMO \
  --labels "high-priority"

Forma de datos

{
  "Code": "RequirementsListFiltered",
  "Data": [
    {
      "RequirementKey": "DEMO:1",
      "Name": "User must be able to log in",
      "Status": "Active"
    }
  ]
}

uip tm requirement list-related-defects

List defects linked to a requirement via a connector integration.

Argumentos

Nada.

Opciones

• --project-key <key> (obligatorio) : proyecto propietario.
• --requirement-key <key> (required) — requirement key (for example, DEMO:1).

Ejemplo

uip tm requirement list-related-defects \
  --project-key DEMO \
  --requirement-key DEMO:1

Forma de datos

{
  "Code": "RequirementRelatedDefects",
  "Data": [
    {
      "DefectId": "DEF-42",
      "Title": "Login fails on Safari",
      "Status": "Open"
    }
  ]
}

uip tm requirement list-by-test-execution

List the requirements covered by a given test execution.

Argumentos

Nada.

Opciones

• --project-key <key> (obligatorio) : proyecto propietario.
• --execution-id <uuid> (required) — execution UUID. Get from uip tm testsets run or uip tm executions list.

Ejemplo

uip tm requirement list-by-test-execution \
  --project-key DEMO \
  --execution-id a1b2c3d4-0000-0000-0000-000000000001

Forma de datos

{
  "Code": "RequirementsByExecution",
  "Data": [
    {
      "RequirementKey": "DEMO:1",
      "Name": "User must be able to log in"
    }
  ]
}

uip tm requirement search-by-label

Find requirements tagged with a specific label.

Argumentos

Nada.

Opciones

• --project-key <key> (obligatorio) : proyecto propietario.
• --label <text> (required) — label to search for.

Ejemplo

uip tm requirement search-by-label \
  --project-key DEMO \
  --label "high-priority"

Forma de datos

{
  "Code": "RequirementsSearchByLabel",
  "Data": [
    {
      "RequirementKey": "DEMO:1",
      "Name": "User must be able to log in"
    }
  ]
}

uip tm requirement export

Export requirements to a file. Format options and output defaults are tool-version-dependent; run uip tm requirement export --help to see the current set.

Argumentos

Nada.

Opciones

• --project-key <key> (obligatorio) : proyecto propietario.
• --format <format> — export format (run --help to see accepted values).
• --output-path <path> — destination path for the exported file. Defaults to the current directory.

Ejemplo

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

Forma de datos

Writes a file to --output-path and prints a RequirementExport envelope:

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

uip tm requirement list-testcase-ids

List the internal UUIDs of all test cases assigned to a requirement.

Argumentos

Nada.

Opciones

• --project-key <key> (obligatorio) : proyecto propietario.
• --requirement-key <key> (required) — requirement key (for example, DEMO:1).

Ejemplo

uip tm requirement list-testcase-ids \
  --project-key DEMO \
  --requirement-key DEMO:1

Forma de datos

{
  "Code": "RequirementTestCaseIds",
  "Data": [
    "a1b2c3d4-0000-0000-0000-000000000001",
    "a1b2c3d4-0000-0000-0000-000000000002"
  ]
}

uip tm requirement assign-testcases

Link one or more test cases to a requirement.

Argumentos

Nada.

Opciones

• --project-key <key> (obligatorio) : proyecto propietario.
• --requirement-key <key> (required) — requirement key (for example, DEMO:1).
• --test-case-keys <keys> (required) — comma-separated test case keys (for example, DEMO:1,DEMO:2).

Ejemplo

uip tm requirement assign-testcases \
  --project-key DEMO \
  --requirement-key DEMO:1 \
  --test-case-keys DEMO:1,DEMO:2

Forma de datos

{
  "Code": "RequirementAssignTestCases",
  "Data": {
    "Assigned": 2
  }
}

uip tm requirement unassign-testcases

Remove one or more test case links from a requirement.

Argumentos

Nada.

Opciones

• --project-key <key> (obligatorio) : proyecto propietario.
• --requirement-key <key> (required) — requirement key (for example, DEMO:1).
• --test-case-keys <keys> (required) — comma-separated test case keys to unlink.

Ejemplo

uip tm requirement unassign-testcases \
  --project-key DEMO \
  --requirement-key DEMO:1 \
  --test-case-keys DEMO:1,DEMO:2

Forma de datos

{
  "Code": "RequirementUnassignTestCases",
  "Data": {
    "Unassigned": 2
  }
}

uip tm requirement unlink-connector

Remove a connector integration link from a requirement. Disconnects the external tool mapping without deleting the requirement itself.

Argumentos

Nada.

Opciones

• --project-key <key> (obligatorio) : proyecto propietario.
• --requirement-key <key> (required) — requirement key (for example, DEMO:1).

Ejemplo

uip tm requirement unlink-connector \
  --project-key DEMO \
  --requirement-key DEMO:1

Forma de datos

{
  "Code": "RequirementUnlinkConnector",
  "Data": {
    "RequirementKey": "DEMO:1",
    "Result": "Unlinked"
  }
}

Relacionado

• testcases — assign test cases to requirements with requirement assign-testcases.
• objectlabel — manage the labels you can search by with requirement search-by-label.
• executions — list requirements covered by a run with requirement list-by-test-execution.

Ver también

• Descripción general de Test Manager