Una vez que haya construido el escenario de prueba, puede ejecutarlo para generar un informe de prueba.Seleccionar el método de ejecución adecuado#
Apidog proporciona múltiples formas de ejecutar escenarios de prueba, adecuadas para diferentes requisitos de prueba.Este método se inicia desde una máquina local y es adecuado para pruebas rápidas a pequeña escala. Es particularmente eficaz cuando el desarrollo y las pruebas se realizan simultáneamente, lo que permite la supervisión en tiempo real y ajustes inmediatos.Ideal para gestionar datos a gran escala o escenarios iterativos, este método ofrece una mayor velocidad de ejecución. Puede ejecutarse sin conexión, lo cual es adecuado para entornos con recursos restringidos o que no requieren una interfaz gráfica de usuario.Este estilo de ejecución está integrado dentro del pipeline de CI/CD, lo que lo convierte en una excelente opción para procesos de integración automatizada y despliegue continuo. Es especialmente útil en entornos donde las pruebas se ejecutan con frecuencia para confirmar la estabilidad de las API después de cada actualización de código.4.
Ejecución con runner self-hosted:
En los escenarios de prueba, si se utilizan variables de entorno/globales, los valores reales de estas variables pueden diferir según el método de ejecución elegido, lo que podría producir resultados de prueba inconsistentes. Más información. Primeros pasos#
1
Vaya al escenario de prueba deseado y seleccione el entorno en el que desea que se ejecuten las peticiones.
3
Verá un informe de prueba que muestra información como la tasa de aprobación, el tiempo de ejecución y otros datos de la ejecución actual. Puede expandir cada petición para ver validaciones y aserciones.
4
Haga clic en "more" para inspeccionar los detalles reales de la petición y la respuesta.
Opciones de ejecución en escenarios de prueba#
Al ejecutar un escenario de prueba en Apidog, se pueden configurar varios ajustes y opciones para adaptar la ejecución de la prueba a requisitos específicos.A continuación, exploramos los aspectos críticos de estos ajustes:Entorno#
Especifique el servicio (URL base) al que deben dirigirse las peticiones del escenario y el conjunto de variables que se utilizará. Obtenga más detalles en entornos y servicios.Tenga en cuenta que las peticiones personalizadas tienen su propia URL completa y NO se dirigirán al entorno establecido en este contexto, a diferencia de los pasos importados.Datos de prueba#
El escenario de prueba admite la importación de conjuntos de datos de prueba externos. Cuando se ejecuta el escenario de prueba, el sistema recorrerá todos los conjuntos de datos del archivo de datos y asignará los datos de los conjuntos de datos a las variables correspondientes; consulte pruebas basadas en datos para obtener más detalles.Iteraciones#
Configure el número de veces que todos los pasos dentro del escenario se ejecutarán en un bucle.Si hay una cantidad significativa de datos que procesar, se recomienda utilizar Apidog CLI para la ejecución en lugar del cliente de Apidog, con el fin de optimizar el rendimiento.Hilos#
Ejecute todos los pasos en varios hilos, donde los datos entre hilos permanecen aislados para evitar interferencias.Tenga en cuenta que esta función está en Beta y puede requerir una mayor optimización del rendimiento. Para pruebas de carga rigurosas, se recomienda utilizar la funcionalidad de prueba de rendimiento en su lugar.
Los hilos no son compatibles con la CLI.Se ejecuta en#
La máquina que realmente consume recursos de hardware para ejecutar escenarios de prueba. Todas las peticiones iniciadas en los escenarios de prueba se enviarán desde la máquina especificada aquí. Por lo tanto, las diferencias en el entorno de red de la máquina solicitante pueden dar lugar a resultados de prueba variables.Este ajuste no se guardará como parte de la configuración de ejecución del escenario de prueba. Cada vez, se utilizará de forma predeterminada la máquina local para ejecutar los escenarios de prueba. Además, este ajuste no tendrá efecto durante ejecuciones por lotes o ejecuciones de CLI. En estos casos, las peticiones se iniciarán utilizando los recursos de la máquina actual.
Notificaciones#
Al habilitar esta función, se enviarán notificaciones a los destinatarios especificados una vez que el escenario de prueba manual se haya completado. La notificación incluirá una descripción general de los resultados de la prueba y un enlace al informe detallado. Puede configurar si desea enviar la notificación tan pronto como finalice la prueba o solo cuando se produzca un fallo, lo que ayuda a minimizar alertas innecesarias. Consulte ajustes de notificación para obtener información más detallada.Compartido#
Al habilitar la opción "Share" en el lado derecho de Advanced Settings, el informe de prueba generado después de cada ejecución del escenario de prueba se compartirá automáticamente con otros miembros del proyecto. Puede ver todos los informes de prueba que se han compartido dentro del equipo en la pestaña Shared de la sección Test Reports. Consulte informes de prueba para obtener más detalles.Ajustes avanzados#
En caso de error#
Configure cómo debe gestionar la prueba los errores, que pueden incluir fallos de aserción, fallos de validación de formato de datos, errores del servidor, etc. Las opciones son:Ignorar: continuar ejecutando el siguiente paso cuando se produzca un error (ajuste predeterminado).
Continuar: finalizar la iteración actual e iniciar la siguiente cuando se produzca un error.
Finalizar ejecución: detener toda la ejecución cuando se encuentre un error.
Retraso#
Establezca una pausa entre el envío de cada paso para gestionar y controlar la velocidad de ejecución.Guardar peticiones/respuestas#
De forma predeterminada, Apidog guarda cada petición y respuesta. En casos en los que las peticiones o respuestas sean significativamente grandes (potencialmente varios MB), podrían ocupar un espacio considerable en disco. Puede habilitar esta opción para no guardar cada petición y respuesta, sino guardar solo los resultados de aserción y validación.Como alternativa, puede optar por guardar solo las peticiones y respuestas fallidas para conservar espacio.Mantener valores de variables#
Esta opción está habilitada de forma predeterminada, lo que garantiza que el valor actual de las variables globales y de entorno, cuando se modifiquen durante la prueba, conserve el último resultado modificado. Si esta opción está deshabilitada, las variables globales y de entorno no cambiarán después de la ejecución de la prueba; conservarán el valor que tenían antes de la ejecución.Las variables locales no se ven afectadas por este ajuste y se borrarán después de cada ejecución.Ejecutar con cookies almacenadas#
En la esquina inferior derecha de Apidog, el icono Cookies conduce a la gestión de cookies. Apidog guarda automáticamente las cookies al realizar peticiones de API. Si desea utilizar las cookies guardadas durante la ejecución del escenario de prueba, habilite esta opción.Guardar cookies después de la ejecución#
De forma similar a lo anterior, si desea actualizar las cookies guardadas después de ejecutar un escenario de prueba, habilite esta opción.Al configurar estos ajustes avanzados en Apidog, puede ajustar con precisión sus ejecuciones de prueba para satisfacer sus necesidades de prueba específicas, garantizando ejecuciones de prueba eficientes y precisas.Ajustes de tiempo de ejecución en el modo de diseño de escenarios de prueba#
Si se encuentra en el modo de diseño de escenarios de prueba, las configuraciones de tiempo de ejecución relevantes están contraídas en el lado derecho del botón "Run". Pase el ratón sobre este botón de ajustes para ver las configuraciones detalladas de tiempo de ejecución de este escenario de prueba.Ejecutar pruebas funcionales#
Después de ejecutar pruebas funcionales, se le dirigirá a la página de ejecución del escenario de prueba. El gráfico circular de la imagen siguiente proporciona una visión general de los resultados de la prueba, actualizándose en tiempo real a medida que se ejecuta el escenario de prueba. Debajo del gráfico circular, encontrará los pasos de prueba detallados que se están ejecutando, con el estado de cada paso mostrado durante la ejecución.Una vez que se complete la ejecución de la prueba funcional, puede hacer clic en el endpoint correspondiente para ver sus métricas y estado durante la prueba. Esto incluye el nombre del endpoint, el método de petición, la URL de la petición, el código de estado de la respuesta, el tiempo de respuesta, el contenido de la respuesta, la validación de datos y los resultados de aserción. Para obtener más detalles, consulte informes de prueba.Reglas para usar variables de entorno/globales en diferentes métodos de ejecución#
Las variables de entorno y globales son persistentes, lo que significa que pueden guardarse para uso a largo plazo en varias ejecuciones o diferentes escenarios de prueba. Sin embargo, los valores reales de las variables utilizadas pueden variar según el método de ejecución seleccionado. Por ejemplo:Si un escenario de prueba utiliza una variable de entorno Token, podría ejecutarse correctamente dentro del cliente, pero fallar cuando se ejecuta mediante un Runner self-hosted porque el valor de Token es incorrecto.Esta discrepancia puede ocurrir porque el valor real de la variable de entorno Token se toma del valor almacenado localmente dentro del cliente durante la ejecución. Sin embargo, al ejecutarse en un Runner self-hosted, el Runner no tiene el mismo Token almacenado localmente, lo que provoca un fallo.Para abordar este problema, Apidog proporciona un conjunto de reglas para gestionar los valores de la variable de entorno/global en diferentes métodos de ejecución:| Método de ejecución | Uso de variables de entorno/globales | Ubicación de almacenamiento de variables |
|---|
| Local (Client, Web) | Utiliza los valores actuales de las variables de entorno/globales para la ejecución. | Almacenados localmente. Pueden modificarse manualmente o actualizarse mediante pre/post procesadores. Visibles en Environment Management > Environment/Global Variables > Current Values. |
| CLI, CI/CD | Para ejecución en línea en tiempo real:- Utiliza los valores iniciales de las variables de entorno/globales para la ejecución (predeterminado).
- Especifique el uso de valores de variables de entorno/globales almacenados en un archivo en la máquina que ejecuta el escenario de prueba mediante la opción
--variables path. Más información.
Para ejecución con datos exportados:- Utiliza los valores de variables de entorno/globales incluidos en el archivo exportado para la ejecución.
| - Los valores iniciales se almacenan en Apidog Cloud y solo pueden modificarse manualmente dentro del cliente.
- Almacenados en el archivo especificado por la opción
--variables path, lo que permite la modificación manual o actualizaciones mediante pre/post procesadores. - Almacenados en el archivo exportado. Pueden modificarse manualmente o actualizarse mediante pre/post procesadores.
|
| Self-hosted Runner | - Utiliza los valores iniciales de las variables de entorno/globales para la ejecución (predeterminado).
- Utiliza los valores almacenados localmente dentro del Runner para la ejecución. Más información.
| - Los valores iniciales se almacenan en Apidog Cloud y solo pueden modificarse manualmente dentro del cliente.
- Almacenados dentro del Runner especificado. Pueden modificarse manualmente o actualizarse mediante pre/post procesadores. Visibles a través de la interfaz de usuario del producto o en el archivo dentro del Runner en
/opt/runner/variables.
|
Ejecutar escenarios de prueba con endpoints de otros proyectos#
Cuando un escenario de prueba incluye endpoints importados de otros proyectos, las URL de petición de estos endpoints durante la ejecución se determinan mediante la configuración que establezca en Environment associations.Si el "Develop Env" del proyecto actual está asociado con el "Prod Env" de otro proyecto, al ejecutar el escenario de prueba usando "Develop Env", el endpoint importado se enviará a la URL de "Prod Env". Todos los demás endpoints utilizarán la URL de "Develop Env" del proyecto actual.Implementar varias pruebas#
Los pasos mencionados representan la ejecución básica de un escenario de prueba. Al configurar escenarios de prueba, puede incorporar varios ajustes avanzados para satisfacer diversos requisitos de prueba.Pruebas basadas en datos: Realice pruebas usando diversos conjuntos de datos para validar el comportamiento del sistema en varios escenarios. Pruebas de rendimiento: Evalúe el rendimiento del sistema bajo condiciones de carga variables para valorar la escalabilidad y la capacidad de respuesta. Tareas programadas: Establezca planes estructurados que detallen el alcance, el enfoque y el calendario de las actividades de prueba. Integración CI/CD: Automatice los procesos de compilación, prueba y despliegue para garantizar lanzamientos de software fiables y frecuentes. 
