🇮🇹 IT

📁 Local File

Legge, scrive o aggiunge contenuto a file sul filesystem locale del server. Usalo per persistere dati tra le esecuzioni, elaborare file caricati, generare report o scambiare dati con altre applicazioni in esecuzione sullo stesso server.

Categoria: Operazioni su File · Identificatore tipo: local_file

Panoramica

Il nodo Local File fornisce accesso diretto al filesystem del server su cui e in esecuzione Flusso. Supporta tre operazioni: leggere l'intero contenuto di un file nel contesto del workflow, scrivere (creare o sovrascrivere) un file con nuovo contenuto, e aggiungere contenuto a un file esistente senza eliminare quello gia presente.

I percorsi possono essere assoluti (ad es. /var/data/output.txt) e supportano riferimenti {{ variable }}, rendendo semplice costruire nomi di file dinamici da payload del trigger o output di step precedenti. Quando l'opzione Create Directories e attiva, le directory padre mancanti nel percorso vengono create automaticamente prima della scrittura.

Accesso solo al server. I file scritti qui esistono sul server Flusso, non sulla tua macchina locale. Usa Google Drive, Dropbox o Amazon S3 se i file devono essere accessibili da altre macchine o condivisi con utenti esterni.

Configurazione

Campo	Stato	Descrizione
Operation	Obbligatorio	`read` — legge l'intero contenuto del file in memoria. `write` — crea o sovrascrive completamente il file. `append` — aggiunge contenuto alla fine di un file esistente; crea il file se non esiste.
Path	Obbligatorio	Percorso assoluto del file, ad es. `/var/data/output.txt`. Supporta riferimenti `{{ variable }}` per nomi di file dinamici.
Content	Obbligatorio per write/append	Il testo o i dati da scrivere. Supporta riferimenti `{{ variable }}`.
Encoding	Opzionale	Codifica del file. Predefinito: `utf-8`. Opzioni: `utf-8`, `base64`.
Create Directories	Opzionale	Attiva/disattiva. Quando attivo, crea automaticamente le directory padre mancanti. Predefinito: attivo.

Dati di Output

Questi campi sono disponibili negli step successivi usando la chiave step del nodo.

Campo	Tipo	Descrizione
`content`	string	Contenuto del file (solo modalita lettura).
`path`	string	Percorso assoluto del file su cui si e operato.
`size`	number	Dimensione del file in byte dopo l'operazione.
`success`	boolean	True se l'operazione e stata completata senza errori.

Esempio di Utilizzo

Un nodo Loop itera sui record di uno step precedente.
All'interno del loop, un nodo Local File con Operation: append scrive ogni risultato elaborato come una nuova riga in /var/reports/daily.txt.
Dopo l'uscita dal loop, un secondo nodo Local File con Operation: read ricarica il file completato nel contesto del workflow.
Un nodo Email Notification allega il contenuto del file all'email del report finale.

Suggerimenti e Note

Usa l'operazione append all'interno di un Loop per costruire un file di log o CSV riga per riga senza sovrascrivere i dati precedenti.
I percorsi dinamici con {{ variable }} ti permettono di organizzare i file per data, utente o ID esecuzione automaticamente — ad esempio /var/exports/{{ trigger.output.date }}-report.csv.
L'opzione di codifica base64 e utile quando si leggono file binari (immagini, PDF) che devono essere incorporati in uno step successivo come stringa Base64.
File molto grandi possono causare pressione sulla memoria quando letti in un singolo step. Per file che superano qualche centinaio di megabyte, considera l'elaborazione a blocchi o un approccio di streaming dedicato.
L'opzione Create Directories e attiva per impostazione predefinita, quindi non e necessario pre-creare la struttura delle cartelle in anticipo.

Nodi Correlati

Google Drive — archivia file in Google Drive per accesso multi-macchina e condivisione.
Dropbox — archivia file in Dropbox.
Amazon S3 — archiviazione di oggetti scalabile compatibile con AWS e provider di terze parti.
Loop — itera sugli array e usa Local File all'interno del corpo del loop.