🇮🇹 IT

📦 Dropbox

Legge o scrive file in un account Dropbox. Supporta il download di file, il caricamento di nuovi contenuti e la sovrascrittura di file esistenti. Richiede credenziali OAuth Dropbox da Impostazioni → Integrazioni.

Categoria: Operazioni su File · Identificatore tipo: dropbox

Panoramica

Il nodo Dropbox connette i workflow Flusso al tuo storage Dropbox. Puoi leggere il contenuto di un file nel contesto del workflow per l'elaborazione, caricare contenuto generato come nuovo file, o sovrascrivere un file esistente a un percorso noto.

I percorsi Dropbox iniziano sempre con una barra e usano la stessa struttura mostrata nell'interfaccia web di Dropbox — ad esempio, /Reports/output.csv. I percorsi supportano riferimenti {{ variable }} così puoi costruire nomi di file dinamici dai dati del workflow.

Prerequisito: Le credenziali Dropbox devono essere connesse in Impostazioni → Integrazioni prima che questo nodo possa accedere al tuo account. Un amministratore deve completare questo passaggio una volta per il tuo account Flusso.

Configurazione

Campo	Stato	Descrizione
Credential	Obbligatorio	Credenziale dell'account Dropbox da Impostazioni → Integrazioni.
Operation	Obbligatorio	`read` — scarica il contenuto del file. `write` — carica nuovo o sovrascrive esistente.
Path	Obbligatorio	Il percorso completo Dropbox incluso il nome del file, ad esempio `/reports/output.csv`. Supporta riferimenti `{{ variable }}`.
Content	Obbligatorio per write	Contenuto da caricare. Supporta riferimenti `{{ variable }}`.
Overwrite	Opzionale — modalità write	Interruttore. Quando disattivato, l'operazione fallisce se un file esiste già al percorso indicato. Predefinito: attivato.
Mode	Opzionale — modalità write	`add` — rinomina automaticamente il file se uno esiste già al percorso. `overwrite` — sostituisce qualsiasi file esistente al percorso. `update` — aggiorna una revisione specifica del file. Predefinito: `overwrite`.

Dati di Output

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

Campo	Tipo	Descrizione
`content`	string	Contenuto del file (modalità read).
`path`	string	Percorso Dropbox del file.
`size`	number	Dimensione del file in byte.
`modified_at`	string	Timestamp ISO 8601 dell'ultima modifica.

Esempio di Utilizzo

Un Schedule Trigger si attiva ogni lunedì mattina.
Un nodo HTTP Request recupera i dati più recenti da un'API esterna.
Un nodo Transform formatta i dati come stringa CSV.
Un nodo Dropbox con Operation: write carica il CSV in /Reports/{{ trigger.output.week }}-report.csv in una cartella condivisa con i clienti.

Suggerimenti & Note

I percorsi Dropbox non distinguono maiuscole/minuscole su Windows e macOS ma sono trattati come case-sensitive dall'API Dropbox. Usa una capitalizzazione coerente per evitare comportamenti imprevisti.
Usa Mode: add quando vuoi che Dropbox rinomini automaticamente il file se uno esiste già (ad esempio output (1).csv) anziché sovrascriverlo.
L'output modified_at è utile per il logging di audit — passalo a uno step di append Google Sheets per tracciare quando ogni file è stato aggiornato l'ultima volta.
Le cartelle condivise e i Team Space sono accessibili a condizione che l'account Dropbox connesso abbia i permessi appropriati.

Nodi Correlati

Google Drive — l'alternativa di storage cloud file di Google.
Local File — operazioni su file lato server senza credenziali cloud.
Amazon S3 — object storage scalabile per file di grandi dimensioni o workflow ad alto volume.