Amazon S3、DropBox、Google Drive 和 OneDrive CSV 配置

我们可以生成逗号分隔文件（CSV），并从Amazon S3、DropBox、Google Drive和OneDrive中读取数据。 这是从其他服务导入数据，或导出文件以进行备份或与其他应用程序共享的一种简单方法。为了实现最大的灵活性并支持所有服务，其配置选项非常丰富。以下是配置方法：

• 请设置要让我们读取或修改的文件的路径。您可以在路径中的任意位置包含“{tasktype}”，我们将把它替换为该任务同步的数据类型——因此，“/exports/{tasktype}.csv”在“活动”任务中会变成“/exports/Activity.csv”，在“睡眠”任务中会变成“/exports/Sleep.csv”。这样，一个文件夹中就可以存放多个任务，而不会导致它们互相覆盖。
• 如果您提供的是文件夹而非单个文件，我们将使用该文件夹内的FitnessSyncer-{tasktype}.csv，例如FitnessSyncer-Activity.csv。
• 请指定该文件应使用的分隔符。如果您找不到所需的分隔符，请联系我们。
• 如果您的文件中包含注释块，请选择注释前缀字符。如果您找不到所需的字符，请联系我们。
• 如果文件顶部包含一段文本，您可以将起始行更改为包含标题的行号。
• 对于数据中的每一列，请勾选“列号”左侧的复选框，然后输入该列的数字索引。例如，在 Excel 中，如果该列是 B1，则该值为 2。
• 对于数据中未包含的任何数据，您可以在“默认”列中输入一个覆盖值。
• 某些 CSV 文件是活动数据的每日汇总，在这种情况下，您可能希望按日期对这些数据进行分组，以免每天产生大量记录（例如每分钟一条）。 要实现这一点，请勾选“按日期分组数据？”复选框（目前此功能仅适用于“活动”）。
• 某些 CSV 文件包含每餐的详细数据，在这种情况下，您可能希望按日期对这些数据进行分组，以免产生大量零散的记录。要实现这一点，请勾选“按餐分组数据？”复选框（目前此功能仅适用于营养信息）。
• 某些 CSV 文件中包含未指定时区的日期和时间，在这种情况下，系统将默认采用您个人资料中的时区。如果未指定的日期和时间实际上是 UTC 时间，您可以通过勾选“对未指定时区的日期强制使用 UTC 时区？”复选框来覆盖该设置。

在导出数据时，“每日汇总显示总计”选项可让您灵活设置汇总行。若未勾选该选项，则将显示与Stream中完全一致的数据。若勾选此选项，每日汇总行将显示该日的总步数。 如果该日期默认没有汇总行，系统会向您的数据集添加一行汇总行。

为了方便进行列映射，您可以点击“通过上传样本选择列”按钮，该功能允许您上传文件的样本部分，然后以交互方式映射列并保存该配置。这是确保包含所有必填字段（例如开始日期）的绝佳方法。

所有其他设置都与“源”或“目标”完全相同。

某些服务可能会生成代表某项活动的 CSV 文件。系统支持此类文件，但您必须使用“Cloud Files”选项进行配置。

要配置 Amazon S3，请将访问密钥填入“用户名”字段，将密钥填入“密码”字段，路径请使用 bucket/directory/file。

如果您收到一条错误提示，指出某行未提供日期、活动或描述，或者该行的信息不完整，那么很可能是您遗漏了必填字段，或者系统无法解析该字段。我们建议您使用我们的“示例上传工具”，该工具会列出该数据类型的必填字段。

注意：对于目标任务，我们不会重写文件，而是将我们认为的新信息追加到文件末尾。如果您删除了该文件并希望重新填充内容，或者您已更改了导出数据的结构，则需要重置该任务。

CSV 在 Android 和 iOS 应用中

CSV 任务是在网站上而非在应用程序中设置的。原因在于字段映射：可供选择的字段多达数百个，而在手机屏幕上逐一筛选并不方便，因此应用程序不会显示其中一半的内容，而是将用户引导至本网站。

这些应用确实会按其本貌显示CSV任务。打开其中一个，文件格式显示为CSV，与这里一样，而且路径、名称和计划都像往常一样可以在那里进行编辑。 但这些应用程序无法创建新的CSV任务，因为没有列映射的CSV源无法导入任何内容。

当您需要映射功能——或者方言设置、引号、分隔符和起始行——时，应用会打开该网站并跳转到您之前查看的任务页面，自动登录，并在您操作完成后将您带回应用。返回过程中，应用会重新读取该任务，因此您在网页上所做的任何更改都会在应用中显示出来。

如果您已在该设备的浏览器中登录了 FitnessSyncer，则切换过程将直接使用该会话。

CSV 和日期

我们需要所有进口商品的日期。

• 如果您的日期与以下任一格式相似，请选择 日期（美国） ：
  • 07/27/2019 16:13:37
  • 07/27/2019 16:13
  • 07/27/2019
  • Jul 27, 2019
  • July 27, 2019
  • 2019-07-27 16:13:37
  • 2019-07-27 16:13:37 Z
  • 2019-07-27T16:13:37Z
  • 2019-07-27T16:13:37
  • July 27, 2019 04:13:37 PM
  • July 27, 2019 04:13 PM
  • July 27, 2019 - 04:13:37 PM
  • July 27, 2019 16:13:37
  • July 27, 2019 16:13
  • July 27 2019 04:13:37 PM
  • July 27 2019 04:13 PM
  • July 27 2019 - 04:13:37 PM
  • July 27 2019 16:13:37
  • July 27 2019 16:13
  • Jul 27, 2019 04:13:37 PM
  • Jul 27, 2019 04:13 PM
  • Jul 27, 2019 16:13:37
  • Jul 27, 2019 16:13
  • 2019-07-27 16:13Z
  • 2019-07-27 16:13
  • 27-Jul-2019 16:13
  • 07-27-2019 16:13
  • 07-27-2019
  • 16:13:37 PM Jul 27 2019
  • 2019-07-27
  • 2019/07/27 16:13:37
  • 2019/07/27 16:13
• 如果您的日期与以下任一格式相似，请选择 日期（非美国） ：
  • 27/07/2019 16:13:37
  • 27/07/2019 16:13
  • 27/07/2019
  • 27 Jul 2019
  • 27 July 2019
  • 2019-07-27 16:13:37
  • 2019-07-27 16:13:37 Z
  • 2019-07-27T16:13:37Z
  • 2019-07-27T16:13:37
  • 2019-07-27 16:13
  • 27 July 2019 04:13:37 PM
  • 27 July 2019 04:13 PM
  • 27 July 2019 16:13:37
  • 27 July 2019 16:13
  • 27 Jul 2019 04:13:37 PM
  • 27 Jul 2019 04:13 PM
  • 27 Jul 2019 16:13:37
  • 27 Jul 2019 16:13
  • 27-Jul-2019 16:13
  • 2019-07-27
  • 27-Jul-19
  • 27.07.2019 16:13:37
  • 2019/07/27 16:13:37
  • 2019/07/27 16:13
  • 27.07.2019 16:13Z
  • 27.Jul.2019 16:13
  • 27.07.2019
  • 2019.07.27 16:13Z
  • 27.Jul.2019 16:13
  • 2019.07.27
  • 27/Jul/2019
  • 20190727
• 如果您的数据类似于“1564244017”，请选择“时间（以秒为单位）”。
• 如果您的数据类似于“1564244017000”，请选择“时间（以毫秒为单位）”。
• 如果您的数据表中设有专门用于存储 年、 月份 和 日 的列，请选择这三列。
• 如果时间未以上述任一格式指定，您可以使用“时间格式”来添加时间，该格式必须是以下格式之一：
  • 04:13:37 Z PM
  • 04:13:37 PM
  • 04:13 PM
  • 16:13:37 Z
  • 16:13:37
  • 16:13

在数据导出时，我们将使用上述配置中的第一种格式。

如果您的日期格式与上述任何一种都不符，请联系我们。

CSV 和枚举值

部分字段仅接受固定值集中的某个值。这些值必须与下文所示完全一致——全部大写，并在标注处使用下划线——而非我们在FitnessSyncer其他位置显示的友好名称。 如果某个值与指定值不完全匹配，系统会默认跳过该行（而非拒绝整个导入操作），因此如果某个字段的导入结果与预期不符，建议仔细核对这些字段。

• 月经周期追踪, 流量水位:
  • NONE (无)
  • SPOTTING (点状出血)
  • LIGHT (量少)
  • MEDIUM (量中)
  • HEAVY (量多)
• 月经周期追踪, 宫颈粘液:
  • DRY (干)
  • STICKY (置顶)
  • CREAMY (奶油般的)
  • WATERY (水汪汪的)
  • EGG_WHITE (蛋清)
• 月经周期追踪, 排卵测试:
  • NEGATIVE (否)
  • HIGH (高)
  • PEAK (峰值)
• 药物剂量单位:
  • ML (ML)
  • MG (MG)
  • MGML (MG/ML)
  • MCG (微克)
  • TABLET (平板电脑)