如何将 Dropbox Forms 数据导出为 CSV 文件
In this article
重要提示：Dropbox Forms 将于 2025 年 9 月 30 日停用。自 2025 年 9 月 2 日起，您将无法再使用 Dropbox Forms 创建新的工作流程，但在 9 月 30 日截止日期之前，您可以仍然可以查看和导出现有工作流程。
您可以使用 Dropbox Forms 将数据下载为 CSV 文件。此功能仅适用于 Dropbox Forms 付费套餐。
如何将数据导出为 CSV 文件
如需将 Dropbox Forms 中的数据导出为 CSV 文件：
- 登录 Dropbox Forms。
- 点击左侧菜单栏中的已发送。
- 单击下载 CSV。
- 选择日期范围，显示已发送的表单。
- 在您要下载的表单旁边选中复选框。系统将分别下载每个选定的表单。
- 点击继续。
您的数据将以 CSV 格式保存在 ZIP 文件中。您可以使用偏好的程序来查看这些数据。
注意：将数据下载为 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 密钥以及现有的工作流程。
- 登录 Dropbox Forms 门户网站。
- 点击左侧边栏中的 API 密钥。
- 点击右上角的新密钥。
- 为您的 API 密钥输入唯一名称，便于您的团队识别。
- 选择密钥是用于测试还是实时请求。
- 创建密钥后，您将获得：
- 公钥 ID
- 私钥值
重要提示：请立即记录私钥值，并将其存储在安全的位置。之后您将无法检索私钥值，但可以随时生成新密钥。
Dropbox Forms API 使用您的 API 密钥以及 JSON Web 令牌 (JWT) 进行身份验证。您的 API 密钥用于检索短期 JWT，然后可用于验证 API 调用。
如何批量导出数据
获得 API 密钥后，您需要：
- 将 JWT 添加到后续每次调用的标头中：
Authorization: Bearer <YOUR_JWT>- 注意：请将 <YOUR_JWT> 替换为您的 JWT。
2. 在终端中运行以下命令，获取工作流程列表：
curl -s -H "Authorization: Bearer <YOUR_JWT>" \
https://api.helloworks.com/v3/workflows3. 记下输出的所有 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注意：请将 <WORKFLOW_ID> 替换为您的 ID，并将 URL 中的 YYYY-MM-DDT00:00:00Z 替换为您的开始和结束日期，例如 start_date=2020-01-01T00:00:00Z。
unzip -p workflow_<WORKFLOW_ID>.zip "*.csv" > workflow_<WORKFLOW_ID>.csv注意：
- 如果有多个 CSV 文件，您需要全部解压缩处理。
- 一次最多只能下载 183 天的数据。如果您需要更多天的数据，则需要多次调用。
如何下载每个实例的文档
下载并打开 CSV 文件后，您需要：
- 查找包含实例 ID 的列（“workflow_instance_id”或“instance_id”）。
- 运行此命令，下载包含每个实例 ID 文档的 ZIP 文件：
curl -L -H "Authorization: Bearer <YOUR_JWT>" \
https://api.helloworks.com/v3/workflow_instances/<INSTANCE_ID>/documents \社区答案
-
发布者: Coromandel2025 352 天前
398
10
-
发布者: Kittykiy01 435 天前
2147
26
-
22924
3
-
发布者: Saikiran 3500 天前
4360
6
-
发布者: Keith G.9 3859 天前
5226
6
