es:first_steps_in_tast [TAST DokuWiki ]

User Tools

Site Tools


Sidebar

Primeros pasos en TAST

Que es UML

Configuración del sistema para el uso de TAST

Preguntas más frecuentes

Problemas reconocidos

Indice de la herramienta TAST

Adaptadores de TAST

Ejemplos de adaptadores

TAST Integraciones

Características de interés

Documentación de administración técnica

Recomendaciones para modelar

Formación en la herramienta TAST

es:first_steps_in_tast

Primeros pasos en TAST

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 click en “editar” después de seleccionarla. Si no la tienes, haz click 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. Click en el botón de Windows.
    b. Ve a “Panel de control”.
    c. Ve a “Programas”.
    d. Click en “Java”.

  5. Añade una excepción en la opción de editar sitios en la pestaña de seguridad:
    a. Click en “Editar lista de sitios”.


    b. Click 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

    y descomprímela en “C:”



Prerrequisitos para automatizar GUI HTML

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

  1. A través de Mapeo Selectivo.
  2. Navegador F12.

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:

  • Para pausar o continuar: <Barra espaciadora>
  • Para copiar el contenido del atributo o buscar por: <Click + Control + C>
  • Para pegar el contenido del atributo o buscar por: <Click + Control + V>
  • Para ver la fuente html: [v]
  • Para salir: [esc]

A continuación os explicamos como instalar esta herramienta.

Mapeo Selectivo

  1. En el navegador abre la herramienta TAST.
  2. Añade esta página a la barra de favoritos:



  3. Cambia el nombre de este favorito por el de 'Mapeo selectivo':



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



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


  6. 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>
    por «URL_SERVIDOR_TAST_ORGANIZACION>




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



  8. 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 click en el botón → Haremos click 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.


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 click 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 click 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 click en el botón → Hacemos click 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.



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 click sobre él. La pantalla del F12, mostrará la información del elemento.

Sobre el elemento, hacemos doble click 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 click 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 click en el botón “Iniciar sesión”, la primera página web vista es el TABLERO DE CONTROL 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:

  • Tablero de control.
  • Ajustes.
  • Personalizar.
    • Dominios y Proyectos.
    • Proyectos & Usuarios.
  • Funciones de usuario.
  • Infraestructura.
  • Modelado.
    • Diagrama UML.
    • Gestión de datos.
  • Ejecución.
    • Gestión de TS.
    • Planificación.
  • 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 click 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:

  • El usuario inicia sesión en la aplicación de TAST con Usuario y Contraseña.

  • Si el usuario no ha configurado en su móvil la Aplicación de Autenticación aparecerá en pantalla un código QR y un código alfanumérico para que el usuario escanee el código QR o introduzca el código alfanumérico para realizar la configuración.

    La Aplicación de Autenticación genera un código de 6 cifras. Este código se está renovando cada cierto tiempo (aproximadamente 30 segundos). Si el usuario no lo introduce antes de dicho tiempo deberá esperar a que se genere otro código e introducirlo en la aplicación TAST.

    A continuación, deberá hacer clic en “Enviar” para que TAST lo verifique. Si es correcto, accederá a TAST.

  • Si el usuario ya tiene configurada en su móvil la Aplicación de Autenticación (la cual generará un código de 6 cifras) deberá proceder como se ha indicado en el punto anterior.

  • Si el usuario tiene problemas al acceder o ha perdido el acceso a la Aplicación de Autenticación y a los códigos, contactar con el Soporte Técnico por medio del correo tast.support@sipsa.net

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 Cliente que aparece en la parte superior derecha de la aplicación.



El cliente HTML se puede descargar en dos formatos: exe y jar.


  • Con la opción '.exe', se descarga un archivo 'tast.zip', que tendremos que guardar en algún lugar en nuestro ordenador, y extraer el archivo que aparece dentro de zip.
    Este archivo tiene el formato:tast_vn. nn. nn, donde 'n.nn.nn' es la versión de HTML cliente (ejemplo: tast_v 1.20.23. exe).
  • Con la opción '.jar, un archivo 'tast. jar' es descargado, con lo cual tendremos que guardar en la ruta.
    C:\AppTast
    Para poder utilizar tast.jar, también debemos tener en la ruta C:\AppTast el archivo TAST.cmd.

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 click 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:

  • Al hacer click en el botón “Sí”, aparecerán todas las ejecuciones (pendientes o ejecutadas) del usuario que ha iniciado sesión.

  • Al hacer click en el botón 'No', se eliminarán todas las ejecuciones del cliente HTML, que aparecerá en la tabla vacía.

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

  • Al hacer click en el botón 'Aceptar', aparecerá la ventana de la sección 1, con todas las ejecuciones (pendientes o ejecutadas) del usuario que ha iniciado sesión.

    En la parte superior de la ventana principal del cliente HTML, aparecerán tres opciones:

    • Actualizar.
    • Eliminar.
    • Horario.

Opción de actualización

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

  • todos los casos de prueba iniciados desde la opción 'Validación de lanzamiento' de Modelado.
  • todos los conjuntos de pruebas iniciados desde la opción 'Ejecutar conjunto de pruebas' de Gestión del conjunto de pruebas.

Opción eliminar

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

Opción de programación

Al hacer click 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:

  • Nombre del conjunto de pruebas: el nombre del caso de prueba o conjunto de pruebas.
  • Exc.Time(ms): tiempo de ejecución del caso de prueba o conjunto de pruebas, expresado en milisegundos.
  • Paso: se utiliza para indicar el paso en el que desea detener la ejecución.( Modo debug).
  • Depurar: los dos iconos solo se habilitan cuando Modo debug se utiliza.
  • Acción: hay tres acciones posibles:

    • ejecutar el caso de prueba / conjunto de pruebas: se puede utilizar cuando el icono de la aplicación: aparece.
    • detener el caso de prueba / conjunto de pruebas: una vez que se ha iniciado la ejecución (el icono de la aplicación de la ejecución:aparece), se puede detener haciendo clic en ese icono.
      Cuando la ejecución se detiene, se mostrará la siguiente ventana:



    • reiniciar el caso de prueba / conjunto de pruebas: una vez que la ejecución se ha pausado (aparece en Status). Se puede reiniciar haciendo clic en el icono

  • Estado: Muestra el estado de las ejecuciones. Puede contener los valores:

    el caso de prueba/conjunto de pruebas aún no se ha ejecutado.
    el caso de prueba/conjunto de pruebas se ha ejecutado y terminado ok.
    el caso de prueba/conjunto de pruebas se ha ejecutado y terminado ko.
    el caso de prueba/conjunto de pruebas se ha pausado.
    cuando las evidencias no se pueden cargar y registrar correctamente en el NAS donde se almacenan los resultados.
  • Logs: haciendo click en esta opción, el cliente abre una ventana del explorador con la ruta donde se encuentran los siguientes archivos:
    • registros de la ejecución,
    • capturas de pantalla (si se indica previamente),
    • otros archivos (si procede) resultado de la ejecución: excel, scripts,…

Filtros en el Cliente Tast

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

  • Test case 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

Nota: 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).

INPORTANTE: 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.

es/first_steps_in_tast.txt · Last modified: 2024/10/10 14:09 by montse