List Storage Files

List Storage Files

Tipo: storage-list-files  ·  Paquete: Storage Activities v1.0.5  ·  Salida: List<Dictionary<string,object>>

Lista los archivos del Almacenamiento de Zoan Cloud en el ambiente donde corre el robot. Sirve para procesar todo lo que llegó a un bucket (por ejemplo, documentos que las personas suben desde el portal) o para comprobar si un archivo ya existe.

Cómo funciona

• Con bucket, devuelve solo los archivos de ese bucket.
• Sin bucket, devuelve los archivos de todos los buckets del ambiente (sin los buckets reservados de Zoan Cloud).

El resultado viene ordenado por bucket y por nombre, y trae todos los archivos (no hay paginación). Cada elemento es una referencia de archivo.

Carpetas vacías

Las carpetas que se crean desde el portal se guardan como un archivo vacío llamado .folder dentro de la carpeta (ej. facturas/.folder). La actividad omite esos marcadores, así que la lista solo trae archivos reales: puedes recorrerla directamente. Una carpeta vacía, por lo tanto, no aparece en el resultado.

Parámetros requeridos

Ninguno.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
bucket	string	—	Bucket por el que filtrar. Vacío = todos los buckets del ambiente.

Salida

Devuelve una lista de diccionarios, uno por archivo:

Campo	Tipo	Descripción
id	string	Id del archivo.
bucket	string	Bucket donde está.
name	string	Nombre dentro del bucket, con sus carpetas.
size	number	Tamaño en bytes.
content_type	string	Tipo de contenido detectado.
created_at	string	Fecha de creación (ISO 8601, UTC).

Si no hay archivos (o el bucket indicado aún no existe), devuelve una lista vacía: no es un error.

Errores comunes

Mensaje	Causa y solución
… HTTP 400: …Invalid bucket name…	El nombre de bucket tiene caracteres no permitidos.
… HTTP 404: …Ese bucket no existe en este ambiente.	Pediste un bucket reservado de Zoan Cloud, que no se puede listar.
Las actividades de almacenamiento requieren el contexto de ejecución de Zoan Cloud. Falta: …	El proceso no corre desde Zoan Cloud ni desde el Designer con sesión iniciada.

Los errores llegan con el prefijo “No se pudieron listar los archivos: ”.

Ejemplo

Descargar todos los archivos del bucket entrada para procesarlos:

List Storage Files   bucket = "entrada"   → output: archivos
For Each   items = archivos   itemVariable = f
 └─ activities:
      Download Storage File   id = f["id"]
                              destination = "C:/entrada/" + str(f["name"])

Actividades relacionadas

• Download Storage File — descargar cada archivo.
• Delete Storage File — limpiar el bucket al terminar.
• Upload Storage File — subir archivos nuevos.