Come esportare i dati di Dropbox Forms in un file CSV

Aggiornato Oct 23, 2025

In this article

warning icon

Nota importante: Dropbox Forms verrà sospeso il 30 settembre 2025. A partire dal 2 settembre 2025, non potrai più creare nuovi flussi di lavoro con Forms, ma potrai visualizzare quelli esistenti ed esportarli fino alla scadenza prevista per il 30 settembre.

Scopri di più sulla fine del supporto per Dropbox Forms.

Puoi utilizzare Dropbox Forms per scaricare i tuoi dati in un file CSV. Questa funzionalità è disponibile solo per i piani Dropbox Forms a pagamento. 

Gli amministratori di team possono scaricare i dati da un massimo di 25.000 moduli compilati. Ogni riga contiene tutte le informazioni fornite da un destinatario, da ogni pagina del modulo.

Come esportare i dati in un file CSV

Puoi scaricare i dati solo dai moduli inviati e compilati.

Per esportare i dati presenti in Dropbox Forms in un file CSV:
  1. Accedi a Dropbox Forms. 
  2. Fai clic su Inviati nella barra dei menu a sinistra. 
  3. Fai clic su Scarica CSV.
  4. Seleziona un intervallo di date per popolare i moduli inviati. 
  5. Seleziona la casella accanto ai moduli che desideri scaricare. Ogni modulo selezionato verrà scaricato separatamente. 
  6. Fai clic su Procedi.

I tuoi dati vengono salvati in un file ZIP in formato CSV. Puoi utilizzare il tuo programma preferito per visualizzare queste informazioni.

highlighter icon

Nota: i PDF, gli audit trail e gli allegati caricati non vengono visualizzati quando scarichi i dati in un file CSV. Per trovare queste informazioni, devi scaricare i moduli singolarmente. A tale scopo, fai clic su Scarica in Azioni.

Come esportare i dati in blocco utilizzando Dropbox Forms API

Puoi utilizzare Dropbox Forms API per esportare i dati del flusso di lavoro in blocco. Dropbox Forms API è un'API REST che consente di lavorare con flussi di lavoro automatizzati in Dropbox Forms. Puoi creare e gestire istanze di flussi di lavoro, verificarne lo stato e ricevere notifiche al termine dei flussi di lavoro. 

Puoi utilizzare application/x-www-form-urlencoded o application/json per le tue richieste; tutte le risposte API vengono restituite in formato JSON.
 

 

Come configurare Dropbox Forms API

Per iniziare a esportare con Dropbox Forms API, avrai bisogno di una chiave API e un flusso di lavoro esistente.

  1. Accedi al portale Dropbox Forms.
  2. Fai clic su Chiavi API nella barra laterale sinistra.
  3. Fai clic su Nuova chiave in alto a destra.
  4. Inserisci un nome univoco per la chiave API in modo che il tuo team possa identificarla.
  5. Scegli se la chiave verrà utilizzata per richieste test o live.
  6. Una volta creata la chiave, riceverai:
    • Un ID della chiave pubblica
    • Un valore della chiave privata
warning icon

Importante: annota immediatamente il valore della chiave privata e conservalo in un luogo sicuro. Successivamente non sarà possibile recuperare il valore della chiave privata, ma potrai generare nuove chiavi in qualsiasi momento.

Dropbox Forms API utilizza sia la chiave API che un JSON Web Token (JWT) per l'autenticazione. La chiave API viene utilizzata per recuperare un JWT di breve durata, che può quindi essere usato per autenticare le chiamate API.
 

Come eseguire un'esportazione in blocco

Una volta ottenuta una chiave API, dovrai eseguire quanto segue: 

  1. Aggiungere il tuo JWT all'intestazione in ogni chiamata successiva:
Authorization: Bearer <YOUR_JWT>
  • Nota: sostituisci <YOUR_JWT> con il tuo JWT. 

2. Ottenere un elenco dei tuoi flussi di lavoro eseguendo questo comando in un terminale: 

curl -s -H "Authorization: Bearer <YOUR_JWT>" \
https://api.helloworks.com/v3/workflows

3. Prendere nota di ogni workflow_id nell'output. 

4. Eseguire questo comando per scaricare un file ZIP contenente dati in formato CSV per un intervallo di date selezionato:

curl -L -H "Authorization: Bearer <YOUR_JWT>" \
"https://api.helloworks.com/v3/workflows/<WORKFLOW_ID>/csv?start_date=YYYY-MM-DD&end_date=YYYY-MM-DD" \
-o workflow_<WORKFLOW_ID>.zip
highlighter icon

Nota: sostituisci <WORKFLOW_ID> con il tuo ID e YYYY-MM-DDT00:00:00Z nell'URL con le date di inizio e fine, ad esempio start_date=2020-01-01T00:00:00Z.

6. Eseguire questo comando per estrarre il file CSV:
unzip -p workflow_<WORKFLOW_ID>.zip "*.csv" > workflow_<WORKFLOW_ID>.csv
highlighter icon

Note

  • Se sono presenti più CSV, dovrai estrarli ed elaborarli tutti.
  • Puoi scaricare dati relativi a un massimo di 183 giorni alla volta. Se hai bisogno di un intervallo maggiore, dovrai effettuare più chiamate.

Come scaricare i documenti per ogni istanza 

Una volta scaricato e aperto il file CSV, è necessario:

  1. Cercare la colonna con gli ID istanza ("workflow_instance_id" o "instance_id").
  2. Eseguire questo comando per scaricare un file ZIP contenente i documenti per ogni ID istanza: 
curl -L -H "Authorization: Bearer <YOUR_JWT>" \
https://api.helloworks.com/v3/workflow_instances/<INSTANCE_ID>/documents \
3. Estrarre il file ZIP per visualizzare i file. 
Questo articolo ti è risultato utile?

Let us know how why it didn't help:

Thanks for letting us know!

Grazie per i tuoi commenti!

Altri modi per ottenere assistenza