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. 共享（工具栏）可导出完整的应用事件日志诊断 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 的共享功能进行协作