Zo exporteer je Dropbox Forms-gegevens naar een CSV
In this article
Belangrijke opmerking: Dropbox Forms wordt op 30 september 2025 stopgezet. Vanaf 2 september 2025 kun je geen nieuwe workflows meer maken met Forms, maar je kunt bestaande workflows bekijken en exporteren tot de deadline van 30 september.
Meer informatie over het einde van de ondersteuning voor Dropbox Forms.
Je kunt Dropbox Forms gebruiken om je gegevens naar een CSV-bestand te downloaden. Deze functie is alleen beschikbaar voor betaalde Dropbox Forms-abonnementen.
Zo exporteer je gegevens naar een CSV
Zo exporteer je gegevens in Dropbox Forms naar een CSV:
- Meld je aan bij Dropbox Forms.
- Klik op Verzonden in de linker menubalk.
- Klik op CSV downloaden.
- Selecteer een datumbereik om verzonden formulieren in te vullen.
- Vink het vakje aan naast de formulieren die je wilt downloaden. Elk geselecteerd formulier wordt afzonderlijk gedownload.
- Klik op Doorgaan.
Je gegevens worden opgeslagen in een ZIP-bestand als CSV. Je kunt deze informatie bekijken in een programma naar keuze.
Opmerking: PDF's, audittrails en geüploade bijlagen worden niet weergegeven wanneer je gegevens downloadt naar een CSV. Om deze informatie te vinden, moet je formulieren afzonderlijk downloaden. Klik hiervoor op Downloaden onder Acties.
Zo exporteer je gegevens in bulk met de Dropbox Forms API
Je kunt de Dropbox Forms API gebruiken om workflowgegevens in bulk te exporteren. De Dropbox Forms API is een REST API waarmee je kunt werken met geautomatiseerde workflows in Dropbox Forms. Je kunt workflowinstanties maken en beheren, hun status controleren en meldingen ontvangen wanneer workflows zijn voltooid.
Je kunt application/x-www-form-urlencoded of application/json gebruiken voor je verzoeken en alle API-reacties worden geretourneerd in JSON-indeling.
Zo stel je de Dropbox Forms API in
Om te beginnen met exporteren met de Dropbox Forms API, heb je een API-sleutel en een bestaande workflow nodig.
- Meld je aan bij het Dropbox Forms-portaal.
- Klik op API-sleutels in de linkerzijbalk.
- Klik op Nieuwe sleutel in de rechterbovenhoek.
- Voer een unieke naam in voor je API-sleutel, zodat je team deze kan identificeren.
- Kies of de sleutel wordt gebruikt voor test- of liveverzoeken.
- Wanneer de sleutel is gemaakt, krijg je:
- Een openbare sleutel-ID
- Een privésleutelwaarde
Belangrijk: noteer de waarde van de privésleutel onmiddellijk en bewaar deze op een veilige locatie. Je kunt de privésleutelwaarde later niet meer ophalen, maar je kunt op elk gewenst moment nieuwe sleutels genereren.
De Dropbox Forms API gebruikt zowel je API-sleutel als een JSON Web Token (JWT) voor authenticatie. Je API-sleutel wordt gebruikt om een kortstondige JWT op te halen, die vervolgens kan worden gebruikt om API-oproepen te verifiëren.
In bulk exporteren
Zodra je een API-sleutel hebt, moet je het volgende doen:
- Voeg je JWT toe aan de koptekst bij elke volgende oproep:
Authorization: Bearer <YOUR_JWT>
- Opmerking: vervang <YOUR_JWT> door je JWT.
2. Krijg een lijst met je workflows door deze opdracht in een terminal uit te voeren:
curl -s -H "Authorization: Bearer <YOUR_JWT>" \
https://api.helloworks.com/v3/workflows
3. Noteer elke workflow_id in de uitvoer.
4. Voer deze opdracht uit om een ZIP-bestand met CSV-gegevens voor een gekozen datumbereik te downloaden:
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
Opmerking: vervang <WORKFLOW_ID> door je ID en JJJJ-MM-DDT00:00:00Z in de URL door je begin- en einddatum, bijvoorbeeld start_date=2020-01-01T00:00:00Z.
unzip -p workflow_<WORKFLOW_ID>.zip "*.csv" > workflow_<WORKFLOW_ID>.csv
Opmerkingen:
- Als er meerdere CSV's zijn, moet je ze allemaal extraheren en verwerken.
- Je kunt maximaal 183 dagen tegelijk downloaden. Als je meer nodig hebt, moet je meerdere oproepen doen.
Documenten downloaden voor elke instantie
Zodra je de CSV hebt gedownload en geopend, moet je het volgende doen:
- Zoek de kolom met instantie-ID's ('workflow_instance_id' of 'instance_id').
- Voer deze opdracht uit om een ZIP-bestand te downloaden dat de documenten voor elke instantie-ID bevat:
curl -L -H "Authorization: Bearer <YOUR_JWT>" \
https://api.helloworks.com/v3/workflow_instances/<INSTANCE_ID>/documents \
Antwoorden uit de community
-
Geplaatst door: americanpunkin 934 dagen geleden
1534
5