Descripción General #
La función LISTAR CARPETAS pertenece al comando fileFx dentro de la categoría RPA (Documentos) de STELA. Su propósito principal es inspeccionar un directorio específico del sistema de archivos local o de red y extraer el listado completo de sus subcarpetas de primer nivel.
LISTAR CARPETAS genera un contenedor estructurado (etiqueta) en STELA. Dentro de este contenedor se almacena la cantidad total de subcarpetas encontradas (cant_carpetas) e indexa cada directorio detectado (carpeta1, carpeta2…carpetaN) con su nombre correspondiente.
Estructura de variables generadas en el contenedor:
- cant_carpetas: Número total de subcarpetas encontradas (ej. 3).
- carpeta1: Nombre de la primera subcarpeta detectada.
- carpeta2: Nombre de la segunda subcarpeta detectada.
- carpetaN: Nombre de la n-ésima subcarpeta detectada.
Parámetros y opciones #
Función (obligatorio): Operación a ejecutar dentro del comando. Selecciona o ingresa la opción LISTAR CARPETAS.
Parámetro 1 (obligatorio) — Ruta de la Carpeta: Especifica la ruta completa del directorio que deseas inspeccionar (ejemplo: C:\temp\procesos o \\servidor\compartido\carpetas).
Parámetro 2 (opcional) — Contenedor / Etiqueta Destino: Nombre de la etiqueta donde STELA guardará el bloque de resultados. Si se omite este campo, STELA asignará una etiqueta por defecto basada en FileFx.
Guardar Resultado (no aplica): Esta opción no se utiliza como variable escalar en esta función. Todos los datos resultantes se estructuran en el contenedor definido en el Parámetro 2.
Usos más comunes #
- Integración con Almacenamiento Remoto o Compartido:En entornos corporativos, el robot inspecciona la ruta de red , STELA lista únicamente las carpetas de primer nivel accesible, permitiendo comprobar si hay nuevos lotes de trabajo listos para su procesamiento sin alterar los archivos dentro de ellos
- Auditoría y Control de Subdirectorios Temporales:Esta funcionalidad es fundamental para procesos de automatización que requieren iterar, validar o procesar estructuras de directorios dinámicas de forma automatizada. Por ejemplo en un flujo de mantenimiento permite inspeccionar los subdirectorios temporales dentro del sistema de archivo; guarda el resultado en el contenedor
cant_carpetascon lo que el robot invoca rutinas adicionales para archivar o eliminar directorios antiguos
Ejemplo de uso #
Imagina un proceso diario en el que un robot debe verificar los directorios de clientes generados dentro de una ruta específica para comprobar qué carpetas se crearon durante la jornada y continuar con la auditoría de documentos.
Pasos
1.Seleccionar la función LISTAR CARPETAS en la parametrización del comando FileFx
2. Configurar Parámetro 1: Define la ruta completa del repositorio a verificar C:\Empresa\Clientes
3. Configurar Parámetro 2:Define la etiqueta CarpetasClientes para guardar el resultado
4. Ejecutar el bot con la función LISTAR CARPETAS
5. Verificar el contenedor CarpetasClientes con la variable cant_carpetas. (Ver archivo _wrk_datos en la carpeta de logs)
Al ejecutarse, el robot inspecciona la ruta y guarda automáticamente variables en memoria como la cantidad total y el nombre de cada una de las subcarpetas encontradas, permitiendo al flujo posterior recorrer cada cliente secuencialmente.
Errores Comunes y Soluciones #
- Error: Acceso denegado / Permisos insuficientes en el sistema de archivos.
- Solución: Asegúrate de que el usuario o servicio que ejecuta el agente de STELA posea permisos de lectura e inspección de directorios en la ruta de destino o carpeta compartida de red.
- Error: No se encuentran las variables de carpetas esperadas en los pasos posteriores.
- Solución: Confirma que estés haciendo referencia a las variables utilizando la sintaxis de contenedor o etiqueta definida en el Parámetro 2 .