List Files

List Files

Tipo: list-files  ·  Paquete: Filesystem Activities v1.0.6  ·  Salida: List

Devuelve una lista de rutas de los archivos (o carpetas) que hay dentro de un directorio. Es la base de los procesos que trabajan sobre muchos archivos: recorrer todos los Excel de una carpeta, procesar cada PDF de descargas, archivar lo que llegó hoy. Soporta patrones (*.xlsx), búsqueda en subcarpetas y filtro por tipo.

Cómo funciona

Lista el contenido de la carpeta path. Filtra por el pattern, opcionalmente baja a las subcarpetas (recursive) y decide si incluir archivos, carpetas o ambos (include). Devuelve las rutas como una lista de textos, que normalmente recorres con For Each.

• Orden: las rutas salen ordenadas alfabéticamente. Con include = all, primero todas las carpetas y luego todos los archivos.
• Rutas completas: cada elemento es la ruta de la carpeta indicada más el nombre (y las subcarpetas, si recursive = true), lista para pasar a otra actividad.
• Foto del momento: la lista refleja la carpeta al ejecutar la actividad; los archivos que lleguen después no aparecen.
• Sin efectos secundarios: solo lee la carpeta.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
path	string	—	Carpeta a listar. Ej: C:\descargas.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
pattern	string	"*"	Filtro por nombre con comodines: * (cualquier secuencia) y ? (un carácter). Ej: *.xlsx, factura_*.pdf. Un solo patrón; no admite ** ni listas como *.pdf;*.xml.
recursive	bool	false	Incluir el contenido de todas las subcarpetas.
include	string	"files"	Qué incluir: files (archivos), directories (carpetas) o all (ambos).

Salida

Devuelve una List de string con las rutas encontradas. Si nada coincide, devuelve una lista vacía (no falla): compruébalo con count(archivos) == 0.

Errores comunes

Mensaje	Causa y solución
No se encontró la carpeta.	path no existe o no es una carpeta. Créala antes con Create Directory o revisa la ruta.
Access to the path '…' is denied.	Sin permiso sobre la carpeta, o (con recursive = true) sobre alguna subcarpeta: en ese caso falla toda la búsqueda.
'path' es obligatorio.	La expresión de path dio nulo.

Ejemplo

Procesar todos los Excel de una carpeta y sus subcarpetas:

List Files   path = "C:/datos"   pattern = "*.xlsx"   recursive = true   → output: archivos
Log   message = "Encontrados " + count(archivos) + " archivos"

For Each   items = archivos   itemVariable = ruta
 └─ activities:
      Read Excel Sheet   path = ruta   → output: tabla
      ... procesar ...

Patrones

El pattern usa comodines: * (cualquier secuencia) y ? (un carácter). Ejemplos: *.pdf (todos los PDF), reporte_*.xlsx (los que empiezan por reporte_), 2026-??-*.csv. Para filtros más complejos, lista todo y filtra después con expresiones (regex).

Actividades relacionadas

• For Each — recorrer los archivos listados.
• Move File / Copy File — actuar sobre cada archivo.
• File Exists — comprobar un archivo concreto.