Gestión de Archivos, Datos y Excel

La suite de Vivabots cuenta con actividades nativas y eficientes para gestionar archivos en disco, manipular variables de texto y datos complejos (incluyendo JSON), y realizar automatizaciones avanzadas en Microsoft Excel.

1. Operaciones con Archivos

Borrar Archivo: Elimina de forma definitiva un archivo en disco utilizando una ruta manual o guardada en una variable.
Escribir Texto en Archivo: Crea un nuevo archivo de texto o modifica uno existente. Ofrece la opción de Sobrescribir (reemplaza todo el contenido) o Adjuntar (escribe al final de la última línea).
Esperar por Archivo: Detiene temporalmente el flujo de automatización hasta que un archivo aparezca en una carpeta (puedes parametrizar el tiempo máximo de espera en segundos).
Leer Archivo de Texto: Abre un archivo local en disco, extrae todo su texto y lo almacena en una variable especificada.
Mover o Copiar Archivo: Transfiere o duplica un archivo de una ruta origen a una ruta destino. Permite crear la carpeta de destino automáticamente si no existe y sobrescribir archivos coincidentes.
Renombrar Archivo: Cambia el nombre de un archivo en disco especificando su nuevo nombre e incluyendo la extensión de archivo.

2. Manipulación y Procesamiento de Datos

2.1 Operaciones con Cadenas de Texto (Strings)

Contador de Palabras: Devuelve el número total de palabras contenidas en una cadena de texto.
Dividir Texto (Split): Divide una cadena de texto en múltiples elementos basándose en un carácter delimitador (ej. , o saltos de línea [CrLf]) y devuelve un arreglo para ser iterado.
Extracción de Texto: Extrae subcadenas específicas de un bloque de texto más amplio seleccionando criterios como: Extraer todo antes del texto, después del texto o entre textos.
Reemplazar Texto: Busca coincidencias de un patrón de texto dentro de una variable y las sustituye por un valor de reemplazo.
Sub Cadena: Extrae un fragmento de texto indicando la posición de inicio (1-indexed) y la longitud deseada.
Longitud de Palabra: Obtiene el número exacto de caracteres de una variable de texto.

2.2 Fechas, Expresiones Regulares y Logs

Calcular Fechas: Permite realizar sumas y restas de tiempo (horas, minutos, días, meses, años) a una fecha origen y guardar el resultado en una variable.
Formato a Datos: Aplica un formato visual a números y fechas de acuerdo a la sintaxis del lenguaje .NET (ej. dd/MM/yyyy o formato moneda C2).
Extraer RegEx: Realiza extracciones complejas de texto mediante patrones de expresiones regulares (ej. extraer correos electrónicos o números telefónicos).
Log de Datos: Registra mensajes personalizados en un archivo de bitácora local (.log) para fines de depuración o auditoría.
Modificar Variable (Base64 y Case): Codifica o decodifica cadenas de texto en formato Base64, o convierte variables de texto a mayúsculas o minúsculas de forma directa.

2.3 Procesamiento de JSON

Parsear Objeto JSON: Analiza una estructura JSON y extrae un valor específico utilizando la nomenclatura estándar de consulta JSONPath (ej. $.cliente.id).
Parsear Array JSON: Convierte una matriz o arreglo JSON en una lista indexada de Vivabots para poder ser recorrida en bucle.
Extraer de PDF: Extrae todo el contenido de texto legible dentro de un archivo de documento PDF de forma nativa.

3. Automatización de Microsoft Excel

Vivabots ofrece un conjunto completo de comandos para interactuar con hojas de cálculo. La suite permite tanto abrir Excel interactivamente para el usuario (mediante automatización COM) como leer archivos de forma ultra-rápida y en segundo plano sin abrir la interfaz de Excel (mediante consultas OLEDB/Database).

Crear Excel: Inicia un nuevo proceso de la aplicación de Excel y le asigna un Nombre de Instancia único (ej. Reportes1). Este nombre servirá de identificador para todas las siguientes actividades del libro.
Abrir Libro: Abre un archivo de Excel existente (.xlsx, .xls, .xlsm) y lo vincula al Nombre de Instancia correspondiente.
Activar Hoja: Cambia el foco del libro activo a una hoja de trabajo específica identificada por su nombre (ej. Enero).
Agregar Libro: Añade una nueva pestaña u hoja de cálculo vacía al libro vinculado a la instancia.
Crear Conjunto de Datos (Lectura Rápida OLEDB): Lee un rango de celdas de un libro de Excel y lo convierte en un conjunto de datos en memoria de forma instantánea. No requiere que la aplicación de Excel esté abierta, ya que realiza una lectura binaria directa.
Conjunto de Datos de Excel en Bucle: Permite iterar línea por línea a través de los registros del conjunto de datos en memoria creado previamente con la actividad anterior.
Obtener Celda: Lee el valor de una celda específica de la hoja activa (ej. C3) y lo asigna a una variable.
Establecer Celda: Escribe un valor de texto o variable en una coordenada de celda especificada de la hoja activa.
Ir a la Celda: Mueve el puntero de selección activa de Excel a una celda específica.
Eliminar Celda: Borra una celda o rango de celdas (ej. A1:C1) de la hoja activa, permitiendo elegir si las celdas sucesoras se desplazarán hacia arriba.
Borrar Fila: Elimina por completo una fila indexada de la hoja (ej. fila 3) y permite desplazar las filas inferiores hacia arriba.
Obtener el Índice de la Última Fila: Recupera el número total de filas que contienen datos en una columna determinada. Es ideal para calcular el límite de iteraciones en bucles.
Ejecutar Macro: Ejecuta de forma directa una macro VBA contenida en el libro de Excel especificando su nombre exacto.
Guardar Libro: Guarda los cambios realizados en el archivo de Excel activo.
Guardar Libro Como: Guarda el documento de Excel activo en una nueva ruta de almacenamiento.
Cerrar Excel: Cierra el libro de Excel y libera la instancia de memoria. Permite configurar si los cambios pendientes deben ser guardados (True) o descartados (False).