Índice de Documentación
IntroducciónInstalaciónInterfaz de BuilderLógica y SistemaArchivos y DatosWeb y APIsEscritorio y UIPro-Code & SDK
InicioDocumentaciónWeb y APIs

Automatización Web y APIs

Vivabots proporciona potentes herramientas tanto para interactuar con APIs y librerías externas de back-end como para automatizar flujos de trabajo en páginas y aplicaciones web a través de emulación de navegador.

1. Integraciones y APIs

1.1 Ejecutar DLL

Permite invocar métodos de librerías (.dll) compiladas en C# u otros lenguajes de .NET directamente desde el flujo de automatización.

  • Clase Interna: Especifica el nombre completo de la clase en la DLL que deseas instanciar.
  • Método Interno: Nombre del método que deseas ejecutar.
  • Variable Destino: Variable donde se almacenará el resultado del método.
  • Parámetros: Configuración opcional de clave-valor de argumentos de entrada para el método.

1.2 Ejecutar REST API

Permite interactuar con endpoints HTTP e integrarse con servicios web de terceros.

  • URL Base: Dirección del servidor API (ej. https://api.empresa.com/v1).
  • Punto Final (Endpoint): Ruta específica del recurso (ej. /clientes).
  • Tipo de Método: GET, POST, PUT, DELETE, PATCH, etc.
  • Parámetros: Envío de información a través de:
    • HEADER (encabezados de autenticación, content-type)
    • PARAMETER (query string parameters)
    • JSON BODY (cuerpo de petición JSON)
    • FILE (subida de archivos binarios)
  • Variable Destino: Variable de tipo texto donde se guardará la respuesta JSON/XML.

1.3 Petición HTTP (HTML Scraper)

Realiza una descarga del código fuente HTML crudo de una dirección web directamente mediante HTTP. El resultado se vuelca a una variable para ser procesado posteriormente, lo que evita tener que abrir un navegador visual.

1.4 Petición HTTP Query (XPath)

Permite extraer datos estructurados de una variable que contenga código HTML (como el obtenido en la actividad Petición HTTP) mediante consultas en formato XPath.

  • XPath Query: Sintaxis XPath del elemento a extraer (ej. //*[@id="ez-toc-container"] o //table/tr/td).
  • Cómo obtener el XPath en Chrome: Haz clic derecho en el elemento en la página web -> Inspeccionar -> Clic derecho en el código de la consola -> Copy -> Copy XPath.

2. Automatización de Navegador Web

Vivabots dispone de dos motores para automatizar interfaces web: el motor moderno basado en Selenium/WebDriver (recomendado) y el motor heredado de Internet Explorer (para sistemas legacy).

2.1 Crear Navegador

Inicia una sesión limpia de navegador web.

  • Motor: Permite seleccionar el motor de ejecución, siendo Chrome el recomendado.
  • Seguimiento de Instancias: Opción para Mantener Instancia abierta al finalizar el proceso (útil para depurar) o cerrarla inmediatamente.
  • Tamaño: Maximizado o Normal.
  • Parámetros Selenium: Configuración adicional opcional de línea de comandos para Selenium (ej. ejecutar en modo headless sin interfaz gráfica).

2.2 Navegar URL

Dirige el navegador web activo a una dirección URL específica. Se puede definir de forma manual o pasar una variable dinámica que contenga el enlace.

2.3 Acción del Elemento

Realiza operaciones sobre elementos HTML dentro del navegador activo.

  • Método de búsqueda: Selector utilizado para encontrar el elemento en la página web:
    • Encontrar elementos por Id
    • Encontrar elementos por Name (ej. selector q para barras de búsqueda estándar)
    • Encontrar elementos por XPath
    • Encontrar elementos por ClassName
    • Encontrar elementos por CSS Selector
  • Acción a realizar:
    • Hacer clic: Envía un evento clic al elemento.
    • Establecer Texto: Escribe información en campos de formulario (ej. ingresar contraseña o usuario).
    • Obtener Texto: Recupera el valor o el texto interno de una etiqueta para guardarlo en una variable.

2.4 Ejecutar Script (Inyección JavaScript)

Permite inyectar y ejecutar un bloque de código JavaScript de forma directa dentro de la consola de la página web activa del navegador.

  • Script: Código JS a ejecutar (ej. console.log("Hola mundo!"); o manipulación del DOM mediante document.querySelector).
  • Argumentos: Valores opcionales pasados desde Vivabots al script JS.

2.5 Navegación Direccional

Simula los controles básicos de navegación del navegador:

  • Navegar hacia adelante: Va a la página siguiente en el historial.
  • Navegar hacia atrás: Vuelve a la página anterior.
  • Refrescar: Recarga la página web activa.

2.6 Cerrar Navegador

Finaliza la sesión del navegador y libera los recursos del sistema asociados a la instancia.

AnteriorArchivos y DatosSiguienteEscritorio y UI