Как экспортировать данные из Dropbox Forms в файл CSV

Обновление Oct 23, 2025

In this article

warning icon

Важное примечание. Dropbox Forms прекратит работу 30 сентября 2025 года. Со 2 сентября 2025 года вы больше не сможете создавать новые рабочие процессы с помощью Dropbox Forms, но сможете просматривать существующие рабочие процессы, а также экспортировать их до 30 сентября.

Подробнее о прекращении поддержки Dropbox Forms.

Вы можете использовать Dropbox Forms для скачивания данных в файл CSV. Эта функция доступна только для платных тарифных планов Dropbox Forms. 

Администраторы рабочих групп могут скачивать данные из 25 000 заполненных форм. Каждая строка содержит всю информацию, предоставленную получателем, со всех страниц вашей формы.

Как экспортировать данные в файл CSV

Вы можете скачивать данные только из отправленных и заполненных форм.

Чтобы экспортировать данные из Dropbox Forms в файл CSV, выполните следующие действия.
  1. Войдите в Dropbox Forms. 
  2. Нажмите Sent (Отправленные) на панели меню слева. 
  3. Нажмите Скачать CSV.
  4. Выберите диапазон дат, чтобы заполнить отправленные формы. 
  5. Установите флажки рядом с формами, которые хотите скачать. Каждая выбранная форма будет скачана отдельно. 
  6. Нажмите Proceed (Продолжить).

Ваши данные будут сохранены в ZIP-архиве в формате CSV. Можно просмотреть эту информацию в любой программе.

highlighter icon

Примечание. Файлы PDF, журналы аудита и загруженные вложения не будут сохранятся при скачивании данных в файл CSV. Чтобы найти эту информацию, необходимо скачать каждую форму по отдельности. Для этого нажмите Download (Скачать) в разделе Actions (Действия).

Как выполнять групповой экспорт данных с помощью Dropbox Forms API

С помощью Dropbox Forms API можно выполнять групповой экспорт данных рабочих процессов. Dropbox Forms API — это интерфейс REST API, который позволяет работать с автоматизированными рабочими процессами в Dropbox Forms. С его помощью можно создавать экземпляры рабочих процессов и управлять ими, проверять их статус и получать уведомления о завершении. 

Для запросов можно использовать кодировку «application/x-www-form-urlencoded» или «application/json», а все ответы API будут возвращены в формате JSON.
 

 

Как настроить Dropbox Forms API

Чтобы начать экспорт с помощью Dropbox Forms API, потребуется ключ API и существующий рабочий процесс.

  1. Войдите на портал Dropbox Forms.
  2. Нажмите API Keys (Ключи API) на боковой панели слева.
  3. Нажмите New key (Новый ключ) в правом верхнем углу.
  4. Введите уникальное имя ключа API, чтобы ваша рабочая группа могла его идентифицировать.
  5. Выберите, будет ли ключ использоваться для тестовых или реальных запросов.
  6. После создания ключа вы получите следующие данные.
    • Идентификатор открытого ключа
    • Значение закрытого ключа
warning icon

Важно! Запишите значение закрытого ключа и сохраните его в безопасном месте. Значение закрытого ключа нельзя будет получить позже, но вы сможете создавать новые ключи в любое время.

Dropbox Forms API использует для проверки подлинности как ключ API, так и веб-токен JSON (JWT). Ключ API используется для получения кратковременного JWT, который затем можно использовать для проверки подлинности вызовов API.
 

Как выполнить групповой экспорт

Получив ключ API, выполните следующие действия. 

  1. Добавьте JWT в заголовок при каждом последующем вызове.
Authorization: Bearer <YOUR_JWT>
  • Примечание. Замените <YOUR_JWT> на свой JWT. 

2. Получите список рабочих процессов, выполнив следующую команду в терминале. 

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

3. Запишите каждый идентификатор workflow_id в выходных данных. 

4. Выполните приведенную ниже команду, чтобы скачать ZIP-файл, содержащий данные CSV для выбранного диапазона дат.

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

Примечание. Замените <WORKFLOW_ID> на свой идентификатор и YYYY-MM-DDT00:00:00Z в URL-адресе на даты начала и окончания, например start_date=2020-01-01T00:00:00Z.

6. Выполните приведенную ниже команду, чтобы извлечь файл CSV.
unzip -p workflow_<WORKFLOW_ID>.zip "*.csv" > workflow_<WORKFLOW_ID>.csv
highlighter icon

Обратите внимание

  • При наличии нескольких файлов CSV необходимо извлечь и обработать каждый их них.
  • За один раз можно скачать данные не более чем за 183 дня. Если требуются данные за более длительный срок, выполните несколько вызовов.

Как скачать документы для каждого экземпляра 

После скачивания и открытия файла CSV выполните следующие действия.

  1. Найдите столбец с идентификаторами экземпляров («workflow_instance_id» или «instance_id»).
  2. Выполните приведенную ниже команду, чтобы скачать ZIP-файл, содержащий документы для каждого идентификатора экземпляра. 
curl -L -H "Authorization: Bearer <YOUR_JWT>" \
https://api.helloworks.com/v3/workflow_instances/<INSTANCE_ID>/documents \
3. Распакуйте ZIP-файл, чтобы просмотреть файлы. 
Оказалась ли эта статья полезной?

Расскажите, почему статья вам не помогла:

Спасибо, что поделились своим мнением!

Благодарим за отзыв!