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

# 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 (`cant_archivos`) y variables individuales con los nombres de cada uno de los archivos localizados

##### Parámetros y opciones

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

- **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:tempentradas` o `D:ProcesosArchivos`). 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:DownloadsFacturas`

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

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

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

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

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.

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

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