Requisitos de uip tm

uip tm requirements los requisitos dentro de un proyecto de Test Manager. Los requisitos son la capa de trazabilidad: expresan lo que debe hacer el sistema, y cada requisito puede vincularse a uno o más casos de prueba para mostrar la cobertura.

Sinopsis

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>]

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).

lista de requisitos de uip tm

Enumerar los requisitos en un proyecto con filtrado enriquecido del lado del servidor.

Argumentos

Nada.

Opciones

• --project-key <key> (requerido) — proyecto a listar.
• --filter <text> : requisitos de búsqueda por nombre o clave.
• --requirement-ids <uuid...> : UUID separados por espacios a incluir.
• --labels <labels...> : nombres de etiquetas separados por espacios para filtrar.
• --updated-by <userId> : filtrar por el ID de usuario que actualizó el requisito por última vez.
• --test-case-id <uuid> : devuelve solo los requisitos vinculados a este UUID de caso de prueba.
• --changed-since <datetime> : devuelve los requisitos modificados después de esta marca de tiempo ISO-8601.
• --sort-by <expr> — expresión de ordenación (nombre del campo, opcionalmente con el sufijo :asc o :desc).
• --limit <n> — tamaño de la página. El valor predeterminado es 50.
• --offset <n> : resultados a omitir. El valor predeterminado es 0.

Ejemplo

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

Forma de datos

{
  "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"
    }
  ]
}

Obtener requisitos de uip tm

Obtener un único requisito. Se debe proporcionar --requirement-id o --requirement-key ; son opcionales y mutuamente excluyentes.

Argumentos

Nada.

Opciones

• --project-key <key> (obligatorio) : proyecto propietario.
• --requirement-id <uuid> : UUID de requisito interno. Mutuamente excluyente con --requirement-key.
• --requirement-key <key> : clave de requisito (por ejemplo, DEMO:1). Mutuamente excluyente con --requirement-id.

Ejemplo

uip tm requirements 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"
  }
}

creación de requisitos de uip tm

Crear un nuevo requisito en un proyecto.

Argumentos

Nada.

Opciones

• --project-key <key> (obligatorio) : proyecto propietario.
• --name <name> (obligatorio) : nombre del requisito.
• --description <text> — descripción de forma libre. El valor predeterminado es vacío.
• --external-reference <ref> — referencia de sistema externo (por ejemplo, un ID de ticket de Jira).
• --connector-requirement-uuid <uuid> — UUID de un sistema de requisitos externo conectado.

Ejemplo

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

Forma de datos

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

actualización de requisitos de uip tm

Actualizar un requisito existente. Se debe proporcionar al menos uno de estos campos.

Argumentos

Nada.

Opciones

• --project-key <key> (obligatorio) : proyecto propietario.
• --requirement-id <uuid> (obligatorio) : UUID interno del requisito a actualizar.
• --name <name> — nuevo nombre.
• --description <text> — nueva descripción.

Ejemplo

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

Forma de datos

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

eliminación de requisitos de uip tm

Elimine uno o más requisitos por sus UUID internos.

Argumentos

Nada.

Opciones

• --project-key <key> (obligatorio) : proyecto propietario.
• --requirement-ids <uuid...> obligatorio) : UUID internos separados por espacios para eliminar.
• -y, --yes : omite la solicitud de confirmación.

Ejemplo

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

Forma de datos

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

exportación de requisitos de uip tm

Exportar requisitos a un archivo.

Argumentos

Nada.

Opciones

• --project-key <key> (obligatorio) : proyecto propietario.
• (obligatorio) : ruta para escribir el archivo --output-file <path> exportación.

Ejemplo

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

Forma de datos

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

requisitos de uip tm lista-id-de-caso-de-prueba

Enumera los UUID de los casos de prueba vinculados a un requisito.

Argumentos

Nada.

Opciones

• --project-key <key> (obligatorio) : proyecto propietario.
• --requirement-id <uuid> (obligatorio) : UUID interno del requisito.

Ejemplo

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

Forma de datos

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

Casos de prueba de requisitos de uip tm

Añada o elimine enlaces de casos de prueba en un requisito. Pasa --add-testcase-ids o --remove-testcase-ids (no ambos en la misma llamada).

Argumentos

Nada.

Opciones

• --project-key <key> (obligatorio) : proyecto propietario.
• --requirement-id <uuid> (obligatorio) : requisito para modificar.
• --add-testcase-ids <uuid...> : UUID de casos de prueba separados por espacios para vincular.
• --remove-testcase-ids <uuid...> : UUID de casos de prueba separados por espacios para desvincular.

Ejemplos

# 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

Forma de datos

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

requisitos de uip tm lista por ejecución de prueba

Enumerar los requisitos cubiertos por una ejecución de prueba específica. Devuelve los requisitos cuyos casos de prueba vinculados se incluyeron en esa ejecución.

Argumentos

Nada.

Opciones

• --project-key <key> (obligatorio) : proyecto propietario.
• --execution-id <uuid> (obligatorio) : UUID de ejecución de prueba.
• --labels <label...> : filtrar por nombres de etiquetas (separados por espacios).
• --updated-by <userId> : filtrar por el ID de usuario que actualizó el requisito por última vez.
• --filter <text> : requisitos de búsqueda por nombre o clave.
• --sort-by <expr> — expresión de ordenación (nombre del campo, opcionalmente con el sufijo :asc o :desc).
• --limit <n> — tamaño de la página. El valor predeterminado es 50.
• --offset <n> : resultados a omitir. El valor predeterminado es 0.

Ejemplo

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

Forma de datos

{
  "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"
    }
  ]
}

Relacionado

• proyecto : propietario del ámbito del proyecto.
• casos de prueba : casos de prueba que se pueden vincular a los requisitos.

Ver también

• Descripción general de Test Manager
• Autenticación