电子邮件自动化指南

电子邮件自动化允许您自动将健康数据作为电子邮件附件发送到您选择的地址。每次运行都会导出您配置的数据，将文件附加到一封简短的摘要邮件中，并发送给收件人。

概述

使用场景:

• 定期向自己发送健康导出
• 与医疗保健提供者或教练共享数据

限制

• 健康数据访问： 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 自动化指南