Descripción General #
La función BUSCAR del comando XlsFx tiene como propósito realizar consultas avanzadas y condicionadas sobre un rango específico de celdas en archivos de Excel o planillas CSV. A diferencia de una lectura simple celda por celda, esta función actúa como un motor de filtrado interno que localiza todas las filas que cumplen simultáneamente con los criterios definidos y extrae la información estructurada hacia un contenedor de STELA para su posterior procesamiento en el flujo.
Parámetros y Opciones #
A continuación, se detalla cada uno de los parámetros configurables:
- Archivo (Obligatorio; tipos: file, texto, constante, variable): Define la ruta física del archivo .xls, .xlsx o .csv sobre el cual se ejecutará la búsqueda.
- Función (Obligatorio): Debe ingresarse el valor exacto BUSCAR.
- Parámetro 1 – Rango (Obligatorio): Delimita el cuadrante de celdas que el comando va a escanear y evaluar (ej: A2:D50).
- Parámetro 2 (Obligatorio): Primera condición de búsqueda obligatoria bajo la estructura Columna: criterio.
- Columna: Letra de la columna que se desea evaluar (ej: B).
- Criterio: Permite evaluar un dato comparándolo contra un valor fijo, una variable o utilizando operadores lógicos de comparación. Ejemplo:
A:Producto 1(Evalua cuantas veces aparece la palabra Producto 1 en la columna A), C:<49(Evalúa si el valor en la columna C del campo A es menor que 49)
- Parámetro 3 y 4 – Filtro2 y Filtro3 (Opcionales): Permiten añadir hasta dos condiciones lógicas adicionales bajo el mismo formato Columna: criterio. El registro examinado debe cumplir con todas las reglas en simultáneo para ser considerado un hallazgo válido.
- Hoja (Opcional): Especifica el nombre de la pestaña de trabajo dentro del libro de Excel.
- Actualizar (Opcional): Determina si se recarga el archivo en la memoria antes de buscar. Si se omite, actúa por defecto como VERDADERO.
- Impactar (Opcional): Define la persistencia en el guardado físico. Al ser un comando estrictamente de lectura, se deja por defecto en VERDADERO o se omite, ya que no altera la estructura de las celdas.
- Contraseña (Opcional): Clave de cifrado en caso de que el archivo de origen esté protegido.
- Encoding (csv) (Opcional): Codificación aplicable únicamente si el origen es un archivo CSV. Si se omite, toma de forma automática UTF-8.
- Guardar resultado (Obligatorio): Nombre del contenedor o etiqueta general bajo el cual se estructurará el bloque de resultados obtenidos.
Comportamiento del Contenedor de Salida #
Este comando no genera una variable única de tipo escalar, sino que crea un conjunto organizado de variables indexadas dentro del contenedor indicado en guardar resultado. STELA almacena y expone internamente las siguientes claves funcionales:
- cant_datos: Almacena el número total de filas que coincidieron con los filtros establecidos.
- num_col: Cantidad de columnas procesadas dentro del rango.
- num_row: Índices de las filas donde se detectaron los hallazgos.
- dato1, dato2, dato3…: Contenido de texto consolidado por cada registro que superó con éxito las condiciones de búsqueda.
Ejemplos de Uso Avanzado #
- Búsqueda Combinada Multicriterio (Texto y Números): Para auditar un reporte de ventas consolidado en el rango A2:E100, necesitas identificar los registros de la sucursal Norte con montos superiores a 5000. Se configura los filtros en los parámetros correspondientes para que realicen la extracción cruzada en una sola instrucción: {xlsFx} ; C:\procesos\ventas.xlsx ; BUSCAR ; A2:E100 ; B:Norte ; C:>5000 ; ; Monitoreo ; VERDADERO ; VERDADERO ; ; ; ResultadosNorte
- Validación de Registros por Rangos Cronológicos: Cuando procesas un lote operativo y requieres extraer únicamente los contratos o transacciones cuya fecha de alta sea igual al cierre del periodo (ej: 31/12/2026)
- Sincronización y Cruce de Datos entre Archivos: Se utiliza cuando es necesario actualizar la información de un archivo de Excel (Destino) tomando como base los datos de un segundo archivo (Origen). El robot ejecuta un bucle (ciclo) que recorre el archivo origen, utiliza la función BUSCAR para localizar la fila exacta mediante una llave primaria o referencia (como un ID), y actualiza los campos correspondientes de forma masiva y automatizada.
Errores Comunes y Soluciones #
- Error: La búsqueda de texto exacto no arroja resultados a pesar de que la palabra está parcialmente visible en la celda.
- Solución: Los operadores directos como :texto ejecutan una comparación estricta por igualdad completa sobre el contenido de la celda.
- Error: El robot falla al intentar recuperar los datos de forma directa usando la variable de salida.
- Solución: Recuerda que el parámetro guardar resultado en la función BUSCAR genera un contenedor multidimensional (etiqueta con múltiples entradas) y no una variable simple. Para consumir la información en pasos subsiguientes, debes invocar las variables complementarias del contenedor, validando primero si existen registros mediante la lectura de la variable cant_datos.
Ejemplo de Uso #
Supongamos que el robot está procesando el archivo de inventario (Productos.xlsx) que contiene 100 registros en la pestaña «Productos». Necesita revisar la tabla en el rango A2:D101 para ubicar la primera fila que pertenezca a la categoría Herramientas y el producto sea “Martillo #1”, con el fin de extraer su información o editar su stock en pasos posteriores.
Ejemplo de Configuración en STELA
| Parámetro | Valor de ejemplo | Descripción |
| Hoja | Productos | La pestaña original que tiene el diseño. |
| Archivo | «C:\User \Downloads\reporte.xlsx» | El archivo donde queremos la copia. |
| Rango (Parámetro 2) | A2:D101 | Rango de búsqueda |
| Criterio (Parámetro 3) | C: Herramientas | El robot evaluará los valores únicamente de la columna C (Categoría). |
| Guardar resultado | vBuscar | Contenedor XlsFx |
Pasos:
- Buscar el comando XlsFx en la sección RPA (Documentos)
2. Seleccionar la función “BUSCAR”
3. Configurar los Parámetros requeridos
4. Agregar un mensaje para visualizar en el log en cual fil se encuentra el dato requerido
5. Descargar y Ejecutar
6. Revisamos la evidencia
