Filesystem Activities

Versión: 1.0.0  ·  ID: zoan-packages-fs  ·  Autor: Zoan Software

El paquete Files (filesystem) trabaja con archivos y carpetas del sistema: leer y escribir archivos de texto, copiar, mover, eliminar, comprobar si algo existe y listar el contenido de una carpeta. Es un paquete de apoyo presente en casi toda automatización — para organizar descargas, generar archivos de salida, mover documentos procesados o leer datos de configuración.

Para datos estructurados, usa el paquete específico

Este paquete maneja archivos de texto y operaciones de archivo/carpeta. Para leer o escribir formatos con estructura, usa el paquete adecuado: Excel (.xlsx), CSV, JSON, XML, PDF o Word.

Rutas de archivo

Casi todas las actividades reciben una ruta. Puedes indicarla de dos formas:

• Ruta absoluta: C:\reportes\salida.txt o C:/reportes/salida.txt. En expresiones, recuerda que la barra invertida se escribe literal: = "C:\reportes\" + nombre. Ver rutas de Windows.
• Archivo del proyecto con asset(...): para archivos que viajan dentro de tu paquete (plantillas, datos de ejemplo), usa = asset("datos/entrada.txt"). Resuelve la ruta correcta sin importar en qué máquina se ejecute. Ver asset().

Construye rutas de forma segura

Para unir carpetas y nombres de archivo, usa pathJoin(carpeta, archivo) en vez de concatenar con \ a mano — evita errores con las barras. Ver funciones de archivos.

Sobrescritura (overwrite)

Cuidado con los valores por defecto, que no son iguales en todas las actividades:

Actividad	overwrite por defecto
Write File	true — reemplaza el archivo existente
Copy File / Move File	false — falla si el destino ya existe

Actividades

Leer y escribir texto

Actividad	Tipo	Salida	Qué hace
Read File	read-file	string	Lee el contenido de un archivo de texto
Write File	write-file	—	Escribe texto en un archivo (lo crea o reemplaza)
Append to File	append-file	—	Añade texto al final de un archivo

Operaciones de archivo

Actividad	Tipo	Salida	Qué hace
File Exists	file-exists	boolean	¿Existe el archivo?
Copy File	copy-file	—	Copia un archivo a otra ruta
Move File	move-file	—	Mueve o renombra un archivo
Delete File	delete-file	—	Elimina un archivo

Carpetas

Actividad	Tipo	Salida	Qué hace
Create Directory	create-directory	—	Crea una carpeta (y las que falten en la ruta)
List Files	list-files	string[]	Lista los archivos/carpetas de un directorio

Un flujo típico

Procesar cada archivo descargado y archivarlo:

List Files   path = "C:/descargas"   pattern = "*.xlsx"   → output: archivos

For Each   items = = archivos   itemVariable = ruta
 └─ activities:
      ... procesar el archivo ...
      Move File   source = = ruta   destination = = pathJoin("C:/procesados", fileName(ruta))

Siguientes pasos

• Read File / Write File — lo más usado.
• List Files — recorrer una carpeta.
• Expresiones › Archivos y rutas — pathJoin, fileName, asset…