Saltar al contenido
Engineer
Menú
Diseño
Español

Engineer / Glosario

Criterios de aceptación

condiciones para dar por válido un cambio concreto

Qué es

Los criterios de aceptación son las condiciones que debe cumplir un cambio concreto para que pueda darse por válido. Describen qué se podrá observar en unas circunstancias determinadas. «Enviar una confirmación de la cita» nombra una función. «Al reservar una cita disponible, la confirmación presenta la misma referencia y hora de inicio que el registro de reserva» permite comprobar parte del comportamiento y deja abierta la forma de generar esa confirmación.

El manual de servicios digitales del Gobierno británico describe los criterios de una historia de usuario como una lista de resultados con la que verificar que el servicio ha cumplido su cometido. La historia explica quién necesita el servicio y para qué. Los criterios concretan el acuerdo para que se pueda discutir, implementar y verificar. También pueden cubrir una ruta de error, el acceso mediante teclado o una restricción operativa, siempre que sean pertinentes para aceptar ese cambio. Las distintas condiciones pueden requerir distintas pruebas.

Conviene separar varios documentos. Una especificación puede definir requisitos comunes a muchos cambios. Un caso de prueba describe una ejecución que aporta evidencia de uno o varios criterios. La Definición de Terminado de Scrum recoge las medidas de calidad que debe cumplir el trabajo de un Incremento. Los criterios de aceptación aclaran el comportamiento de un cambio particular. Un equipo puede exigir acceso con teclado para cualquier elemento interactivo y concretar, para un selector de fechas nuevo, que la persona pueda elegir y revisar una cita usando solo el teclado.

Por qué importa

Un criterio útil saca a la luz una discrepancia cuando todavía es fácil cambiar de rumbo. Para la persona responsable del servicio, una cita puede estar reservada en el momento en que existe el registro. Para quien pide la cita, puede no estarlo hasta que llegue un correo. Atención al público quizá necesita una referencia para contestar si ese correo se pierde. Son resultados diferentes. Decidir cuándo se muestra el éxito y qué ocurre si falla el proveedor de correo evita que la discrepancia aparezca por primera vez en producción.

Los criterios marcan qué hay que observar. Una persona puede revisar la pantalla de confirmación y otra interrumpir de forma controlada el envío de mensajes. Las dos saben qué buscar. Un requisito de accesibilidad quizá necesita recorrer los controles con el teclado además de una comprobación automática. Un límite de tiempo necesita un entorno conocido y una carga de referencia. «El sistema será rápido» permite varias interpretaciones incompatibles.

Las normas y las obligaciones legales se siguen aplicando aunque no se copien en la historia. Describe cómo se aplica una norma al componente nuevo si sin esa precisión habría que adivinar la respuesta. Para un calendario, puede bastar con indicar qué acciones deben completarse con el teclado y citar el estándar de referencia. Así el criterio queda acotado sin perder de vista al público que depende de ese uso.

Cómo se aplica en la práctica

Imaginemos un servicio que permite reservar una cita y recibir un mensaje de confirmación. El borrador dice «se reserva la cita y se envía un correo». La persona que gestiona el servicio, quien lo desarrolla y quien prepara la verificación pueden discutir tres intentos concretos. Son ejemplos ilustrativos. Las condiciones definitivas corresponden al equipo responsable del servicio.

  • Si hay una cita libre a las 14:00 en la zona horaria indicada, se crea una sola reserva confirmada. Su referencia, fecha y hora aparecen en pantalla y coinciden con el registro.
  • Si alguien ocupa ese mismo hueco antes de que se procese la petición, se indica que la cita ya no está disponible y se ofrece volver a los horarios libres. No aparece una reserva adicional para el hueco ocupado.
  • Si falla el envío después de confirmar la cita, la reserva permanece activa. La pantalla sigue mostrando la referencia y el fallo queda visible para quien deba gestionarlo.

Cada ejemplo señala el estado previo, la acción y un resultado comprobable. Gherkin les da una forma conocida con Dado, Cuando y Entonces. Puede facilitar la lectura y el uso de pruebas automáticas. Para una modificación pequeña también sirve una lista breve. En ambos casos conviene precisar qué referencia se coteja y desde dónde se observa el resultado. Ver que un correo salió de una cola no acredita que haya llegado.

El primer intento se hace en la pantalla real. El segundo exige controlar el orden de las solicitudes. Para el tercero se provoca el fallo después de confirmar la transacción. Si se anotan esas circunstancias y lo observado, otra persona podrá repetir la verificación. Nuestra declaración de accesibilidad ofrece un ejemplo relacionado. Describe pruebas con el teclado y señala qué se observó y qué necesita más revisión. Un criterio de uso debería permitir registrar evidencia de ese nivel de detalle.

Dónde surgen los problemas

Las expresiones vagas aplazan la discusión. «Se gestiona el error de forma adecuada» deja abierta la respuesta ante un fallo. Especifica cuándo aparece el mensaje, qué indica, qué acción queda disponible y qué efecto no debe producirse. En la reserva, una captura que muestra el aviso no basta para saber si se conservó el registro. Hay que mirar también el estado de la cita.

Otro problema es convertir una opción técnica en el criterio antes de justificarla. «Usar la cola nueva» puede ser una decisión de arquitectura válida. A quien espera el correo le interesa saber qué ocurre durante el retraso. Documenta la elección técnica donde se puedan explicar sus motivos y redacta la condición con el comportamiento observable. Si una integración externa exige un protocolo concreto, cita el requisito y aclara dónde se aplica.

En el extremo opuesto, una lista puede acabar abarcando toda una versión. Divide el trabajo por resultados y conserva junto a cada uno su ruta de error importante. Acuerda qué reglas son comunes y quién verifica el cambio particular. Si un ensayo muestra que falta una condición, registra la razón del cambio en el criterio y repite las verificaciones afectadas. La siguiente persona podrá saber qué se había acordado y qué queda abierto.

Lecturas adicionales

Contacto

¿Aún está definiendo lo que necesita?

Cuéntenos qué está fallando o qué intenta construir. Le diremos qué haría falta, cuánto costaría aproximadamente y si somos las personas adecuadas.

Desde 1.400 DKK por hora, sin IVA; y un precio por hora menor en una contratación más larga.

welcome@engineer.company +45 50 10 61 84 Copenhague, Dinamarca