View Categories

FileFx – Listar archivos

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 (fileCount) 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 (como FileFx).
  • 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 file1 hasta fileN 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 fileCount 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 #

magina que tu robot descarga diariamente un conjunto de facturas en formato PDF dentro de la carpeta C:\Descargas\Facturas y necesitas saber cuántos archivos se descargaron y cuáles son sus nombres antes de procesarlos. El robot inspeccionará la carpeta y creará el contenedor con la variable fileCount reflejando el total y las variables file1, file2, etc., con el nombre de cada PDF.

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 archivo a verificar C:\Descargas\Facturas
  3. Definir 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 fileCount. (Ver archivo _wrk_datos en la carpeta de logs)
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.