Líneas base de referencia inmutables¶
Abra un caso de prueba o un capítulo de requisitos en la aplicación web y seleccione Historial. Al elegir una línea base, se abre el contenido guardado del objeto. Para crear o comparar líneas base, abra la administración desde la biblioteca o desde Requisitos.
Las líneas base de referencia se crean y leen en el cliente web. Windows conserva sus datos de proyecto pero no tiene una interfaz dedicada para líneas base.
Una línea base de referencia captura requisitos y la biblioteca de pruebas juntos bajo un nombre. Cambios posteriores o eliminación de los originales no modifican su contenido guardado. Puede inspeccionarla y compararla con los contenidos actuales del mismo alcance, por ejemplo antes y después de revisar una característica del producto.
Una línea base es un punto de referencia inmutable. No es una firma electrónica, aprobación de contenido ni aceptación automática de liberación. Versiones de casos de prueba captura casos de prueba normales individuales; un comparación de versiones evalúa resultados de pruebas.
Seleccione el nombre de una referencia para abrirla. Si la lista de objetos es larga, use los controles de página situados debajo de la tabla. Seleccione un objeto para ver su contenido guardado.
Prerrequisitos y permisos¶
La creación requiere una cuenta activa de proyecto con el rol de administrador, o el rol de gestor de proyecto con permiso para editar configuraciones del proyecto. También debe poder leer todo el alcance seleccionado. Esto incluye objetos vinculados y fuentes principales cuyos nombres, contenidos heredados o archivos se capturan. Permisos insuficientes rechazan la creación en lugar de producir silenciosamente una línea base incompleta.
La lectura, comparación y descarga de archivos vuelve a verificar los permisos actuales. Crear una línea base no otorga acceso especial permanente. Si un original requerido ya no existe o la identidad del proyecto ha cambiado en una copia, solo los administradores del proyecto pueden leer la línea base guardada. Revocar permisos puede eliminar una línea base previamente visible de la lista y bloquear enlaces conocidos de detalle o descarga.
Capturar una línea base¶
- Abra Líneas base de referencia en el proyecto Web. También puede acceder a la página desde la biblioteca de pruebas y requisitos. Seleccione Crear línea base para abrir el cuadro de diálogo.
- Introduzca un nombre y motivo significativos, como “Checkout antes de la revisión” y por qué se necesita este punto de referencia.
- Seleccione el alcance del requisito: todos los requisitos, o una carpeta, documento o capítulo junto con sus descendientes.
- Seleccione independientemente la biblioteca de pruebas completa o una unidad de prueba con sus unidades y casos descendientes. Un enlace de requisito no expande automáticamente esa selección para incluir otros casos de prueba.
- Revise ambos alcances y confirme explícitamente la captura inmutable. Abra la línea base guardada y verifique sus objetos y archivos.
Nombre, motivo, autor, tiempo de captura y alcance se conservan con el contenido. Esta versión no permite editar, restaurar ni eliminar líneas base individuales. La creación no modifica los originales, versiones de casos de prueba, planes, ejecuciones ni resultados.
Si la aplicación informa un cambio concurrente, recargue las fuentes y revise la solicitud nuevamente. Si se exceden los límites de tamaño, seleccione un alcance menor; nunca se guarda una línea base parcial truncada.
Contenidos y archivos guardados¶
Una línea base incluye la estructura y orden seleccionados, descripciones, campos personalizados con sus definiciones, contenido heredado efectivo en el momento de la captura y enlaces de requisito a caso de prueba. Los casos de prueba normales incluyen sus variantes, pasos, resultados esperados y bloques de pasos reutilizables. Los casos de prueba rápidos incluyen además definiciones de campos, filas, celdas y atributos de fila.
Los archivos adjuntos almacenados e imágenes incrustadas se conservan con sus bytes independientemente de los originales. Esto incluye archivos adjuntos heredados capturados y archivos en celdas Quick. Los archivos ya ausentes en la captura se marcan explícitamente como faltantes. Los enlaces a archivos externos permanecen como referencias: sus destinos no se descargan automáticamente ni se archivan como copias de archivo. Las vistas previas históricas no recuperan imágenes externas. Los campos de contraseña están excluidos.
Los límites son 100 MB por archivo y 256 MB para todos los archivos guardados combinados. La aplicación también limita el número de objetos y el tamaño del contenido. Realice una copia de seguridad completa del proyecto: los contenidos históricos de los archivos pertenecen a la base de datos del proyecto. Una exportación en hoja de cálculo o texto no reemplaza esa copia de seguridad.
Comparar con el ámbito actual¶
Abra una línea base guardada y solicite una comparación con el contenido actual. La vista general distingue objetos añadido, eliminado, cambiado y sin cambios. Las diferencias detalladas muestran valores antiguos y actuales, incluidos enlaces, variantes, orden y archivos.
La comparación resuelve nuevamente el alcance guardado contra el proyecto actual. Un hijo añadido recientemente se incluye en la comparación actual; un objeto movido fuera del alcance se trata como eliminado. Una raíz de alcance eliminada nunca expande la comparación a todo el proyecto. Ese lado del alcance actual está vacío y sus objetos guardados aparecen como eliminados. La vista Web muestra una advertencia. Debido a que la fuente fue eliminada, solo los administradores del proyecto pueden leer esa línea base histórica. Los contenidos actuales también deben ser legibles en su totalidad.
Ejemplo: capture un documento de requisitos y la unidad de prueba “Checkout”. Luego cambie un paso de prueba, elimine un enlace de requisito y agregue un caso de prueba rápido dentro de la unidad. La comparación muestra diferencias de campo para el caso modificado y el nuevo caso de prueba rápido como agregado. La línea base guardada conserva el paso y el enlace originales. La comparación no aplica cambios a la biblioteca ni a la planificación de pruebas.
MCP y REST¶
Las APIs usan los mismos permisos de proyecto y objeto que la Web. La capacidad project.library-baseline.read requiere acceso API al proyecto y permisos de lectura actuales; no se requiere concesión adicional de alcance de lectura. REST expone las herramientas como POST /api/v1/operations/<tool name>; consulte Capítulo REST para autenticación y enrutamiento de proyectos. La disponibilidad depende de la versión del servidor instalada.
| Herramienta | Entradas y resultado |
|---|---|
ztm_library_baseline_options |
Leer ámbitos permitidos de requisito/unidad de prueba y disponibilidad de creación |
ztm_library_baseline_list |
Leer líneas base visibles con skip y take (máximo 100); HasMore indica otra página |
ztm_library_baseline_read |
baselineId: lea contenidos guardados y metadatos del activo sin bytes de archivo |
ztm_library_baseline_compare |
baselineId: compare con el contenido actual del alcance guardado |
ztm_library_baseline_asset |
baselineId, assetId: leen un archivo almacenado de hasta 512 KiB; Content está codificado en Base64 |
Los usuarios autorizados descargan archivos más grandes a través de la descarga web autenticada. Las API tampoco recuperan referencias externas.
Una comparación también informa raíces de alcance eliminadas en MissingScopeRoots. Esta advertencia distingue un alcance faltante de un alcance existente que no contiene objetos.
La creación requiere la capacidad de escritura project.library-baseline.create explícitamente otorgada y las acciones de escritura habilitadas. Llame a ztm_project_action_prepare con este capabilityId, su propio idempotencyKey y, por ejemplo, estos arguments:
{
"name": "Checkout before revision",
"reason": "Jointly confirmed reference point for the revision",
"scope": { "requirementType": "", "requirementId": 0, "testUnitId": 0 },
"operationId": "b7830698-beb9-4a89-a3c3-cf1a07543ee9",
"scopeConfirmed": true
}
Un requirementType vacío con requirementId: 0 selecciona todos los requisitos. De lo contrario, use ReqFolders, ReqDocuments o ReqChapters con un ID devuelto por opciones de alcance. testUnitId: 0 selecciona toda la biblioteca. El usuario responsable debe seleccionar y confirmar realmente el nombre, motivo y ambos alcances; scopeConfirmed no reemplaza esa decisión.
Revise la vista previa, luego confírmela explícitamente mediante ztm_project_action_commit con el mismo capabilityId y el previewToken devuelto. Solo preparar no guarda una línea base. El usuario autenticado es el autor. Preserve operationId para reintentos; los contenidos cambiados con el mismo ID son rechazados. Los reintentos también verifican permisos actuales. El permiso general de escritura no habilita la edición, restauración o eliminación de líneas base de referencia.
Abra desde Windows¶
En Windows, haga clic derecho en una unidad de prueba de biblioteca, carpeta de requisitos, documento de requisitos o capítulo de requisitos y elija Abra líneas base de referencia en la web. El ámbito seleccionado se preselecciona para la creación. Abrir la página no crea una línea base; Web verifica permisos nuevamente.
Su sesión autenticada de Windows inicia sesión automáticamente. Solo si la transferencia falla aparece la página de inicio de sesión; se conserva el destino.
Impacto de un cambio en un requisito¶
Utilice una línea base guardada en vista de impacto de cambios para comparar un capítulo de requisitos con su contenido actual y las pruebas legibles asociadas. El análisis no crea una nueva ejecución de pruebas.
Adoptar estándares de otro proyecto¶
En el cliente Web, puede adoptar una línea base de referencia seleccionada explícitamente de otro proyecto accesible como casos de prueba normales locales. Elija Estándares del proyecto en el encabezado de la biblioteca de pruebas, o Importar línea base de referencia en su menú de importación/contexto. Los usuarios de solo lectura pueden comparar; los permisos de escritura faltantes aparecen como bloqueadores e impiden la aplicación. La importación ordinaria del proyecto sigue disponible: copia el contenido fuente actual sin establecer una relación controlada con una línea base histórica.
- Elija el proyecto fuente, una línea base de referencia legible y la carpeta destino. Seleccione casos normales individuales o unidades de prueba con sus unidades y casos descendientes. La selección expandida puede contener hasta 200 unidades y casos combinados; las selecciones superpuestas cuentan cada objeto una vez. Seleccionar una línea base no aprueba ni publica su contenido.
- Elija cómo manejar nombres coincidentes y revise la vista previa, incluyendo rutas destino, nombres finales, casos locales afectados y bloqueadores. La adopción usa contenidos y archivos guardados; los cambios en vivo posteriores en la fuente no los reemplazan.
- Al adoptar una línea base recién seleccionada más tarde, la vista previa distingue cambios en la fuente, cambios locales y cambios en ambos lados. Los cambios locales se conservan por defecto. Elija Reemplazar cambios locales solo para el caso individual que ha revisado, luego elija Revise las decisiones para preparar una nueva vista previa. El texto nunca se fusiona automáticamente.
- Confirme Aplicar tras revisar la vista previa. Abra los casos locales guardados desde el recibo y verifique sus contenidos y archivos después de recargar.
Las unidades de prueba seleccionadas se crean debajo de la carpeta de destino con sus nombres guardados y jerarquía histórica, incluidas unidades vacías. Movimientos posteriores en la fuente no cambian esa estructura histórica. Las unidades sirven como contenedores; sus propias descripciones de origen, atributos, archivos adjuntos y permisos no se copian. Las unidades de destino previamente asignadas se reutilizan en importaciones repetidas y no se renombran ni mueven para seguir cambios posteriores en la fuente.
La copia tiene sus propias identidades locales, variantes normales, archivos independientes y versiones de caso de prueba. Repetir la misma operación completada no crea otra copia. Una actualización explícita posterior conserva la identidad del caso objetivo mapeado. Las plantillas y ejecuciones abiertas mantienen sus copias existentes; sincronícelas por separado cuando sea necesario. Las ACL de origen, cuentas de usuario, credenciales y enlaces de requisitos o dependencias externas no se importan como relaciones locales.
El caso normal importado ofrece Origen y actualización. Abra su origen, seleccione explícitamente la línea base legible que desea comparar y elija Comparar. Sin acceso a la fuente actual, solo queda una pista genérica del origen; el caso local sigue siendo utilizable. Las adiciones al nombre original, incluido un sufijo de colisión asignado durante la importación, se conservan durante las actualizaciones del caso; nuevos prefijos y sufijos se aplican a nuevas copias. Los casos locales movidos conservan su carpeta destino. Los destinos eliminados o copiados nunca se reasignan mediante la coincidencia de sus nombres.
Necesita un usuario activo realmente mapeado en el proyecto fuente, acceso de lectura a toda la línea base seleccionada y los permisos de destino apropiados. Crear un caso y actualizar un caso existente requieren permisos separados. La falta de acceso a la fuente no debe reducir silenciosamente la selección. Una nueva adopción vuelve a verificar y lee la fuente autorizada cuando comienza la ejecución, luego realiza el cambio local en el destino. No existe una transacción compartida entre ambos proyectos. Perder el acceso a la fuente posteriormente no elimina contenidos locales guardados legítimamente; la reproducción exacta verifica el acceso actual al destino y no revela información adicional de la fuente.
Las líneas base antiguas sin identidades estables de objetos guardadas o definiciones históricas requeridas de campos y variantes no pueden utilizarse para este flujo de trabajo controlado. Capture una nueva línea base completa en el origen en lugar de presentar definiciones actuales como históricas. Los casos de prueba rápidos y las variantes con una vinculación activa a datos de prueba están excluidos de este flujo de trabajo. Los contenidos o archivos no portables aparecen como bloqueadores en la vista previa; la selección confirmada no se aplica parcialmente. Windows puede utilizar los casos locales resultantes como casos de prueba ordinarios; la adopción y comparación controladas utilizan el cliente web.
Manejar nombres coincidentes¶
La decisión de nombre se aplica a nuevos objetos en la misma carpeta destino, por separado para unidades de prueba y casos de prueba:
- Importar: Cree una copia independiente con el mismo nombre; no se sobrescribe un objeto existente con ese nombre.
- Omitir: Omitir el objeto en conflicto. Para una unidad, esto omite todo su subárbol seleccionado, incluidos casos ya mapeados dentro de él.
- Renombrar: Use un nombre disponible con un sufijo como “(2)” o “(3)”. La vista previa muestra el nombre final.
Los mapeos de origen existentes se reconocen por identidad. Sus actualizaciones siguen decisiones individuales de cambio local; nombres coincidentes nunca establecen un mapeo. Un caso no portable seleccionado sigue siendo un bloqueo incluso con Omitir y detiene toda la adopción. Si el destino cambia después de la vista previa, revise una nueva vista previa.
Atributos, imágenes y límites¶
Los atributos portátiles incluyen texto libre y campos claramente definidos de texto de una línea o multilinea, enteros, fechas, casillas de verificación, listas de opción única o múltiple y campos HTML simples. Los campos requeridos se corresponden inequívocamente por nombre, tipo y definición guardada, o se crean localmente con los permisos de gestión necesarios. Los valores heredados efectivos al capturar se guardan como valores locales independientes sin herencia adicional. Las actualizaciones cambian específicamente los campos importados; los atributos locales adicionales se conservan.
Los valores de contraseña no se transfieren. Los campos SQL, botones, menús y tipos de campo de enlace están excluidos de este flujo de trabajo controlado. Las líneas base antiguas sin definiciones históricas completas requieren una nueva captura; las definiciones actuales nunca se sustituyen. Las imágenes en valores de atributos HTML y definiciones de variantes se copian independientemente cuando la vista previa confirma que son portables. Las imágenes en valores predeterminados de definiciones de atributos son actualmente un bloqueador explícito. Un bloqueador detiene toda la selección confirmada.
Abra desde Windows¶
En Windows, haga clic derecho en la unidad de prueba objetivo y elija Abra los estándares del proyecto en Web. El flujo de trabajo Web preselecciona ese destino. Su sesión autenticada de Windows existente lo conecta; si la transferencia falla, el inicio de sesión Web retiene el destino. La configuración de visibilidad a nivel de proyecto para entradas opcionales de Windows Web puede ocultar este elemento del menú. La adopción y comparación no tienen editor Windows separado; los casos locales resultantes permanecen como casos de prueba normales de Windows.
MCP y REST para adopción controlada¶
La capacidad de lectura es project.standards.read. ztm_project_standards_lookup devuelve opciones autorizadas con kind: sources, baselines, targets, items o units. Las líneas base requieren sourceProjectId; los casos y unidades históricas también requieren sourceBaselineId. Use skip para paginación; query está permitido solo para fuentes y destinos, y take (1–100) solo para casos y unidades. Las rutas del proyecto y los IDs de usuarios externos no son entradas.
ztm_project_standards_preview compara un conjunto seleccionado explícitamente sin guardar. Proporcione sourceProjectId, sourceBaselineId, su propio operationId, targetTestUnitId y items, cada uno con un sourceTestCaseId distinto. Cada caso puede establecer replaceLocalChanges, que por defecto es false; configúrelo a true solo después de revisar ese reemplazo específico. Opcionales namePrefix y nameSuffix están limitados a 100 caracteres cada uno. Use sourceTestUnitIds para seleccionar además unidades históricas con sus subárboles. Una selección solo de unidad aún requiere items como arreglo vacío. La selección ampliada está limitada a 200 casos y unidades combinados. conflictHandling acepta import (por defecto), skip o rename. La vista previa y el recibo incluyen además Containers; las vistas previas de casos exponen TargetPath y TargetTitle. La autorización general de escritura no decide la selección ni los reemplazos individuales.
Para aplicar, pase los mismos argumentos a ztm_project_action_prepare con capabilityId: project.standards.apply y su propio idempotencyKey. Revise la vista previa devuelta, luego confirme con ztm_project_action_commit, la misma capacidad y su previewToken. El recibo duradero identifica objetivos locales autorizados y revisiones aplicadas. Las repeticiones mantienen el mismo operationId y contenidos; los argumentos cambiados no se reproducen. Las identidades de destino que ya no son legibles permanecen ocultas en solicitudes repetidas.
El recibo registra quién aplicó la importación y cuándo (UTC). Para cada caso creado o actualizado, cuenta variantes copiadas y referencias de archivos (incluyendo imágenes en línea), y enlaces de requisitos fuente y dependencias omitidas de la copia. Recibos antiguos pueden omitir estos detalles.
ztm_project_standards_receipt lee el recibo guardado del usuario conectado mediante operationId sin reabrir la fuente. Los permisos actuales del destino filtran las referencias de destino; una operación faltante se reporta como no encontrada.
Las lecturas adicionales permiten actualizaciones posteriores:
| Herramienta | Uso |
|---|---|
ztm_project_standards_imported |
Enumere las normas locales legibles con opción targetTestUnitId, query, skip y take (1–200, por defecto 50). Se omiten las referencias ocultas a la fuente. |
ztm_project_standards_origin |
testCaseId: lea la procedencia local. El proyecto fuente, línea base y detalles del caso aparecen solo con acceso fuente actual; de lo contrario, permanece una indicación genérica de origen. |
ztm_project_standards_compare |
sourceProjectId, sourceBaselineId y 1–200 targetTestCaseIds distintos: comparan casos locales ya existentes con una línea base fuente seleccionada explícitamente sin escritura. La ausencia de esa línea base no significa automáticamente eliminación. |
Para una actualización dirigida, una entrada items puede contener adicionalmente targetTestCaseId. Ese caso local debe coincidir con su origen registrado; un ID de destino arbitrario no puede establecer una relación. Esto también permite abordar un caso local después de que haya sido movido. Revise la comparación y la decisión individual de reemplazo nuevamente antes de Preparar/Confirmar.
REST expone las mismas herramientas a través de POST /api/v1/operations/<tool-name>. Se aplican los permisos actuales del proyecto/objeto, los ámbitos de la clave API, las acciones de escritura habilitadas y las restricciones de demostración como en el cliente web; consulte Capítulo REST. Las operaciones disponibles dependen de la versión del servidor instalada.
Reanudar tras la terminación de un proceso¶
Para la adopción controlada de estándares, VistaDB modifica una copia completa temporal de la base de datos y reemplaza el archivo original solo después de la finalización exitosa. Esto requiere acceso disponible a la base de datos y espacio adicional en disco para toda la base de datos más los archivos y versiones importados. Si otro acceso mantiene la base de datos abierta, la aplicación lo informa; cierre ese acceso y reintente la solicitud.
Una terminación de proceso antes del reemplazo de archivo deja intacto el estado previo de la base de datos. Después del reemplazo, el cambio y el recibo se guardan; reintente con el mismo ID de operación para recuperar el resultado almacenado. Esta protección se aplica a la adopción controlada de estándares y no repara una base de datos ya dañada. Si persiste un conflicto de base de datos, pida a su administrador que inspeccione el estado tras realizar una copia de seguridad; no se realiza reparación automática.