Jak wyeksportować dane z Dropbox Forms do pliku CSV

Zaktualizowano Oct 23, 2025

In this article

warning icon

Ważna informacja: Dropbox Forms zostanie wycofany z dniem 30 września 2025 r. Od 2 września 2025 r. nie będzie można już tworzyć nowych przepływów pracy za pomocą Dropbox Forms, ale do 30 września będzie można wyświetlać istniejące przepływy pracy, a także je eksportować.

Więcej informacji o zakończeniu wsparcia dla Dropbox Forms.

Przy użyciu Dropbox Forms możesz pobrać swoje dane do pliku CSV. Ta funkcja jest dostępna tylko w płatnych taryfach Dropbox Forms. 

Administratorzy zespołu mogą pobierać dane z maksymalnie 25 000 wypełnionych formularzy. Każdy wiersz zawiera wszystkie informacje podane przez odbiorcę na poszczególnych stronach formularza.

Jak wyeksportować dane do pliku CSV

Możesz pobierać dane tylko z wysłanych i wypełnionych formularzy.

Aby wyeksportować dane z Dropbox Forms do pliku CSV:
  1. Zaloguj się do Dropbox Forms. 
  2. Kliknij Wysłane na lewym pasku menu. 
  3. Kliknij Pobierz CSV.
  4. Wybierz zakres dat, aby wyświetlić wysłane formularze. 
  5. Zaznacz pole wyboru obok formularzy, które chcesz pobrać. Wybrane formularze zostaną pobrane osobno. 
  6. Kliknij Kontynuuj.

Twoje dane zostaną zapisane w pliku ZIP jako plik CSV. Aby je wyświetlić, użyj wybranego przez siebie programu.

highlighter icon

Uwaga: pliki PDF, ścieżki kontroli i przesłane załączniki nie pojawią się podczas pobierania danych do pliku CSV. Aby odnaleźć te informacje, musisz osobno pobrać poszczególne formularze. Aby to zrobić, kliknij Pobierz w sekcji Działania.

Jak eksportować dane zbiorczo za pomocą Dropbox Forms API

Możesz użyć Dropbox Forms API, aby zbiorczo eksportować dane związane z przepływem pracy. Dropbox Forms API to interfejs REST API, który umożliwia pracę ze zautomatyzowanymi przepływami pracy w Dropbox Forms. Możesz tworzyć i zarządzać instancjami przepływów pracy, sprawdzać ich status i otrzymywać powiadomienia o ich ukończeniu. 

Do swoich żądań możesz używać formatu application/x-www-form-urlencoded lub application/json, a wszystkie odpowiedzi API są zwracane w formacie JSON.
 

 

Jak skonfigurować Dropbox Forms API

Aby rozpocząć eksportowanie za pomocą Dropbox Forms API, potrzebny będzie klucz API i istniejący przepływ pracy.

  1. Zaloguj się do portalu Dropbox Forms.
  2. Kliknij Klucze API na lewym pasku bocznym.
  3. Kliknij Nowy klucz w prawym górnym rogu.
  4. Wprowadź unikalną nazwę klucza API, aby Twój zespół mógł go zidentyfikować.
  5. Wybierz, czy klucz będzie używany do żądań testowych, czy produkcyjnych.
  6. Po utworzeniu klucza otrzymasz:
    • identyfikator klucza publicznego,
    • wartość klucza prywatnego.
warning icon

Ważne: natychmiast zapisz sobie wartość klucza prywatnego i przechowuj ją w bezpiecznym miejscu. Wartości klucza prywatnego nie będzie już można pobrać ponownie, ale w każdej chwili będzie można wygenerować nowe klucze.

Dropbox Forms API używa do uwierzytelniania zarówno klucza API, jak i tokena JSON Web Token (JWT). Klucz API służy do pobierania krótkotrwałego JWT, który można następnie wykorzystać do uwierzytelniania wywołań API.
 

Jak wykonać eksport zbiorczy

Po uzyskaniu klucza API musisz: 

  1. Dodać JWT do nagłówka przy każdym kolejnym wywołaniu:
Authorization: Bearer <YOUR_JWT>
  • Uwaga: zastąp <YOUR_JWT> swoim JWT. 

2. Pobrać listę swoich przepływów pracy, uruchamiając to polecenie w terminalu: 

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

3. Zanotować poszczególne identyfikatory workflow_id podane w danych wyjściowych. 

4. Uruchomić to polecenie, aby pobrać plik ZIP zawierający dane CSV dla wybranego zakresu dat:

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

Uwaga: zastąp <WORKFLOW_ID> swoim identyfikatorem, a YYYY-MM-DDT00:00:00Z w adresie URL datą początkową i końcową, na przykład start_date=2020-01-01T00:00:00Z.

6. Uruchomić to polecenie, aby wyodrębnić plik CSV:
unzip -p workflow_<WORKFLOW_ID>.zip "*.csv" > workflow_<WORKFLOW_ID>.csv
highlighter icon

Uwagi

  • Jeśli masz wiele plików CSV, musisz wyodrębnić i przetworzyć każdy z nich.
  • Jednocześnie możesz pobrać dane tylko dla okresu obejmującego maksymalnie 183 dni. Jeśli potrzebujesz danych za dłuższy okres, musisz wykonać kilka wywołań.

Jak pobrać dokumenty dla poszczególnych instancji 

Po pobraniu i otwarciu pliku CSV musisz:

  1. Odszukać kolumnę z identyfikatorami instancji („workflow_instance_id” lub „instance_id”).
  2. Uruchomić to polecenie, aby pobrać plik ZIP zawierający dokumenty dla poszczególnych identyfikatorów instancji: 
curl -L -H "Authorization: Bearer <YOUR_JWT>" \
https://api.helloworks.com/v3/workflow_instances/<INSTANCE_ID>/documents \
3. Rozpakować plik ZIP, aby wyświetlić pliki. 
Czy ten artykuł był pomocny?

Powiedz nam, dlaczego to nie pomogło:

Dziękujemy za informację!

Dziękujemy za przesłanie opinii.