---
title: FileFx – Listar carpetas
description: "##### 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…"
url: "https://www.stela.ai/wiki/filefx-listar-carpetas/"
updated: "2026-08-10"
category: Comandos RPA
---

# FileFx – Listar carpetas

##### 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

![Comando FileFx parámetros STELA](https://www.stela.ai/wp-content/uploads/2026/08/image-19.png)

**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:tempprocesos` o `\servidorcompartidocarpetas`).

**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_carpetas` con 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:EmpresaClientes`

3. Configurar **Parámetro 2**:Define la etiqueta `CarpetasClientes` para guardar el resultado

![Comando FileFx ejemplo parámetros STELA](https://www.stela.ai/wp-content/uploads/2026/08/image-20.png)

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

![Comando FileFx ejemplo log STELA](https://www.stela.ai/wp-content/uploads/2026/08/image-21-1024x299.png)

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.

![Comando FileFx ejemplo _wrk_datos STELA](https://www.stela.ai/wp-content/uploads/2026/08/image-22.png)

##### 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* .