電子郵件自動化指南

電子郵件自動化可讓您自動將健康資料以電子郵件附件的形式傳送到您選擇的地址。每次執行都會匯出您設定的資料，將檔案附加到一封簡短的摘要郵件中，並傳送給收件人。

概覽

使用案例:

• 定期將健康匯出寄給自己
• 與醫療保健提供者或教練分享資料

限制

• 健康資料存取： iPhone 鎖定時，App 無法存取健康資料。自動化僅在裝置解鎖期間執行。這是 Apple 施加的限制，無法繞過。更多資訊
• 背景處理: iOS 限制背景處理以保持電池壽命。自動化依賴於背景應用程式重新整理，在以下情況下可能不會立即執行:
  • 應用程式的背景應用程式重新整理已停用
  • 裝置處於低電量模式
  • 裝置長時間處於非活動狀態
  • 系統資源受限
  • 多個應用程式競爭背景執行時間
• 附件大小： 附件上限為 30 MB。您可能需要向郵件服務商確認是否有更低的限制。若匯出檔案附件超過服務商的限制，郵件很可能會被拒收。

先決條件

• 有效的收件人電子郵件地址
• 自動化執行時的網路連線
• 有效的 Premium 權限

設定

從主導覽進入自動匯出畫面，然後點選「新增自動化」並選擇「Email」作為自動化類型。

自動化名稱

輸入自動化的描述性名稱（例如，「每日郵件備份」、「每週提供者匯出」）。

通知

設定何時接收通知:

• 快取更新時通知 - 當快取資料更新時接收通知
• 執行時通知 - 每次自動化傳送郵件時接收通知

電子郵件地址

輸入應傳送匯出檔案的收件人地址。

地址範例:

• me@example.com
• care@clinic.example

注意事項:

• 需要有效的電子郵件地址。
• 請確保您輸入的電子郵件地址正確
• 每個自動化僅支援一個收件人地址

主旨前綴

您可以選擇性設定主旨前綴，方便在收件匣中尋找或篩選郵件。

• 若留空，郵件會使用為匯出產生的預設主旨（Health Auto Export）。
• 若已設定，前綴會加在預設主旨前面（例如，Daily Export — …）。

前綴範例：

• Daily Export
• HAE Backup
• Provider Sync

資料類型設定

資料類型

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

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

健康指標設定

當選擇健康指標時:

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

提示: 僅選擇您需要的指標可以縮小附件大小並提高處理速度——考量到 30 MB 的郵件上限，這一點格外重要。

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

運動設定

當選擇運動時:

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

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

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

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

提示: 路線資料與精細的運動指標可能會產生較大的附件。若郵件因大小遭拒，請優先選擇較粗略的設定。

匯出設定

匯出格式

選擇匯出資料的格式:

• JSON 格式 - 提供具有巢狀物件的詳細資料結構。最適合應用程式、資料庫和詳細分析。JSON 格式包含更詳細的資訊，適用於複雜資料類型，如睡眠階段和 AFib 讀數。
• CSV 格式 - 提供可以輕鬆匯入到 Excel、Numbers 等電子試算表應用程式或其他工具的表格資料。

提示: 全面的資料請使用 JSON，若收件人將在試算表中開啟附件，請使用 CSV。

匯出版本

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

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

日期範圍

選擇資料的匯出時間範圍:

• 預設 - 同步完整前一天的資料，加上截至目前日期與時間的資料
• 自上次同步以來 - 每次同步時，匯出自上次匯出執行以來截至目前日期與時間的所有資料
• 今天 - 同步目前日期截至目前時間的所有資料
• 昨天 - 同步完整前一天的所有資料
• 過去 7 天 - 同步完整過去七天的資料

彙總資料

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

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

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

時間分組

選擇如何聚合資料。可用選項取決於所選的匯出格式。

注意: 更細粒度的聚合（分鐘/秒）會建立更大的附件，但提供更詳細的資料。較粗粒度的聚合會建立較小的附件，其中包含彙總資料。若要維持在 30 MB 上限以內，請優先選擇較粗略的分組。

同步頻率

設定自動化應傳送郵件的頻率:

選擇一個數字和間隔。

電子郵件可用間隔： 小時、天、週和月。

注意： 當您選擇 Email 作為自動化類型時，預設頻率為每天一次。

測試和驗證

手動測試

1. 在自動化設定畫面輕點「手動匯出」
2. 選擇日期範圍
3. 輕點「匯出」以傳送測試郵件
4. 檢查收件人的收件匣（如有需要請檢查垃圾郵件資料夾），確認附件已送達

檢視活動記錄

1. 在自動化設定畫面中點一下 檢視活動記錄。
2. 檢視 執行（依時間分組，最新的在前），並展開每次執行中的事件。
3. 區分 警告（例如健康資料查詢緩慢）與 錯誤（編碼失敗、超大拒絕或傳送失敗）—請參閱自動化總覽 — 活動記錄。
4. 檢查每次執行的傳送成功列與錯誤詳情。
5. 分享（工具列）可匯出完整的應用程式事件記錄診斷 ZIP 以供支援（與設定 → 進階相同）。
6. 清除 僅清除此自動化的活動記錄。

疑難排解

常見問題

未收到郵件

• 確認收件人地址拼寫正確
• 檢查垃圾郵件/垃圾箱資料夾
• 確認自動化是否至少執行過一次（活動記錄）
• 確保自動化執行時有網路連線
• 嘗試手動匯出以立即測試傳送

「匯出檔案過大，無法以郵件傳送」/ 超過 30 MB

• 選擇較少的健康指標
• 使用較短的日期範圍（例如，使用今天或昨天代替過去 7 天）
• 啟用彙總資料並使用較粗略的時間分組
• 對於大型匯出，請使用 Dropbox、Google Drive 或 REST API

傳送失敗/逾時

• 檢查您的網際網路連線
• 增加要求逾時設定
• 檢視活動記錄中的具體錯誤訊息
• 嘗試使用較短的日期範圍進行手動匯出

自動化未自動執行

• 確保自動化已啟用
• 確認應用程式的背景應用程式重新整理已啟用
• 定期解鎖裝置，以便可以讀取 HealthKit 資料
• 新增自動化小工具以提高背景可靠性（參閱為自動化設定小工具）
• 檢視活動記錄中被跳過或失敗的執行

錯誤訊息

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

• 收件人電子郵件地址缺失或無效
• 編碼後的匯出檔案超過 30 MB
• 傳送請求逾時或失敗
• 無法讀取或編碼健康資料

請檢視活動記錄以取得詳細的錯誤資訊。

提示和最佳實踐

1. 自動同步：

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

2. 維持在 30 MB 以內：

• 僅選擇您需要的指標
• 郵件優先使用每日或更短的日期範圍
• 使用彙總資料和較粗略的時間分組
• 對於大型歷史資料回填，請改用 Dropbox、Google Drive 或 REST API

3. 收件匣整理：

• 設定主旨前綴，讓篩選器/規則能夠可靠地捕捉匯出郵件
• 若您的服務商支援，請使用專用地址或加號別名

4. 頻率：

• 對大多數使用者而言，每日郵件是不錯的預設選擇
• 避免在指標集較大時使用過於頻繁的頻率——附件會迅速增大

5. 可靠性：

• 新增自動化小工具（參閱為自動化設定小工具）
• 變更指標、日期範圍或聚合方式後，請監控活動記錄

6. 安全性：

• 僅傳送給您信任的地址
• 儲存前請確認收件人

相關指南

• 自動化概覽
• 為自動化設定小工具
• Dropbox 自動化指南
• Google 雲端硬碟自動化指南
• REST API 自動化指南