Adaptador GUI HTML

English

Introducción

TAST ha creado este Adaptador que nos permite interactuar con todo tipo de páginas web para navegar, extraer datos, validar. A través del Adaptador GUI HTML, TAST se conecta con aplicaciones web basadas en HTML y es posible probar dichas aplicaciones. Este adaptador tiene un importante compañero llamado Mapeo Selectivo, que es un asistente JavaScript que aporta una interfaz de usuario más amigable para ayudar a la creación de mapeos TAST. Es posible realizar pruebas individuales con este Adaptador o pruebas End to End conectando con otros Adaptadores.

Parámetros de Inicialización

En el mapeo de este Adaptador necesitamos proporcionarle unos datos que son necesarios para establecer la conexión y poder hacer uso de este: 

• Url: nos indica la url de la página sobre la que vamos a realizar las pruebas. Es la primera url a localizar.
• Browser: es el navegador que elegimos para hacer la prueba. Podemos elegir Microsoft Edge, Firefox, Opera. Si no elegimos ninguna será Chrome, por defecto.
• Browser arguments(Opt.):
• WaitFor step (Opt.):
• Validate Insert Values: indica si el Adaptador debe validar o no los valores que recibe el Adaptador durante la ejecución. Por defecto, no está marcada. La recomendación es que se mantenga sin revisar por razones de rendimiento. Este campo es muy útil en casos de pruebas especiales, pero en general no es necesario usarlo.
• Full Screenshot: si marcamos esta casilla, tomará una captura de pantalla de toda la página (no solo la parte visible), Si no está marcado, los pantallazos se tomarán de la parte visible de la pantalla.
• Create Selenium JSON: haciendo clic en esta casilla se genera un archivo .side tras la ejecución de la navegación.
• Incognito mode: al marcar esta casilla el navegador trabajará en modo incógnito.

Parámetros para la vista móvil

Los siguientes parámetros se usarán únicamente si se quiere emular la vista móvil en el navegador.

• Emulador del dispositivo: se utiliza para poder tener la vista móvil en la ejecución. Permite elegir el emulador entre los distintos dispositivos proporcionados. Si no se selecciona ninguno, no habrá emulación; la ejecución se realizará con el formato estándar. Cuando se elige un dispositivo, se muestran las medidas por defecto de ese dispositivo en los tres campos siguientes y el formato de la ejecución será con esas medidas. Estas medidas se pueden cambiar manualmente a elección del usuario:
  
  

  • • Ancho del dispositivo

    • Altura del dispositivo

    • Zoom del dispositivo
      
      

• Modo horizontal: haciendo clic en este checkbox, la vista de la ejecución será en formato horizontal.

Funciones Predefinidas (PF's)

• allOptionsAreSelected(Element): verifica si todas las opciones están seleccionadas. Se aplica para seleccionar múltiples html. Como parámetro de entrada tenemos Element (Element es un elemento html con el cual se interactúa, como son los links, inputs, checks, etc. También hay una entrada SearchBy que se utiliza para buscar el tipo de “etiqueta” o “valor” que puede tener el elemento. Esas etiquetas son ClassName, CssSelector, Id, LinkText, Name, PartialLinkText, TagName y xPath).

• checkBox(Element): marca la casilla de verificación en el elemento. Como parámetro de entrada tenemos Element; en esta función el usuario le indica cual es el checkbox que tiene que activar mediante este parámetro, y lo marca.

• checkRadio(Element): marca la opción del botón de radio (radio button). Como parámetro de entrada contamos con un Element que en este caso es para indicar que botón de radio queremos marcar.

• clear(Element): borra el valor del elemento. Se indica con el parámetro Element que debe borrar la función.

• clearAndType(Element): borra el valor del elemento y escribe el nuevo valor. Como con la función clear, le indicas con el parámetro Element que debe borrar y escribir y con un value que añadimos en el mapeo del mensaje, el mensaje que queremos que escriba.

• click(Element): hace clic con el ratón sobre el elemento html. El elemento html en cuestión se determina con el parámetro de entrada Element.

• clickAction(Element): esta PF tiene un comportamiento similar al de clic() PF. Sin embargo, en este caso, antes de hacer clic en el control, simula el movimiento del ratón. Este comportamiento es obligatorio en varias aplicaciones.

• clickAndHold(Element,Time): función que hace clic en un elemento y lo deja pulsado. Esta función obtiene un parámetro de entrada (Element) en el cual se indica en que elemento hay que pulsar y otro parámetro (Time) en donde el usuario indica el tiempo que el elemento se mantendrá pulsado (como valor opcional). Por defecto la duración de la pulsación será de 1 segundo. También, esta función recoge un pantallazo a mitad del tiempo indicado en el parámetro time.

• clickByJavaScript(Element): hace clic en el elemento html mediante ejecución de JavaScript.

• clickLink(Element): hace clic con el ratón sobre el elemento html. Se usa cuando se abre una nueva ventana. Cuando la aplicación abre una nueva página html, tenemos que usar clickLink porque la aplicación no tiene el foco de la segunda página html.

• clickPrint(Element): hace clic en el botón 'print' de la página, este se indica mediante el parámetro de entrada Element (solo en caso de que la pagina en cuestión tenga botón de imprimir).

• closeAllWindows(): cierra todas las ventanas del adaptador. No necesita parámetros de entrada.

• closeOthersWindows(): cerrar todas las ventanas extra abiertas, dejando la principal activa. No necesita parámetros de entrada.

• closeWindow(Element): cierra el navegador de prueba.

No podemos usar la función closeWindow si más tarde usamos la función openUrl, porque perderemos la instancia HTML GUI Adaptor. 

Como parámetro de entrada tenemos Element,  que será cualquier elemento de la página que queremos cerrar.

• cookiesManage: hace clic en el botón de aceptar las cookies.

• countElements(Element): cuenta los elementos encontrados en html y guarda el valor en una variable entera. Como parámetro de entrada tenemos Element, con el cual indicamos que parte de dicho html queremos que cuente.

• deleteAllCookies(): elimina todas las cookies del navegador. No requiere parámetros.

• deselectAllOptions(Element): anula todas las opciones de html seleccionado. Se aplica cuando se han seleccionado múltiples html, como parámetro de entrada tenemos un Element, indicamos la parte de la página en la que queremos que se aplique esta función.

• doubleClick(Element): hace doble clic en el elemento. Con el parámetro de entrada Element indicamos que elemento queremos que se use el doble clic.

• dragAndDrop(): función para mover un elemento a otro. Con el parámetro “ElementFrom” elegimos cual es el elemento que queremos desplazar y con el parámetro “ElementTo” la ubicación de otro elemento en el cual queremos que termine el primero. El resultado es el desplazamiento del elemento seleccionado.

• dragAndDropClickAndHold(): cumple la misma función que dragAndDrop, pero mueve el elemento de una manera diferente. Debe ser usado si no funciona dragAndDrop. Tiene un parámetro extra opcional para esperar antes de soltar el elemento seleccionado.