Download Storage File

Download Storage File

Tipo: storage-download-file  ·  Paquete: Storage Activities v1.0.5  ·  Salida: string

Descarga un archivo de un bucket del Almacenamiento de Zoan Cloud al disco del robot, para trabajar con él (abrirlo en Excel, adjuntarlo a un correo, cargarlo en un sistema). Devuelve la ruta local donde quedó guardado.

Cómo funciona

1. Identifica el archivo por su id o por bucket + name. Si indicas id, se ignoran bucket y name.
2. Pide a Zoan Cloud un enlace temporal de descarga y baja el archivo a destination.
3. Crea las carpetas de destination que no existan. Si ya hay un archivo en esa ruta, lo sobrescribe.

Si el bucket tiene activada la auditoría de descargas, la lectura queda registrada.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
destination	string	—	Ruta local donde se guarda el archivo, con su nombre. Ej: C:/trabajo/ventas.xlsx.

Además, debes indicar id o name (ver parámetros opcionales).

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
id	string	—	Id del archivo (alternativa a bucket + name).
name	string	—	Nombre del archivo dentro del bucket, con sus carpetas. Ej: 2026/ventas.xlsx.
bucket	string	"default"	Nombre del bucket. Solo se usa con name.

Salida

Devuelve un string con la ruta local del archivo descargado (el mismo valor de destination). Si el archivo no existe, la actividad falla: no devuelve una ruta vacía.

Errores comunes

Mensaje	Causa y solución
'destination' es obligatorio.	No indicaste destination.
Indica 'id' o 'name'.	No indicaste ni id ni name.
… HTTP 404: …File not found in this environment.	No hay un archivo con ese id o con ese bucket + name en el ambiente donde corre el robot (los nombres distinguen mayúsculas y carpetas). Comprueba la referencia con List Storage Files.
… HTTP 400: …Invalid bucket name…	El nombre del bucket tiene caracteres no permitidos.
La descarga falló: HTTP {código}.	Falló la descarga del enlace temporal (red, proxy). Reintenta con Retry.
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 pudo descargar el archivo: ”. Un error al escribir en destination (ruta inválida, sin permisos, archivo abierto en otro programa) también hace fallar la actividad.

Ejemplo

Download Storage File   bucket = "reportes"   name = "2026/ventas.xlsx"
                        destination = "C:/trabajo/ventas.xlsx"   → output: ruta
Read Excel Sheet        path = ruta   hasHeader = true   → output: ventas

Actividades relacionadas

• Upload Storage File — subir un archivo al bucket.
• List Storage Files — buscar el archivo que quieres descargar.
• Get Storage File URL — obtener el enlace sin descargar el archivo.