Storage Activities

Versión: 1.0.5 · ID: zoan-packages-storage · Autor: Zoan Software

El paquete Storage permite que un robot guarde y recupere archivos en el Almacenamiento de Zoan Cloud: un espacio de archivos en la nube, propio de cada ambiente, que comparten los procesos, los asistentes de IA y las personas desde el portal. Es útil para dejar un reporte generado por el robot donde otros lo encuentren, pasar un archivo de un proceso a otro (aunque corran en máquinas distintas) o compartir un documento con un enlace temporal.

Buckets, nombres y carpetas

El almacenamiento se organiza en buckets (contenedores). Cada ambiente tiene siempre un bucket default, que es el que usan las actividades cuando no indicas otro. Los buckets se ven y se administran en el menú Almacenamiento de Zoan Cloud (ver Almacenamiento).
Si subes un archivo a un bucket que todavía no existe, se crea automáticamente. El nombre de un bucket admite letras, dígitos, punto, guion bajo y guion (hasta 120 caracteres).
Cada archivo se identifica por su id o por la pareja bucket + name. El nombre puede incluir carpetas separadas por /, por ejemplo reportes/2026/ventas.xlsx.
Un bucket puede estar marcado como solo lectura (no admite subidas ni borrados) o auditar las descargas (cada enlace de descarga queda registrado en la auditoría).
Zoan Cloud reserva algunos buckets para uso interno (por ejemplo, el de los archivos que las personas adjuntan al responder una tarea): las actividades de Storage no los leen ni los escriben, y responden como si no existieran.

Cómo se autentica el robot

No necesitas credenciales. Las actividades usan la identidad de la ejecución que Zoan Cloud entrega al robot, y esa identidad ya define el tenant y el ambiente: un robot solo ve los archivos del ambiente donde corre y no puede leer los de otro.

La referencia de archivo

Upload Storage File y List Storage Files devuelven referencias de archivo con esta forma:

Campo	Tipo	Descripción
`id`	`string`	Id del archivo (UUID). Sirve para referenciarlo en las demás actividades.
`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 que Zoan Cloud detectó en los bytes del archivo (ej. `application/pdf`).
`created_at`	`string`	Fecha de creación (ISO 8601, UTC).

Actividades

Actividad	Tipo	Salida	Qué hace
Upload Storage File	`storage-upload-file`	`object`	Sube un archivo local a un bucket
Download Storage File	`storage-download-file`	`string`	Descarga un archivo del bucket a una ruta local
List Storage Files	`storage-list-files`	`List<Dictionary<string,object>>`	Lista los archivos del ambiente o de un bucket
Get Storage File URL	`storage-get-file-url`	`string`	Devuelve un enlace temporal de descarga
Delete Storage File	`storage-delete-file`	—	Borra un archivo del bucket

Cuando Zoan Cloud rechaza una operación

El mensaje de la actividad incluye la operación, el código HTTP y la respuesta del servidor, por ejemplo:

“No se pudo descargar el archivo: Falló GET /internal/storage/files/url en Zoan Cloud: HTTP 404: {“error”:{…,“message”:“File not found in this environment.”}}”

El message de la respuesta dice la causa. Cada página de actividad lista los casos habituales en Errores comunes. Todos estos errores se pueden capturar con Try / Catch.

Un flujo típico

Un proceso genera un reporte y lo deja en el almacenamiento; otro proceso, en otra máquina, lo descarga para trabajar con él:

// Proceso A
Upload Storage File     path = "C:/reportes/ventas.xlsx"   bucket = "reportes"
                        name = "2026/ventas.xlsx"   → output: archivo

// Proceso B
Download Storage File   bucket = "reportes"   name = "2026/ventas.xlsx"
                        destination = "C:/trabajo/ventas.xlsx"   → output: ruta

Siguientes pasos

Upload Storage File — el punto de partida.
Get Storage File URL — compartir un archivo con un enlace temporal.
Almacenamiento en Zoan Cloud — administrar buckets desde el portal.