如何将 Dropbox Forms 数据导出为 CSV 文件

已更新 Oct 23, 2025

In this article

warning icon

重要提示:Dropbox Forms 将于 2025 年 9 月 30 日停用。自 2025 年 9 月 2 日起,您将无法再使用 Dropbox Forms 创建新的工作流程,但在 9 月 30 日截止日期之前,您可以仍然可以查看和导出现有工作流程。

了解有关终止支持 Dropbox Forms 的更多信息。

您可以使用 Dropbox Forms 将数据下载为 CSV 文件。此功能仅适用于 Dropbox Forms 付费套餐。

团队管理员最多可以下载 25000 份已完成表单的数据。表单每一页的每一行包含一位接收者提供的所有信息。

如何将数据导出为 CSV 文件

您只能下载已发送和已完成表单的数据。

如需将 Dropbox Forms 中的数据导出为 CSV 文件:
  1. 登录 Dropbox Forms。
  2. 点击左侧菜单栏中的已发送
  3. 单击下载 CSV
  4. 选择日期范围,显示已发送的表单。
  5. 在您要下载的表单旁边选中复选框。系统将分别下载每个选定的表单。
  6. 点击继续。

您的数据将以 CSV 格式保存在 ZIP 文件中。您可以使用偏好的程序来查看这些数据。

highlighter icon

注意:将数据下载为 CSV 文件时,PDF、审核记录和已上传的附件不会显示。要查看这些信息,您需要单独下载表单。要执行此操作,请在操作下方点击下载

如何使用 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 密钥
  3. 点击右上角的新密钥
  4. 为您的 API 密钥输入唯一名称,便于您的团队识别。
  5. 选择密钥是用于测试还是实时请求。
  6. 创建密钥后,您将获得:
    • 公钥 ID
    • 私钥值
warning icon

重要提示:请立即记录私钥值,并将其存储在安全的位置。之后您将无法检索私钥值,但可以随时生成新密钥。

Dropbox Forms API 使用您的 API 密钥以及 JSON Web 令牌 (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. 运行此命令,下载包含所选日期范围数据 CSV 的 ZIP 文件:

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> 替换为您的 ID,并将 URL 中的 YYYY-MM-DDT00:00:00Z 替换为您的开始和结束日期,例如 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. 查找包含实例 ID 的列(“workflow_instance_id”或“instance_id”)。
  2. 运行此命令,下载包含每个实例 ID 文档的 ZIP 文件:
curl -L -H "Authorization: Bearer <YOUR_JWT>" \
https://api.helloworks.com/v3/workflow_instances/<INSTANCE_ID>/documents \
3. 解压缩 ZIP 文件以查看其中的文件。
这篇文章有用吗?

请告诉我们为什么它没有帮助:

感谢您告诉我们!

谢谢您的意见!

获取帮助的其他方式