Dropbox 自動化指南

Dropbox 自動化可讓您自動將健康資料備份到 Dropbox。檔案會組織在資料夾中，可以 JSON 或 CSV 格式匯出，讓您可以從任何裝置輕鬆存取健康資料或與他人分享。

概覽

Dropbox 自動化會自動將您的健康資料上傳到 Dropbox 帳戶中的指定資料夾。檔案會依日期範圍（日、週、月或年）組織，可以從任何具有 Dropbox 存取權限的裝置存取。

使用案例:

• 健康資料的自動雲端備份
• 從多個裝置存取健康資料
• 與醫療保健提供者分享健康資料
• 長期資料歸檔
• 與可以存取 Dropbox 的其他服務整合

限制

• 健康資料存取： iPhone 鎖定時，App 無法存取健康資料。自動化僅在裝置解鎖期間執行。這是 Apple 施加的限制，無法繞過。更多資訊

• 背景處理: iOS 限制背景處理以保持電池壽命。自動化依賴於背景應用程式重新整理，在以下情況下可能不會立即執行:

  • 應用程式的背景應用程式重新整理已停用
  • 裝置處於低電量模式
  • 裝置長時間處於非活動狀態
  • 系統資源受限
  • 多個應用程式競爭背景執行時間

先決條件

• Dropbox 帳戶
• 網際網路連線

設定

開啟側邊欄，然後點一下自動化。點選「新增自動化」並選擇「Dropbox」作為自動化類型。

自動化名稱

輸入自動化的描述性名稱（例如，「每日健康備份」、「每週健康匯出」）。此名稱將用於識別您的自動化。

啟用狀態和通知

設定自動化狀態和通知偏好設定:

• 狀態已啟用 - 切換以啟用或停用自動化
• 快取更新時通知 - 當快取資料更新時接收通知
• 執行時通知 - 每次自動化上傳資料時接收通知
• 排程提醒 — 可選提示，提醒你解鎖並開啟 App。參閱自動化概覽。與執行時通知分開。

自動化類型

選擇「Dropbox」作為自動化類型。這決定了您的健康資料將匯出到哪裡。

Dropbox 連線

在設定其他設定之前，您必須連線 Dropbox 帳戶。

連線 Dropbox

1. 點選「連線 Dropbox」按鈕
2. 您將被重新導向到 Dropbox 的授權頁面
3. 如果提示，請登入您的 Dropbox 帳戶
4. 檢視應用程式請求的權限並授權
5. 複製提供的代碼，然後返回 Health Auto Export 並貼上以繼續

注意: 應用程式請求存取權限以在您的 Dropbox 中建立和管理其自己的資料夾中的檔案。它只存取它建立的資料夾，不存取您的整個 Dropbox。

資料夾名稱

連線後，輸入 Dropbox 中將儲存健康資料的資料夾名稱。

資料夾名稱範例:

• 健康資料
• 每日備份
• 健康匯出
• 我的健康指標

注意: 如果資料夾不存在，它將在您的 Dropbox「Apps」目錄中自動建立。避免使用可能導致檔案系統問題的特殊字元。

管理連線

連線後，您可以管理 Dropbox 連線:

1. 在 Dropbox 設定區段中點選「管理連線」
2. 檢視您的連線狀態
3. 如需要，重新連線
4. 如果要使用不同的帳戶，請中斷連線

自訂檔名

針對 Dropbox 自動化，你可以選擇性設定自訂檔名前綴。

• 若留空，匯出會使用預設命名方式。
• 若已設定，前綴會用於 JSON 檔案，並加在 CSV 樣式檔名前。
• 不適用於檔名的字元會自動清理。

前綴示例：

• HealthBackup
• DailyExport
• CustomName

資料類型設定

資料類型

選擇要匯出的健康資料類型:

• 健康指標 - 步數、心率、睡眠和其他健康測量值
• 運動 - 運動和健身活動
• 症狀 - 健康症狀和狀況
• 心電圖 - 心電圖讀數
• 心率通知 - 高/低/不規則心率事件
• 心理狀態 - 情緒和精神狀態項目（iOS 18.0+）
• 週期追蹤 - 月經週期和生殖健康資料
• 藥物 - 藥物記錄和依從性（iOS 26.0+）

健康指標設定

當選擇健康指標時:

選擇健康指標 - 選擇要包含的特定指標。您可以選擇所有可用指標或選擇特定指標。

提示: 僅選擇您需要的指標可以減少檔案大小並提高上傳速度。

首選來源 - 設定當多個來源提供相同指標時哪些資料來源具有優先順序。

運動設定

當選擇運動時:

包含路線資料 - 開啟以包含具有位置資料的運動的 GPX 路線檔案。

包含運動指標 - 開啟以包含在運動期間收集的健康指標（心率、卡路里等）。

注意: 包含運動指標需要額外的資料查詢，可能會增加檔案大小和處理時間。

時間分組（運動指標） - 使用匯出版本 2 且啟用包含運動指標時:

• 分鐘 - 按分鐘分組運動指標
• 秒 - 按秒分組運動指標

匯出設定

匯出格式

選擇匯出資料的格式:

• JSON 格式 - 提供具有巢狀物件的詳細資料結構。最適合應用程式、資料庫和詳細分析。JSON 格式包含更詳細的資訊，適用於複雜資料類型，如睡眠階段和 AFib 讀數。

• CSV 格式 - 提供可以輕鬆匯入到電子試算表應用程式（如 Excel、Numbers 或 Google Sheets）的表格資料。最適合簡單的資料分析和檢視。

提示: 使用 JSON 進行全面的資料儲存，使用 CSV 在電子試算表應用程式中輕鬆檢視。

匯出版本

選擇匯出版本。版本控制允許您以自己的節奏在匯出的更新版本之間轉換，並最大程度地減少對工作流程的破壞性變更。

• 版本 1 - 舊格式，如果您有依賴此格式的現有工作流程，請使用
• 版本 2 - 當前格式，具有健康指標的本地化支援和增強的運動資料以及更詳細的中繼資料選項

日期範圍

選擇如何將資料組織到檔案中:

• 日 - 為每一天建立單獨的檔案
• 週 - 為每一週建立單獨的檔案
• 月 - 為每一月建立單獨的檔案
• 年 - 為每一年建立單獨的檔案

檔案組織:

• 檔案根據其包含的日期範圍命名
• 每個檔案包含該時間段的所有資料
• 檔案儲存在資料夾名稱中指定的資料夾中

時間分組

選擇如何在每個檔案內聚合資料。可用選項取決於所選日期範圍:

注意: 更細粒度的聚合（分鐘/小時）會建立更大的檔案，但提供更詳細的資料。較粗粒度的聚合（天/週/月）會建立較小的檔案，其中包含彙總資料。

彙總資料

使用健康指標資料類型和 JSON 格式時，開啟或關閉彙總資料。

• 開啟 - 提供聚合資料摘要（預設）
• 關閉 - 盡可能提供非聚合資料，顯示個別資料點

注意: 此設定僅適用於帶有健康指標的 JSON 格式。使用 CSV 格式或選擇多個指標時，資料始終會被聚合。

同步頻率

設定自動化應向 Dropbox 上傳資料的頻率:

選擇一個數字和間隔。

測試和驗證

手動測試

1. 在自動化配置畫面輕點 “Manual Export”
2. 選擇日期範圍
3. 輕點 “Export” 上傳文件
4. 在 Dropbox 資料夾中確認文件已上傳

檢視活動記錄

1. 在自動化設定畫面中點一下 檢視活動記錄。
2. 檢視 執行（依時間分組，最新的在前），並展開每次執行中的事件。
3. 區分 警告（例如健康資料查詢緩慢）與 錯誤（上傳失敗、權杖或連線問題）—請參閱自動化總覽 — 活動記錄。
4. 檢查每次執行的上傳成功列與 HTTP 相關錯誤。
5. 分享（工具列）可导出完整的App 事件記錄诊断 ZIP 以供支持（與設定 → 進階）。
6. 清除僅清除此自動化的活動記錄。

疑難排解

常見問題

「驗證錯誤: 找不到 Dropbox 令牌。連線 Dropbox 以取得令牌。」

• 點選「連線 Dropbox」以授權應用程式
• 確保您已完成授權過程

連線/令牌錯誤

• 點選「管理連線」以重新連線
• 驗證您的網際網路連線
• 檢查您的 Dropbox 帳戶是否處於活動狀態
• 如果令牌已過期，請重新授權應用程式

檔案未出現在 Dropbox 中

• 等待幾秒鐘讓上傳完成
• 檢查您的網際網路連線
• 檢查活動記錄中的上傳錯誤
• 確保自動化已啟用

上傳失敗

• 檢查您的網際網路連線
• 驗證您是否有可用的 Dropbox 儲存空間
• 檢查活動記錄中的特定錯誤訊息
• 嘗試手動匯出以測試連線

令牌過期

• 令牌過期時會自動重新整理
• 如果重新整理失敗，您可能需要重新連線
• 如需要，點選「管理連線」以重新連線

錯誤訊息

如果出現以下情況，應用程式將顯示錯誤訊息:

• Dropbox 連線失敗
• 由於網路問題導致上傳失敗
• 超過 Dropbox 儲存配額
• 無效的資料夾名稱或路徑
• 令牌重新整理失敗

檢查活動記錄以取得詳細的錯誤資訊，包括 HTTP 狀態代碼和 Dropbox API 錯誤訊息。

提示和最佳實踐

1. 自動同步：

   • 為裝置充電並使用 iPhone 鏡像
     • 充電時 iOS 對效能限制較少，資料可以更頻繁地同步
     • 使用 iPhone 鏡像時，裝置行為如同已解鎖。Health Auto Export 即可存取健康資料以執行自動化操作

2. 檔案格式:

   • 使用 JSON 進行全面的資料儲存
   • 使用 CSV 在電子試算表應用程式中輕鬆檢視
   • 選擇格式時考慮您的使用案例

3. 同步頻率:

   • 更頻繁的同步提供更好的資料新鮮度

4. 資料選擇:

   • 僅選擇您需要的指標以減少檔案大小
   • 考慮您的 Dropbox 儲存限制

5. 存取:

   • 檔案可以從任何具有 Dropbox 的裝置存取
   • 如需要，與醫療保健提供者分享資料夾
   • 使用 Dropbox 的分享功能進行協作