Automatización de prueba de API

Studio admite proyectos de pruebas de automatización de API gracias a su integración con Postman, una herramienta de desarrollo de software para realizar llamadas de prueba a las API. Esta integración también incluye Newman, un ejecutador de recopilaciones de línea de comandos para Postman con el que ejecutar y probar una recopilación directamente desde la línea de comandos.

Para importar una colección de Postman a Studio, utiliza el asistente Nuevo servicio para bibliotecas y accede a la colección Postman utilizando una clave API general, que puedes generar en la sección Claves API.

Las recopilaciones importadas pueden usarse para proyectos de prueba. Más información sobre los requisitos previos de Postman, aquí.

En el contexto de prueba, las recopilaciones de Postman importadas en bibliotecas de Studio pueden publicarse como un paquete .nupkg localmente o en Orchestrator, y luego se instalan como dependencias en proyectos de pruebas de automatización.

Ejemplo de Automatización de pruebas de API

El siguiente ejemplo utiliza una recopilación de datos definidos en Postman, lo importa a una biblioteca de Studio, publica la biblioteca junto a la recopilación, la instala en un proyecto de prueba y utiliza actividades de prueba del paquete UiPath.Testing.Activities para verificar el uso de los datos.

Los casos de prueba están diseñados para un flujo de trabajo que solicita préstamos automáticamente y luego recupera sus datos para los clientes bancarios.

Para comprobar los requisitos previos de Postman y Newman, consulta esta página.

Define una Recopilación de datos

Define una recopilación de datos o importa una recopilación existente a tu espacio de trabajo actual en Postman. Creamos una recopilación de datos para solicitar préstamos, además de recuperar y borrar sus datos. Cuando se utiliza en un proyecto de pruebas de la API, dicha recopilación comprueba si la lógica de nuestro flujo de trabajo es correcta.

Importar Recopilaciones

Para importar una recopilación en Studio, crea un proyecto de biblioteca y utiliza la ventana Nuevo servicio. El acceso a la recopilación se otorga con la clave de la API de Postman. Añade esta clave al campo Archivo o Enlace y haz clic en Cargar.

Selecciona solo los puntos finales que te gustaría cargar en tu proyecto, y añade un nuevo Espacio para nombres si fuera necesario.

Comprueba la caja de Recopilaciones vinculadas para que se utilice un vínculo y se ejecute la versión más reciente de tu recopilación en el tiempo de ejecución, en lugar de una versión almacenada de forma local. Haz clic en Guardar cuando lo hayas hecho.

Utilizar Recopilaciones de datos

Una vez importada la recopilación en la biblioteca de Studio, sus puntos finales se transforman automáticamente en actividades, disponibles en la pestaña Actividades, bajo el espacio de nombres que hayas establecido previamente.

En nuestro ejemplo, hemos creado un archivo Secuencia independiente para cada actividad generada a partir de los puntos finales.

Tras añadir una actividad, añade el entorno de Postman (entre comillas "") en el panel Propiedades.

Los valores de los datos definidos en la recopilación de Postman se importan como Argumentos:

Las bibliotecas pueden publicarse de forma local o en Orchestrator como paquete .nupkg.

Carga una biblioteca en un proyecto de prueba de API

1. Crea un proyecto de prueba en Studio utilizando el tipo de proyecto Probar automatización.
   
   

   

   
   
2. Instala la biblioteca publicada como dependencia utilizando la ventana Administrar paquetes.
   
   

   

   
   
3. Los archivos de Secuencia definidos previamente en la biblioteca ya están disponibles en el panel Actividades bajo el espacio para nombres de la biblioteca, junto con las actividades generadas a partir de la importación de Postman.
   
   

   

   
   
4. Utiliza estas actividades en tu proyecto de automatización de pruebas de la API, combinado con actividades del paquete UiPath.Testing.Activities. Creamos un proyecto de prueba para verificar los datos introducidos al solicitar un préstamo en nuestra aplicación de prueba. Esta pequeña prueba utiliza un conjunto de variables codificadas, visibles aquí, en el panel Propiedades:
   
   

   

   
   

   Este sencillo proceso de prueba se utilizó como prueba de humo, para comprobar si la aplicación respondía adecuadamente. Pueden crearse varias pruebas de este tipo en Studio, dependiendo de tus necesidades de automatización.

5. Para verificar varios escenarios en un proyecto de prueba, ve a la cinta, Nuevo > Caso de prueba basado en datos. Importa el conjunto de datos, tal y como se explica aquí. A continuación se muestra un ejemplo de un caso de prueba parecido. Ahora los valores se almacenarán en los argumentos, asignados en la actividad.
   
   

   

   
   
6. Selecciona Ejecutar archivo o Depurar archivo con variaciones de datos y escoge los datos a utilizar. Esto es útil a la hora de probar varios escenarios con múltiples conjuntos de datos.
   
   

   

   
   

7. Una vez ejecutado el proceso, los resultados serán visibles en el panel Salida.

   
   

   

   
   

Usar un archivo o enlace Swagger

Este ejemplo muestra cómo realizar la automatización de pruebas de API cargando un archivo JSON de Swagger en Studio o un enlace de Swagger.

Requisitos previos

Para seguir este ejemplo, debes tener uno de los siguientes recursos disponibles:

• Un archivo JSON exportado desde Swagger, que se encuentra en tu máquina.
• Un enlace a un archivo Swagger.

Pasos

1. En tu proyecto de biblioteca, desde la cinta Diseño , selecciona Nuevo servicio.

   Se mostrará la ventana Editor de servicios .

2. Elija un recurso de Swagger que desee utilizar:
   • Para un archivo JSON Swagger local, selecciona el menú Más opciones junto al campo Archivo o Enlace . Busca y abre el archivo Swagger deseado para importar.
   • Si utilizas un enlace a un archivo Swagger, introduce el enlace Swagger directamente en el campo Archivo o Enlace .
3. En el Editor de servicios, selecciona Cargar.

   Todos los puntos finales definidos desde el archivo Swagger ahora se cargan en el Editor de servicios.

4. Escriba el método u operación que necesita en el cuadro de búsqueda Operaciones de búsqueda y vea los resultados devueltos.

   Para los archivos Swagger, los métodos están marcados con diferentes colores para cada punto final que quieras cargar.

   El espacio de nombres se genera automáticamente, pero puedes editarlo.

5. Selecciona Guardar para integrar el servicio en tu biblioteca.

Figura 1. Un archivo Swagger cargado en el Editor de servicios