KATALON STUDIO Inteligent Test Automation

Este documento es para apoyar a comprender la herramienta de automatización KATALON, ayudando

al usuario a comprender el funcionamiento de la herramienta brindando algunos consejos para la
automatización de procesos en una aplicación WEB.

Para empezar a automatizar, primero hay que conocer un poco la herramienta que vamos a utilizar
para ello aclaro dos puntos o dudas que podrían surgir al respecto:

1. - Que es KATALON?

2. - Que requisitos necesita para operar?

1. - Katalon Studio es una herramienta gratuita para automatización de tests sobre aplicaciones
web y moviles, katalon está construida sobre Selenium y Appium y ofrece un entorno construido
sobre Eclipse para automatizar las pruebas.

La herramienta permite la grabación de una navegación sobre los principales navegadores (Chrome,
Firefox, IE, Edge) generando un código en Groovy muy sencillo de retocar, básicamente elegir el
método adecuado del la clase WebUI, los Tests generados crean un objeto para cada elemento con el
que interacciona de modo que se pueden editar sus propiedades (id por ejemplo).

2.- Los requisitos mínimos para que funcione correctamente son los siguientes:
Operating
Windows 7, Windows 8, Windows 10, macOS 10.11+, Linux (Ubuntu based)
System

CPU
Procesador a 1 GHz o más rápido de 32 bits (x86) o de 64 bits (x64)

Mínimo: 1 GB RAM (32-bit) o 4 GB RAM (64-bit)

Memory
Recomendado: 4 GB RAM (32-bit) o 8 GB RAM (64-bit)

Al menos 1 GB de espacio disponible en el disco duro. Se requiere espacio de

Hard Drive
disco adicional dependiendo del código fuente del proyecto y los informes de
ejecución generados.

Bien, teniendo en cuenta lo anterior, podemos comenzar a utilizar esta herramienta y practicar lo que
es la automatización de test de manera fácil y sencilla.

Primero que nada, hay que tener la herramienta instalada en el equipo que utilizaremos para
practicar, para facilitarte las cosas a continuación te dejo la liga para descargar la herramienta.

www.katalon.com

NOTA: La pagina pedira al usuario crear una cuenta para poder descargar la herramienta, recomiendo
crear la cuenta ya que la necesitaremos para poder ejecutar la herramienta por primera vez.

Una vez instalada abrimos la herramienta, nos pedira ingresar la cuenta que anteriormente creamos
al descargar KATALON, esto es para estar informando al usuario cuando liberen una nueva version, ya
que esta en constante desarrollo.

Al haber ingresado las credenciales correspondientes debera mostarte el homeboard de la aplicacion.

El cual mostrara un pequeño tutorial de 3 pasos indicando las opciónes rapidas para comenzar a
grabar nuestro test:

1.- Que opción permite grabar la pantalla.

2.- Que opción permite ejecutar nuestro test grabado

3.- Donde podremos observar nuestro log de ejecución

Para esto primero necesitaremos crear un proyecto, si no, donde vamos a guardar nuestros test
automatizados? bueno a continuación explicare como crear un nuevo proyecto dentro del cual
tendremos un archivo donde quedaran registrados nuestros scripts de automatización.

Crear un Proyecto nuevo

Para iniciar una grabación en cualquier navegador de tu elección (Recomiendo Chrome), primero hay
que crear un proyecto nuevo en el cual estaran archivados nuestros test automatizados, es muy
sencillo, solo hay que seleccionar en el menu superior la opción "File", se desplegará el menu de
opciónes donde seleccionaremos "New", dentro de este Submenu encontrarás la opción "Project"

Una vez seleccionado la opción nuevo proyecto, se mostrara una pantalla modal en la cual tendremos
que ingresar los datos generales del proyecto como "Nombre", "Tipo", "Localización", "Descripción",
etc...

Asignamos un nombre de su preferencia, seleccionamos el tipo el cual debera tener seleccionado por
default la opción "Generico", preguntaran por que no seleccionamos el tipo "API/Web service"?
porque no estaremos usando una aplicación agena a katalon como las extenciones de los
navegadores, se pueden usar sin ningun problema pero es recomendable mantener el proyecto de
tipo generico ya que de esta manera permite usar tambien aplicaciones externas a katalon, volviendo
a la pantalla de datos generales del proyecto, ingresamos la ubicacion del proyecto e ingresamos una
descripcion que facilite comprender en que consiste el script de automatización y seleccionamos
"OK".
NOTA: Se recomienda crear una carpeta en una ubicación de facil acceso en el PC como el escritorio
para guardar los proyectos creados, la carpeta debera estar nombrada de manera que no tenga
acentos o caracteres especiales, de lo contrario katalon no podra ejecutar tus test automatizados
porque no podra ubicar la carpeta.

Una vez creado nuestro proyecto, podemos dar marcha a la automatización, ahora si, seleccionamos
la opción "Record web" en la parte superior de la pantalla.

Al seleccionar esta opción se abrira una pantalla modal donde nos permitira agregar la URL sobre la
cual queremos trabajar, mostrara la opción que permite elegir el navegador de nuestro agrado,
mostrara tambien el grid donde se estara registrando cada accion que ralice el usuario y la opción
"Run" la cual inicia el proceso de grabacion de pantalla.
Al haber ingresado la URL y seleccionado el navegador de nuestro agrado presionamos la opción
"Run", al hacer esto se debera abrir una pantalla mostrando la pagina web ingresada, es aqui donde
inicia la automatización.

Cada accion que realicen en el navegador abierto por katalon quedara registrado en el log de
grabacion, un clic, el ingreso de datos dentro de un campo, la seleccion de algun botón.
NOTA: Se recomienda tener cuidado con las acciones que realiza, es necesario tener muy bien
definido que es lo que queremos probar para tratar de mantener el script lo mas sencillo posible y
evitar tener que depurar el test de acciones innecesarias.

Una vez verificado en el log de grabación que se registraron correctamente las acciones que
realizamos precionamos la opción "OK", deberá mostrarse la pantalla con los elementos capturados
de la pantalla web y el folder donde quedara archivado nuestro test, presionamos "OK" nuevamente.
Al presionar "OK" mostrara un modal donde ingresaremos los datos generales de nuestro test,
"Nombre" y "Descripción", al haber ingresado estos datos seleccionamos la opción "OK".

Al realizar esta acción guardara nuestro test permitiendo modificar los registros (acciones) de nuestro
test , se recomienda ejecutar nuestro test sin realizar ninguna modificación para detectar los campos
que neceistan modificación o alguna corrección dentro de los parametros o Xpath, seleccionamos la
opción "Run" en la parte superior de la pantalla para poder correr nuestro script de automatización.

Al seleccionar la opción "Run" deberá ejecutar el script y te mostrara en la pantalla el progreso de la

ejecución, el log de estatus sobre cada paso o acción realizada por el bot.
Si la ejecución finaliza sin ningun error deberá mostrar el mensaje de test finalizado de manera
correcta y listo, has creado tu primer test automatizado.
Katalon tambien te muestra el script si te gusta la programación, una vez generado el test
automatizado solo selecciona la opción "<> Script" que se muestra sobre el log de progreso.

Aun no te apresures, con forme vallas realizando pruebas surgiran algunas incognitas las cuales con
un poco de invesigación se solucionan, pero guarda la calma, te dejare algunos escenarios o consejos
que me han servido con algunos elementos que podrian provocar que tu test automatizado se
detenga, estos son las incognitas mas comunes con los cuales te toparas.
Consejos.

1.- Elemento con Xpath incorrecto

Al toparte con un elemento que no detecte el bot, primero que nada recomiendo revisar el Xpath del
elemento en tu log de acciones, solo hay que dar clic derecho sobre el elemento que provoca que el
bot se detenga y seleccionar la opción para abrir el elemento, es la ultima del menu de opciónes
(Open Input).

Al seleccionar esta opción se mostrara la pestaña del elemento donde mostrara los atributos con los
que este cuenta.
Ahora seleccionas la opción atributos, de esta manera se mostrarán las propiedades del elemento,
buscamos en las propiedades "Xpath" y seleccionamos el campo, esto habilitara el campo para poder
ingresar el Xpath que necesitamos y seleccionamos el check de la propiedad xpath para que se
ejecute en el test correctamente.

Como obtener el Xpath del elemento que necesitamos? es muy sencillo, en la pantalla web sobre la
que queremos aplicar automatización damos clic derecho sobre el elemento que nos causa problemas
( esto en caso de usar el navegador Chrome, varia dependiendo del navegador) y seleccionamos la
opción inspeccionar elemento.
Al seleccionar "Inspeccionar" se abrira en una ventana lateral del navegador, el codigo HTML del
portal web con el cript del elemento seleccionado.

Al dar clic derecho sobre el script del elemento seleccionado se abrira un pequeño menu donde
buscaremos la opción "Copy" la cual desplegara un submenu donde buscareos la opción "Copy XPath"
y listo, este es el xpath del elemento para modificar el atributo en el test de automatización.
2.- No detecta una opción dentro de un menú desplegable
Este escenario es muy comun con los elementos tipo dropdown o desplegables, por que pasa esto?
Pues por que como el bot de automatización trabaja de manera instantanea no da tiempo a que el
elemento se despliegue completamente, para cuando el elemento finaliza la animación el bot ya
intento dar clic en la opción, pero como no logro encontrarla detiene el ciclo y marca como error
dicha acción, la solucion es mas sencilla de lo que parece, solo hay que agregar un delay de 1 o 2
segundos en el log de acciones de nuestro test y listo.... Que si como se hace eso? muy sencillo.

Seleccionamos la opción "Add" que se muestra sobre el log de acciones de nuestro test, si tenemos
seleccionado un elemento en nuestro log, el nuevo registro se agregara justo debajo del elemento
seleccionado, podremos desplazarlo usando las opciónes "Move UP" o "Move Down", las cuales
sirven para dar orden a nuestro log de acciones.
Ahora solo seleccionas la opción delay dentro del select o escribes Delay y se mostrara el elemento,
presionamos enter y listo, se agrega el nuevo elemento.
Una vez agregado el delay, damos doble clic sobre la columna input, debera mostrarnos una pantalla
con las propiedades del elemento, la cual nos permitira ingresar el tiempo que dura este delay,
ingresar caracteres numericos y seleccionar la opción "OK" y listo delay agregado.

Esto soluciona el problema de los elementos tipo dropdown o menu desplegable.

3.- Elemento "Datepicker" no es grabado o no lo detecta katalon

Esto sucede ya que los elementos datepicker representan mas de una acción, una para abrir el
elemento y otra para seleccionar el dia, mes o año, dependiendo de la selección lleva 2 o 3 acciones
como mínimo, katalon solamente lo toma como una accion, es por eso que al capturareste tipo de
elementos, hay que agregar los paso extra que conlleva el seleccionar un datepicker.

Para agregar un paso a un test que ya fue grabado es necesario usar la opción "Spy Web", esta opción
te permite guardar o capturar un objeto y poderlo agregar a un test ya automatizado.

Al seleccionar la opción "Spy Web" se abrira una pantalla similar a la de grabacion de pantalla, solo
que esta tiene una funcion diferente.
Se muestra el campo para ingresar la "URL" y el botón "Start", tambien muestra un grid donde se
registra o graba el elemento que queremos guardar.

Al seleccionar la opción start comenzara a registrar solamente aquellos elementos que tu asi lo
requieras, esto es posible seleccionando la conbinación de teclas que muestra en la parte superior de
la pantalla, las cuales pueden ser editadas al gusto del usuario en la ruta: Window > Katalon studio
preferences > Katalon > Object Spy.
Una vez capturado el objeto cerramos el navegador abierto por nuestra herramienta katalon y se
debera mostrar capturado el elemento seleccionado.

Una vez capturado el elemento, seleccionamos la opción "Save", esto abrira una ventana
mostrandonos el repositorio de elementos que tenemos, ahi podremos elegir donde queremos
guardar este nuevo elemento y presionamos "OK" y cerramos la ventana de "Spy Web".
NOTA: Se recomienda guardar el elemento en el folder donde estan guardados los elementos del test
que estamos usando actualmente.

Para agregar el elemento que hemos capturado solo agregamos un nuevo registro en el log de
acciones de nuestro test e ingresamos la acción "Click", una vez agregada la nueva acción
seleccionamos la columna "Object".

Al dar doble click sobre esta columna se abrira el repositorio de elementos del test.
Ahora solo hace falta buscar el elemento que capturamos con la opción "Spy Web" y seleccionamos la
opción "OK".

Asi hemos agregado la nueva acción sobre el elemento que queremos que el bot ejecute, repito esto
funciona para poder capturar los elementos como datepicker, sin embargo no esta limitado a esos
elementos unicamente, de ti depende usarla para lo que mas te convenga.