Primeros pasos en TAST

English

TAST (Test Automation System Tool) es una herramienta para automatizar las pruebas. Está basado en diagramas UML. Tiene un sistema basado en usuarios, donde cada usuario tiene una función y, dependiendo de esta función, puede realizar diferentes acciones.

Prerrequisitos para instalar TAST

Para poder usar TAST, es necesario realizar unos pequeños cambios en la configuración del PC para permitir que el programa funcione como se espera, poder usar el cliente y evitar que los mensajes de seguridad aparezcan cada vez que la herramienta está abierta. En primer lugar, se necesita una configuración para los permisos del cliente.

La configuración se realiza siguiendo estos pasos:

1. Verifica que tengas el Java Runtime Environment (JRE) instalado. Para verificarlo, abre una consola de comandos de Windows y escribe: java -version. Si tienes el JRE instalado te saldrá la versión que tienes, es requerida la versión 1.8.0. En caso de no tenerlo instalado, puedes descargarlo del siguiente link: https://www.java.com/es/download/. Este paso es completamente necesario.

2. Cambia las variables de entorno: Desde el panel de control → Cuentas de usuario → Cuentas de usuario → Cambiar mis variables de entorno →  

   

    

   a. Si tienes la variable PATH, haz clic en “editar” después de seleccionarla. Si no la tienes, haz clic en “nuevo”.
   Añade los siguientes valores a la variable PATH:
   
   C:\Program Files(x86)\Java\jre1.8.0_281
   C:\Program Files(x86)\Common Files\Oracle\Java\javapath
   C:\ProgramData\Oracle\Java\javapath
   
   (los números del jre se tienen que corresponder con tu versión del jre)
   
   

3. Reinicia el PC.

4. Abre las opciones de Java siguiendo estos pasos:
   a. Clic en el botón de Windows.
   b. Ve a “Panel de control”.
   c. Ve a “Programas”.
   d. Clic en “Java”.

5. Añade una excepción en la opción de editar sitios en la pestaña de seguridad:
   a. Clic en “Editar lista de sitios”.
   
   
   b. Clic en “Añadir”
   
   c. Añade sitios:
   
   Para entorno SIPSA:
   https://app.cloud1.testautomationsystemtool.com/

6. Descarga la carpeta de los drivers de TAST de este link:
   https://testautomationsystemtool.com/cliente/sw/AppTast.zip
   
   Descomprímela en tu carpeta de usuario (%USERHOME%), normalmente la encontrarás en C:\Users\<userid>.

Prerrequisitos para automatizar GUI HTML

Para poder automatizar páginas GUI HTML, hay dos maneras de hacerlo:

TAST ha creado una herramienta propia, Mapeo Selectivo, gracias a la cual, podemos obtener los valores de búsqueda, de una manera más eficaz. Cuando se utiliza el mapeo selectivo, las mejores opciones de búsqueda se sugieren de arriba a abajo. Podemos buscar por name, type, xtpath, Css, Css attributes.
Las opciones disponibles para la funcionalidad de Mapeo Selectivo son:

A continuación os explicamos como instalar esta herramienta.

Mapeo Selectivo

En el navegador abre la herramienta TAST.

Haz visible el Mapeo Selectivo en la barra de favoritos del navegador:

Posiciónate en Mapeo Selectivo, botón derecho del ratón y selecciona Propiedades

Copiar el siguiente texto en la URL:

javascript:prefFile='';void(z=document.body.appendChild(document.createElement('script')));void(z.language='javascript');void(z.type='text/javascript');void(z.src='https://app.testautomationsystemtool.com/rest/selectivemapping');void(z.id='tast');

En el caso de tener su propia instalación, debe sustituir https://app.testautomationsystemtool.com/rest/selectivemapping');void(z.id='tast');> por «URL_SERVIDOR_TAST_ORGANIZACION>

Después de hacer clic en el favorito de Mapeo Selectivo, aparece una ventana similar a la siguiente:

Los atributos cambiarán en función de dónde se encuentre el foco en la página web.

Ejemplo de cómo trabajar con el Mapeo Selectivo

En primer lugar vamos a crear un diagrama GUI muy sencillo que va a consistir en una búsqueda en Google, de TAST SIPSA: Se abrirá Google → Aceptaremos el mensaje de Cookies de nuestro ordenador → Incluiremos nuestro criterio de búsqueda de Google → Haremos clic en el botón → Haremos clic en la 1ª opción que aparece.

Os pasamos un link, para que accedáis al vídeo con la explicación de este caso de prueba.  Búsqueda Sencilla en Google

Ahora pasamos a explicarlo paso a paso:

Accedemos a Modelo/ Diagrama UML desde el menú:

Seleccionamos nuestro dominio y proyecto

Creamos un diagrama nuevo.

Rellenamos los campos para crear el diagrama con el nombre, descripción y ubicación donde queramos crearlo.

Comenzamos a dibujar el diagrama desde las herramientas de dibujo que se encuentran en el menú de la derecha de la pantalla. Le damos al signo + y aparecerá un desplegable.

Seleccionamos la segunda opción: Objeto

El primer Adaptador que necesitamos es el Adaptador de Usuario. Este Adaptador no necesita Propiedades, pero es necesario, ya que todos los mensajes parten de él.

Después seleccionamos otro Adaptador, y en este caso necesitamos el Adaptador GUI, que es el que nos permite interactuar con todo tipo de páginas web, para navegar, extraer datos, validar, etc…

Tendremos que darle a aceptar el cambio de Adaptador.

Y ya podemos lanzar mensajes

Este Adaptador necesita qué en la pestaña de Propiedades, le indiquemos la URL y el nombre del Buscador, en ese caso Chrome.

La URL y el buscador son necesarias. Los demás campos son opcionales.

Después nos vamos a la pestaña de Mapeo Selectivo, damos dos veces clic y la abrimos. Nos aparecerá a la derecha de la imagen, un desplegable gris claro con unos datos, que irán variando según vayamos modificando nuestra búsqueda dándole a la tecla [v] y la ayuda de un marcador rojo.

Gracias a esta herramienta, podemos obtener los valores de búsqueda, que debemos incluir, copiándolos y pegándolos en la siguiente pestaña de Mapeo del Objeto. Podemos buscar por: name, type, xtpath, Css attributes, según hayamos marcado en el desplegable de SearchBy. Posteriormente lo pegamos en la pestaña de Elemento.

Si queremos documentar algún paso, abrimos la pantalla de documentación del mensaje y damos una explicación de este paso. Luego al descargar el documento de evidencias aparecerá documentado.

Así, terminamos de dar todas las propiedades a los mensajes, mapeamos los mensajes y los documentamos.

Una vez hemos terminado todo el proceso, guardamos el diagrama y lo validamos.

Si no podemos editarlo o queremos abrir de nuevo el diagrama, para hacer algún cambio, tenemos que ir a la pestaña del candado y desbloquearlo.

Este diagrama tendrá también una numeración asignada por defecto.

Abrimos Cliente, bajándonos la versión Exe.

Y nos aparecerá esta pantalla, en la que damos clic en Más información, nunca en No ejecutar.

Después tardará unos segundos en instalarse el Cliente

Le damos a aceptar

Y por último aparecerá la pantalla de Cliente con el caso de prueba listo para ser ejecutado.

Buscamos el caso de prueba, lo ejecutamos, si no hemos tenido fallos se marcará en verde.

Automáticamente se lanzará el caso de prueba y veremos como: Se abre Google → Aceptamos el mensaje de Cookies de nuestro ordenador → Incluimos nuestro criterio de búsqueda de Google → Hacemos clic en el botón → Hacemos clic en la 1ª opción que aparece.

Al lado de la pestaña verde aparecerá una carpeta que contiene todos los pasos de la ejecución. La buscamos en nuestro directorio C:

La abrimos y tenemos todos los pasos realizados, las funciones predefinidas que hemos necesitados para los mensajes y el resultado.

Si queremos tener este caso de prueba documentado nos vamos a Resultados y le damos a la pestaña de descargas.

Nos creará un documento Word con el número de pasos realizados, el Resultado, el link para acceder al diagrama y si hemos documentado los mensajes, nos los detallará también.

Navegador F12

Para obtener el mapeo de un mensaje del adaptador GUI lo podemos hacer con la tecla F12. En este caso vamos a buscar un type en Google, que es el campo donde escribimos la búsqueda que queremos hacer en Google.

Abrimos la página que queremos diagramar (URL del adaptador GUI). Se da a la tecla F12 del teclado y aparece la consola.

Pinchamos en la flecha de la imagen que nos muestra los elementos de la página que queremos seleccionar para inspeccionar.

Se posiciona sobre el elemento del que queremos obtener el mapeo y se hace clic sobre él. La pantalla del F12, mostrará la información del elemento.

Sobre el elemento, hacemos doble clic en el campo que queremos obtener para que se seleccione. En nuestro caso, vamos a hacer la búsqueda por “name”. Copiamos el elemento ( Ctrl+ C).

Volvemos al mapeo del mensaje en nuestro diagrama. Donde seleccionamos el campo búsqueda (name) y la información copiada del F12 en el campo element.

Si queremos hacer la búsqueda por Xpath o Css Selector, en el elemento seleccionado en la consola (F12), se hace clic con el botón derecho/copy/copy selector-copy Xpath. Y se pega en el campo elemento del mapeo del mensaje.

Inicio de sesión en TAST

La primera pantalla vista al acceder a la herramienta es la que se encuentra a continuación:

donde el usuario necesita iniciar sesión, con el fin de entrar en su vista TAST personal. Este inicio de sesión se puede hacer con las mismas credenciales que para acceder a Windows (es decir, número LDAP N000000 o XI000000 y contraseña).

Después de hacer clic en el botón “Iniciar sesión”, la primera página web vista es el TABLERO DE CONTROL o Cuadro de mandos de la herramienta, donde el usuario puede ver la principal información útil sobre la herramienta y su último uso.

Para cambiar entre las diferentes funcionalidades de la aplicación, el usuario puede utilizar el menú en el lado izquierdo de la pantalla. Este menú se puede presentar de dos maneras (contraído o expandido):

En este menú, se pueden seleccionar las siguientes opciones:

•  Cuadro de mandos o también llamado Tablero de control.   
• Ajustes.
• Personalizar.
  • Dominios y Proyectos.
  • Proyectos y Usuarios.
• Roles de usuario.
• Infraestructura.
• Modelado.
  • Diagrama UML.
  • Gestión de datos.
  • Gestión de Repositorios.
  • Gestión de Bibliotecas.
• Ejecución.
  • Gestión de TS.
  • Planificación.
• Resultados.
  • Resultados.

El botón 'Modelado' llevará al usuario a la página que permite crear diagramas UML.

Para cerrar sesión, el usuario debe hacer clic en su usuario (arriba a la derecha) y luego verá el botón Cerrar sesión.

Doble Autenticación para acceder a TAST

La aplicación web de TAST permite activar la doble autenticación (doble capa de seguridad) para entrar en la aplicación.

Como requisito, el usuario, en un teléfono móvil debe tener instalada alguna Aplicación de Autenticación como, por ejemplo, aplicación Google Authenticator, o Twilio Authy Authenticator u otra aplicación similar.

El procedimiento es:

Cliente HTML

La función del cliente HTML de TAST es ejecutar los casos de prueba y los conjuntos de pruebas.

Download

Para poder utilizar esta herramienta, el primer paso es descargarla desde TAST, a través de la opción Usuario que aparece en la parte superior derecha de la aplicación.

Tenemos el Cliente de Tast en sus dos versiones. Podemos descargar la versión que necesitemos y moverla a la carpeta apropiada para la aplicación:

Funcionalidad

La primera pantalla vista al acceder al cliente HTML es la que aparece a continuación, donde el usuario necesita iniciar sesión, para entrar en su cliente TAST HTML personal. Este inicio de sesión se puede hacer con las mismas credenciales que para acceder a TAST (es decir, número LDAP N000000 o XI000000 y contraseña).

Después de hacer clic en el botón “Iniciar sesión”, aparecerán algunos de los siguientes mensajes, dependiendo de si la versión del cliente HTML es la última o no:

1- La versión del cliente HTML es la última:

2- La versión del cliente HTML no es la última:

Opción de actualización

La ventana del cliente HTML se actualiza con todas las ejecuciones que se encuentran en ese momento, añadiendo:

Opción eliminar

Permite eliminar los casos de prueba y conjuntos de pruebas seleccionados.

Opción de programación

Al hacer clic en esta opción, las ejecuciones planificadas que están listas para ejecutarse, aparecerán en la ventana (según la funcionalidad de Planificación).

Contenido de la tabla de cliente HTML

En esta tabla aparece la siguiente información:

Filtros en el Cliente Tast

Se pueden filtrar los elementos de la tabla usando estos 3 campos:

• Test set name
• Last execution date
• Status

Estos filtros se pueden usar individual o conjuntamente.

 Pulsando el botón de Filtrar tabla, se aplica a la tabla los filtros introducidos en los campos.

Pulsando el botón Limpiar filtros, se limpian  los campos de filtros y se repone la tabla en su estado original.

Los filtros se aplicarán a los testcases, es decir, a los test case data pertenecientes a un test set, y a los test case data de validación.

Test case name

En este filtro es posible usar:

•  operadores lógicos: OR, AND, NOT
•  asterisco *:  solo, o al final de una cadena
•  dobles comillas “: para delimitar nombres que contienen espacios en blanco
•  Mayúsculas o minúsculas: es indiferente

·        Los prefijos de test case data “tcd_” o de test case validation “tcv_” no son tenidos en cuenta en la comparación.

Algunos ejemplos en este campo:

• “test excel” (testcases cuyo nombre es igual a “test excel”)
•  bbdd* OR “test excel” (testcases cuyo nombre contenga la cadena “bbdd” o sea igual a “test excel”)
• NOT  xml* (testcases cuyo nombre no contiene la cadena “xml”)
• Test* AND NOT xml* (testcases cuyo nombre contiene la cadena “test” y no contiene la cadena “xml”)

Last execution date

En este filtro es posible usar:

• Asterisco *: solo, indica cualquier fecha
• Guión - :  delimitador entre 2 fechas
• Formatos de fecha admitidos:  "dd.MM.yyyy HH:mm"  y  "dd.MM.yyyy"

Algunos ejemplos para este campo:

• * (testcases ejecutados en cualquier fecha)
• 23.09.2024 08:40 (testcases cuya fecha/hora de última ejecución es menor o igual a 23/09/2024 08:40)
• 23.09.2024 (testcases ejecutados hasta el 23/09/2024. En este caso como no se ha indicado la hora se está tomando por defecto la primera hora de dicho día por lo que se mostrarán los testcases cuya fecha/hora de última ejecución es menor o igual a 23/09/2024 00:00)
• * - 23.09.2024 08:40 (testcases cuya fecha/hora de última ejecución es menor o igual a 23/09/2024 08:40)
• * - 23.09.2024 (testcases ejecutados hasta el 23/09/2024. En este caso como no se ha indicado la hora se está tomando por defecto la primera hora de dicho día por lo que se mostrarán los testcases cuya fecha/hora de última ejecución es menor o igual a 23/09/2024 00:00)
• 23.09.2024 08:40 - * (testcases cuya fecha/hora de última ejecución es mayor o igual a 23/09/2024 08:40)
• 23.09.2024 - * (testcases ejecutados desde el 23/09/2024. En este caso como no se ha indicado la hora se está tomando por defecto la primera hora de dicho día por lo que se mostrarán los testcases cuya fecha/hora de última ejecución es mayor o igual a 23/09/2024 00:00)
• 25.04.2024 17:18 - 23.09.2024 08:40  (testcases ejecutados entre ese rango de fechas, es decir, cuya fecha/hora de última ejecución es mayor o igual a 25/04/2024 17:18 y menor o igual a 23/09/2024 08:40)
• 25.04.2024 - 23.09.2024 (testcases ejecutados entre ese rango de fechas, en este caso, como no se ha indicado la hora se está tomando por defecto la primera hora de ambos días por lo que se mostrarán los testcases cuya fecha/hora de última ejecución es mayor o igual a 25/04/2024 00:00 y menor o igual a 23/09/2024 00:00)

Status

En este filtro es posible usar:

• Operadores lógicos: OR, AND, NOT
• Palabras clave válidas: OK, KO, executed, notexec ó notexecuted
• Mayúsculas o minúsculas: es indiferente

 Algunos ejemplos para este campo:

• OK (testcases ejecutados cuyo resultado ha sido OK verde)
• ok OR ko (testcases ejecutados cuyo resultado ha sido OK -verde- o KO -rojo-)
• OK or KO or NotExec (testcases ejecutados cuyo resultado ha sido OK -verde- o KO -rojo-, o los que aun no han sido ejecutados)
• Executed (testcases ejecutados, independientemente de su resultado rojo o verde)
• NOT ok (testcases sin resultado OK. Asi incluye los elementos aun no ejecutados y a los ejecutados KO)
• Executed and not ko (solo los testcases ejecutados y que han resultado OK verde. Este ejemplo, sería lo mismo que el primero).

Si se aplicaron uno o más filtros a la tabla, cuando se intente ejecutar el test set, solamente se ejecutarán los testcases que fueron filtrados.

Por ejemplo, si se filtró la tabla con el campo Status = “KO OR notexec”, cuando se haga click en el botón de Run Test Set, solamente los testcases con estado KO y Not executed serán ejecutados. Es decir, solamente ejecuta los testcases que aparecen en la tabla filtrada.

Para terminar, tenemos un tercer botón de ayuda:

Pulsando este botón, nos aparece una pantalla con toda la ayuda necesaria para filtrar los elementos utilizando estos tres campos.