FileFx – Listar archivos - STELA Automation made Simple

Descripción General #

La función LISTAR ARCHIVOS pertenece al comando RPA FileFx. Su objetivo principal es inspeccionar una carpeta del sistema de archivos y obtener la lista de todos los archivos visibles presentes en ella.

Esta función almacena los resultados dentro de un contenedor o etiqueta estructurada. Genera automáticamente una variable con el total de archivos encontrados (cant_archivos) y variables individuales con los nombres de cada uno de los archivos localizados

Parámetros y opciones #

Función (obligatorio): Operación a ejecutar dentro del comando. Selecciona o escribe LISTAR ARCHIVOS
Parámetro 1 (obligatorio): Especifica la ruta completa de la carpeta que deseas inspeccionar (ejemplo: C:\temp\entradas o D:\Procesos\Archivos). Debe corresponder a un directorio existente en el equipo ejecutor.
Parámetro 2 (opcional): Nombre del contenedor o etiqueta donde STELA guardará la estructura de datos resultante. Si dejas este campo vacío, STELA utilizará una etiqueta predeterminada del sistema .
Guardar resultado (no aplica): Esta función no utiliza una variable escalar directa para este parámetro, ya que la información se organiza en formato de grupo/etiqueta dentro de Parámetro 2.

Usos más comunes #

Procesamiento dinámico de archivos en lote: Si necesitas iterar sobre una cantidad variable de documentos recibidos en una carpeta, utiliza LISTAR ARCHIVOS. A continuación, puedes emplear una condición o bucle para recorrer dinámicamente desde archivo1 hasta archivoN y procesar cada documento individualmente.
Validación de carpetas de entrada antes de la ejecución: Antes de ejecutar un flujo masivo de integración, configura LISTAR ARCHIVOS sobre la carpeta de entrada. Luego, evalúa mediante una condición si cant_archivos es mayor a 0. Si el valor es 0, el robot puede desviar el flujo o enviar una notificación indicando que no hay insumos pendientes para procesar.
Control y auditoría post-procesamiento: Luego de ejecutar una rutina de descompresión o generación de reportes, aplica LISTAR ARCHIVOS sobre la carpeta destino. Esto permite registrar en la evidencia la cantidad final y los nombres de los archivos generados exitosamente.

Ejemplo de uso #

Imagina que tu robot descarga diariamente un conjunto de facturas en formato PDF dentro de la carpeta de Descargas y necesitas saber cuántos archivos se descargaron y cuáles son sus nombres antes de procesarlos.

Pasos

1.Seleccionar la función LISTAR ARCHIVOS en la parametrización del comando FileFx

2. Configurar Parámetro 1: Define la ruta completa del repositorio a verificar C:\Downloads\Facturas

3. Configurar Parámetro 2:Define la etiqueta FacturasDiarias para guardar el resultado

4. Ejecutar el bot con la función LISTAR ARCHIVOS

5. Verificar el contenedor FacturasDiarias con la variable cant_archivos. (Ver archivo _wrk_datos en la carpeta de logs)

El robot inspecciona la carpeta y crea el contenedor con la variable cant_archivos reflejando el total y las variables archivo1, archivo2, etc., con el nombre de cada PDF.

Errores Comunes y Soluciones #

Error: El robot no genera las variables con los nombres de los archivos.
- Solución: Asegúrate de estar consultando las variables mediante la etiqueta definida en el Parámetro 2 , en lugar de buscar una sola variable escalar en el campo Guardar resultado.
Error de permisos al intentar acceder al directorio.
- Solución: Confirma que el usuario o el servicio bajo el cual se ejecuta el agente de STELA cuente con permisos de lectura sobre la carpeta y la red correspondiente.