Automatización de Pruebas en Oracle APEX: Un Ejemplo Práctico con Python y Selenium

La automatización de pruebas es esencial para garantizar la calidad de las aplicaciones en entornos dinámicos como Oracle APEX. En este artículo, exploraremos cómo configurar y ejecutar pruebas automatizadas utilizando Selenium y Python, con una prueba de login como ejemplo práctico .

Introducción a Selenium.

Selenium es una herramienta popular de automatización de pruebas para aplicaciones web. Con Oracle APEX, puedes utilizar Selenium para probar flujos de trabajo como el inicio de sesión, validaciones y navegación entre páginas. Esto asegura que los cambios en tu aplicación no afecten la funcionalidad existente.

Estructura del Proyecto

El proyecto está organizado en módulos para separar las responsabilidades:

drivers.py: Configura los controladores de Selenium para Chrome y opciones headless.
loginAPEX.py: Define los métodos para interactuar con la página de inicio de sesión.
automation_orclAPEX.py: Contiene las pruebas unitarias, incluyendo el flujo de inicio de sesión.

Configuración del Driver

El archivo drivers.py configura los navegadores compatibles y permite ejecuciones headless (sin interfaz gráfica), ideal para CI/CD.

from enum import Enum
from webdriver_manager.chrome import ChromeDriverManager
from selenium.webdriver.chrome.service import Service
from selenium.webdriver.chrome.options import Options
from selenium import webdriver
class GeneradorDriver():
    def Generar(self,tipo_browser):
        if tipo_browser == TipoBrowser.CHROME:            
            self.driver = webdriver.Chrome(service=Service(executable_path=r".\utils\chromedriver.exe"))
            self.driver.maximize_window()
            return self.driver
class GeneradorDriverHeadLess():
    def Generar(self,tipo_browser):
        if tipo_browser == TipoBrowser.CHROME:
            # Config para ejecución headless chrome
            chrome_options = Options()
            chrome_options.add_argument("enable-logging")
            chrome_options.add_argument("headless")
            chrome_options.add_argument("disable-gpu")
            service = Service(executable_path=r".\utils\chromedriver116.exe")
            # service = Service(ChromeDriverManager().install())
            self.driver = webdriver.Chrome(service=service, options=chrome_options)
            self.driver.maximize_window()
            return self.driver
class TipoBrowser(str,Enum):
    CHROME = "chrome"
    FIREFOX = "firefox"

Interacción con Oracle APEX

En loginAPEX.py, se definen métodos para interactuar con elementos de la página, como campos de texto y botones.

Ejemplo: Inicio de Sesión

import random
import string
from utils.drivers import GeneradorDriver, TipoBrowser
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.common.keys import Keys
class LoginApex():
    boton_login          = (By.XPATH, "//*[@id='B11409857260876630']")  #XPATH del boton login cambiar por el tuyo
    login = (By.XPATH, "//*[@id='P9999_USERNAME']") #XPATH del item user cambiar por el tuyo
    clave_login = (By.XPATH, "//*[@id='P9999_PASSWORD']")#XPATH del item password cambiar por el tuyo
    usuario_login           = (By.XPATH, "//*//*[@id='L11525360857973883']") # XPATH del user ya logueado, que aparece arriba cambiar por el tuyo
    url = "tuurl.com/login"
    def __init__(self,driver):
        self.driver = driver
    def cargar_pagina(self):
        self.driver.get(self.url)
    def ingresar_usuario_login(self, login):
        WebDriverWait(self.driver,10).until(lambda d : d.find_element(*self.login)).send_keys(login)
    def ingresar_password_login(self, clave_login):
        WebDriverWait(self.driver,10).until(lambda d : d.find_element(*self.clave_login)).send_keys(clave_login)
    def texto_usuario_login(self):
        return WebDriverWait(self.driver,20).until(lambda d : d.find_element(*self.usuario_login)).text
    def botonLogin(self):
        WebDriverWait(self.driver,10).until(lambda d : d.find_element(*self.boton_login)).click()

Automatización de Pruebas

El archivo principal, automation_orclAPEX.py, utiliza el framework unittest para estructurar las pruebas. Por ejemplo, una prueba para verificar el inicio de sesión:

import unittest, time
import HtmlTestRunner
from utils.drivers import GeneradorDriver, TipoBrowser
from paginas.loginAPEX import LoginApex
class TestDWShop(unittest.TestCase):
    def setUp(self):
        self.orden_log = 1              
        self.driver = GeneradorDriver().Generar(TipoBrowser.CHROME)
        self.pagina_dws = LoginApex(self.driver)
        self.login = "tuusuario" 
        self.clave_login = "tupassword" 
        self.tiempo = 3    
    def test2(self):
        log = "cargando pagina..."
        print(str(self.orden_log) + ' - ' + log + '<br>')
        self.orden_log += 1
        self.pagina_dws.cargar_pagina()
        log = "Digitando usuario..."
        print(str(self.orden_log) + ' - ' + log + '<br>')
        self.orden_log += 1
        self.pagina_dws.ingresar_usuario_login(self.login)
        log = "Digitando password..."
        print(str(self.orden_log) + ' - ' + log + '<br>')
        self.orden_log += 1
        self.pagina_dws.ingresar_password_login(self.clave_login)
        log = "Haciendo Click..."
        print(str(self.orden_log) + ' - ' + log + '<br>')
        self.orden_log += 1
        self.pagina_dws.botonLogin()
        log = "Corroborando resultado del registro de usuario..."
        print(str(self.orden_log) + ' - ' + log + '<br>')
        self.orden_log += 1
        resultado = self.pagina_dws.texto_usuario_login()
        log = "Acceso exitoso con: <b>" + resultado + "</b>"
        print(str(self.orden_log) + ' - ' + log + '<br>')
        self.orden_log += 1 
        time.sleep(5)       
def tearDown(self):
        # Se cierra la ventana del navegador web
        self.driver.quit()
if __name__ == '__main__':
    #crea un arrivo test para hacer seguimiento a tus pruebas
    unittest.main(testRunner=HtmlTestRunner.HTMLTestRunner(output=r'.\Reportes'))

Ejecución y Reportes

El uso de HtmlTestRunner genera reportes HTML para revisar los resultados de las pruebas. Para ejecutar las pruebas:

python automation_orclAPEX.py

Los reportes como el siguiente se almacenan en la carpeta ./Reportes.

Si hubiere algun error, ahi mismo se podria ver.

Cómo Obtener los XPaths para Automatizar con Selenium

Los XPaths son fundamentales para localizar elementos en la página y realizar interacciones automatizadas con Selenium. Aquí tienes una guía paso a paso para obtener los XPaths necesarios:

Métodos para Obtener los XPaths

Usando Herramientas de Desarrollador del Navegador
- Abre tu navegador (Chrome, Firefox, etc.) y navega hasta la página que deseas probar.
- Haz clic derecho sobre el elemento que te interesa y selecciona "Inspeccionar".
- Esto abrirá las herramientas de desarrollador, donde se resalta el elemento en el DOM.
- Haz clic derecho sobre la línea resaltada en el DOM y selecciona "Copiar > Copiar XPath".

Ejemplo: Supongamos que quieres capturar el campo de usuario. El DOM podría verse así:

    <input id="P9999_USERNAME" type="text" name="username">

El XPath generado sería:

    //*[@id='P9999_USERNAME']

Usando Selectores Relativos Los XPaths generados automáticamente pueden ser demasiado largos o frágiles. Crear un XPath relativo más robusto es una mejor práctica:
```
 //input[@id='P9999_USERNAME']
```
Complementos del Navegador
- XPath Helper (Chrome): Resalta y prueba tus XPaths en tiempo real.
- Firebug (Firefox): Aunque ya no está disponible, hay extensiones modernas como ChroPath o SelectorsHub.xpath

Conclusión

Con Selenium y Python, puedes automatizar pruebas esenciales para aplicaciones Oracle APEX, mejorando la eficiencia y reduciendo errores humanos. La separación modular en controladores, páginas y pruebas asegura un código limpio y reutilizable.

¿Listo para implementar estas técnicas? te dejo el codigo para que lo descargues de github y lo pruebes orclAPEX+Selenium.