如何將 Dropbox Forms 資料匯出為 CSV

已更新 Oct 23, 2025

In this article

warning icon

重要通知:Dropbox Forms 將於 2025 年 9 月 30 日起終止服務。自 2025 年 9 月 2 日起,您將無法再使用 Forms 建立新的工作流程,但您可以查看現有的工作流程,並在 9 月 30 日截止日期前匯出。

進一步瞭解 Dropbox 表單停止支援的相關資訊。

您可以使用 Dropbox Forms 將資料下載為 CSV 檔案。此功能僅適用於付費的 Dropbox Forms 方案。

團隊管理員最多可以從 25,000 份已完成的表單中下載資料。每一列都包含收件者從表單每一頁提供的所有資訊。

如何將資料匯出為 CSV

您只能從已傳送和已完成的表單中下載資料。

若要將 Dropbox Forms 中的資料匯出為 CSV,請按照以下方式操作:
  1. 登入 Dropbox Forms。
  2. 按一下左側選單列中的 [已傳送]
  3. 按一下 [下載 CSV]
  4. 選擇日期範圍以填入已傳送的表單。
  5. 核取您要下載的表單旁邊的方塊。每個選取的表單將會分別下載。
  6. 按一下 [繼續]

您的資料會以 CSV 格式儲存在 ZIP 檔案中。您可以使用偏好的程式檢視此資訊。

highlighter icon

請注意:當您將資料下載為 CSV 時,PDF、稽核紀錄和任何上傳的附件都不會顯示。若要尋找此資訊,您需要單獨下載表單。若要這麼做,請按一下 [動作]下方的 [下載]

如何使用 Dropbox 表單 API 大量匯出資料

您可以使用 Dropbox Forms API 大量匯出工作流程資料。Dropbox 表單 API 是一種 REST API,可讓您在 Dropbox 表單中使用自動化工作流程。您可以建立和管理工作流程執行個體、檢查其狀態,並在工作流程完成時收到通知。

您可以使用 application/x-www-form-urlencoded 或 application/json 來處理您的請求,所有 API 回應都會以 JSON 格式傳回。

 

如何設定 Dropbox Forms API

若要開始使用 Dropbox 表單 API 匯出,您需要 API 金鑰和現有的工作流程。

  1. 登入 Dropbox Forms 入口網站。
  2. 按一下左側邊欄中的 [API 金鑰]
  3. 按一下右上角的 [新增金鑰]
  4. 輸入 API 金鑰的唯一名稱,以便工作團隊識別。
  5. 選擇金鑰是否會用於測試或即時請求。
  6. 建立金鑰後,您將獲得:
    • 公開金鑰 ID
    • 私人金鑰值
warning icon

重要提醒:請立即記錄私密金鑰值,並將其儲存在安全的位置。您之後將無法擷取私人金鑰值,但您可以隨時產生新金鑰。

Dropbox 表單 API 使用您的 API 金鑰和 JSON Web Token (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,並將網址中的 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 檔案以檢視檔案。
這篇文章對您有幫助嗎?

Let us know how why it didn't help:

Thanks for letting us know!

感謝您的意見。

其他取得協助的方式