Skip to main content

Ejemplo Adaptador GUI HTML

Descripción

HTML (El Lenguaje de Marcado de Hipertexto) es el código que se utiliza principalmente para crear páginas web y sus contenidos. Debido a que es de código abierto y es compatible con todos los navegadores modernos, HTML es de uso gratuito y garantiza que el texto, imágenes y otros elementos se muestren según lo previsto. Sin HTML, todas las páginas web serían archivos de texto sin ningún tipo de formato.

Es la base de la mayoría de las páginas web;  es la forma en que les decimos a los navegadores que estructuren el contenido en títulos, encabezados, párrafos, imágenes, enlaces, listas, formularios, tablas etc...

TAST ha creado este adaptador que nos permite interactuar con todo tipo de páginas web para navegar, extraer datos, validar, como por ejemplo para:

  • Realizar una búsqueda en Google (tiempo en una ciudad) y recoger la temperatura de todo un mes.
  • Descargar PDF de una página oficial del BOE. Y después realizar una serie de comprobaciones sobre pdf, pasar pdf a txt, comprobaciones en txt, etc.
  • Realizar una búsqueda en alguna página de compras (Fnac, Zara, El Corte Inglés...) y comparar precios de productos, tanto entre los productos como con precios fijos.

A través del adaptador GUI HTML, TAST se conecta con aplicaciones web basadas en HTML y luego es posible probarlas. Este adaptador tiene una ayuda importante, Selective Mapping, que es un asistente de JavaScript que nos ayuda a mapear todos los elementos que encontremos en una página web.

Enunciado del ejercicio

TAST recogerá diferentes URL's (seis en concreto) que habremos incluido en una Excel y las abrirá una a una con el Adaptador GUI HTML. Estas URL's corresponden a 6 páginas Web. Obtendremos una captura de pantalla de las diferentes Url's' que se han ido abriendo.
Tip: utilizamos la función getNumColumns o getNumRows  como valor final del bucle. Utilizamos un bucle while o for de TAST.

Resolución del caso de prueba

Hemos diseñado este caso de prueba utilizando tres Adaptadores: el Adaptador Objeto de Usuario, el Adaptador Excel, y el Adaptador GUI HTML. También hemos creado el bucle WHILE, con el que ejecutaremos los mismos pasos, mientras se cumpla la condición que le indicamos en las propiedades del Fragmento Combinado.

Este es el enlace al siguiente diagrama: https://app.cloud1.testautomationsystemtool.com/opendiagram?id=12085

 

Ejemplo de Adaptador GUI HTML1.png

 

 

Adaptador Usuario

Siempre presente en todos los diagramas. Todos los mensajes definidos en el diagrama parten de este adaptador. No tiene parámetros de inicialización.

Adaptador Excel

El Adaptador Excel intentaráIntentará leer y analizar la hoja Excel. Los parámetros de inicialización necesarios para este ejemploadaptador son los siguientes:

  • FilePath: representa la ruta completa y el nombre del archivo Excel que está siendo utilizado en esta instancia del Adaptador de Excel:
      • C:\test\URLsPERIODICOS.xlsx
  • Sheet:  indica el número de la hoja del archivo Excel con la que vamos a trabajar: 1

Adaptador GUI HTML

LosEn parámetrosla de inicializacióconfiguración para estedel adaptador debemos sonincluir los siguientes:siguientes datos:

  • Url: primera url a localizar cuando se crea el adaptador.
  • Browser:  el navegador que utilizará en la prueba.
  • Validate Insert Values: indica si el adaptador debe validar o no los valores que recibe el adaptador durante la ejecución. Por defecto, está desmarcado. La recomendación es mantenerlo desmarcado por razones de rendimiento.

Funciones y elementos relevantes

Separaremos las funciones por el adaptador al que pertenecen.

Funciones que hemos utilizado con el Adaptador Objeto de Usuario

  • SetVariable: creamos la #Fila, cuyo nombre es introducido cómo parámetro, para usarla a lo largo del caso prueba. Le damos el valor: 1, y especificamos el tipo de dato: INTEGER. En este primer mensaje lo que queremos al darle el valor 1 a la #Fila, es que tome el valor de la Fila 1.

Es importante especificar con qué tipo de dato estamos trabajando. Estos pueden ser: boolean, string, integer, double, etc…

En el último mensaje dentro del bucle volvemos a usar esta función predefinida. En este caso el valor que le damos a la #Fila, el de #Fila + 1. Irá cogiendo los valores de las sucesivas Filas 2, 3, 4, 5, 6, del archivo excel. Cada vez que coja el valor de una Fila se repetirán los mensajes que están dentro del bucle. Así sucesivamente hasta llegar a la Fila 7, donde deja de cumplirse la condición del bucle.
 

Funciones que hemos utilizado con el Adaptador GUI HTML:

HTML
  • closeAllWindows: closescierra alltodas thelas windowsventanas ofdel theadaptador instantiatedinstanciado. adaptor.Dejara Itcerradas willlas closeseis theventanas sixde windowslas ofseis the sixpáginas web pagesque thathemos weido have been opening.abriendo.
  • openUrl: opensAbre auna newnueva url indel thenavegador. browser.Tiene Ituna hasserie ade seriesparámetros ofopcionales, optionalpara parameters,comprobar tosi check if thela url wasse openedabrió andy timeouttiempo beforede verifyingespera it.antes Inde thisverificarla. caseEn weeste indicatecaso thele valueindicamos #URL.el valor #URL.
  • takeScreenshot: takestoma auna screenshotcaptura ofde eachpantalla de cada página web pageque thatha hasido been opened.abriendo.
  • waitFor: waitespera theel timetiempo inen secondssegundos thatque wele indicateindiquemos whenal mappinghacer theel message:mapeo del mensaje: 2.

Funciones que hemos utilizado con el Adaptador Excel

  • getNumRows: esta función recoge el número de filas de la TastTableData generada al leer la hoja Excel. Nos dará como resultado: 6, qué es el número de filas que hemos creado, una por cada dirección.
  • getTableValue: recoge el valor contenido de la celda indicada por los parámetros RowNum y ColNum (#Fila y 3). Irá recogiendo las distintas URL's empezando por la Fila 1, columna 3, después con la Fila 2, columna 3, etc… mientras se cumpla la condición o guardia especificada en el
Fragmento Combinado: Bucle WHILE
  • Guardia #Fila < = #FilasTotales

Es decir, mientras el valor de la variable Fila (valor 1) sea menor o igual al valor de la variable FilasTotales (valor 6).
Este es un caso muy sencillo, porque el número de urls's que vamos a abrir es sólo de seis, pero imaginemos por un momento que tuviéramos que hacer esta comprobación con todos los diarios de nuestro país. Gracias a esta herramienta que nos proporciona TAST, esto se haría de una manera más ágil.


 

 

 

Diagram.pngEjemplo de Adaptador GUI HTML2.png

Archivos necesarios para ejecutar el caso

Before designing the test case, we created an xlsx file. In it we copied the six urls from six different newspapers. We have started with Row 1, Row 2,.... up to Row 6. While the column is always the same, column 3. We save it in the directory C:\test with the name we have given it, in this case C:\test\URLsNewsPapers.xlsx

URLsNewsPapers..png

Important: before executing this test case, we must check that the .xlxs file is closed, otherwise we will get an error.

Ejecución del Test Set

When we finish executing this test case, we see if it has been executed correctly:

ExecutionGUIHTMLAdaptor.png

Captura de resultados

We then open the icon on the right (marked with a red arrow) and we have as a result the evidence folder, where both the log of the execution is stored, as well as all the screenshots, files, etc... if we have checked the "Evidence" box in the general settings of the diagram.

Carpeta de evidencias

EvidenceFolder.png

Log de la ejecución  

LogGUIHTMLAdaptor.png

WhenA returningla thehora results,de H-TESTdevolvernos returnslos aresultados, WordTAST document,nos detailingdevuelve theun stepsdocumento weWord, haveen taken,el theque resultsse obtaineddetallan fromlos eachpasos step,que thehemos realizado, los resultados obtenidos de cada paso, los links toal thediagrama diagramy and theal test set, ifsi wehemos havedado clickeda ondescargar downloaddocumento documenten inla thecasilla Resultsde box.

Resultados.

WordDocumentGUIHTMLAdaptor.pngts_prueba_gui_y_excel_sin_gate_10.01.2022_10.03.55_10.01.2022_10.04.34.docx

 


ts_Excel Adaptor - GUI HTML Adaptor Example_20.05.2024 14.31.12_20.05.2024 14.34.04.docx

Archivos necesarios para ejecutar el caso

Antes de diseñar el caso de prueba, hemos creado un archivo xlsx. En él hemos copiado las seis urls de seis periódicos distintos. Hemos empezado por la Fila 1, Fila 2,…. hasta la Fila 6. Mientras que la columna es siempre la misma, la 3. Lo guardamos en el directorio C:\test\ con el nombre que le hayamos dado, en este caso URLsPERIODICOS.xlsx

Ejemplo de Adaptador GUI HTML.png

Antes de hacer la ejecución de este caso de prueba, debemos comprobar que el archivo .xlxs esté cerrado, porque de lo contrario, nos dará error.


Back to top