SFTP List Directory

SFTP List Directory

Tipo: sftp-list  ·  Paquete: SFTP Activities v1.1.0  ·  Salida: List<object>

Lista los archivos y carpetas de una ruta remota. Es la base de los procesos que recogen archivos: ver qué hay disponible en el servidor para descargarlo y procesarlo.

Cómo funciona

Lista el contenido directo de remotePath (no entra en subcarpetas) y, si das pattern, se queda con los nombres que lo cumplen. Las entradas especiales . y .. se omiten. El resultado incluye archivos y carpetas: usa isDirectory para distinguirlos.

El patrón admite * (cualquier texto) y ? (un carácter), se compara con el nombre completo y no distingue mayúsculas: *.csv encuentra datos.CSV.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
remotePath	string	—	Carpeta remota a listar.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
session	ZoanSftpSession	—	Sesión de SFTP Connect. Dentro de un body se hereda.
pattern	string	—	Patrón de nombre, ej. "*.csv", "reporte_????.txt". Sin valor se devuelve todo.

Salida

Devuelve una List<object> en la que cada elemento es un diccionario con estas claves:

Clave	Tipo	Contenido
name	string	Nombre del archivo o carpeta.
fullName	string	Ruta remota completa (úsala en Download, Move o Delete).
size	number	Tamaño en bytes.
isDirectory	bool	true si es una carpeta.
lastWriteTime	string	Fecha de última modificación en formato ISO 8601 (ej. "2026-10-15T08:30:00.0000000-05:00").

El orden es el que entrega el servidor (no necesariamente alfabético). Si la carpeta está vacía o nada cumple el patrón, devuelve una lista vacía.

Errores comunes

Mensaje	Causa y solución
'remotePath' es obligatorio.	Falta el parámetro o la expresión dio null.
'session' debe ser una ZoanSftpSession.	La actividad está fuera del body de SFTP Connect y no recibió session.
Error del servidor: ruta no encontrada	remotePath no existe o no es una carpeta. Compruébalo con SFTP Exists.
Error del servidor: permiso denegado	El usuario no puede leer esa carpeta.

Ejemplo

Descargar solo los archivos (no las carpetas) que coinciden con el patrón:

SFTP List Directory   remotePath = "/salida"   pattern = "*.csv"   → output: archivos
Log   message = "Archivos disponibles: " + count(archivos)
For Each   items = archivos   itemVariable = item
 └─ activities:
      If   condition = !(bool)item["isDirectory"]
       └─ then:
            SFTP Download   remotePath = item["fullName"]   localPath = pathJoin("C:/descargas", item["name"])

Actividades relacionadas

• SFTP Download — descargar cada archivo listado.
• SFTP Exists — comprobar un archivo concreto.