KEPLIN Docs

El proyecto de pruebas

Qué son las pruebas de una app, dónde viven, cómo se ejecutan sin tocar los datos reales, y el minitab Pruebas.

Cada app tiene su proyecto de pruebas: un conjunto de pruebas automáticas que dice, tras cada cambio, si lo que funcionaba sigue funcionando. Una prueba es una lista de pasos, como abrir una pantalla, rellenar un campo, pulsar un botón y verificar lo que aparece, y se construye como el resto de la plataforma: arrastrando y eligiendo.

Hay cuatro tipos de prueba, y una prueba puede mezclar pasos de todos:

Tipo Qué verifica Ejemplo
Pantalla El recorrido de quien usa la app: abrir, rellenar, hacer clic, ver. Crear una cuenta nueva y ver la fila en la tabla.
API Una operación GraphQL de la app: la respuesta, el tiempo, el efecto en los datos. getContas devuelve solo cuentas de Industria, en menos de 500 ms.
Script La ejecución de un script: lo que devuelve y lo que escribe. El script de sincronización crea tres contactos.
Workflow El recorrido de un proceso: tareas, decisiones, notificaciones. Una solicitud de más de 10 días va a la dirección y, aprobada, avisa a quien la pidió.

El minitab Pruebas, con las pruebas por carpeta y el resultado de la última ejecución de cada una
El minitab Pruebas, con las pruebas por carpeta y el resultado de la última ejecución de cada una

Dónde viven las pruebas

Las pruebas forman parte de la app, como las pantallas y las APIs:

  • están en cada versión de la app, y se fusionan con los demás cambios en el merge (ver Historial y merge);
  • aparecen en el historial de la app, con quién las cambió;
  • viajan en la exportación de la app y entran en las plantillas;
  • tienen checkout, como los demás documentos: dos personas no guardan la misma prueba a la vez.

Lo que queda solo en esta instalación son los resultados de las ejecuciones (guardados 30 días).

Cómo se ejecutan sin tocar los datos reales

Cada prueba se ejecuta en un entorno de prueba nuevo, creado para ella y eliminado al final:

  • Las bases de datos son copias de prueba. Una base interna de la app empieza con la misma estructura que la real, sin filas, y recibe los datos de prueba. Lo que una prueba guarda no llega a la base real ni a la prueba siguiente.
  • Las cuentas son las que elija en el entorno de prueba, una por rol, entre las cuentas de la app. Una prueba sin rol es un visitante, sin sesión, y solo ve lo que es público.
  • Los correos y las notificaciones quedan retenidos en la prueba, para que la prueba los verifique, y nunca salen.
  • Las peticiones HTTP de las APIs y de los workflows reciben las respuestas simuladas del entorno de prueba, y nunca salen a la red.
  • Los errores que provoca una prueba no aparecen en el Radar ni generan alertas.

Atención

Una base de datos externa con escritura (la base de un ERP, por ejemplo) no se copia: las pruebas usan otro datasource de la app, el datasource de prueba, que se elige en el entorno de prueba. Mientras falte, ninguna prueba de la app se ejecuta. Ver El entorno de prueba.

El minitab Pruebas

Las pruebas están en el minitab Pruebas del árbol de la app, entre Datos y Radar. Los minitabs muestran solo el icono: pase el ratón por encima para ver el nombre.

El panel tiene:

  • Pruebas: las pruebas por carpeta, cada una con el resultado de la última ejecución (verde superada, rojo falló, vacío aún no se ejecutó). Para cambiar una prueba de carpeta, arrástrela a la carpeta.
  • Datos de prueba: los conjuntos de filas que cargan las pruebas.
  • Ejecuciones: las ejecuciones recientes; abrir una muestra el resultado.
  • Inestables: las pruebas que se superan y fallan alternadamente.

Arriba están la búsqueda, Nueva prueba, Nueva carpeta de pruebas, Entorno de prueba y Ejecutar todas las pruebas.

Preguntas frecuentes

¿Por qué aparece «Las pruebas no se ejecutan»? La app tiene una base externa con escritura sin datasource de prueba. Abra el Entorno de prueba y elíjalo, o pídaselo a un administrador.

¿Una prueba puede estropear los datos reales? No. Las pruebas escriben solo en las copias de prueba. La única base real que lee una prueba es una base externa en Solo lectura, y en esa la plataforma rechaza cualquier escritura.

¿Quién puede escribir y ejecutar pruebas? Quien tiene el perfil Developer en la app. El entorno de prueba solo lo cambia un administrador.